WHMCS OpenID and cPanel Setup Guide

In cPanel 54, support was introduced for login using OpenID Connect authentication providers.

WHMCS 6.2 and later can act as an OpenID Connect Authentication Provider.

The WHMCS OpenID Connect feature allows users to sign into cPanel using their login credentials for your WHMCS Billing & Support system. Utilizing this integration reduces the number of login credentials that end users are required to remember.

Setup Guide

To enable WHMCS as an OpenID Connect Authentication Provider for your cPanel/WHM server, follow the steps below.

Important: Please ensure you are running cPanel/WHM Version 54 or later or these options will not be available.

1. Log into WHM as root
2. Navigate to Security Center > Manage External Authentications
3. Select the Configure tab
4. Under the Authentication Providers heading, locate Log in via WHMCS
5. Click the Configure button
6. Copy the Redirect URI that contains the cPanel port number (2083) to your clipboard - you will need this in a minute.
7. Now login to your WHMCS Admin Area
8. Navigate to Setup > OpenID Connect
9. Click the Generate New Client API Credentials button
10. Enter a name for this OpenID Credential Set - we suggest using the following details
    Application Name: cPanel
    Description: hostname.example.com
    Logo URI: /modules/servers/cpanel/logo.png
    Redirect URI: (the URI you copied into your clipboard above)
11. Once all fields have been filled out, click the Generate Credentials button
12. The page will re-load and display the generated Client API Credentials to you
13. Copy the generated Client ID and Client Secret from here and paste them into the appropriate fields within the WHM WHMCS External Authentication Provider Configuration interface
14. In the Well Known Config URI field, enter https://www.example.com/whmcs/oauth/openid-configuration.php, replacing https://www.example.com/whmcs with your WHMCS System SSL URL
15. Finally, tick the box to confirm you have used the Redirect URIs as provided, and then click Save to complete the process.

To complete the setup and activate the WHMCS integration, slide the toggle switch for the Status (cpaneld) to Enabled. Upon doing this, the "Log in via WHMCS" button should immediately begin showing on the cPanel login page.

Repeat the above steps for each compatible cPanel/WHM server you wish to offer WHMCS authentication for. We recommend creating a unique set of OpenID Connect API Credentials for each server you wish to connect with your WHMCS installation for best security practices.