Managing SSO Service

Business Manager offers the global account feature that allows you to authorize only once and then switch between Parallels Plesk Panel and Business Manager without being prompted to log in again. The global accounts are managed by the Single Sign-On (SSO) service.

The software that provides the SSO service is called SSO server. This server is automatically installed together with Panel. By default, the SSO is automatically set up to share global accounts between Business Manager and Panel installed on the same server (the local Panel). In this case, the SSO does not need to know the IP addresses of the Business Manager and Panel, so it uses the localhost IP address (127.0.0.1) for referring to them. This SSO mode is called single-panel mode. The single-panel mode best suits for beginner hosting providers that use a single Panel (which is local). This mode works out of the box and does not require any additional host name configuration steps.

If you want to expand you business and sell hosting accounts on two or more Panel servers, make sure that all these servers are able to connect to Business Manager and reconfigure the SSO to work with multiple Panels. To check if the Panel servers resolve the Business Manager host name, run the nslookup system utility on these servers:

nslookup <bm_host_name>

If your Business Manager host name is not registered, register it or purchase a new host name and configure Business Manager to use it by running the following command:

/usr/share/plesk-billing/integration --command=update --hostname=<new_host_name>

After you make sure that Panel servers are able to connect to Business Manager server, switch the SSO to the multiple-panels mode. In this mode, the SSO uses the servers host names instead of the localhost and this allows Business Manager to interact with multiple remote panels. After switching the SSO mode, connect the remote Panels. You can find the instructions on changing the SSO mode below.

The interaction between the SSO service and Business Manager is regulated by the SSO utility. To learn more what you can do with this utility, refer to the Parallels Plesk Panel Command Line Reference for Linux or Windows, section Single Sign-On Configuration.

 

Switching SSO Modes

Note: Before you switch SSO to multiple-panels mode, ensure that connected Panels servers resolve the Business Manager domain name.

To switch the SSO to multiple-panels mode, run the following command on the Business Manager server:

/usr/share/plesk-billing/integration --command=switch-sso-mode --sso-mode=multiple-panels

To switch the SSO back to single-panel mode, run the integration utility the following way:

/usr/share/plesk-billing/integration --command=switch-sso-mode --sso-mode=single-panel

Important: If you switch SSO to the single-panel mode while the remote Panels are still connected to Business Manager, your customers whose subscriptions are served by remote Panels will experience problems with transparent switching to these Panels.

 

Leave your comments on this page