Advanced Pterodactyl SSO

Install the Advanced Pterodactyl SSO extension on Pterodactyl v2 so customers can use Auto Login from Paymenter.

Advanced Pterodactyl SSO is a small Pterodactyl v2 extension that makes Auto Login of Advanced Pterodactyl work. It comes with Advanced Pterodactyl, in the Pterodactyl v2 SSO folder of the download. On Pterodactyl v1 you use the SSO plugin instead, see Advanced Pterodactyl.

Requirements

  • Pterodactyl Panel v2.0 or newer (the extension system).
  • Advanced Pterodactyl 2.0 or newer in Paymenter, set to Pterodactyl v2.

Installation

Step 1: Find the files

Extract the Advanced Pterodactyl zip and open the Pterodactyl v2 SSO folder. It has advanced-pterodactyl-sso-1.0.pteroext (the installable build) and advanced-pterodactyl-sso-source.zip (the editable source).

Step 2: Install in the Panel

  1. Sign in to your Panel as an administrator.
  2. Go to Admin → Extensions.
  3. Click Install and upload the .pteroext file.
  4. Toggle the extension on to enable it.

Or install it from the command line in your panel folder:

php artisan p:extension:install advanced-pterodactyl-sso-1.0.pteroext
php artisan p:extension:enable advanced-pterodactyl-sso

Step 3: Set the secret

Create a random secret of at least 32 characters, for example:

openssl rand -hex 32
  1. In the Panel, open Admin → Extensions, click Settings on Advanced Pterodactyl SSO and paste the secret into SSO secret.
  2. In Paymenter, open the server under Admin → Servers, paste the same secret into SSO Secret Key and leave SSO Endpoint Path on /sso.

Customers now see Auto Login on their service and land in the panel signed in.

Settings

SettingWhat it does
SSO secretThe shared secret. It is stored encrypted. Auto Login is off while it is empty.
Allow admin loginsOff by default. When off, Auto Login never signs anyone in as a root admin, even with the right secret.

How it works

  1. The customer clicks Auto Login in Paymenter.
  2. Paymenter asks the Panel at /sso for a login token, with the secret and the Pterodactyl user ID of the customer.
  3. The Panel checks the secret and returns a random token that works once and expires after 60 seconds.
  4. The browser opens /sso-login with that token and the customer is signed in.

The secret never reaches the browser. The token only works once, so a link that is copied or opened again does nothing.

Troubleshooting

ProblemSolution
HTTP 503: SSO is not configuredFill in the SSO secret in the extension settings.
HTTP 403: Invalid SSO secretThe secrets in the Panel and in Paymenter are not the same.
HTTP 403: Admin logins are turned offThe customer is a root admin. Turn on Allow admin logins, or use a normal account.
HTTP 404The extension is not enabled, or the SSO Endpoint Path in Paymenter is not /sso.
The customer lands on the login pageThe token was already used or older than 60 seconds. Click Auto Login again.

Need help?

Visit builtbyotte.com/help. We reply to every message within 24 hours.