Managing Login Handler

Login handler is a utility that redirects a user who already logged in to the Plesk Sitebuilder Administrator Panel or Wizard.

For this, send a GET or POST query to the handler address:

• http://<sb-example-host.com>/ExternalLogin.ashx (Plesk Sitebuilder for Windows)

  or

• http://<sb-example-host.com>/external_login.php (Plesk Sitebuilder for Linux/Unix)

Here http://<sb-example-host.com>/ means your Plesk Sitebuilder root URL.

Query parameters

• Login. User login ID. Required.
• Password. User password. Required.
• SiteID. ID of the site to open in the Wizard after successful login. Optional.
• ShowAdmin. If specified (and SiteID is not specified), redirects to the Administrator Panel on successful login. Optional
• ReturnUrl. URL to redirect to in case of successful login. You can use relative URLs for this parameter (e.g. /Wizard/Pages) if redirecting to one of the Plesk Sitebuilder screens. If redirecting to an external resource, use only absolute URLs in http:// format. Optional.

Note: If both ReturnUrl and ShowAdmin parameters are present in the query, the ShowAdmin parameter will be ignored.

• FailUrl. URL to redirect to in case of login failure. Optional, but highly recommended to specify the parameter.
• Skin. ID of skin to select in the new session. Can be one of the following:

  AquaCompact

  LonghornAero

  LonghornBlack

  PleskBlue

  PleskReflections

  PleskSea

  PleskViolet

  WinXPBlue

  WinXPOlivegreen

  WinXPReloadedCompact

  WinXPSilver

  LonghornYellow

  PleskClassicSilver

  PleskNature

  PleskSilver

• Language. Session GUI language by standard culture code, for example "en-US", or "ru-RU". Optional.

Request examples

If dealing with Plesk Sitebuilder for Linux/Unix, use the URLs in the following formats:

• To log in to the Administrator Panel as administrator:

  http://<sb-example-host.com>/external_login.php?Login=admin&Password=admin

• To log in to the Wizard as site owner:

  http://<sb-example-host.com>/external_login.php?Login=siteowner&Password=siteowner

• To log in to the Administrator Panel as site owner:

  http://<sb-example-host.com>/external_login.php?Login=siteowner&Password=siteowner&ShowAdmin=true

• To login to the Administrator Panel with a specific language and skin:

  http://<sb-example-host.com>/external_login.php?Login=admin&Password=admin&Skin=AquaCompact&Language=de-DE

• To log in as site owner directly to the page of editing a particular site (specified by its ID):

  http://<sb-example-host.com>/external_login.php?Login=siteowner&Password=siteowner&SiteID=b2e11f743e10475dcaa60f81b271caaa

If dealing with Plesk Sitebuilder for Windows, use the URLs in the following formats:

• To log in to the Administrator Panel as administrator:

  http://<sb-example-host.com>/ExternalLogin.ashx?Login=admin&Password=admin

• To log in to the Wizard as site owner:

  http://<sb-example-host.com>/ExternalLogin.ashx?Login=siteowner&Password=siteowner

• To log in to the Administrator Panel as site owner:

  http://<sb-example-host.com>/ExternalLogin.ashx?Login=siteowner&Password=siteowner&ShowAdmin=true

• To login to the Administrator Panel with a specific language and skin:

  http://<sb-example-host.com>/ExternalLogin.ashx?Login=admin&Password=admin&Skin=AquaCompact&Language=de-DE

• To log in as site owner directly to the page of editing a particular site (specified by its ID):

  http://<sb-example-host.com>/ExternalLogin.ashx?Login=siteowner&Password=siteowner&SiteID=b2e11f743e10475dcaa60f81b271caaa

Note: It is recommended to avoid the POST request in order to save the sensitive info in browser navigation history.