CPanel Single Sign-On

From WHMCS Documentation

Revision as of 15:30, 11 June 2015 by Matt (talk | contribs) (Created page with "cPanel Single Sign-On is available in WHMCS 6.0 and later. Single Sign-On allows users to transition from WHMCS to the cPanel or WHM interfaces without having to re-authentic...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

cPanel Single Sign-On is available in WHMCS 6.0 and later.

Single Sign-On allows users to transition from WHMCS to the cPanel or WHM interfaces without having to re-authenticate. It is utilised:

  • In the client area to login to cPanel for shared hosting accounts
  • In the client area to login to WHM for reseller hosting accounts
  • In the admin area to login to cPanel for shared hosting accounts
  • In the admin area to login to WHM for reseller hosting accounts
  • In the admin area to login to WHM for all cPanel servers configured in the WHMCS installation

For more information on the admin area capabilities, please refer to the WHMCS Connect documentation.

Requirements

To use cPanel Single Sign-On your servers need to be running cPanel & WHM 11.46 and higher.

To use the deep linking functionality used within the client area your servers need to be running cPanel & WHM 11.50 and higher.

Permissions

All clients have permission to perform single sign-on into any hosting account within their client account.

For users with administrative privileges, you can control access to Single Sign-On functionality on a per server and per admin user group basis. For example you can say that Admin Role Group 1 can perform Single Sign-On for Servers 1 and 3, while only Admin Role Group 2 can perform Single Sign-On to Server 2.

Permissions can be configured for a server in Setup > Servers. Edit the server you wish to adjust the permissions for, scroll down until you reach the SSO Access Control section. Then under the Access Control setting select Restricted after which a list of admin role groups will be displayed for you to be able to choose which admin role groups should be allowed to utilise Single Sign-On with the selected server.

Sso-permissions.png

Caveats

  • cPanel Single Sign-On can be performed for any user owned by the WHM user configured for a cPanel server within the WHMCS installation. In the case of a WHM reseller account, what this means is that if you do not own your own account you will not be able to perform Single Sign-On into it. Attempting to login will result in the error "".