Wissen / Einrichtung

Anmeldung über Authentik

Anwendung und Provider in Authentik anlegen und Kontris damit verbinden.

Kontris nutzt genau einen Anbieter für Single Sign-on: Entra ID oder Authentik. Mit Authentik kommen die Rollen aus den Gruppen des Benutzers.

https://contracthub.example.com steht für deine APP_BASE_URL, https://auth.example.com für Authentik.

1. Gruppen anlegen

Unter Directory → Groups dreimal:

Gruppe Rolle in Kontris
ContractHub.Admin Vollzugriff
ContractHub.Auditor Lesezugriff auf alles, auch das Audit-Log
ContractHub.User Zugriff nach Ordnerberechtigungen

Andere Namen sind möglich. Du trägst sie dann in OIDC_ROLE_ADMIN, OIDC_ROLE_AUDITOR und OIDC_ROLE_USER ein. Ordne die Benutzer den Gruppen zu.

2. Anwendung und Provider

  1. Applications → Applications → Create with provider.
  2. Name Kontris, Slug contracthub.
  3. Provider-Typ OAuth2/OpenID Provider, Client-Typ Confidential.
  4. Redirect URI im Modus Strict: https://contracthub.example.com/auth/callback.
  5. Wähle einen Signing Key und lass die Scopes openid, email und profile ausgewählt.
  6. Notiere Client ID und Client Secret.

Lass den Subject mode auf dem Standard und ändere ihn nach der Inbetriebnahme nicht mehr. Kontris erkennt Benutzer an diesem Wert.

Die Issuer-URL steht in der Übersicht des Providers, zum Beispiel https://auth.example.com/application/o/contracthub/, mit dem Schrägstrich am Ende.

3. E-Mail-Änderungen sperren

Kontris verknüpft vorab angelegte Benutzer über die E-Mail-Adresse. Benutzer sollten sie in Authentik deshalb nicht selbst ändern dürfen (System → Settings).

4. Kontris konfigurieren

OIDC_ENABLED=true
OIDC_PROVIDER=authentik
OIDC_ISSUER=https://auth.example.com/application/o/contracthub/
OIDC_CLIENT_ID=<Client ID>
OIDC_CLIENT_SECRET=<Client Secret>
docker compose up -d --force-recreate contracthub

Verwendet Authentik ein Zertifikat einer internen Zertifizierungsstelle, muss Kontris dieser vertrauen. Binde dazu das CA-Bündel des Servers ein und setze NODE_EXTRA_CA_CERTS:

    environment:
      NODE_EXTRA_CA_CERTS: /etc/ssl/certs/host-ca.crt
    volumes:
      - /etc/ssl/certs/ca-certificates.crt:/etc/ssl/certs/host-ca.crt:ro

Stand 15.11.2026 · Kommst du nicht weiter? Schreib uns