You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fx-dev@ws.apache.org by ru...@apache.org on 2006/05/01 21:57:17 UTC
svn commit: r398673 [1/8] - in /webservices/wss4j/site: ./ style/
Author: ruchithf
Date: Mon May 1 12:57:15 2006
New Revision: 398673
URL: http://svn.apache.org/viewcvs?rev=398673&view=rev
Log:
Updating site for the 1.5.0 release
Added:
webservices/wss4j/site/cert.html
Removed:
webservices/wss4j/site/changelog-report.html
webservices/wss4j/site/developer-activity-report.html
webservices/wss4j/site/file-activity-report.html
webservices/wss4j/site/javadoc-warnings-report.html
Modified:
webservices/wss4j/site/api.html
webservices/wss4j/site/axis.html
webservices/wss4j/site/checkstyle-report.html
webservices/wss4j/site/cvs-usage.html
webservices/wss4j/site/dependencies.html
webservices/wss4j/site/downloads.html
webservices/wss4j/site/index.html
webservices/wss4j/site/issue-tracking.html
webservices/wss4j/site/javadoc.html
webservices/wss4j/site/jdepend-report.html
webservices/wss4j/site/license.html
webservices/wss4j/site/mail-lists.html
webservices/wss4j/site/maven-reports.html
webservices/wss4j/site/package.html
webservices/wss4j/site/pmd-report.html
webservices/wss4j/site/project-info.html
webservices/wss4j/site/style/maven-base.css
webservices/wss4j/site/style/maven-classic.css
webservices/wss4j/site/style/maven-theme.css
webservices/wss4j/site/style/print.css
webservices/wss4j/site/team-list.html
Modified: webservices/wss4j/site/api.html
URL: http://svn.apache.org/viewcvs/webservices/wss4j/site/api.html?rev=398673&r1=398672&r2=398673&view=diff
==============================================================================
--- webservices/wss4j/site/api.html (original)
+++ webservices/wss4j/site/api.html Mon May 1 12:57:15 2006
@@ -1,9 +1,9 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache WSS4J - </title><style type="text/css" media="all">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache WSS4J - Apache WSS4J API Overview</title><style type="text/css" media="all">
@import url("./style/maven-base.css");
- @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://ws.apache.org/images/project-logo.jpg"></img></a><a href="http://ws.apache.org/wss4j/" id="projectLogo"><span>Apache WSS4J</span></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: August 1, 2005 7:14:41 PM EDT
- <span class="separator">|</span>Doc for 1.0
- </div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuProject Documentation"><h5></h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Apache_WSS4J_API_Overview"></a><h2>Apache WSS4J API Overview</h2></div><div class
="section"><div class="subsection"><a name="Contents"></a><h3>Contents</h3><ul>
+ @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://ws.apache.org/images/project-logo.jpg"></img></a><a href="http://ws.apache.org/wss4j/" id="projectLogo"><span>Apache WSS4J</span></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 02 May 2006
+ | Doc for 1.5</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About Apache WSS4J</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Apache_WSS4J_API_Overview"></a><h2>Apache WSS4J API Overview</h2></div><div class="section"><div class="subsection"><a name="Contents"></a><h3>Contents</h3><ul>
<li><a href="#API_Overview">API Overview</a><br></br>
</li>
<ul>
@@ -35,453 +35,270 @@
</p><p>Following is an overview of the main classes and methods for the
WSS4J API. Please refer to the java docs for the complete API
documentation.<br></br>
-</p></div><div class="subsection"><a name="org_apache_ws_security_WSSecurityEngine"></a><h3>org.apache.ws.security.WSSecurityEngine</h3><table class="bodyTable">
- <tbody>
- <tr class="a">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: middle;">Get an instance of security
-engine </td>
- <td colspan="2" rowspan="1" style="vertical-align: top;">
+</p></div><div class="subsection"><a name="org_apache_ws_security_WSSecurityEngine"></a><h3>org.apache.ws.security.WSSecurityEngine</h3><table class="bodyTable"><tbody>
+ <tr class="a"><td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
+ </td></tr>
+ <tr class="b"><td style="vertical-align: middle;">Get an instance of security
+engine </td><td colspan="2" rowspan="1" style="vertical-align: top;">
<pre>public static org.apache.ws.security.WSSecurityEngine getInstance()</pre>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Get
+ </td></tr>
+ <tr class="a"><td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Get
a singleton instance of security engine
class. If you need to get an instance configured for an older spec
(different namespaces) then use the other method which takes
org.apache.ws.security.WSSConfig<br></br>
- </td>
- </tr>
- <tr class="b">
- <td colspan="1" rowspan="4" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
- </td>
- </tr>
- <tr class="a">
- </tr>
- <tr class="b">
- </tr>
- <tr class="a">
- </tr>
- <tr class="b">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">
+ </td></tr>
+ <tr class="b"><td colspan="1" rowspan="4" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
+ </td></tr>
+ <tr class="a"></tr>
+ <tr class="b"></tr>
+ <tr class="a"></tr>
+ <tr class="b"><td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">
<pre>org.apache.ws.security.WSSecurityEngine</pre>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">Processes
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">Processes
WS-Security Headers in a SOAP Envelope<br></br>
- </td>
- </tr>
- </tbody>
-</table><br></br><table class="bodyTable">
- <tbody>
- <tr class="a">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: middle;">Verify WSS Headers<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top;">
+ </td></tr>
+ </tbody></table><br></br><table class="bodyTable"><tbody>
+ <tr class="a"><td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
+ </td></tr>
+ <tr class="b"><td style="vertical-align: middle;">Verify WSS Headers<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top;">
<pre>java.util.Vector <b>processSecurityHeader</b>(<br></br> org.w3c.dom.Document doc,<br></br> java.lang.String actor,<br></br> javax.security.auth.callback.CallbackHandler cb,<br></br> org.apache.ws.security.components.crypto.Crypto crypto<br></br> ) throws org.apache.ws.security.WSSecurityException</pre>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
+ </td></tr>
+ <tr class="a"><td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
a SOAP Envelope as a W3C Document and verifies the WSS Headers.
This
includes Username Token processing, Signature verification, decryption
and timestamp verification. In the case of encrypted elements,
decryption is performed live on the passed document, i.e., it is
transformed into the decrypted format.<br></br>
- </td>
- </tr>
- <tr class="b">
- <td colspan="1" rowspan="4" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
- </td>
- <td style="vertical-align: top; font-weight: bold;">
+ </td></tr>
+ <tr class="b"><td colspan="1" rowspan="4" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
+ </td><td style="vertical-align: top; font-weight: bold;">
<pre>doc</pre>
- </td>
- <td style="vertical-align: top;">the SOAP Envelope as W3C DOM
-Document</td>
- </tr>
- <tr class="a">
- <td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">actor</td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
+ </td><td style="vertical-align: top;">the SOAP Envelope as W3C DOM
+Document</td></tr>
+ <tr class="a"><td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">actor</td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
engine works on behalf of this actor. Refer to the SOAP specification
about actor or role, this may be null.<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: top; font-weight: bold;">cb<br></br>
- </td>
- <td style="vertical-align: top;">a callback hander to the caller
+ </td></tr>
+ <tr class="b"><td style="vertical-align: top; font-weight: bold;">cb<br></br>
+ </td><td style="vertical-align: top;">a callback hander to the caller
to resolve passwords during encryption and UsernameToken handling, this
may be null.<br></br>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">crypto<br></br>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
+ </td></tr>
+ <tr class="a"><td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">crypto<br></br>
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
object that implements the access to the keystore and the handling of
certificates. A default implementation is included:
org.apache.ws.security.components.crypto.Merlin<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
- </td>
- <td style="vertical-align: top;">
+ </td></tr>
+ <tr class="b"><td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
+ </td><td style="vertical-align: top;">
<pre>java.util.Vector</pre>
- </td>
- <td style="vertical-align: top;">Vector of
+ </td><td style="vertical-align: top;">Vector of
org.apache.ws.security.WSSecurityEngineResult, this has the information
resulting from the processing, such as the principal, SAML token, etc.<br></br>
- </td>
- </tr>
- </tbody>
-</table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSBaseMessage"></a><h3>org.apache.ws.security.message.WSBaseMessage</h3><table class="bodyTable">
- <tbody>
- <tr class="a">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: middle;">Set the Signature/Encryption
+ </td></tr>
+ </tbody></table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSBaseMessage"></a><h3>org.apache.ws.security.message.WSBaseMessage</h3><table class="bodyTable"><tbody>
+ <tr class="a"><td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
+ </td></tr>
+ <tr class="b"><td style="vertical-align: middle;">Set the Signature/Encryption
parts<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top;">
+ </td><td colspan="2" rowspan="1" style="vertical-align: top;">
<pre>public void setParts(java.util.Vector parts)</pre>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
+ </td></tr>
+ <tr class="a"><td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
a vector of org.apache.ws.security.WSEncryptionPart.<br></br>
- </td>
- </tr>
- <tr class="b">
- <td colspan="1" rowspan="2" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
- </td>
- <td style="vertical-align: top; font-weight: bold;">
+ </td></tr>
+ <tr class="b"><td colspan="1" rowspan="2" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
+ </td><td style="vertical-align: top; font-weight: bold;">
<pre>doc</pre>
- </td>
- <td style="vertical-align: top;">the SOAP Envelope as W3C DOM
-Document</td>
- </tr>
- <tr class="a">
- <td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">crypto<br></br>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
+ </td><td style="vertical-align: top;">the SOAP Envelope as W3C DOM
+Document</td></tr>
+ <tr class="a"><td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">crypto<br></br>
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
object that implements the access to the keystore and the handling of
certificates. A default implementation is included:
org.apache.ws.security.components.crypto.Merlin<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
- </td>
- <td style="vertical-align: top;">
+ </td></tr>
+ <tr class="b"><td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
+ </td><td style="vertical-align: top;">
<pre>org.w3c.dom.Document</pre>
- </td>
- <td style="vertical-align: top;">the
+ </td><td style="vertical-align: top;">the
SOAP Envelope Signed. The signed elements depend on the signature parts
that are specified by the WSBaseMessage.setParts(java.util.Vector
parts) method<br></br>
- </td>
- </tr>
- </tbody>
-</table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSSignEnvelope__extends_WSBaseMessage_"></a><h3>org.apache.ws.security.message.WSSignEnvelope (extends WSBaseMessage)</h3><table class="bodyTable">
- <tbody>
- <tr class="a">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: middle;">Signs a SOAP Envelope<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top;">
+ </td></tr>
+ </tbody></table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSSignEnvelope__extends_WSBaseMessage_"></a><h3>org.apache.ws.security.message.WSSignEnvelope (extends WSBaseMessage)</h3><table class="bodyTable"><tbody>
+ <tr class="a"><td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
+ </td></tr>
+ <tr class="b"><td style="vertical-align: middle;">Signs a SOAP Envelope<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top;">
<pre>public org.w3c.dom.Document build(<br></br> org.w3c.dom.Document doc,<br></br> org.apache.ws.security.components.crypto.Crypto crypto<br></br> ) throws org.apache.ws.security.WSSecurityException</pre>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
+ </td></tr>
+ <tr class="a"><td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
a SOAP Envelope as a W3C Document and adds WSS Signature header to it.
The signed elements depend on the signature parts
that are specified by the WSBaseMessage.setParts(java.util.Vector
-parts) method. By default, SOAP Body is signed </td>
- </tr>
- <tr class="b">
- <td colspan="1" rowspan="2" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
- </td>
- <td style="vertical-align: top; font-weight: bold;">
+parts) method. By default, SOAP Body is signed </td></tr>
+ <tr class="b"><td colspan="1" rowspan="2" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
+ </td><td style="vertical-align: top; font-weight: bold;">
<pre>doc</pre>
- </td>
- <td style="vertical-align: top;">the SOAP Envelope as W3C DOM
-Document</td>
- </tr>
- <tr class="a">
- <td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">crypto<br></br>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
+ </td><td style="vertical-align: top;">the SOAP Envelope as W3C DOM
+Document</td></tr>
+ <tr class="a"><td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">crypto<br></br>
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
object that implements the access to the keystore and the handling of
certificates. A default implementation is included:
org.apache.ws.security.components.crypto.Merlin<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
- </td>
- <td style="vertical-align: top;">
+ </td></tr>
+ <tr class="b"><td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
+ </td><td style="vertical-align: top;">
<pre>org.w3c.dom.Document</pre>
- </td>
- <td style="vertical-align: top;">the
+ </td><td style="vertical-align: top;">the
SOAP Envelope signed.<br></br>
- </td>
- </tr>
- </tbody>
-</table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSAddTimestamp__extends_WSBaseMessage_"></a><h3>org.apache.ws.security.message.WSAddTimestamp (extends WSBaseMessage)</h3><table class="bodyTable">
- <tbody>
- <tr class="a">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: middle;">Add a Timestamp Token to a
-SOAP Envelope </td>
- <td colspan="2" rowspan="1" style="vertical-align: top;">
+ </td></tr>
+ </tbody></table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSAddTimestamp__extends_WSBaseMessage_"></a><h3>org.apache.ws.security.message.WSAddTimestamp (extends WSBaseMessage)</h3><table class="bodyTable"><tbody>
+ <tr class="a"><td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
+ </td></tr>
+ <tr class="b"><td style="vertical-align: middle;">Add a Timestamp Token to a
+SOAP Envelope </td><td colspan="2" rowspan="1" style="vertical-align: top;">
<pre>public org.w3c.dom.Document <b>build</b>(<br></br> org.w3c.dom.Document doc,<br></br> int ttl)</pre>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
+ </td></tr>
+ <tr class="a"><td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
a SOAP Envelope as a W3C Document and adds a Timestamp header to
it. Please refer to the WS specification 1.0. chapter 10 / appendix A.2
<p> </p>
<p> </p>
- </td>
- </tr>
- <tr class="b">
- <td colspan="1" rowspan="2" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
- </td>
- <td style="vertical-align: top; font-weight: bold;">
+ </td></tr>
+ <tr class="b"><td colspan="1" rowspan="2" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
+ </td><td style="vertical-align: top; font-weight: bold;">
<pre>doc</pre>
- </td>
- <td style="vertical-align: top;">the SOAP Envelope as W3C DOM
-Document</td>
- </tr>
- <tr class="a">
- <td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">
+ </td><td style="vertical-align: top;">the SOAP Envelope as W3C DOM
+Document</td></tr>
+ <tr class="a"><td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">
<pre>ttl</pre>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">(time
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">(time
to live) This is the time difference in seconds between the <code>Created</code>
and the <code>Expires</code> in <code>Timestamp</code>, set to zero
-if <code>Expires</code> should not be added. </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
- </td>
- <td style="vertical-align: top; background-color: rgb(255, 255, 255);">
+if <code>Expires</code> should not be added. </td></tr>
+ <tr class="b"><td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
+ </td><td style="vertical-align: top; background-color: rgb(255, 255, 255);">
<pre>org.w3c.dom.Document</pre>
- </td>
- <td style="vertical-align: top; background-color: rgb(255, 255, 255);">the
+ </td><td style="vertical-align: top; background-color: rgb(255, 255, 255);">the
SOAP Envelope with the Timestamp added<br></br>
- </td>
- </tr>
- </tbody>
-</table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSEncryptBody__extends_WSBaseMessage_"></a><h3>org.apache.ws.security.message.WSEncryptBody (extends WSBaseMessage)</h3><table class="bodyTable">
- <tbody>
- <tr class="a">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: middle;">Encrypt a SOAP Envelope<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top;">
+ </td></tr>
+ </tbody></table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSEncryptBody__extends_WSBaseMessage_"></a><h3>org.apache.ws.security.message.WSEncryptBody (extends WSBaseMessage)</h3><table class="bodyTable"><tbody>
+ <tr class="a"><td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
+ </td></tr>
+ <tr class="b"><td style="vertical-align: middle;">Encrypt a SOAP Envelope<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top;">
<pre>public org.w3c.dom.Document build(<br></br> org.w3c.dom.Document doc,<br></br> org.apache.ws.security.components.crypto.Crypto crypto<br></br> ) throws org.apache.ws.security.WSSecurityException</pre>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
+ </td></tr>
+ <tr class="a"><td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
a SOAP Envelope as a W3C Document and adds WSS Encryption header to it.
Unlike
what the class name might imply, this can be used to encrypt elements
in the SOAP Header, such as Username Tokens or other arbitrary
elements. The encrypted elements depend on the signature parts
that are specified by the WSBaseMessage.setParts(java.util.Vector
-parts) method. By default, SOAP Body is encrypted</td>
- </tr>
- <tr class="b">
- <td colspan="1" rowspan="2" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
- </td>
- <td style="vertical-align: top; font-weight: bold;">
+parts) method. By default, SOAP Body is encrypted</td></tr>
+ <tr class="b"><td colspan="1" rowspan="2" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
+ </td><td style="vertical-align: top; font-weight: bold;">
<pre>doc</pre>
- </td>
- <td style="vertical-align: top;">the SOAP Envelope as W3C DOM
-Document</td>
- </tr>
- <tr class="a">
- <td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">crypto<br></br>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
+ </td><td style="vertical-align: top;">the SOAP Envelope as W3C DOM
+Document</td></tr>
+ <tr class="a"><td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">crypto<br></br>
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
object that implements the access to the keystore and the handling of
certificates. A default implementation is included:
org.apache.ws.security.components.crypto.Merlin<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
- </td>
- <td style="vertical-align: top;">
+ </td></tr>
+ <tr class="b"><td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
+ </td><td style="vertical-align: top;">
<pre>org.w3c.dom.Document</pre>
- </td>
- <td style="vertical-align: top;">the
+ </td><td style="vertical-align: top;">the
SOAP Envelope encrypted.<br></br>
- </td>
- </tr>
- </tbody>
-</table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSAddUsernameToken__extends_WSBaseMessage_"></a><h3>org.apache.ws.security.message.WSAddUsernameToken (extends WSBaseMessage)</h3><table class="bodyTable">
- <tbody>
- <tr class="a">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: middle;">Add a Username Token to a
+ </td></tr>
+ </tbody></table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSAddUsernameToken__extends_WSBaseMessage_"></a><h3>org.apache.ws.security.message.WSAddUsernameToken (extends WSBaseMessage)</h3><table class="bodyTable"><tbody>
+ <tr class="a"><td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
+ </td></tr>
+ <tr class="b"><td style="vertical-align: middle;">Add a Username Token to a
SOAP Envelope<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top;">
+ </td><td colspan="2" rowspan="1" style="vertical-align: top;">
<pre>public org.w3c.dom.Document build(<br></br> org.w3c.dom.Document doc,<br></br> java.lang.String username,<br></br> java.lang.String password)</pre>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
+ </td></tr>
+ <tr class="a"><td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
a SOAP Envelope as a W3C Document and adds a Username Token header to
it. Use setPasswordType(java.lang.String pwType) to choose between
-plain text passwords and digested ones. </td>
- </tr>
- <tr class="b">
- <td colspan="1" rowspan="3" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
- </td>
- <td style="vertical-align: top; font-weight: bold;">
+plain text passwords and digested ones. </td></tr>
+ <tr class="b"><td colspan="1" rowspan="3" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
+ </td><td style="vertical-align: top; font-weight: bold;">
<pre>doc</pre>
- </td>
- <td style="vertical-align: top;">the SOAP Envelope as W3C DOM
-Document</td>
- </tr>
- <tr class="a">
- <td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">username<br></br>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
+ </td><td style="vertical-align: top;">the SOAP Envelope as W3C DOM
+Document</td></tr>
+ <tr class="a"><td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">username<br></br>
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
username to use<br></br>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: top;">password<br></br>
- </td>
- <td style="vertical-align: top;">the password to use (a plain
+ </td></tr>
+ <tr class="b"><td style="vertical-align: top;">password<br></br>
+ </td><td style="vertical-align: top;">the password to use (a plain
text string)<br></br>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">
+ </td></tr>
+ <tr class="a"><td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">
<pre>org.w3c.dom.Document</pre>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
SOAP Envelope with the username token header added<br></br>
- </td>
- </tr>
- </tbody>
-</table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSSAddSAMLToken__extends_WSBaseMessage_"></a><h3>org.apache.ws.security.message.WSSAddSAMLToken (extends WSBaseMessage)</h3><table class="bodyTable">
- <tbody>
- <tr class="b">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: middle;">Add a SAML Token to a SOAP
-Envelope </td>
- <td colspan="2" rowspan="1" style="vertical-align: top;">
+ </td></tr>
+ </tbody></table><br></br></div><div class="subsection"><a name="org_apache_ws_security_message_WSSAddSAMLToken__extends_WSBaseMessage_"></a><h3>org.apache.ws.security.message.WSSAddSAMLToken (extends WSBaseMessage)</h3><table class="bodyTable"><tbody>
+ <tr class="b"><td style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Action<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 204, 204); font-weight: bold;">Method<br></br>
+ </td></tr>
+ <tr class="a"><td style="vertical-align: middle;">Add a SAML Token to a SOAP
+Envelope </td><td colspan="2" rowspan="1" style="vertical-align: top;">
<pre>public org.w3c.dom.Document build(<br></br> org.w3c.dom.Document doc,<br></br> org.opensaml.SAMLAssertion assertion)</pre>
- </td>
- </tr>
- <tr class="b">
- <td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
- </td>
- <td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
+ </td></tr>
+ <tr class="b"><td style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Description<br></br>
+ </td><td colspan="2" rowspan="1" style="vertical-align: top; background-color: rgb(204, 255, 255);">Takes
a SOAP Envelope as a W3C Document and adds a SAML Assertion Token
header to
it. Please refer to the OpenSAML documentation on how to construct SAML
assertions.<br></br>
- </td>
- </tr>
- <tr class="a">
- <td colspan="1" rowspan="2" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
- </td>
- <td style="vertical-align: top; font-weight: bold;">
+ </td></tr>
+ <tr class="a"><td colspan="1" rowspan="2" style="vertical-align: middle; background-color: rgb(204, 204, 204); font-weight: bold;">Parameters<br></br>
+ </td><td style="vertical-align: top; font-weight: bold;">
<pre>doc</pre>
- </td>
- <td style="vertical-align: top;">the SOAP Envelope as W3C DOM
-Document</td>
- </tr>
- <tr class="b">
- <td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">
+ </td><td style="vertical-align: top;">the SOAP Envelope as W3C DOM
+Document</td></tr>
+ <tr class="b"><td style="vertical-align: top; font-weight: bold; background-color: rgb(204, 255, 255);">
<pre>assertion</pre>
- </td>
- <td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
+ </td><td style="vertical-align: top; background-color: rgb(204, 255, 255);">the
SAML assertion to add<br></br>
- </td>
- </tr>
- <tr class="a">
- <td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
- </td>
- <td style="vertical-align: top; background-color: rgb(255, 255, 255);">
+ </td></tr>
+ <tr class="a"><td style="vertical-align: top; background-color: rgb(204, 204, 204);"><span style="font-weight: bold;">Returns</span><br></br>
+ </td><td style="vertical-align: top; background-color: rgb(255, 255, 255);">
<pre>org.w3c.dom.Document</pre>
- </td>
- <td style="vertical-align: top; background-color: rgb(255, 255, 255);">the
+ </td><td style="vertical-align: top; background-color: rgb(255, 255, 255);">the
SOAP Envelope with the SAML assertion header added<br></br>
- </td>
- </tr>
- </tbody>
-</table><br></br></div><div class="subsection"><a name="Examples"></a><h3>Examples</h3></div><div class="subsection"><a name="Sign_the_SOAP_Body"></a><h3>Sign the SOAP Body</h3><small>Document envelope = ...<br></br>
+ </td></tr>
+ </tbody></table><br></br></div><div class="subsection"><a name="Examples"></a><h3>Examples</h3></div><div class="subsection"><a name="Sign_the_SOAP_Body"></a><h3>Sign the SOAP Body</h3><small>Document envelope = ...<br></br>
WSSignEnvelope signer = new WSSignEnvelope();<br></br>
Crypto crypto = CryptoFactory.getInstance("crypto.properties");<br></br>
Vector parts = new Vector();<br></br>
@@ -537,4 +354,4 @@
System.out.println(eResult.getPrincipal().getName());<br></br>
}<br></br>
}<br></br>
-}</small><br></br></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2005, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
+}</small><br></br></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2006, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Modified: webservices/wss4j/site/axis.html
URL: http://svn.apache.org/viewcvs/webservices/wss4j/site/axis.html?rev=398673&r1=398672&r2=398673&view=diff
==============================================================================
--- webservices/wss4j/site/axis.html (original)
+++ webservices/wss4j/site/axis.html Mon May 1 12:57:15 2006
@@ -1,9 +1,9 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache WSS4J - </title><style type="text/css" media="all">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache WSS4J - Axis Deployment Tutorial</title><style type="text/css" media="all">
@import url("./style/maven-base.css");
- @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://ws.apache.org/images/project-logo.jpg"></img></a><a href="http://ws.apache.org/wss4j/" id="projectLogo"><span>Apache WSS4J</span></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: August 1, 2005 7:14:41 PM EDT
- <span class="separator">|</span>Doc for 1.0
- </div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuProject Documentation"><h5></h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Apache_WSS4J"></a><h2>Apache WSS4J</h2></div><div class="section"><a name="Axis_D
eployment_Tutorial"></a><h2>Axis Deployment Tutorial</h2></div><div class="section"><div class="subsection"><a name="Contents"></a><h3>Contents</h3><ul>
+ @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://ws.apache.org/images/project-logo.jpg"></img></a><a href="http://ws.apache.org/wss4j/" id="projectLogo"><span>Apache WSS4J</span></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 02 May 2006
+ | Doc for 1.5</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About Apache WSS4J</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Apache_WSS4J"></a><h2>Apache WSS4J</h2></div><div class="section"><a name="Axis_Deployment_Tutorial"></a><h2>Axis Deployment Tutorial</h2></div><div class="section"><div
class="subsection"><a name="Contents"></a><h3>Contents</h3><ul>
<li>Introduction</li>
<li>Prerequisties</li>
<li>Steps</li>
@@ -11,7 +11,7 @@
<li>Username Token<br></br>
</li>
</ul>
-</ul></div></div><div class="section"><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><div style="margin-left: 40px;">WS4J can be used for securing web
+</ul></div></div><div class="section"><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><div style="margin-left: 40px;">WSS4J can be used for securing web
services deployed in virtually any application server, but it includes
special support for Axis. WSS4J ships with handlers that can be used in
Axis-based web
@@ -394,4 +394,4 @@
requests.</li>
</ol>
<br></br>
-</div><br></br><br></br><div style="margin-left: 40px;"></div></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2005, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
+</div><br></br><br></br><div style="margin-left: 40px;"></div></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2006, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: webservices/wss4j/site/cert.html
URL: http://svn.apache.org/viewcvs/webservices/wss4j/site/cert.html?rev=398673&view=auto
==============================================================================
--- webservices/wss4j/site/cert.html (added)
+++ webservices/wss4j/site/cert.html Mon May 1 12:57:15 2006
@@ -0,0 +1,42 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache WSS4J - Including the sender's certificate in the signed message</title><style type="text/css" media="all">
+ @import url("./style/maven-base.css");
+
+ @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Guy Rixon"></meta><meta name="email" content="gtr@ast.cam.ac.uk"></meta></head><body class="composite"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://ws.apache.org/images/project-logo.jpg"></img></a><a href="http://ws.apache.org/wss4j/" id="projectLogo"><span>Apache WSS4J</span></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 02 May 2006
+ | Doc for 1.5</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About Apache WSS4J</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Including_the_sender_s_certificate_in_the_signed_message"></a><h2>Including the sender's certificate in the signed message</h2><p>
+When messages are digitally signed, the recipient must have the sender's
+certificate chain in order to check the signature. Typically, the chain has
+two certificates: that of the sender and that of the sender's certificate
+authority (CA).
+</p><p>
+There are two common ways of getting the certificates to the service.
+</p><ol>
+<li>
+Install the CA's certificate in the service configuration. Send the caller's
+individual certificate with the signed message. This is called "direct reference",
+since the signature mark-up in the SOAP header refers directly to an included
+credential.
+</li>
+<li>
+Install both the CA certificate and the caller's individual certificate in the
+service configuration. Send the CA's name and the serial number of the caller's
+certificate in the SOAP message; have the service retrieve its copy of the certificate
+using these metadata. This is called the "issuer-serial" method.
+</li>
+</ol><p>
+The issuer-serial method presumes that all trusted users of the service are known to the
+service and have pre-registered
+their certificate chains before using the service. The direct-reference method presumes
+that the service operator trusts all users with certificates issued by a trusted CA.
+</p><p>
+To use the direct-reference method when using WSDoAllSender to sign the messages, the client must
+set a handler property as follows.
+</p><pre>
+stub._setProperty(WSHandlerConstants.SIG_KEY_ID, "DirectReference");
+</pre><p>
+To use the issuer-serial method, the property should be set like this:
+</p><pre>
+stub._setProperty(WSHandlerConstants.SIG_KEY_ID, "IssuerSerial");
+</pre><p>
+If the property is not set, the default in WSS4J is to use the issuer-serial method.
+</p></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2006, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: wss4j-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: wss4j-dev-help@ws.apache.org