TelltaleDNS
Set up Pocket ID authentication for your TelltaleDNS instance
The following example variables are used and should be replaced with your actual URLs.
- dns.example.com (the URL of your TellTaleDNS instance)
- id.example.com (the URL of your Pocket ID instance)
Create groups in Pocket ID
Section titled “Create groups in Pocket ID”In Pocket ID, open Administration → User Groups and click Add Group to create the following groups. Use these exact values for Name, because they’re referenced in the TelltaleDNS group map.
| Group name | Maps to TelltaleDNS group | What it does |
|---|---|---|
telltale-viewers |
viewer |
Sees dashboards and the query log, such as on wall displays |
telltale-operators |
operator |
Everything a viewer can, plus pause blocking, flush the cache, and manage lists, clients, and groups |
telltale-admins |
admin |
Everything, including users, the audit log, and security settings |
Add users to whichever group reflects their role. Users not in any of these groups are denied access.
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
TelltaleDNSand add the callback URLhttps://<app>.example.com/api/v1/auth/oidc/pocketid/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, set Client Launch URL to
https://<app>.example.comand turn on PKCE, then click Save. - On the client’s Access tab, select
telltale-admins,telltale-operatorsandtelltale-viewersunder Allowed User Groups.
TelltaleDNS setup
Section titled “TelltaleDNS setup”Paste this into your telltale.toml file, change the required values and restart TelltaleDNS. The full auth settings can be found here.
[auth.oidc]public_url = "https://dns.example.com"
[[auth.oidc.provider]]id = "pocketid"name = "Pocket-ID"issuer = "https://id.example.com"client_id = "<<Client ID copied from Pocket ID>>"client_secret = "<<Client Secret copied from Pocket ID>>"scopes=["openid", "profile", "email", "groups"]groups_claim = "groups"
[[auth.oidc.provider.role]]group = "telltale-admins"role = "admin"
[[auth.oidc.provider.role]]group = "telltale-operators"role = "operator"
[[auth.oidc.provider.role]]group = "telltale-viewers"role = "viewer"