Configure WHMCS Single Sign-On (SSO) with Joomla OAuth Client Plugin

Overview

Set up Single Sign-On (SSO) on your Joomla site using the WHMCS OAuth provider with the Joomla OAuth & OpenID Connect plugin. This integration allows users to securely log in to your Joomla websites and applications by authenticating through WHMCS's OAuth provider, using the OAuth 2.0 authentication protocol. The WHMCS OAuth Joomla plugin also offers advanced features such as automatic user creation, attribute mapping, and group mapping.

Visit our Joomla OAuth Client Plugin page to learn more about the features and pricing plans available for the Joomla OAuth Single Sign-On (OAuth & OpenID Connect) plugin.

Configuration Steps

In this configuration, WHMCS functions as the OAuth server, while Joomla allows users to log in with their WHMCS credentials by utilizing the Joomla OAuth Client Plugin.

Step 2: Configure WHMCS as OAuth Server

• First, log into your WHMCS account.
• You will be presented with following screen. Go to Setup -> OpenID Connect on the navigation bar on top.

• Click on Generate New Client API Credentials button.

• You will be redirected to the app details page. Fill in the required details and enter Authorized Redirect URIs here. Click on Generate Credentials button.

Step 3: Configure Client ID & Secret

• Now your API credentials are generated successfully. Under the Client API Credentials section you will get Client ID and Client Secret. Click on Save Changes.

• Go back to your Joomla Dashboard. Then go to Step 2 in the Configure OAuth tab.
• Paste the Client ID, Client Secret and Tenant. Also Set Client Credentials In Header and Body then click on Save Settings. Once Settings are saved then click on Save Configuration.

• Scope & Endpoints are given below, which are required for configuring Joomla as OAuth Client plugin to configure WHMCS as a custom OAuth or OIDC provider.

Scope	read_public
Authorize Endpoint	https://{yourWHMCSdomain}/oauth/authorize.php
Access Token Endpoint	https://{yourWHMCSdomain}/oauth/token.php
Get User Info Endpoint	https://{yourWHMCSdomain}/oauth/userinfo.php
Set Client Credentials	In Both (In Header and In Body)