WHMCS Connect

WHMCS Connect allows you to access the control panels for all configured servers that use supported control panels. This allows you to work with these servers without the need to reauthenticate.

You can access this feature at Utilities > WHMCS Connect.

  • Currently, you can use cPanel & WHM with Single Sign-On.
  • This feature supports the Firefox® and Safari® browsers. Chromium-based browsers browsers (for example, Chrome™) are not supported.

Using WHMCS Connect

The menu at the top-right of the interface provides a list of all servers that support Single Sign-On. Select one from the menu to connect.

When you choose a server from the menu, WHMCS will securely communicate via the API to establish a session and load the control panel interface in the lower frame. If a session cannot be established successfully, you will receive an error message.

Disable Use X-Frame-Options

WHMCS Connect requires the use of an iframe.

To do this in cPanel & WHM:

  1. Log in to WHM.
  2. Go to WHM » Server Configuration » Tweak Settings.
  3. Set Use X-Frame-Options and X-Content-Type-Options headers with cpsrvd to Off.
  4. Click Save.

Permissions

Several sets of permissions control access to WHMCS Connect servers.

Admin Role Groups

Access to WHMCS Connect requires the WHMCS Connect admin role group permission. By default, only Full Administrator admins have access to WHMCS Connect.

Per Server and Per Admin User Group

You can grant access to Single Sign-On functionality on a per-server and per-admin group basis. For example, you can allow users in Admin Role Group 1 to perform Single Sign-On for servers 1 and 3, while users of Admin Role Group 2 can only perform Single Sign-On to server 2.

By default, all admins can perform Single Sign-On into any server in WHMCS. However, Single Sign-On is only available through WHMCS Connect or at Configuration () > System Settings > Servers.

To configure permissions for a server:

  1. Go to Configuration () > System Settings > Servers.
  2. Edit the desired server.
  3. Under SSO Access Control, set Access Control to Restricted. A list of admin role groups will appear.
  4. Select the admin role groups that you want to grant permission to.
  5. Save your changes.

Last modified: October 31, 2024