4 Interoperability with Oracle WebLogic Server 12c Web Service Security Environments

This chapter describes interoperability of Oracle Web Services Manager (OWSM) with Oracle WebLogic Server 12c web service security environments.

This chapter includes the following sections:

4.1 Overview of Interoperability with Oracle WebLogic Server 12c Web
Service Security Environments

In Oracle Fusion Middleware 12c, you can attach both OWSM and Oracle WebLogic Server 12c web service policies to WebLogic Java EE web services.

For more information about:

For more details about the predefined Oracle WebLogic Server 12c web service policies, see:

Table 4-1 and Table 4-2 summarize the most common Oracle WebLogic Server 12c web service policy interoperability scenarios based on the following security requirements: authentication, message protection, and transport. The tables are organized as follows:

  • Table 4-1 describes interoperability scenarios with WebLogic web service policies and OWSM client policies.

  • Table 4-2 describes interoperability scenarios with OWSM web service policies and WebLogic web service client policies.

Table 4-1 WebLogic Web Service Policy and OWSM Client Policy Interoperability

Identity Token WS-Security Version Message Protection Transport Security Service Policy Client Policy

Username

1.1

Yes

No

  • Wssp1.2-2007-Wss1.1-UsernameToken-Plain-EncryptedKey-Basic128.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

oracle/wss11_username_token_with_message_protection_client_policy

Username and MTOM

1.1

Yes

No

  • Wssp1.2-2007-Wss1.1-UsernameToken-Plain-EncryptedKey-Basic128.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

oracle/wss11_username_token_with_message_protection_client_policy

wsmtom_policy

Username

1.0

Yes

No

  • Wssp1.2-wss10_username_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

oracle/wss10_username_token_with_message_protection_client_policy

SAML 2.0

1.1

Yes

No

  • Wssp1.2-wss11_saml_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

oracle/wss11_saml_token_with_message_protection_client_policy

SAML

1.1

Yes

No

  • Wssp1.2-wss11_saml_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

oracle/wss11_saml_token_with_message_protection_client_policy

SAML and MTOM

1.1

Yes

No

  • Wssp1.2-wss11_saml_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

oracle/wss11_saml_token_with_message_protection_client_policy

wsmtom_policy

SAML

1.0

Yes

No

  • Wssp1.2-wss10_saml_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

oracle/wss10_saml_token_with_message_protection_client_policy

Mutual Authentication

1.1

Yes

No

  • Wssp1.2-wss11_x509_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

oracle/wss11_x509_token_with_message_protection_client_policy

Mutual Authentication

1.0

Yes

No

  • Wssp1.2-wss10_x509_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

oracle/wss10_x509_token_with_message_protection_client_policy

Table 4-2 OWSM Web Service Policy and WebLogic Web Service Client Policy Interoperability

Identity Token WS-Security Version Message Protection Transport Security Service Policy Client Policy

Username

1.1

Yes

No

oracle/wss11_username_token_with_message_protection_service_policy

  • Wssp1.2-2007-Wss1.1-UsernameToken-Plain-EncryptedKey-Basic128.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

Username and MTOM

1.1

Yes

No

oracle/wss11_username_token_with_message_protection_service_policy

  • Wssp1.2-wss10_username_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

Username

1.0

Yes

No

oracle/wss10_username_token_with_message_protection_service_policy

  • Wssp1.2-wss10_username_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

Username over SSL

1.0 and 1.1

No

Yes

oracle/wss_username_token_over_ssl_service_policy

Wssp1.2-2007-Https-UsernameToken-Plain.xml

Username over SSL with MTOM

1.0 and 1.1

No

Yes

oracle/wss_username_token_over_ssl_service_policy

Wssp1.2-2007-Https-UsernameToken-Plain.xml

SAML over SSL

1.0 and 1.1

No

Yes

oracle/wss_saml_token_over_ssl_service_policy

Wssp1.2-2007-Saml1.1-SenderVouches-Https.xml

SAML over SSL with MTOM

1.0 and 1.1

No

Yes

oracle/wss_saml_token_over_ssl_service_policy

Wssp1.2-2007-Saml1.1-SenderVouches-Https.xml

SAML 2.0

1.1

Yes

No

oracle/wss11_saml_token_with_message_protection_service_policy

  • Wssp1.2-wss11_saml_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

SAML

1.1

Yes

No

oracle/wss11_saml_token_with_message_protection_service_policy

  • Wssp1.2-wss11_saml_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

SAML with MTOM

1.1

Yes

No

oracle/wss11_saml_token_with_message_protection_service_policy

  • Wssp1.2-wss11_saml_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

SAML

1.0

Yes

No

oracle/wss10_saml_token_with_message_protection_service_policy

  • Wssp1.2-wss10_saml_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

Mutual Authentication

1.1

Yes

No

oracle/wss11_x509_token_with_message_protection_service_policy

  • Wssp1.2-wss11_x509_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

Mutual Authentication

1.0

Yes

No

oracle/wss10_x509_token_with_message_protection_service_policy

  • Wssp1.2-wss10_x509_token_with_message_protection_owsm_policy.xml

  • Wssp1.2-2007-SignBody.xml

  • Wssp1.2-2007-EncryptBody.xml

4.2 Username Token With Message Protection (WS-Security 1.1)

This section tells how to implement username token with message protection that conforms to the WS-Security 1.1 standard, in the following interoperability scenarios:

4.2.1 Interoperating with a WebLogic Web Service Policy

The following instructions tell how to implement username token with message protection that conforms to the WS-Security 1.1 standard and ensure interoperability between the WebLogic web service policy and the OWSM client policy:

To Attach and Configure the WebLogic Web Service Policy:

  1. Create a WebLogic web service.

    For more information, see "Roadmap for Implementing WebLogic (Java EE) Web Services" in Understanding Web Services

  2. Attach the following policies:

    1. Wssp1.2-2007-Wss1.1-UsernameToken-Plain-EncryptedKey-Basic128.xml

    2. Wssp1.2-2007-SignBody.xml

    3. Wssp1.2-2007-EncryptBody.xml

      For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

  3. Configure identity and trust stores.

    For more information, see "Configure identity and trust" in Oracle WebLogic Server Administration Console Online Help

  4. Configure message-level security.

    Note:

    You only need to configure the Confidentiality Key for a WS-Security 1.1 policy.

    For more information, see:

  5. Deploy the web service.

    For more information, see "Install a Web Service" in Oracle WebLogic Server Administration Console Online Help

To attach and Configure the OWSM Client Policy:

  1. Create a client proxy for the web service created earlier using clientgen or some other mechanism.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service client: oracle/wss11_username_token_with_message_protection_client_policy.

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  3. Configure the policy.

    For more information, see "oracle/wss11_username_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  4. Specify keystore.recipient.alias in the client configuration.

    For more information, see "oracle/wss11_username_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  5. Ensure that the keystore.recipient.alias keys specified for the client exist as trusted certificate entry in the trust store configured for the web service.

    For more information, see "oracle/wss11_username_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  6. Provide a valid username and password as part of the configuration.

    For more information, see "oracle/wss11_username_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  7. Invoke the web service method from the client.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

4.2.2 Web Service Client Policy

The following instructions tell how to implement username token with message protection that conforms to the WS-Security 1.1 standard and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and Configure the OWSM Policy:

  1. Create and deploy a web service.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service:

    1. oracle/wss11_username_token_with_message_protection_service_policy.

      For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

To attach and Configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service created using clientgen.

    For more information, see "Using the clientgen Ant Task to Generate Client Artifacts" in Developing JAX-WS Web Services for Oracle WebLogic Server

  2. Attach the following policies:

    1. Wssp1.2-2007-Wss1.1-UsernameToken-Plain-EncryptedKey-Basic128.xml

    2. Wssp1.2-2007-SignBody.xml

    3. Wssp1.2-2007-EncryptBody.xml

      For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

  3. Provide the configuration for the server (encryption key) in the client.

    Note:

    Ensure that the encryption key specified is in accordance with the encryption key configured for the web service.

    For more information, see "Updating a Client Application to Invoke a Message-Secured Web Service" in Securing WebLogic Web Services for Oracle WebLogic Server

  4. Invoke the web service method from the client.

    For more information, see "Writing the Java Client Application Code to Invoke a Web Service" in Developing JAX-WS Web Services for Oracle WebLogic Server

4.3 Username Token With Message Protection (WS-Security 1.1) and MTOM

This section describes how to implement username token with message protection that conforms to the WS-Security 1.1 standard and uses Message Transmission Optimization Mechanism (MTOM), in the following interoperability scenarios:

4.3.1 Interoperating with a WebLogic Web Service Policy

The following instructions tell how to implement username token with message protection that conforms to the WS-Security 1.1 standard and uses Message Transmission Optimization Mechanism (MTOM), and to ensure interoperability between the WebLogic web service policy and the OWSM client policy:

To attach and Configure the WebLogic Web Service Policy:

  1. Create a WebLogic web service.

    For more information, see "Roadmap for Implementing WebLogic (Java EE) Web Services" in Understanding Web Services.

  2. Use the @MTOM annotation in the web service.

    For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

To attach and configure the OWSM Client Policy:

  1. Configure the client proxy for the web service using clientgen or some other mechanism.

  2. If you did not use the @MTOM annotation in the web services, attach wsmtom_policy from the Management tab.

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

4.3.2 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement username token with message protection that conforms to the WS-Security 1.1 standard and uses Message Transmission Optimization Mechanism (MTOM), and to ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Configure the OWSM web service.

  2. Attach wsmtom_policy from the Management tab.

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

To attach and configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service created using clientgen.

  2. If you did not attach the wsmtom_policy, use the @MTOM annotation in the web service client.

4.4 Username Token With Message Protection (WS-Security 1.0)

This section describes how to implement username token with message protection that conforms to the WS-Security 1.0 standard, in the following interoperability scenarios:

Note:

WS-Security 1.0 policy is supported for legacy applications only. Use WS-Security 1.1 policy for maximum performance. For more information, see "Username Token With Message Protection (WS-Security 1.1)".

4.4.1 Interoperability with a WebLogic Web Service Policy

The following instructions tell how to implement username token with message protection that conforms to the WS-Security 1.0 standard and ensure interoperability between the WebLogic web service policy and the OWSM client policy:

To attach and configure the WebLogic Web Service Policy:

  1. Create a WebLogic web service.

    For more information, see "Roadmap for Implementing WebLogic (Java EE) Web Services" in Understanding Web Services

  2. Attach the following policies:

    1. Wssp1.2-2007-SignBody.xml

    2. Wssp1.2-wss10_username_token_with_message_protection_owsm_policy.xml

    3. Wssp1.2-2007-EncryptBody.xml

      For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

  3. Configure identity and trust stores.

    For more information, see "Configure identity and trust" in Oracle WebLogic Server Administration Console Online Help.

  4. Configure message-level security.

    For more information, see:

  5. Deploy the web service.

    For more information, see Deploying Applications to Oracle WebLogic Server.

To attach and configure the OWSM Client Policy:

  1. Create a client proxy to the web service created using clientgen or some other mechanism.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service client:

    1. oracle/wss10_username_token_with_message_protection_client_policy.

      For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  3. Configure the policy.

    For more information, see "oracle/wss10_username_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

    Note:

    Ensure that you use different keys for client (sign and decrypt key) and keystore recipient alias (server public key used for encryption). Ensure that the recipient alias is in accordance with the keys defined in the web service policy security configuration.

  4. Ensure that the signing and encryption keys specified for the client exist as trusted certificate entries in the trust store configured for the web service.

  5. Provide a valid username and password as part of the configuration.

  6. Invoke the web service method from the client.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

4.4.2 Interoperability with a WebLogic Web Service Client Policy

The following instructions tell how to implement username token with message protection that conforms to the WS-Security 1.0 standard and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Create a web service.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service:

    1. oracle/wss10_username_token_with_message_protection_service_policy.

      For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager.

To attach and configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service created using clientgen.

    For more information, see "Using the clientgen Ant Task to Generate Client Artifacts" in Developing JAX-WS Web Services for Oracle WebLogic Server

  2. Attach the following policies:

    1. Wssp1.2-wss10_username_token_with_message_protection_owsm_policy.xml

    2. Wssp1.2-2007-SignBody.xml

    3. Wssp1.2-2007-EncryptBody.xml

      For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

  3. Configure the client for server (encryption key) and client certificates.

    Note:

    Ensure that the encryption key specified is in accordance with the encryption key configured for the web service.

    For more information, see "Updating a Client Application to Invoke a Message-Secured Web Service" in Securing WebLogic Web Services for Oracle WebLogic Server

  4. Invoke the web service method from the client.

    For more information, see "Writing the Java Client Application Code to Invoke a Web Service" in Developing JAX-WS Web Services for Oracle WebLogic Server

4.5 Username Token Over SSL

This section how to implement username token over SSL, in the following interoperability scenario:

4.5.1 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement username token over SSL and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Configure the server for one-way SSL.

    For more information, see "Configuring SSL on WebLogic Server (One-Way)" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  2. Create a web service.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  3. Attach the following policy:

    1. oracle/wss_username_token_over_ssl_service_policy.

      For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

To attach and configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service created using clientgen. Provide a valid username and password as part of the configuration for this policy in the client proxy.

    For more information, see "Using the clientgen Ant Task to Generate Client Artifacts" in Developing JAX-WS Web Services for Oracle WebLogic Server

  2. Configure WebLogic Server for SSL.

    For more information, see "Configuring SSL on WebLogic Server (One-Way)" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  3. Configure identity and trust stores.

    For more information, see "Configure identity and trust" in Oracle WebLogic Server Administration Console Online Help

  4. Attach Wssp1.2-2007-Https-UsernameToken-Plain.xml to the web service client.

    For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

  5. Provide the truststore and other required System properties in the SSL client.

    For more information, see "Using SSL Authentication in Java Clients" in Developing Applications with the WebLogic Security Service

  6. Invoke the web service.

    For more information, see "Writing the Java Client Application Code to Invoke a Web Service" in Developing JAX-WS Web Services for Oracle WebLogic Server

4.6 Username Token Over SSL with MTOM

This section describes how to implement username token over SSL with Message Transmission Optimization Mechanism (MTOM), in the following interoperability scenario:

4.6.1 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement username token over SSL with MTOM and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Configure the OWSM web service.

To attach and configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service created earlier.

  2. Use the @MTOM annotation in the web service client.

    For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

4.7 SAML Token (Sender Vouches) Over SSL

This section describes how to implement SAML token sender vouches with SSL, in the following interoperability scenario:

4.7.1 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement SAML token sender vouches with SSL and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Configure the oracle/wss_saml_token_over_ssl_service_policy policy for two-way SSL.

    For more information, see "oracle/wss_saml_token_over_ssl_service_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  2. Create a web service.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  3. Attach the following policy to the web service: oracle/wss_saml_token_over_ssl_service_policy.

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager.

To attach and configure the WebLogic Web Service Client Policy:

  1. Configure the oracle/wss_saml_token_over_ssl_service_policy policy for two-way SSL.

    For more information, see "oracle/wss_saml_token_over_ssl_service_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  2. Create a web service.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  3. Attach the following policy to the web service: oracle/wss_saml_token_over_ssl_service_policy.

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager.

To attach and configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service created earlier using clientgen.

    For more information, see "Using the clientgen Ant Task to Generate Client Artifacts" in Developing JAX-WS Web Services for Oracle WebLogic Server

  2. Configure Oracle WebLogic Server for two-way SSL.

    For more information, see "Configuring SSL on WebLogic Server (Two-Way)" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  3. Configure identity and trust stores.

    For more information, see "Configure identity and trust" in Oracle WebLogic Server Administration Console Online Help

  4. Attach Wssp1.2-2007-Saml1.1-SenderVouches-Https.xml to the web service client.

    For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

  5. Configure a SAML credential mapping provider.

  6. In the WebLogic Server Administration Console, navigate to Security Realms > RealmName > Providers > Credential Mapping page and create a New Credential Mapping Provider of type SAMLCredentialMapperV2.

  7. Select the new provider, click on Provider Specific, and configure it as follows:

    1. Set Issuer URI to www.oracle.com.

    2. Set Name Qualifier to www.oracle.com.

  8. Restart Oracle WebLogic Server.

    For more information, see "Accessing Oracle WebLogic Administration Console" in Administering Web Services

  9. Create a SAML relying party by setting the Profile to WSS/Sender-Vouches.

  10. Configure the SAML relying party as follows (leave other values set to the defaults):

    1. Target URL: <url_used_to_access_Web_service>

    2. Description: <your_description>

    3. Select the Enabled checkbox and click Save.

    4. Ensure the Target URL is set to the URL used for the client web service.

      For more information, see "Create a SAML 1.1 Relying Party" in Oracle WebLogic Server Administration Console Online Help

  11. Create a servlet and call the proxy code from the servlet.

  12. Use BASIC authentication so that the authenticated subject can be created.

  13. Provide the truststore and other required System properties in the SSL client.

    For more information, see "Using SSL Authentication in Java Clients" in Developing Applications with the WebLogic Security Service

  14. Invoke the Web application client.

  15. Enter the credentials of the user whose identity is to be propagated using the SAML token.

    For more information, see "Writing the Java Client Application Code to Invoke a Web Service" in Developing JAX-WS Web Services for Oracle WebLogic Server

4.8 SAML Token (Sender Vouches) Over SSL with MTOM

This section describes how to implement SAML token sender vouches over SSL with MTOM, in the following interoperability scenario:

4.8.1 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement SAML token vouches over SSL with MTOM and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Configure the OWSM web service.

    For more information, see "SAML Token (Sender Vouches) Over SSL"

To attach and configure the WebLogic Web Service Client Policy:

  1. Configure the Oracle WebLogic web service client policy.

    For more information, see "SAML Token (Sender Vouches) Over SSL"

  2. Use the @MTOM annotation in the web service client.

    For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server.

4.9 SAML Token 2.0 (Sender Vouches) With Message Protection (WS-Security 1.1)

This section describes how to implement SAML 2.0 token sender vouches with message protection that conforms to the WS-Security 1.1 standard, in the following interoperability scenarios:

4.9.1 Interoperating with a WebLogic Web Service Policy

The following instructions tell how to implement SAML 2.0 token sender vouches with message protection that conforms to the WS-Security 1.1 standard and ensure interoperability between the WebLogic web service policy and the OWSM client policy:

To attach and configure the WebLogic Web Service Policy:

  1. Create a WebLogic web service.

    For more information, see "Roadmap for Implementing WebLogic (Java EE) Web Services" in Understanding Web Services

  2. Attach the following policies:

    • Wssp1.2-2007-Saml2.0-SenderVouches-Wss1.1.xml

    • Wssp1.2-2007-SignBody.xml

    • Wssp1.2-2007-EncryptBody.xml

    For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

  3. Configure the keystore properties for message signing and encryption. The configuration should be in accordance with the keystore used on the server side. Create the trust store out of the keystore by exporting both keys, and trust both of them while importing into trust store. Configure identity and trust stores.

    For more information, see "Configure identity and trust" in Oracle WebLogic Server Administration Console Online Help.

  4. Configure message-level security.

    For more information, see

  5. Attach new configuration using the annotation:

    @WssConfiguration(value="<my_security_configuration>") where <my_security_configuration> is the name of the Web Security Configuration created in previous step.

    For more information, see "Configuring Message-Level Security" in Securing WebLogic Web Services for Oracle WebLogic Server

  6. Deploy the web service.

    For more information, see Deploying Applications to Oracle WebLogic Server.

  7. Create a SAML Identity Asserter.

    In the WebLogic Server Administration Console, navigate to Security Realms > RealmName > Providers > Credential Mapping page and create a New Credential Mapping Provider of type SAML2IdentityAsserter.

    For more information, see "Configure Authentication and Identity Assertion providers" in Oracle WebLogic Server Administration Console Online Help

  8. Restart WebLogic Server.

    For more information, see "Start and stop servers" in the Oracle WebLogic Server Administration Console Online Help.

  9. To add the identity provider to the identity asserter created in Step 7, perform the following steps:

    1. Select the identity asserter created in Step 7 in the WebLogic Administration Console.

    2. Create a new identity provider partner, select New, and then select New Webservice Identity Provider Partner.

    3. Provide a name, and select Finish.

  10. Configure the identity provider as follows:

    1. Select the identity provide partner created in Step 9.

    2. Select the Enabled check box.

    3. Provide the Audience URI. For example:

      target:*:/saml20WLSWS-Project1-context-root/Class1Port

    4. Set Issuer URI to www.oracle.com.

    5. Set Target URL to <url_used_to_access_Web_service>.

    6. Set Profile to WSS/Sender-Vouches.

To attach and configure the OWSM Client Policy:

  1. Generate a client using JDeveloper for the web service created earlier. Create a Web project and then select New, and create a client proxy using the WSDL.

    For more information, see

  2. Add a servlet in the above project.

  3. Attach the following policy to the web service client: oracle/wss11_saml20_token_with_message_protection_client_policy.

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  4. Specify keystore.recipient.alias in the client configuration.

    Note:

    Ensure that keystore.recipient.alias is same as the decryption key specified for the web service.

    For more information, see "oracle/wss11_saml20_token_with_message_protection_cient_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  5. Ensure that the keystore.recipient.alias keys specified for the client exist as trusted certificate entry in the trust store configured for the web service.

    For more information, see "oracle/wss11_saml20_token_with_message_protection_cient_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  6. In JDeveloper, secure web project with Form-based authentication using the Configure ADF Security Wizard.

    For more information, see Developing Applications with Oracle JDeveloper

  7. Invoke the Web application client.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

4.9.2 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement SAML 2.0 token sender vouches with message protection that conforms to the WS-Security 1.1 standard and ensure interoperability between the WebLogic web service client policy and the OWSM policy:

To attach and configure the OWSM Policy:

  1. Create a web service.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service:

    oracle/wss11_saml20_token_with_message_protection_service_policy.

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

To attach and configure the WebLogic Web Service Client:

  1. Create a Java EE client for the deployed web service using JDeveloper. Create a Web project and create a proxy using WSDL proxy.

    For more information, see "Creating JAX-WS Web Services and Clients" in Developing Applications with Oracle JDeveloper

  2. Attach the following policies:

    • Wssp1.2-2007-Saml2.0-SenderVouches-Wss1.1.xml

    • Wssp1.2-2007-SignBody.xml

    • Wssp1.2-2007-EncryptBody.xml

      Note:

      Extract weblogic.jar to a folder and provide the absolute path to the above policies files.

      For more information, see "Attaching Policies" in Developing Applications with Oracle JDeveloper

  3. Add servlet to above web project.

  4. Configure the client for server (encryption key) and client certificates.

    Note:

    Ensure that the encryption key specified is in accordance with the decryption key configured for the web service.

    For more information, see "Updating a Client Application to Invoke a Message-Secured Web Service" in Securing WebLogic Web Services for Oracle WebLogic Server

  5. Secure the Web application client using BASIC Authentication.

    For more information, see "Developing BASIC Authentication Web Applications" in Developing Applications with the WebLogic Security Service

  6. Deploy the Java EE Web application client.

    For more information, see "Deploying Web Services Applications" in Administering Web Services

  7. Configure a SAML credential mapping provider.

    • In the Oracle WebLogic Server Administration Console, navigate to Security Realms > RealmName > Providers > Credential Mapping page and create a New Credential Mapping Provider of type SAML2CredentialMapper.

  8. Select the new provider, click on Provider Specific, and configure it as follows:

    1. Set Issuer URI to www.oracle.com.

    2. Set Name Qualifier to www.oracle.com.

    For more information, see "Configure Credential Mapping Providers" in Oracle WebLogic Server Administration Console Online Help

  9. Restart WebLogic Server.

    For more information, see "Start and stop servers" in the Oracle WebLogic Server Administration Console Online Help.

  10. To create a new service provider partner, perform the following steps:

    1. Select the credential mapper created in Step 7 in the WebLogic Administration Console, and then select the Management tab.

    2. Select New, and then select New Webservice Service Provider Partner.

    3. Provide a name, and select Finish.

  11. Configure the service provider partner as follows:

    1. Select the service provide partner created in Step 10.

    2. Select the Enabled check box.

    3. Provide the Audience URI.

    4. Set Issuer URI to www.oracle.com.

    5. Set Target URL to <url_used_to_access_Web_service>.

    6. Set Profile to WSS/Sender-Vouches.

  12. Invoke the Web application client.

4.10 SAML Token (Sender Vouches) with Message Protection (WS-Security 1.1)

This section describes how to implement SAML token sender vouches with message protection that conforms to the WS-Security 1.1 standard, in the following interoperability scenarios:

4.10.1 Interoperating with a WebLogic Web Service Policy

The following instructions tell how to implement SAML token sender vouches with message protection that conforms to the WS-Security 1.1 standard and ensure interoperability between the WebLogic web service policy and the OWSM client policy:

To attach and configure the WebLogic Web Service Policy:

  1. Create a WebLogic web service.

    For more information, see "Roadmap for Implementing WebLogic (Java EE) Web Services" in Understanding Web Services

  2. Attach the following policies:

  3. Configure identity and trust stores.

    For more information, see "Configure identity and trust" in Oracle WebLogic Server Administration Console Online Help

  4. Configure message-level security.

    Note:

    Since this is a WS-Security 1.1 policy, you need to configure Confidentiality Key only.

    For more information, see

  5. Deploy the web service.

    For more information, see Deploying Applications to Oracle WebLogic Server.

  6. Create a SAMLIdentityAsserterV2 authentication provider.

    • In the WebLogic Server Administration Console, navigate to Security Realms > RealmName > Providers > Credential Mapping page and create a New Credential Mapping Provider of type SAMLCredentialMapperV2.

      For more information, see "Configuring Authentication and Identity Assertion providers" in Oracle WebLogic Server Administration Console Online Help

  7. Restart WebLogic Server.

    For more information, see "Start and stop servers" in the Oracle WebLogic Server Administration Console Online Help.

  8. Select the authentication provider created in step 5.

  9. Create a SAML asserting party.

    • Set Profile to WSS/Sender-Vouches.

    For more information, see "Create a SAML 1.1 Asserting Party" in Oracle WebLogic Server Administration Console Online Help

  10. Configure the SAML asserting party as follows:

    1. Set Issuer URI to www.oracle.com.

    2. Set Target URL to <url_used_to_access_Web_service>.

      For more information, see "Create a SAML 1.1 Asserting Party" in Oracle WebLogic Server Administration Console Online Help

To attach and configure the OWSM Client Policy:

  1. Create a client proxy to the web service created earlier using clientgen or some other mechanism.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service client:

    • oracle/wss11_saml_token_with_message_protection_client_policy.

      For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  3. Configure the policy, as described in oracle/wss11_saml_token_with_message_protection_client_policy.

    For more information, see "oracle/wss11_saml_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  4. Specify keystore.recipient.alias in the client configuration.

    Note:

    Ensure that keystore.recipient.alias is the same as the decryption key specified for the web service.

    For more information, see "oracle/wss11_saml_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  5. Ensure that the keystore.recipient.alias keys specified for the client exist as trusted certificate entry in the trust store configured for the web service.

    For more information, see "oracle/wss11_saml_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  6. Provide a valid username whose identity needs to be propagated using SAML token in the client configuration.

    For more information, see "oracle/wss11_saml_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  7. Invoke the Web application client.

4.10.2 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement SAML 2.0 sender vouches with message protection that conforms to the WS-Security 1.1 standard and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Create a web service.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service:

    • oracle/wss11_saml_token_with_message_protection_service_policy.

      For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

To attach and configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service (above) using clientgen.

    For more information, see "Using the clientgen Ant Task to Generate Client Artifacts" in Developing JAX-WS Web Services for Oracle WebLogic Server

  2. Attach the following policies:

  3. Configure the client for server (encryption key) and client certificates.

    Note:

    Ensure that the encryption key specified is in accordance with the decryption key configured for the web service.

    For more information, see "Updating a Client Application to Invoke a Message-Secured Web Service" in Securing WebLogic Web Services for Oracle WebLogic Server

  4. Secure the Web application client using BASIC Authentication.

    For more information, see "Developing BASIC Authentication Web Applications" in Developing Applications with the WebLogic Security Service.

  5. Deploy the web service client.

    For more information, see "Deploying Web Services Applications" in Administering Web Services

  6. Configure a SAML credential mapping provider.

    • In the Oracle WebLogic Server Administration Console, navigate to Security Realms > RealmName > Providers > Credential Mapping page and create a New Credential Mapping Provider of type SAMLCredentialMapperV2.

  7. Select the new provider, click on Provider Specific, and configure it as follows:

    1. Set Issuer URI to www.oracle.com.

    2. Set Name Qualifier to www.oracle.com.

      For more information, see "Configure Credential Mapping Providers" in Oracle WebLogic Server Administration Console Online Help

  8. Restart WebLogic Server.

    For more information, see "Start and stop servers" in the Oracle WebLogic Server Administration Console Online Help.

  9. Create a SAML relying party.

  10. Configure the SAML relying party.

    • Ensure the Target URL is set to the URL used for the client web service.

      For more information, see "Configure a SAML 1.1 Relying Party" in Oracle WebLogic Server Administration Console Online Help

  11. Invoke the Web application client.

4.11 SAML Token (Sender Vouches) with Message Protection
(WS-Security 1.1) and MTOM

This section describes how to implement SAML token with sender vouches and message protection that conforms to the WS-Security 1.1 standard and uses Message Transmission Optimization Mechanism (MTOM), in the following interoperability scenarios:

4.11.1 Interoperating with a WebLogic Web Service Policy

The following instructions tell how to implement SAML token sender vouches with message protection that conforms to the WS-Security 1.1 standard and MTOM and ensure interoperability between the WebLogic web service policy and the OWSM client policy:

To attach and configure the WebLogic Web Service Policy:

  1. Create a WebLogic web service, as described in Section 4.10, "SAML Token (Sender Vouches) with Message Protection (WS-Security 1.1)"

    For more information, see "Roadmap for Implementing WebLogic (Java EE) Web Services" in Understanding Web Services

  2. Use the @MTOM annotation in the web service in Step 2 of " Attaching and Configuring the WebLogic Web Service Policy".

    For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

To attach and configure the OWSM Client Policy:

  1. Create a client proxy to the web service created earlier, as described in Section 4.10, "SAML Token (Sender Vouches) with Message Protection (WS-Security 1.1)"

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach wsmtom_policy from the Management tab.

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

4.11.2 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement SAML token sender vouches with message protection that conforms to the WS-Security 1.1 standard and MTOM and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Create and deploy a web service.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service:

    • oracle/wss11_username_token_with_message_protection_service_policy.

      For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

To attach and configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service created earlier using clientgen.

    For more information, see "Using the clientgen Ant Task to Generate Client Artifacts" in Developing JAX-WS Web Services for Oracle WebLogic Server

  2. Attach the following policies:

    • Wssp1.2-2007-Wss1.1-UsernameToken-Plain-EncryptedKey-Basic128.xml

    • Wssp1.2-2007-SignBody.xml

    • Wssp1.2-2007-EncryptBody.xml

    For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

  3. Provide the configuration for the server (encryption key) in the client.

    Note:

    Ensure that the encryption key specified is in accordance with the encryption key configured for the web service.

    For more information, see "Updating a Client Application to Invoke a Message-Secured Web Service" in Securing WebLogic Web Services for Oracle WebLogic Server

  4. Invoke the web service method from the client.

    For more information, see "Writing the Java Client Application Code to Invoke a Web Service" in Developing JAX-WS Web Services for Oracle WebLogic Server

4.12 SAML Token (Sender Vouches) with Message Protection (WS-Security 1.0)

This section describes how to implement SAML token with sender vouches and message protection that conforms to the WS-Security 1.0 standard, in the following interoperability scenarios:

Note:

WS-Security 1.0 policy is supported for legacy applications only. Use WS-Security 1.1 policy for maximum performance. For more information, see "SAML Token (Sender Vouches) with Message Protection (WS-Security 1.1)".

4.12.1 Interoperating with a WebLogic Web Service Policy

The following instructions tell how to implement SAML token with sender vouches and message protection that conforms to the WS-Security 1.0 standard and ensure interoperability between the WebLogic web service policy and the OWSM client policy:

To attach and configure the WebLogic Web Service Policy:

  1. Create a WebLogic web service.

    For more information, see "Roadmap for Implementing WebLogic (Java EE) Web Services" in Understanding Web Services

  2. Attach the following policies:

    • Wssp1.2-wss10_saml_token_with_message_protection_owsm_policy.xml

    • Wssp1.2-2007-SignBody.xml

    • Wssp1.2-2007-EncryptBody.xml

  3. Configure identity and trust stores.

    For more information, see "Configure identity and trust" in Oracle WebLogic Server Administration Console Online Help

  4. Configure message-level security.

    For more information, see

  5. Deploy the web service.

    For more information, see Deploying Applications to Oracle WebLogic Server.

  6. Create a SAMLIdentityAsserterV2 authentication provider.

    • In the WebLogic Server Administration Console, navigate to Security Realms > RealmName > Providers > Credential Mapping page and create a New Credential Mapping Provider of type SAMLCredentialMapperV2.

      For more information, see "Configure Authentication and Identity Assertion providers" in Oracle WebLogic Server Administration Console Online Help

  7. Restart WebLogic Server.

    For more information, see "Start and stop servers" in the Oracle WebLogic Server Administration Console Online Help.

  8. Select the authentication provider created in step 5.

  9. Create a SAML asserting party.

  10. Configure the SAML asserting party as follows (leave other values set to the defaults):

    1. Set Issuer URI to www.oracle.com.

    2. Set Target URL to <url_used_by_client>.

      For more information, see "Configure a SAML 1.1 Asserting Party" in Oracle WebLogic Server Administration Console Online Help

To attach and configure the OWSM Client Policy:

  1. Create a client proxy to the web service created earlier using clientgen or some other mechanism.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service client:

    • oracle/wss10_saml_token_with_message_protection_client_policy.

      For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  3. Configure the policy.

    For more information, see "oracle/wss10_saml_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  4. Ensure that you use different keys for client (sign and decrypt key) and keystore recipient alias (server public key used for encryption). Ensure that the recipient alias is in accordance with the keys defined in the web service policy security configuration.

    For more information, see "oracle/wss10_saml_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  5. Ensure that the signing and encryption keys specified for the client exist as trusted certificate entries in the trust store configured for the web service.

    For more information, see "oracle/wss10_saml_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  6. Provide valid username whose identity needs to be propagated using SAML token in the client configuration.

    For more information, see "oracle/wss10_saml_token_with_message_protection_client_policy" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  7. Invoke the web service method.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

4.12.2 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement SAML token with message protection that conforms to the WS-Security 1.0 standard and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Create a web service.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service:

    • oracle/wss10_saml_token_with_message_protection_service_policy.

      For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

To attach and configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service (above) using clientgen.

    For more information, see "Using the clientgen Ant Task to Generate Client Artifacts" in Developing JAX-WS Web Services for Oracle WebLogic Server

  2. Attach the following policies:

  3. Configure the client for server (encryption key) and client certificates.

    Note:

    Ensure that the encryption key specified is in accordance with the decryption key configured for the web service.

    For more information, see "Updating a Client Application to Invoke a Message-Secured Web Service" in Securing WebLogic Web Services for Oracle WebLogic Server

  4. Secure the Web application client using BASIC Authentication.

    For more information, see "Developing BASIC Authentication Web Applications" in Developing Applications with the WebLogic Security Service

  5. Deploy the web service client.

    For more information, see "Deploying Web Services Applications" in Administering Web Services

  6. Configure a SAML credential mapping provider.

    • In the WebLogic Server Administration Console, navigate to Security Realms > RealmName > Providers > Credential Mapping page and create a New Credential Mapping Provider of type SAMLCredentialMapperV2.

      For more information, see "Configure Credential Mapping Providers" in Oracle WebLogic Server Administration Console Online Help

  7. Select the SAMLCredentialMapperV2, click on Provider Specific, and configure it as follows:

    1. Set Issuer URI to www.oracle.com.

    2. Set Name Qualifier to www.oracle.com.

  8. Restart WebLogic Server.

    For more information, see "Start and stop servers" in the Oracle WebLogic Server Administration Console Online Help.

  9. Create a SAML relying party. Set the profile to WSS/Sender-Vouches.

    For more information, see "Create a SAML 1.1 Relying Party" in Oracle WebLogic Server Administration Console Online Help

  10. Configure the SAML relying party.

    Note:

    Ensure the target URL is set to the URL used for the client web service.

    For more information, see "Configure a SAML 1.1 Relying Party" in Oracle WebLogic Server Administration Console Online Help

  11. Invoke the Web application client and enter the appropriate credentials.

    For more information, see "Writing the Java Client Application Code to Invoke a Web Service" in Developing JAX-WS Web Services for Oracle WebLogic Server

4.13 Mutual Authentication with Message Protection (WS-Security 1.0)

This section tells how to implement mutual authentication with message protection that conform to the WS-Security 1.0 standard, in the following interoperability scenarios:

4.13.1 Interoperating with a WebLogic Web Service Policy

The following instructions tell how to implement mutual authentication with message protection that conforms to the WS-Security 1.0 standard and ensure interoperability between the WebLogic web service policy and the OWSM client policy:

To attach and configure the WebLogic Web Service Policy:

  1. Create a WebLogic web service.

    For more information, see "Roadmap for Implementing WebLogic (Java EE) Web Services" in Understanding Web Services

  2. Attach the following policies:

    1. Wssp1.2-wss10_x509_token_with_message_protection_owsm_policy.xml

    2. Wssp1.2-2007-SignBody.xml

    3. Wssp1.2-2007-EncryptBody.xml

      For more information, see "Updating the JWS File with @Policy and @Policies Annotations" in Securing WebLogic Web Services for Oracle WebLogic Server

  3. Configure identity and trust stores.

    For more information, see "Configure identity and trust" in Oracle WebLogic Server Administration Console Online Help

  4. Configure message-level security.

    For more information, see

  5. Create and configure token handlers for X.509 and for username token. In WebLogic Administration Console, navigate to the Web Service Security page of the domain and create the token handlers as described below.

  6. Create a token handle for username token and configure the following:

    1. Name: <name>

    2. Class name:

      weblogic.xml.crypto.wss.UsernameTokenHandler

    3. Token Type: ut

    4. Handling Order: 1

  7. Create a token handler for X.509 and configure the following:

    1. Name: <name>

    2. Class name:

      weblogic.xml.crypto.wss.BinarySecurityTokenHandler

    3. Token Type: x509

    4. Handling Order: 0

  8. For the X.509 token handler, add the following properties:

    1. Name: UserX509ForIdentity

    2. Value: true

    3. IsEncrypted: False

  9. Configure a credential mapping provider. Create a PKICredentialMapper and configure it as follows (leave all other values set to the defaults):

    1. Keystore Provider: N/A

    2. Keystore Type: jks

    3. Keystore File Name: default_keystore.jks

    4. Keystore Pass Phrase: <password>

    5. Confirm Keystore Pass Phrase: <password>

  10. Configure Authentication by Selecting the Authentication tab and configure as follows:

    1. Click DefaultIdentityAsserter and add X.509 to Chosen active types

    2. Click Provider Specific and configure the following:

      Default User Name Mapper Attribute Type: CN

      Active Types: X.509

      Use Default User Name Mapper: True

      For more information, see "Configure Authentication and Identity Assertion providers" in Oracle WebLogic Server Administration Console Online Help.

  11. If the users are not added, add the Common Name (CN) user specified in the certificate.

    For more information, see "Create users" in Oracle WebLogic Server Administration Console Online Help

  12. Restart Oracle WebLogic Server.

  13. Deploy the web service.

    For more information, see "Install a Web Service" in Oracle WebLogic Server Administration Console Online Help

To attach and configure the OWSM Client Policy:

  1. Create a client proxy to the web service created earlier using clientgen or some other mechanism.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the client:

    wss10_x509_token_with_message_protection_client_policy

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  3. Provide the configuration for the server (encryption key) in the client.

    Note:

    Ensure that the encryption key specified is in accordance with the encryption key configured for the web service.

    For more information, see "Updating a Client Application to Invoke a Message-Secured Web Service" in Securing WebLogic Web Services for Oracle WebLogic Server

  4. Invoke the web service method from the client.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

4.13.2 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement username token with message protection that conforms to the WS-Security 1.0 standard and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Create and deploy a web service application.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service:

    oracle/wss10_x509_token_with_message_protection_service_policy.

To attach and configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service created earlier using clientgen.

    For more information, see "Using the clientgen Ant Task to Generate Client Artifacts" in Developing JAX-WS Web Services for Oracle WebLogic Server

  2. Attach the following policies:

  3. Provide the configuration for the server (encryption key) in the client.

    Note:

    Ensure that the encryption key specified is in accordance with the encryption key configured for the web service.

    For more information, see "Updating a Client Application to Invoke a Message-Secured Web Service" in Securing WebLogic Web Services for Oracle WebLogic Server

  4. Invoke the web service method from the client.

    For more information, see "Writing the Java Client Application Code to Invoke a Web Service" in Developing JAX-WS Web Services for Oracle WebLogic Server

4.14 Mutual Authentication with Message Protection (WS-Security 1.1)

This section tells how to implement mutual authentication with message protection that conform to the WS-Security 1.1 standards, in the following interoperability scenarios:

4.14.1 Interoperating with a WebLogic Web Service Policy

The following instructions tell how to implement mutual authentication with message protection that conforms to the WS-Security 1.1 standard and ensure interoperability between the WebLogic web service policy and the OWSM client policy:

To attach and configure the WebLogic Web Service Policy:

  1. Create a WebLogic web service.

    For more information, see "Roadmap for Implementing WebLogic (Java EE) Web Services" in Understanding Web Services

  2. Attach the following policies:

  3. Configure identity and trust stores.

    For more information, see "Configure identity and trust" in Oracle WebLogic Server Administration Console Online Help

  4. Configure message-level security.

    For more information, see

  5. Create and configure token handlers for X.509 and for username token. In WebLogic Administration Console, navigate to the Web Service Security page of the domain and create the token handlers as described below.

  6. Create a token handle for username token and configure the following:

    • Name: <name>

    • Class name: weblogic.xml.crypto.wss.UsernameTokenHandler

    • Token Type: ut

    • Handling Order: 1

    • Create a token handle for username token and configure the following:

    Create a token handler for X.509 and configure the following:

    • Name: <name>

    • Class name: weblogic.xml.crypto.wss.BinarySecurityTokenHandler

    • Token Type: x509

    • Handling Order: 0

    For the X.509 token handler, add the following properties:

  7. Configure a credential mapping provider by creating a PKICredentialMapper and configure it as follows (leave all other values set to the defaults):

    • Keystore Provider: N/A

    • Keystore Type: jks

    • Keystore File Name: default_keystore.jks

    • Keystore Pass Phrase: <password>

    • Confirm Keystore Pass Phrase: <password>

      For more information, see "Configure Credential Mapping Providers" in Oracle WebLogic Server Administration Console Online Help

  8. Configure Authentication by selecting the Authentication tab and configure as follows:

    • Click DefaultIdentityAsserter and add X.509 to Chosen active types

    • Click Provider Specific and configure the following:

    • Default User Name Mapper Attribute Type: CN

    • Active Types: X.509

    • Use Default User Name Mapper: True

  9. If the users are not added, add the Common Name (CN) user specified in the certificate.

    For more information, see "Create users" in Oracle WebLogic Server Administration Console Online Help

  10. Restart Oracle WebLogic Server.

  11. Deploy the web service.

    For more information, see "Install a Web Service" in Oracle WebLogic Server Administration Console Online Help

To attach and configure the OWSM Client Policy:

  1. Create a client proxy for the web service created earlier using clientgen or some other mechanism.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the client

    wss11_x509_token_with_message_protection_client_policy

  3. Edit the policy as follows:

    <orasp:x509-token 
  orasp:sign-key-ref-mech="thumbprint"
  orasp:enc-key-ref-mech="thumbprint"/>

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

  4. Provide the configuration for the server (encryption key) in the client.

    Note:

    Ensure that the encryption key specified is in accordance with the encryption key configured for the web service.

    For more information, see "Updating a Client Application to Invoke a Message-Secured Web Service" in Securing WebLogic Web Services for Oracle WebLogic Server.

  5. Invoke the web service method from the client.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

4.14.2 Interoperating with a WebLogic Web Service Client Policy

The following instructions tell how to implement mutual authentication with message protection that conforms to the WS-Security 1.1 standard and ensure interoperability between the OWSM web service policy and the WebLogic web service client policy:

To attach and configure the OWSM Policy:

  1. Create and deploy a web service.

    For more information, see "Roadmap for Implementing Oracle Fusion Middleware Web Services" in Understanding Web Services

  2. Attach the following policy to the web service:

    oracle/wss11_x509_token_with_message_protection_service_policy.

    For more information, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager

To attach and configure the WebLogic Web Service Client Policy:

  1. Create a client proxy for the web service created earlier using clientgen.

    For more information, see "Using the clientgen Ant Task to Generate Client Artifacts" in Developing JAX-WS Web Services for Oracle WebLogic Server

  2. Attach the following policies:

  3. Provide the configuration for the server (encryption key) in the client.

    Note:

    Ensure that the encryption key specified is in accordance with the encryption key configured for the web service.

    For more information, see "Updating a Client Application to Invoke a Message-Secured Web Service" in Securing WebLogic Web Services for Oracle WebLogic Server

  4. Invoke the web service method from the client.

    For more information, see "Writing the Java Client Application Code to Invoke a Web Service" in Developing JAX-WS Web Services for Oracle WebLogic Server