Configure generator signing information using the WSS APIs
We can configure the signing information to protect message integrity for the request (client side) generator binding. Signing information includes the signature and the signed parts. To keep the integrity of the message, digital signatures are typically applied.
- Integrity refers to digital signature
- Confidentiality refers to encryption
In addition to using a digital signature and configuring the signing information, the following tasks should also be performed:
- Verify the signing information.
- Incorporate encryption.
- Attach security tokens.
Integrity is provided by applying a digital signature to a SOAP message. To configure signing information to protect message integrity, first digitally sign and then verify the signature for the SOAP messages. Integrity decreases the risk of data modification when you transmit data across a network. message integrity is provided by digitally signing the body, time stamp, and WS-Addressing headers using the signature algorithm methods. The WSS APIs specify which algorithm is to be used to sign the certificate. The signature algorithms specify the Uniform Resource Identifiers (URI) of the signature method. WebSphere Application Server supports several pre-configured request signing algorithm methods.
We can use the following interfaces to configure Web Services Security and to protect SOAP message integrity:
- Use the console to configure policy sets for the signing information.
- Use the WSS API to configure the SOAP message context (only for the client).
Configure signing information and protect message integrity
- Configure signing information using the WSSSignature API.
Configure signing information for the generator binding using the WSSSignature API. Signing information is used to sign parts of a message including the SOAP body, the time stamp, and the WS-Addressing headers. Both signing and encryption can be applied to the same message parts, such as the SOAP body.
- Add or change signed parts using the WSSSignPart API.
- Configure the client for request signing methods using the WSSSignature or WSSSignPart APIs.
To configure the client for request signing, choose the signing methods. The request signing methods include the signature, the canonicalization, the digest, and the transform methods. Use the WSSSignature API to configure the signature and canonicalization methods. Use the WSSSignPart API to configure the digest and transform methods.
Results
The WSS APIs also specify the security token for the generator (client) binding and set the type of token reference to protect message authenticity. By completing the steps in these tasks, you have configured generator signing to protect the integrity of the SOAP message.
What to do next
Verify the consumer signing information using the WSS APIs or by configuring policy sets using the console.
Subtopics
- Configure signing information using the WSS APIs
- Configure signing information using the WSSSignature API
- Add signed parts using the WSSSignPart API
- Configure request signing methods for the client
- Digital signing methods using the WSSSignature API
- Signed parts methods using the WSSSignPart API
Related tasks