WSO2 Single Sign On SSO WordPress End To End Setup Guide | WSO2 Login

WSO2 Single Sign On SSO WordPress End To End Setup Guide | WSO2 Login



If you want users to login to your WordPress site using their WSO2 credentials, you can simply do it using our WP OAuth Single Sign On (OAuth Client) plugin. Once you configure the WSO2 with WordPress plugin, you can allow users to SSO to your WordPress site using WSO2. Similarly, you can map your WordPress roles based on your WSO2 attributes/groups. To know more about other features we provide in WP OAuth Client plugin, you can click here.



You can download OAuth Client plugin using the following link.




Download And Installation

  • Log into your WordPress instance as an admin.
  • Go to the WordPress Dashboard -> Plugins and click on Add New.
  • Seach for a WordPress OAuth Single Sign On plugin and click on Install Now.
  • Once installed click on Activate.

Step 1: Setup WSO2 as OAuth Provider

  • First, let’s register this Consumer App in WSO2 IS. Download and start WSO2 IS.
  • Article-3
  • Once logged in, go to Main -> Service Provider and click on Add.
  • Article-3
  • Enter the Service Provider Name and Description and click on Register.
  • Article-3
  • Now go to the Service Provider->List and edit the Service Provider you have created.
  • Scroll down and select Inbound Authentication Configuration and then select OAuth/OpenID Connect Configuration and click on Configure.
  • Article4_0
  • Select the OAuth Version 2.0 and enter the Redirect/Callback URL from the plugin in Callback URL field. Click on Add.
  • Article-5-1
  • When the app has been added, Client ID and Client Secret are generated for the application. Configure the WordPress OAuth SSO plugin with Client ID, Client Secret, Authentication and Access Token, Get User Info Endpoint of WSO2. Endpoints are provided at the bottom of this guide.
  • Article-5-1
  • Attribute Mapping: To get attributes from WSO2 you have to add following Claim URIs in your WSO2 application.
  • Go to Service Provider->Claim Configuration.
  • Select https://wso2.org/claims/emailaddress from Subject Claim URI dropdown.
  • Add following URIs in Service Provider Claim Dialect: https://wso2.org/oidc/claim & https://wso2.org/claims
  • Article-5-1
  • You have successfully completed your WSO2 Server side configurations.

  • WSO2 Endpoints and Scope:


    Client ID : Click Here
    Client Secret : Click Here
    Scope: openid
    Authorize Endpoint: https://<wso2-app-domain>/oauth2/authorize
    Access Token Endpoint: https://<wso2-app-domain>/oauth2/token
    Get User Info Endpoint: https://<wso2-app-domain>/oauth2/userinfo

Step 2: Setup WordPress as OAuth Client

  • Go to Configure OAuth tab and configure App Name, Client ID, Client Secret from provided Endpoints.
  • openid is already filled but if it doesn't work then configure scope as User.Read and for fetching group info use scope is Directory.read.all.
  • Click on Save Settings to save the configuration.
  • wordpress oauth client plugin sso : save settings

Step 3: User Attribute Mapping.

  • User Attribute Mapping is mandatory for enabling users to successfully login into WordPress. We will be setting up user profile attributes for WordPress using below settings.
  • Finding user attributes

    • Go to Configure OAuth tab. Scroll down and click on Test Configuration.
    • wordpress oauth client plugin : test congifuration
    • You will see all the values returned by your OAuth Provider to WordPress in a table. If you don't see value for First Name, Last Name, Email or Username, make the required settings in your OAuth Provider to return this information.
    • wordpress oauth client plugin sso : test congifuration result
    • Once you see all the values in Test Configuration, go to Attribute / Role Mapping tab, you will get the list of attributes in a Username dropdown.
    • wordpress oauth client plugin sso : attribute/role mapping

Step 4: Login Settings / Sign In Settings.

  • The settings in SSO Settings tab define the user experience for Single Sign On. To add a login widget on your WordPress page, you need to follow below steps.
  • Sign In Settings

    • Go to WordPress Left Panel > Appearances > Widgets.
    • Select miniOrange OAuth. Drag and drop to your favourite location and save.
    • wordpress oauth client plugin sso: login button setting
    • Open your WordPress page and you can see the login button there. You can test the SSO now.

Need Guidance?

Mail us on oauthsupport@xecurify.com for quick guidance(via email/meeting) on your requirement and our team will help you to select the best suitable solution/plan as per your requirement.