Configuring Federation with Microsoft ADFS 2.0 STS as the IP-STS and Oracle STS as the RP-STS

8 Configuring Federation with Microsoft ADFS 2.0 STS as the IP-STS and Oracle STS as the RP-STS

You can refer to the use case description, solution summary, components involved, and the linked documentation resources to configure web services federation with Microsoft ADFS 2.0 STS as the Identity Provided STS (IP-STS) and Oracle STS as the Replying Party (RP-STS).

Use Case

Configure web services federation with Microsoft ADFS 2.0 STS as the IP-STS and Oracle STS as the RP-STS.

Solution

Attach Oracle Web Services Manager (OWSM) WS-Trust policies to the web service and client, and configure Oracle STS and Microsoft ADFS 2.0 STS to establish trust across security domains.

Components

Oracle WebLogic Server
Oracle Web Services Manager (OWSM)
Oracle STS
Microsoft ADFS 2.0 STS
Web service and client applications to be secured

Additional Resources on Oracle Web Services Manager

This use case demonstrates the steps required to:

Attach the appropriate OWSM security policies to enforce message-level protection using SAML bearer authentication.

Specifically, you attach the following policies to the client and service, respectively:
- oracle/wss_sts_issued_saml_bearer_token_over_ssl_client_policy and policies based on oracle/sts_trust_config_client_template
- oracle/wss_sts_issued_saml_bearer_token_over_ssl_service_policy
Configure web services federation using Microsoft ADFS 2.0 STS as the IP-STS and Oracle STS is used as the RP-STS.

Transport security with SSL is used to protect the service, the RP-STS, and IP-STS.

For more information on how to implement this use case, see Use Case: Implementing Web Services federation with Microsoft ADFS2.0 STS.

8.1 Use Case: Implementing Web Services federation with Microsoft ADFS2.0 STS

To implement the use case, complete the following tasks in sequence: configure the Web Service, configure Oracle STS as the RP-STS, configure Microsoft ADFS 2.0 STS as the IP-STS, and configure the Web Service Client.

Note:

In the following sections, high-level configuration steps for Oracle STS and Microsoft ADFS 2.0 STS are provided. For detailed information about how to perform these configuration steps, refer to the documentation for the particular STS:

For Microsoft ADFS 2.0 STS: http://technet.microsoft.com/en-us/library/adfs2(v=ws.10).aspx

8.1.1 Configuring the Web Service

To implement the use case Web Services federation with Microsoft ADFS2.0 STS, first you need to configure the web service.

To configure the web service:

Attach the oracle/wss_sts_issued_saml_bearer_token_over_ssl_service_policy policy to the web service. For the complete procedure, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager.
Import the signing certificate for the Oracle STS /wssbearer endpoint into the OWSM keystore.
Define the Oracle STS endpoint as a trusted issuer and a trusted DN. For the complete procedure, see "Defining Trusted Issuers and Trusted Distinguished Names List for SAML Signing Certificates" in Securing Web Services and Managing Policies with Oracle Web Services Manager.

8.1.2 Configuring Oracle STS as the RP-STS

To implement the use case Web Services federation with Microsoft ADFS2.0 STS, you need to configure Oracle STS as the RP-STS.

To configure Oracle STS as the RP-STS, perform the following steps:

Configure WebLogic Server to enable one-way SSL on port 14101.
Configure the Oracle STS /wssbearer endpoint as follows:
- Attach the policy with the URI sts/wss_sts_issued_saml_bearer_token_over_ssl_service_policy.
- Create an OWSM LRG SAML Validation validation template to validate the incoming SAML token and apply it to the endpoint.
Add the service as a replying party partner in Oracle STS.
Add the Microsoft ADFS 2.0 STS instance acting as the IP-STS as a trusted identity provider:
1. Configure an issuing authority partner profile for the Microsoft ADFS 2.0 STS instance.
2. Add the Microsoft ADFS 2.0 STS instance as an issuing authority partner, giving as the partner name the issuer of the SAML assertion for the instance.
3. Import the signing certificate for the Microsoft ADFS 2.0 STS instance into the OWSM keystore.

8.1.3 Configuring Microsoft ADFS 2.0 STS as the IP-STS

To implement the use case Web Services federation with Microsoft ADFS2.0 STS, you need to configure Microsoft ADFS 2.0 STS as the IP-STS.

For the complete procedure, see the Microsoft ADFS 2.0 STS documentation at http://technet.microsoft.com/en-us/library/adfs2(v=ws.10).aspx.)

Perform the following steps:

Confirm that the /usernamemixed endpoint is enabled.
Add the Oracle STS instance acting as the IP-STS as a relying party using the ADFS 2.0 management console.
Configure ADFS 2.0 STS to issue SAML bearer tokens for the RP-STS.

8.1.4 Configuring the Web Service Client

To implement the use case Web Services federation with Microsoft ADFS2.0 STS, finally you need to configure the web service client.

To configure the web service client:

Attach the policy oracle/wss_sts_issued_saml_bearer_token_over_ssl_client_policy and configure it to refer to the web service. For the complete procedure, see "Attaching Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager.
Additionally, set sts.in.order to the URI of the Oracle STS endpoint followed by the ADFS 2.0 STS endpoint. For example:
```
http://m2.example.com:14100/sts/wssbearer;
http://http://m1.example.com/adfs/services/trust/13/usernamemixed
```
Create a policy from oracle/sts_trust_config_client_template, modify it as follows, and attach it to the client:
- Set Port URI to the ADFS 2.0 STS endpoint. For example:
```
http://m1.example.com/adfs/services/trust/13/usernamemixed
```
- Set Client Policy URI oracle/wss_sts_issued_saml_bearer_token_over_ssl_client_policy.
For the complete procedure, see "Creating and Editing Web Service Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager.
Create a policy from oracle/sts_trust_config_client_template, modify it as follows, and attach it to the client:
- Set Port URI to the Oracle STS endpoint. For example:
```
http://m2.example.com:14100/sts/wssbearer
```
- Set WSDL Uri to the Oracle STS endpoint. For example:
```
http://m2.example.com:14100/sts/wss11user?wsdl
```
For the complete procedure, see "Creating and Editing Web Service Policies" in Securing Web Services and Managing Policies with Oracle Web Services Manager.