Skip to content

Configuring Single Sign-On Using SAML2

Single sign-on is a key feature of the WSO2 Identity Server that enables users to access multiple applications using the same set of credentials. This tutorial allows you to have hands-on experience on how to configure SSO with WSO2 Identity Server using SAML protocol.

To read more about single sign on with WSO2 Identity Server, see Single Sign On.


Pickup is a cab company that has two SAML web applications called pickup-dispatch and pickup-manager. Both applications use WSO2 IS as the identity provider. When SSO is configured for both these applications, an employee is only required to provide their credentials to the first application and the user will be automatically logged in to the second application.



You can find more information regarding the SAML2 and SAML2 Web Browser SSO Profile in the saml-core specification and the saml-profile specification.

Set up

  1. Download WSO2 Identity Server.
  2. Navigate to <IS_HOME>/bin and start the server by executing one of the following commands.

    wso2server.bat run
  3. Follow the steps in deploying saml2-web-app-pickup-dispatch webapp to download, deploy and register dispatch sample.

  4. Follow the steps in deploying saml2-web-app-pickup-manager webapp to download, deploy and register manager sample.

You are now ready to try out SAML SSO with the Pickup Dispatch and Pickup Manager sample web applications.

Try it out

  1. Navigate to on your browser and click Login.


  2. You will be redirected to the login page of WSO2 Identity Server. Login using your WSO2 Identity Server credentials (admin/admin). Provide the required consent. You will be redirected to the Pickup Dispatch application home page.

  3. Now, if you navigate to and click Login, you can see that user has been automatically logged in to this application without being prompted for user credentials.

Configure claims

Additionally, you can also configure claims for the service providers.


For more information, see Configuring Claims for a Service Provider.

  1. On the Main menu of the management console, click Service Providers>List and Edit the "dispatch" service provider.
  2. Expand the Claim Configuration section in the service provider form.
  3. You can select the claims that must be sent to the service provider. Select Use Local Claim Dialect and click Add Claim URI.
  4. Add the following claims as Requested Claims.
  5. Select as the Subject claim URI and click Update to save the service provider configurations.


  6. Now, logout of the Pickup Dispatch and Pickup Manager applications.

  7. Access on your browser and click Login.
  8. Note that the user is now prompted for consent to share the Email Address claim value with the sample application.


This means that you have successfully configured additional claims for your service provider.

Related Topics

For more detailed information on configuring single sign-on using SAML2, see the following page:

To set up reCaptcha for single sign on, see the following page: