CertShell
Sign in to the CertShell browser SSH terminal with Pocket ID, and use Pocket ID groups to decide who can reach which hosts.
Requirements
Section titled “Requirements”- CertShell reachable over HTTPS, e.g.
https://ssh.example.com - A user group in Pocket ID for CertShell admins,
certshell-adminsby default
Create the client in Pocket ID
Section titled “Create the client in Pocket ID”- In Pocket ID, open Administration → OIDC Clients and click Add OIDC Client.
- Enter a name such as
CertShelland add the callback URLhttps://ssh.example.com/auth/callback. - 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.
- On the client’s General tab, turn on PKCE, then click Save.
- On the client’s Access tab, select the groups that may sign in under Allowed User Groups, or choose All Users.
Configure CertShell
Section titled “Configure CertShell”-
Add the values to CertShell’s
.env:APP_URL=https://ssh.example.comOIDC_ISSUER=https://id.example.comOIDC_CLIENT_ID=<client-id>OIDC_CLIENT_SECRET=<client-secret> -
Restart CertShell and sign in. Members of
certshell-admins(set another name withOIDC_ADMIN_GROUP) see the Admin section. -
In CertShell, open Admin → Hosts and allow your Pocket ID groups on each host’s logins.