Clever Single Sign-On SSO WordPress End To End Setup Guide | Clever SSO



f you want users to login to your WordPress site using their Clever credentials, you can simply do it using our WP OAuth Client plugin. Once you configure the Clever with WordPress plugin, you can allow users to SSO to your WordPress site using Clever. Similarly, you can map your WordPress roles based on your Clever 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 Clever as OAuth Provider

  • First of all, go to https://dev.clever.com/ and sign up/login to register a new app.
  • Under Start your Clever Sandbox, click on the click here to get started option.
  • clever1
  • Go to https://apps.clever.com/signup and signup/login to your account.
  • Follow the steps to create an application. (refer to the images below)
  • clever-app-overview2 clever-invites3 clever-provide-application4
  • Click on Clever Instant Login option to continue.
  • clever-login4
  • Click on next button to continue.
  • clever-get- strated5
  • Copy the Client ID and the Client secret and store it in your miniOrange OAuth Client Plugin under the Client ID and Client Secret text fields respectively. Copy the Redirect/Callback URL from your miniOrange oauth client plugin and store it in the Redirect URIs text field. Finally, click on the Save button to save your configurations.
  • clever-set-application6
  • Click on the Next button to continue to next step.
  • Select the browsers you want to be supported for certificate survey and select Secure Authorization Grant Flow for the which authorization flow do you use question (refer to the image on the next page).
  • clever-submit7
  • Enter all the other fields according to your use case and click on the Submit button in the end to save your configurations.

  • Clever Endpoints and Scope:


    Client ID : Click Here
    Client Secret : Click Here
    Scope: read:students read:teachers read:user_id
    Authorize Endpoint: https://clever.com/oauth/authorize
    Access Token Endpoint: https://clever.com/oauth/tokens
    Get User Info Endpoint: https://api.clever.com/v1.1/me

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.