Skip to content
v2.19.3GitHub

CertShell

Sign in to the CertShell browser SSH terminal with Pocket ID, and use Pocket ID groups to decide who can reach which hosts.

  • CertShell reachable over HTTPS, e.g. https://ssh.example.com
  • A user group in Pocket ID for CertShell admins, certshell-admins by default
  1. In Pocket ID, open Administration → OIDC Clients and click Add OIDC Client.
  2. Enter a name such as CertShell and add the callback URL https://ssh.example.com/auth/callback.
  3. Click Create and copy the Client ID and the Client secret. Under Show more details, also copy the Issuer URL. The client secret is only shown once.
  4. On the client’s General tab, turn on PKCE, then click Save.
  5. On the client’s Access tab, select the groups that may sign in under Allowed User Groups, or choose All Users.
  1. Add the values to CertShell’s .env:

    APP_URL=https://ssh.example.com
    OIDC_ISSUER=https://id.example.com
    OIDC_CLIENT_ID=<client-id>
    OIDC_CLIENT_SECRET=<client-secret>
  2. Restart CertShell and sign in. Members of certshell-admins (set another name with OIDC_ADMIN_GROUP) see the Admin section.

  3. In CertShell, open Admin → Hosts and allow your Pocket ID groups on each host’s logins.