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
- Sign in to your Panel as an administrator.
- Go to Admin → Extensions.
- Click Install and upload the
.pteroextfile. - 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
- In the Panel, open Admin → Extensions, click Settings on Advanced Pterodactyl SSO and paste the secret into SSO secret.
- 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
| Setting | What it does |
|---|---|
| SSO secret | The shared secret. It is stored encrypted. Auto Login is off while it is empty. |
| Allow admin logins | Off by default. When off, Auto Login never signs anyone in as a root admin, even with the right secret. |
How it works
- The customer clicks Auto Login in Paymenter.
- Paymenter asks the Panel at
/ssofor a login token, with the secret and the Pterodactyl user ID of the customer. - The Panel checks the secret and returns a random token that works once and expires after 60 seconds.
- The browser opens
/sso-loginwith 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
| Problem | Solution |
|---|---|
| HTTP 503: SSO is not configured | Fill in the SSO secret in the extension settings. |
| HTTP 403: Invalid SSO secret | The secrets in the Panel and in Paymenter are not the same. |
| HTTP 403: Admin logins are turned off | The customer is a root admin. Turn on Allow admin logins, or use a normal account. |
| HTTP 404 | The extension is not enabled, or the SSO Endpoint Path in Paymenter is not /sso. |
| The customer lands on the login page | The 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.