Return-Path: X-Original-To: apmail-ws-dev-archive@www.apache.org Delivered-To: apmail-ws-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id E68769CEB for ; Mon, 3 Oct 2011 09:04:58 +0000 (UTC) Received: (qmail 25035 invoked by uid 500); 3 Oct 2011 09:04:57 -0000 Delivered-To: apmail-ws-dev-archive@ws.apache.org Received: (qmail 24827 invoked by uid 500); 3 Oct 2011 09:04:57 -0000 Mailing-List: contact dev-help@ws.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@ws.apache.org Delivered-To: mailing list dev@ws.apache.org Received: (qmail 24326 invoked by uid 99); 3 Oct 2011 09:04:57 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 03 Oct 2011 09:04:57 +0000 X-ASF-Spam-Status: No, hits=-2000.5 required=5.0 tests=ALL_TRUSTED,RP_MATCHES_RCVD X-Spam-Check-By: apache.org Received: from [140.211.11.116] (HELO hel.zones.apache.org) (140.211.11.116) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 03 Oct 2011 09:04:55 +0000 Received: from hel.zones.apache.org (hel.zones.apache.org [140.211.11.116]) by hel.zones.apache.org (Postfix) with ESMTP id D56D12A696D for ; Mon, 3 Oct 2011 09:04:34 +0000 (UTC) Date: Mon, 3 Oct 2011 09:04:34 +0000 (UTC) From: "Colm O hEigeartaigh (Closed) (JIRA)" To: dev@ws.apache.org Message-ID: <1200952791.2417.1317632674876.JavaMail.tomcat@hel.zones.apache.org> Subject: [jira] [Closed] (WSS-15) Documentation for direct-reference mode of message signing MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 [ https://issues.apache.org/jira/browse/WSS-15?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Colm O hEigeartaigh closed WSS-15. ---------------------------------- > Documentation for direct-reference mode of message signing > ---------------------------------------------------------- > > Key: WSS-15 > URL: https://issues.apache.org/jira/browse/WSS-15 > Project: WSS4J > Issue Type: Improvement > Environment: WSS4J 1.0.0 > Reporter: Guy Rixon > Assignee: Davanum Srinivas > > The WSS4J web-site lacks instructions on how to select the direct-reference mode of message signature (in which the sender's certificate is included in the message). In fact, there's no documentation on the signature modes at all. I append an xdoc outlining the issuer-serial (WSS4J default) and direct-reference modes and explaining how to select them. > > > > Guy Rixon > Including the sender's certificate in the signed message > > > >
>

> 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). >

>

> There are two common ways of getting the certificates to the service. >

>
    >
  1. > 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. >
    2. >
  2. > 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. >
    3. >
>

> 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. >

>

> To use the direct-reference method when using WSDoAllSender to sign the messages, the client must > set a handler property as follows. >

> 
> 				stub._setProperty(WSHandlerConstants.SIG_KEY_ID, "DirectReference");
>
>

> To use the issuer-serial method, the property should be set like this: >

> 
> 				stub._setProperty(WSHandlerConstants.SIG_KEY_ID, "IssuerSerial");
>
>

> If the property is not set, the default in WSS4J is to use the issuer-serial method. >

>
> > > -- This message is automatically generated by JIRA. If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa For more information on JIRA, see: http://www.atlassian.com/software/jira --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@ws.apache.org For additional commands, e-mail: dev-help@ws.apache.org