130 lines
7.8 KiB
HTML
130 lines
7.8 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="concept" />
|
||
|
|
<meta name="DC.Title" content="Debugging" />
|
||
|
|
<meta name="abstract" content="When you are trying to identify JGSS problems, use the JGSS debugging capability to produce helpful categorized messages." />
|
||
|
|
<meta name="description" content="When you are trying to identify JGSS problems, use the JGSS debugging capability to produce helpful categorized messages." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahajgssover.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahajgssconcept.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahajgsscfgmain.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahajgssuse.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahajgssdev.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahajgsssamp.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzahajgssjavadoc.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzahajgssdebug" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>Debugging</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzahajgssdebug"><a name="rzahajgssdebug"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Debugging</h1>
|
||
|
|
<div><p>When you are trying to identify JGSS problems, use the JGSS debugging
|
||
|
|
capability to produce helpful categorized messages.</p>
|
||
|
|
<p>You can turn on one or more categories by setting the appropriate values
|
||
|
|
for the Java™ property com.ibm.security.jgss.debug. Activate
|
||
|
|
multiple categories by using a comma to separate the category names.</p>
|
||
|
|
<p>Debugging categories include the following:</p>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" id="d0e25">Category</th>
|
||
|
|
<th valign="top" id="d0e27">Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" headers="d0e25 ">help</td>
|
||
|
|
<td valign="top" headers="d0e27 ">List debug catgories</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">all</td>
|
||
|
|
<td valign="top" headers="d0e27 ">Turn on debugging for all categories</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">off</td>
|
||
|
|
<td valign="top" headers="d0e27 ">Turn off debugging completely</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">app</td>
|
||
|
|
<td valign="top" headers="d0e27 ">Application debugging (default)</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">ctx</td>
|
||
|
|
<td valign="top" headers="d0e27 ">Context operations debugging</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">cred</td>
|
||
|
|
<td valign="top" headers="d0e27 ">Credentials (including name) operations</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">marsh</td>
|
||
|
|
<td valign="top" headers="d0e27 ">Marshaling of tokens</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">mic</td>
|
||
|
|
<td valign="top" headers="d0e27 ">MIC operations</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">prov</td>
|
||
|
|
<td valign="top" headers="d0e27 ">Provider operations</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">qop</td>
|
||
|
|
<td valign="top" headers="d0e27 ">QOP operations</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">unmarsh</td>
|
||
|
|
<td valign="top" headers="d0e27 ">Unmarshaling of tokens</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">unwrap</td>
|
||
|
|
<td valign="top" headers="d0e27 ">Unwrap operations</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e25 ">wrap</td>
|
||
|
|
<td valign="top" headers="d0e27 ">Wrap operations</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">JGSS Debug class</h4><p>To debug your JGSS application
|
||
|
|
programmatically, use the debug class in the IBM<sup>®</sup> JGSS framework. Your application can
|
||
|
|
use the debug class to turn on and off debug categories and display debugging
|
||
|
|
information for the active categories.</p>
|
||
|
|
<p>The default debugging constructor
|
||
|
|
reads the Java property com.ibm.security.jgss.debug to determine
|
||
|
|
which categories to activate (turn on).</p>
|
||
|
|
<p><strong>Example: Debugging for the
|
||
|
|
application category</strong> </p>
|
||
|
|
<p>The following example shows how to request
|
||
|
|
debug information for the application category: </p>
|
||
|
|
<pre> import com.ibm.security.jgss.debug;
|
||
|
|
|
||
|
|
Debug debug = new Debug(); // Gets categories from Java property
|
||
|
|
|
||
|
|
// Lots of work required to set up someBuffer. Test that the
|
||
|
|
// category is on before setting up for debugging.
|
||
|
|
|
||
|
|
if (debug.on(Debug.OPTS_CAT_APPLICATION)) {
|
||
|
|
// Fill someBuffer with data.
|
||
|
|
debug.out(Debug.OPTS_CAT_APPLICATION, someBuffer);
|
||
|
|
// someBuffer may be a byte array or a String. </pre>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzahajgssover.htm" title="The Java Generic Security Service (JGSS) provides a generic interface for authentication and secure messaging. Under this interface you can plug a variety of security mechanisms based on secret-key, public-key, or other security technologies.">IBM Java Generic Security Service (JGSS)</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzahajgssconcept.htm" title="JGSS operations consist of four distinct stages, as standardized by the Generic Security Service Application Programming Interface (GSS-API).">JGSS concepts</a></div>
|
||
|
|
<div><a href="rzahajgsscfgmain.htm" title="How you configure your iSeries server to use JGSS depends on which version of the Java 2 Software Development Kit (J2SDK) that you run on your server.">Configuring your iSeries server to use IBM JGSS</a></div>
|
||
|
|
<div><a href="rzahajgssuse.htm" title="The IBM Java Generic Security Service (JGSS) API 1.0 shields secure applications from the complexities and peculiarities of the different underlying security mechanisms. JGSS uses features provided by Java Authentication and Authorization Service (JAAS) and IBM Java Cryptography Extension (JCE).">Running IBM JGSS applications</a></div>
|
||
|
|
<div><a href="rzahajgssdev.htm" title="Use JGSS to develop secure applications. Learn about generating transport tokens, creating JGSS objects, establishing context, and more.">Developing IBM JGSS applications</a></div>
|
||
|
|
<div><a href="rzahajgsssamp.htm" title="The IBM Java Generic Security Service (JGSS) sample files include client and server programs, configuration files, policy files, and javadoc reference information. Use the sample programs to test and verify your JGSS setup.">Samples: IBM Java Generic Security Service (JGSS)</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relref"><strong>Related reference</strong><br />
|
||
|
|
<div><a href="rzahajgssjavadoc.htm" title="The javadoc reference information for IBM JGSS includes classes and methods in the org.ietf.jgss api package and the Java versions of some Kerberos credential management tools.">IBM JGSS javadoc reference information</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|