synops/docs/erfaringer/authentik_oppsett.md

Erfaring: Authentik OIDC-oppsett for Synops

Oversikt

Authentik kjører på auth.sidelinja.org og fungerer som SSO for alle Synops-tjenester. To OIDC-providere er konfigurert:

Provider	Application	Slug	Bruk
forgejo	forgejo	forgejo	Git-hosting (git.sidelinja.org)
sidelinja-web	Sidelinja	sidelinja	Hovedapplikasjon (sidelinja.org)

Sidelinja OIDC-provider

Endepunkter

• Issuer: https://auth.sidelinja.org/application/o/sidelinja/
• Discovery: https://auth.sidelinja.org/application/o/sidelinja/.well-known/openid-configuration
• Authorization: https://auth.sidelinja.org/application/o/authorize/
• Token: https://auth.sidelinja.org/application/o/token/
• Userinfo: https://auth.sidelinja.org/application/o/userinfo/
• JWKS: https://auth.sidelinja.org/application/o/sidelinja/jwks/

Konfigurasjon

• Client type: Confidential
• Authorization flow: Implicit consent (ingen godkjenningsskjerm — det er vår egen app)
• Signing algorithm: RS256
• Access token validity: 1 time
• Refresh token validity: 30 dager
• Sub mode: hashed_user_id (SHA256 av Authentik intern UUID)

Redirect URIs

Modus	URL	Formål
strict	https://sidelinja.org/auth/callback/authentik	Produksjon
regex	http://localhost:\d+/auth/callback/authentik	Lokal utvikling

Scopes

Provideren tilbyr: openid, email, profile, offline_access.

Miljøvariabler (.env på server)

AUTHENTIK_ISSUER=https://auth.sidelinja.org/application/o/sidelinja/
AUTHENTIK_CLIENT_ID=<fra Authentik>
AUTHENTIK_CLIENT_SECRET=<fra Authentik>

Disse brukes av SvelteKit (@auth/sveltekit) og senere av maskinrommet for JWT-validering.

JWT-validering i maskinrommet

Maskinrommet (Rust/axum) validerer access tokens utstedt av denne provideren:

1. Hent JWKS fra https://auth.sidelinja.org/application/o/sidelinja/jwks/
2. Valider signatur (RS256), issuer, og utløpstid
3. Slå opp sub-claim i auth_identities-tabellen → node_id

Viktig: sub er en SHA256-hash, ikke en UUID. Se docs/erfaringer/authentik_oidc.md for detaljer om dette og andre fallgruver.

Administrasjon

API-tilgang

Opprett API-token via ak shell:

docker exec sidelinja-authentik-server-1 ak shell -c "
from authentik.core.models import Token, User
user = User.objects.get(username='akadmin')
token, _ = Token.objects.get_or_create(
    identifier='api-token',
    defaults={'user': user, 'intent': 'api', 'expiring': False}
)
print(token.key)
"

Bruk tokenet med: Authorization: Bearer <token>

Verifiser oppsett

# OIDC discovery
curl -s https://auth.sidelinja.org/application/o/sidelinja/.well-known/openid-configuration | jq .issuer

# JWKS (for JWT-validering)
curl -s https://auth.sidelinja.org/application/o/sidelinja/jwks/ | jq '.keys | length'

# List providere via API
curl -s -H "Authorization: Bearer <token>" \
  https://auth.sidelinja.org/api/v3/providers/oauth2/ | jq '.results[].name'

Legge til ny redirect URI

Hvis en ny tjeneste trenger OIDC (f.eks. maskinrommet med egen callback):

# Hent provider pk
curl -s -H "Authorization: Bearer <token>" \
  https://auth.sidelinja.org/api/v3/providers/oauth2/?name=sidelinja-web | jq '.results[0].pk'

# Oppdater redirect_uris (PATCH)
curl -s -X PATCH -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  https://auth.sidelinja.org/api/v3/providers/oauth2/<pk>/ \
  -d '{"redirect_uris": [
    {"matching_mode": "strict", "url": "https://sidelinja.org/auth/callback/authentik"},
    {"matching_mode": "regex", "url": "http://localhost:\\d+/auth/callback/authentik"},
    {"matching_mode": "strict", "url": "https://ny-tjeneste.sidelinja.org/callback"}
  ]}'

Merk: PATCH erstatter hele redirect_uris-listen — inkluder alltid eksisterende URIer.