WHMCS WordPress – Guide to Configure WHMCS as a OAuth/OpenID Connect Server



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

  • First of all, go to your WHMCS domain and log into your WHMCS Administrator account.
  • You will be presented with following screen. Go to Setup OpenID Connect on the navigation bar on top.
  • WHMCS Wordpress|Configure OpenID Connect in WHMCS
  • Click on Generate New Client API Credentials button.
  • WHMCS Wordpress|Create new Client Credentials
  • You will be redirected to the app details page. Fill in the required details and enter Authorized Redirect URIs from miniOrange OAuth/OpenID Connect Plugin and click on Generate Credentials.
  • WHMCS Wordpress|Configure New Client
  • You will be brought to App details page. Here, you can find Client ID and Client Secret.
  • WHMCS Wordpress|Check your client configuration
  • Copy these credentials in MO OAuth Plugin configuration on corresponding fields.

  • WHMCS Endpoints and Scope:


    Client ID : Click Here
    Client Secret : Click Here
    Scope: openid profile email
    Authorize Endpoint: https://{yourWHMCSdomain}/oauth/authorize.php
    Access Token Endpoint: https://{yourWHMCSdomain}/oauth/token.php
    Get User Info Endpoint: https://{yourWHMCSdomain}/oauth/userinfo.php

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.

We also support Login (Single Sign-on) with WHMCS into other CMS like Joomla, Drupal.

We can also integrate Multi-factor Authentication (Two-factor authenticantion), IP Restriction into these CMS.

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.