Network Deployment (Distributed operating systems), v8.0 > Secure applications and their environment > Secure web services > Secure web services > Administer Web Services Security > Administer message-level security for JAX-WS web services > Secure web services using policy sets


Configure policy set and bindings to encrypt a UsernameToken

This example shows how to configure the message-level WS-Security policy set and bindings to send a Username token in a JAX-WS request, and to encrypt the Username token using asymmetric encryption. Make a copy of the Username WSSecurity default policy set and give it a unique name. This example illustrates how to modify a copy of the default policy set. For more information, read about copying default policy set and bindings settings.

By default, the Username WSSecurity policy set signs the WS-Addressing headers and body in the request and the response, and encrypts the body and signature in the request and the response. However, in this example, the goal is to encrypt only the Username token in the request from the client to the service, but not to encrypt any part of the response from the service to the client. In addition, no part of the request or the response will be signed. Therefore, the policy set must be modified to remove several message protection parts. We must also configure the client and server bindings.

First, configure the policy set by modifying your copy of the Username WSSecurity default policy set.


Procedure

  1. From the admin console, click Services > Policy sets > Application policy sets > policy_set_name. In the Policy set settings panel, you can specify information about the policy set, such as the description.
  2. Remove the following message protection parts: request:app_signparts, response:app_signparts and response:app_encparts.

    1. Click Application policy sets > policy_set_name > WS-Security > Main policy > Response message part protection.

    2. Click on app_encparts in the Encrypted parts box, then click the Delete button.

    3. Click on app_signparts in the Signed parts box, then click the Delete button.

    4. Click Application policy sets > policy_set_name > WS-Security > Main policy > Request message part protection.

    5. Click on app_signparts in the Signed parts box, then click the Delete button.

  3. Update the protection part specified for request:app_encparts. By default, this message protection part encrypts the body and signature elements, and must be modified to encrypt the Username token.

    1. Click Application policy sets > policy_set_name > WS-Security > Main policy > Request message part protection > Encrypted part - app_encparts > Edit.
    2. Delete the existing elements in the Elements in part panel, then add two XPath expressions for encrypting the Username token.

      Expression 1: 

      /*[namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/'
        and local-name()='Envelope']/*[namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/'
        and local-name()='Header']/*[namespace-uri()='http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd'
        and local-name()='Security']/*[namespace-uri()='http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd'
        and local-name()='UsernameToken']

      Expression 2: 

      /*[namespace-uri()='http://www.w3.org/2003/05/soap-envelope'
        and local-name()='Envelope']/*[namespace-uri()='http://www.w3.org/2003/05/soap-envelope'
        and local-name()='Header']/*[namespace-uri()='http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd'
        and local-name()='Security']/*[namespace-uri()='http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd'
        and local-name()='UsernameToken']


What to do next

The second part of the process is to configure the client and server bindings. When working with the client binding, be careful when choosing the protection token to edit. The names of the tokens are represented from the perspective of the protector. For instance, on a client, even though the word recipient is in its name, the AsymmetricBindingRecipientEncryptionToken0 is a generator. The best way to make sure that you are choosing the correct token is to look at the Usage column in the Protection tokens table.

  1. Configure the client binding, as follows:

    1. Attach the policy to a service resource and create a new binding for that resource that includes the WSSecurity policy.

    2. Click on WSSecurity in the new binding to display the main WSSecurity binding panel. For example, click Enterprise applications > WSSampleServiceSei > Service client policy sets and bindings > binding_name > WS-Security.

    3. Click Authentication and protection.
    4. Under Protection tokens, click AsymmetricBindingRecipientEncryptionToken0 (the Asymmetric encryption generator).

    5. Click Apply.

    6. Click Callback handler.

    7. Select Custom from the Keystore menu.

    8. Click Custom keystore configuration.

    9. Enter the keystore path. For example: ${USER_INSTALL_ROOT}/etc/ws-security/samples/enc-receiver.jceks.

    10. Select JCEKS for the Type.

    11. Enter the password in the Password and Confirm password fields. For example, storepass.

    12. Enter a Key Name. For example, CN=Bob, O=IBM, C=US.

    13. Enter a Key Alias. For example, bob.

    14. Click OK.

    15. Click OK again.

    16. Click OK one more time to return to the Enterprise Applications > WSSampleServicesSei > Service client policy sets and bindings > binding_name > WS-Security > Authentication and protection panel.
    17. The status of AsymmetricBindingRecipientEncryptionToken0 should display as Configured.

  2. Modify the encrypted parts settings for the client binding, as follows:

    1. Click request:app_encparts under Request message signature and encryption protection.

    2. Enter a Name. For example, MyEncPart.

    3. Click New under Key information.
    4. Fill in a Name. For example, MyEncKeyInfo.

    5. Click OK.

    6. Select MyEncKeyInfo (or the name that you specified for the encrypted part) from the Available box and click Add. MyEncKeyInfo appears in the Assigned box.

    7. Click OK to return to the Enterprise Applications > WSSampleServicesSei > Service client policy sets and bindings > binding_name > WS-Security > Authentication and protection panel.
    8. The status of request:app_encparts should display as Configured.

  3. Configure the Username token settings in the client binding, as follows:

    1. Click request:myUserNameToken under Authentication tokens.

    2. Click Apply.

    3. Click Callback handler.

    4. Specify the User name. For example, LDAPSunuser6.

    5. Specify the password, and confirm the password.

    6. Click OK.

    7. Under Custom properties, click New to add the properties for enabling nonce and timestamp.

    8. Enter the property name com.ibm.wsspi.wssecurity.token.username.addNonce to enable nonce, and the property value true.

    9. Enter the property name com.ibm.wsspi.wssecurity.token.username.addTimestamp to enable timestamp, and the property value true.

    10. Click OK again.
    11. The status of request:myUserNameToken should now display as Configured.

    12. Click Save to save your client bindings.

  4. Configure the server binding, as follows:

    1. Attach the policy to a service resource and create a new binding for that resource that includes the WSSecurity policy.

    2. Click on WSSecurity in the new binding to display the main WSSecurity binding panel. For example, click Enterprise Applications > WSSampleServiceSei > Service client policy sets and bindings > binding_name > WS-Security.

    3. Click Authentication and protection.
    4. Under Protection tokens, click AsymmetricBindingRecipientEncryptionToken0 (the Asymmetric encryption consumer)

    5. Click Apply.

    6. Click Callback handler.

    7. Select Custom from the Keystore menu.

    8. Click Custom keystore configuration.

    9. Enter the keystore path. For example: ${USER_INSTALL_ROOT}/etc/ws-security/samples/enc-receiver.jceks.

    10. Select JCEKS for the Type.

    11. Enter the password in the Password and Confirm password fields. For example, storepass.

    12. Enter a Key Name. For example, CN=Bob, O=IBM, C=US.

    13. Enter a Key Alias. For example, bob.

    14. Enter the password for the keypass in the Password and Confirm password fields.

    15. Click OK.

    16. Click OK again.

    17. Click OK one more time to get return to the Enterprise Applications > WSSampleServicesSei > Service client.policy sets and bindings > binding_name > WS-Security > Authentication and protection panel.
    18. The status of AsymmetricBindingRecipientEncryptionToken0 should display as Configured.

  5. Modify the encrypted parts settings for the server binding, as follows:

    1. Click request:app_encparts under Request message signature and encryption protection.

    2. Enter a Name. For example, MyEncPart.

    3. Click New under Key information.
    4. Fill in a Name. For example, MyEncKeyInfo.

    5. Click OK.

    6. Select MyEncKeyInfo (or the name that you specified for the encrypted part) from the Available box and click Add. MyEncKeyInfo appears in the Assigned box.

    7. Click OK to return to the Enterprise Applications > WSSampleServicesSei > Service client policy sets and bindings > binding_name > WS-Security > Authentication and protection panel.
    8. The status of request:app_encparts should display as Configured.

  6. Configure the Username token settings in the server binding, as follows:

    1. Click request:myUserNameToken under Authentication tokens.

    2. Click Apply.

    3. Click Callback handler.

    4. Click OK.

    5. Under Custom properties, click New to add the properties for verifying nonce and timestamp.

    6. Enter the property name com.ibm.wsspi.wssecurity.token.username.verifyNonce to verify nonce, and the property value true.

    7. Enter the property name com.ibm.wsspi.wssecurity.token.username.verifyTimestamp to verify timestamp, and the property value true.

    8. Click OK again.
    9. The status of request:myUserNameToken should display as Configured.

    10. Click Save to save the server bindings.


Secure web services using policy sets


Related


Copy of default policy set and bindings settings

+

Search Tips   |   Advanced Search