Logging in to Office365 with WS-Trust¶

The WSO2 Identity Server allows you to configure and federate the Office365 Active STS client (based on the WS-Trust protocol) for single sign-on. The WSO2 IS supports the following Office365 Active STS clients.

• Skype for Business Desktop Client (Lync)

• Skype for Business Mobile client

• OneDrive for Desktop Business client

This topic provides instructions on how to configure and federate the Office365 Active STS client for single sign-on, based on the WS-Trust protocol, through the WSO2 Identity server. The following sections guide you through the entire process.

Prerequisites¶

• Configure Azure Active Directory (AD) to trust WSO2 Identity Server. For more information on how to do this, see Configuring Azure Active Directory toTrust WSO2 Identity Server .
• Configure an Active Directory user store as the primary user store in WSO2 Identity Server. For more information on how to do this, see Configuring an Active Directory User Store .
• Configure WSO2 Identity Server to authenticate users using the email address as the username. For more information on how to do this, see Using Email Address as the Username .

Configuring Office 365 WS-Trust¶

1. Start the WSO2 Identity Server and log in to the management console

2. Click Resident under Identity Providers in the Main menu. Expand the Inbound Authentication Configuration section and then the WS-Federation(Passive) Configuration.

3. Replace the value of the Identity Provider Entity Id with the value given for the parameter $issueruri when configuring Azure AD (configured in step 3 of this topic ), and click Update to save changes.
   In this sample scenario, the value for the Identity Provider Entity Id is https://wso2test.com.

   

4. Navigate to Claims>Add in the Main menu and click Add New Claim. Set 'User Principle' and 'ImmutableID' as claims as seen below. See Adding Claim Mapping for more information.

   

5. Navigate to Claims>List and click on the http://wso2.org/claims claim dialect. Click on Edit for each of the claims below and untick the Supported by Default checkbox.

   Why do these claims need to be edited?

   These attributes are not supported by Active Directory by default. Therefore if these attributes are ticked as Supported by Default in Identity Server, they will be shown in the default user profile and you will recieve an error once you try to update the user profile.

1. • Country - http://wso2.org/claims/country

   • Organization - http://wso2.org/claims/organization

   • IM - http://wso2.org/claims/im

2. Navigate to Service Providers > Add in the Main menu and add a new Service Provider named ' Office365'.

3. Expand the Inbound Authentication Configuration section, then the WS-Trust Security Token Service Configuration and click Configure.

4. Enter the following details in the form that appears and click Apply. See Configuring WS-Trust Security Token Service for more information about these fields.

   • Endpoint Address: urn:federation:MicrosoftOnline

   • Certificate Alias: wso2carbon

   

5. Expand the Claim Configuration section and configure the following attributes required by Azure AD as seen below.

   Service Provider Claim	Local Claim	Requested Claim
   http://schemas.xmlsoap.org/claims/UPN	http://wso2.org/claims/upn	Ticked (True)
   http://schemas.microsoft.com/ws/2008/06/identity/claims/role	http://wso2.org/claims/role	Ticked (True)
   http://schemas.microsoft.com/LiveID/Federation/2008/05/ImmutableID	http://wso2.org/claims/objectguid	Ticked (True)

   

6. Set the Subject Claim URI to the Immutable ID claim and the Role Claim URI to the role claim. Click Update to save changes to the service provider.

7. Click Resident under Identity Providers in the Main menu. Expand the Inbound Authentication Configuration section, then the Security Token Service Configuration section and click Apply Security Policy.

8. Select Yes in the Enable Security dropdown.

9. Select UsernameToken under Basic Scenarios and click Next.

   

10. Select the Admin role checkbox from the User Groups and click Finish.

    Note

    It is not mandatory to select the ‘admin’ role for authentication of the UserNameToken. Any role having ‘login’ permissions would be sufficient.

    

11. Click Update to save all changes.

12. Create a user and update the user's profile with a User Principle Name as seen below.

    Note

    ObjectGUID is a binary attribute. Add the following user store property to the <IS_HOME>/repository/conf/deployment.toml file under the relevant user store tag in order to see the value properly in the management console.

    [user_store.properties]
    'java.naming.ldap.attributes.binary' = "objectGUID"

Testing Office365 WS-Trust with WSO2 IS¶

The Skype for Business client is used to demonstrate testing of this scenario. You can test it with the user you created above. The user’s identity will be represented and authenticated by the on premises identity provider (i.e., the WSO2 Identity Server).

1. Download and install the Skype for Business client .
2. Enter the email address of the user you created as the Sign-in address and enter the password of the user.
3. Click Sign In. The identity will be authenticated by the WSO2 IS and you will be successfully signed in to the Skype client.