Skip to content
v2.19.3GitHub

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)

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.

  1. In Pocket ID, open Administration → OIDC Clients and click Add OIDC Client.
  2. Enter a name such as TelltaleDNS and add the callback URL https://<app>.example.com/api/v1/auth/oidc/pocketid/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, set Client Launch URL to https://<app>.example.com and turn on PKCE, then click Save.
  5. On the client’s Access tab, select telltale-admins, telltale-operators and telltale-viewers under Allowed User Groups.

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"