Search

Language:  
Search for:

Available article translations:

[How to] How to configure integration of Parallels Plesk Billing and Parallels Plesk Panel and enable login via SSO

APPLIES TO:
  • Parallels Plesk 9.x for Linux/Unix

Resolution

Install Parallels Plesk Panel 9.0.1 and Parallels Plesk Billing 6.0.1.

Note that Parallels Plesk Billing 6.0.0 does not work with Parallels Plesk Panel 9.0.1; for details, see the article http://kb.parallels.com/en/5985.

If you used Parallels Plesk Panel 6.0.0 before and upgraded Parallels Plesk Panel to version 9.0.1, you should also upgrade Parallels Plesk Billing to version 6.0.1.

You can install Parallels Plesk Billing Bundle via the Plesk autoinstaller. For details, see Installing Parallels Plesk Billing Bundle.

After Parallels Plesk Billing Bundle is installed, the Billing button should appear under Accounts on the "Home" page in Parallels Plesk Panel. If the button is missing, it may be hidden in the page preset. Check and enable the button in the preset configuration for Default Administrator Home Page at {Settings -> Interface Management -> Home Page Presets}.

The button leads to "Administrative Login" of Parallels Plesk Billing: https://<sso hostname>:8443/plesk-billing/admin/login.php.

NOTE: Parallels Plesk Billing Bundle does not work with Parallels Plesk Panel if the PHP option display_errors is enabled in the Plesk PHP configuration. Verify that the option is "Off." You may check with the following command:

~# grep display_errors /usr/local/psa/admin/conf/php.ini
display_errors = Off
~#

If "display_errors" is "On," change the option and restart sw-cp-server to apply the changes:


~# /etc/init.d/sw-cp-server restart
Restarting SWsoft control panels server... stale pidfile.  [  OK  ]
~#

You can configure the login to Parallels Plesk Billing through Parallels Plesk Panel via SSO. In this case, authorization to Parallels Plesk Billing is performed automatically after the Billing button is clicked in Parallels Plesk Panel.

SSO is an application for sw-cp-server. After installation, restart sw-cp-server and verify that the SSO application is up and running:

~# netstat -natp | grep 1144
tcp        0      0 0.0.0.0:11443      0.0.0.0:*      LISTEN      23638/sw-cp-serverd
tcp        0      0 0.0.0.0:11444      0.0.0.0:*      LISTEN      23638/sw-cp-serverd
~#

You can register Parallels Plesk Panel in the SSO server with the Plesk utility /usr/local/psa/bin/sso:

~# /usr/local/psa/bin/sso -s -server https://<sso hostname>:11443 -url https://<sso hostname>:11444
SUCCESS: SSO preferences are successfully updated
~#

Enable it:

~# /usr/local/psa/bin/sso --enable

To register Parallels Plesk Billing in the SSO server, log in to Parallels Plesk Billing as the administrator and go to the page "SSO Settings" via {System -> System Configuration -> SSO Settings}. On the page, enter the URL for the SSO server in "Admin CP Settings" and "Client CP Settings" and click "Submit Changes." To enable SSO mode on the same page, mark the option "Enable SSO" and click "Submit Changes" to finish.

Then you should assign your Plesk and Billing user to the same global account. For example, to assign the Plesk user "admin" and Billing user "admin" to same global account, do the following:

Log in to Parallels Plesk Panel with the "admin" user credentials and go to {System -> Global Account -> Connect To Global Account}.

Connection to a global account ---------------------------------------
Connect your current local account to a new or existing global account

Select a global account to connect to:     [ ] Use current global account
                                           [ ] Use existing global account
                                           [ ] Create new global account
------------------------------------------------------------------------------


To assign, select an option and enter the login credentials of the global account.

Then log in to Parallels Plesk Billing as the administrator and assign the user to the same global account via {System -> Global Account -> Connect To Global Account}:

Connect To Global Account
------------------------------------------------------------------------------

Connect user 'admin' to Global Account:

[ ] Connect to current
[ ] Connect to existing
[ ] Create new
------------------------------------------------------------------------------


After assignment, you may log in to Parallels Plesk Billing without a password. It is enough to click the "Billing" button in Parallels Plesk Panel.

If the SSO server was reconfigured, for example, change hostname or SSL certificate was changed, you should re-register Parallels Plesk Panel and Parallels Plesk Billing in the SSO server.

To register Parallels Plesk Panel in the SSO server, do the following:

~# /usr/local/psa/bin/sso -s -server https://<new hostname>:11443 -url https://<new hostname>:11444
SUCCESS: SSO preferences are successfully updated
~#

To register Parallels Plesk Billing, log in to the control panel and go to the page {System -> System Configuration -> SSO Settings}. Deselect the check-boxes and click the "Submit Changes" button to apply. Then enter the new SSO server into "Register in SSO" and click "Submit Changes" again.

IMPORTANT: After the new registration, reassign the Plesk and Billing users to a global account.

Additional information

Run the utility /usr/local/psa/bin/sso with "--help" to get a list of all available options.

~# /usr/local/psa/bin/sso --help

Usage: sso command [options]

    Available commands:
    --enable or -e                     Enable SSO mode
    --disable or -d                    Disable SSO mode
    --set-prefs or -s                  Set SSO preferences
    --get-prefs or -g                  Get SSO preferences
    --set-branded-idp                  Set branded IdP URL or table of
                                       domains with IdP URls associated for
                                       all domains
                                       if http-request-domain is not
                                       specified
    --get-branded-idp                  Get branded IdP URL for specified
                                       domain, or table of domains with IdP
                                       URls associated for all domains
                                       if http-request-domain is not
                                       specified
    --del-branded-idp                  Romove all Branded IdP URLs (reset to
                                       default) or delete specified IdP URL
                                       only or delete
                                       specified IdP URL associated with
                                       specified domain
    --help or -h                       Displays this help page

    Available options:
    -server      <SSO Server URL>      Set SSO Server URL
    -url               <IdP URL>       Set IdP URL
    -domain   <HTTP Request Domain>    Set HTTP Request Domain

Version: 9.0.1_build90090127.18 os_CentOS 5

~#




12c6f6bd6775cb701defb57d79fe96f6 c81e59b61af9dca603ba03b14aabe968 9f8baf78266b4e54525d1c6bf06305a5 56797cefb1efc9130f7c48a7d1db0f0c

FEEDBACK
Was this article helpful?
Tell us how we may improve it.
Yes No
 
 
 
 
 
 
Desktop Virtualization
- Parallels Desktop 9 for Mac
- Parallels Transporter
- Parallels Desktop Switch to Mac Edition
- Parallels Desktop for Mac Enterprise Edition
- Parallels Management-Mac for Microsoft SCCM
Server Virtualization
- Parallels Cloud Server
- Parallels Containers for Windows 6.0 Beta
- Parallels Virtuozzo Containers
Automation
- Parallels Automation
- Parallels Automation for Cloud Infrastructure
- Parallels Business Automation Standard
- Parallels Virtual Automation
- Parallels Plesk Panel Suite
- Web Presence Builder
- Parallels Plesk Automation
- Parallels Small Business Panel
- Value-added Services for Hosters
- Parallels Partner Storefront
Services & Resources
- Cloud Acceleration Services
- Professional Services
- Support Services
- Training & Certification