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
- Applications → Applications → Create with provider.
- Name
Kontris, Slugcontracthub. - Provider-Typ OAuth2/OpenID Provider, Client-Typ Confidential.
- Redirect URI im Modus Strict:
https://contracthub.example.com/auth/callback. - Wähle einen Signing Key und lass die Scopes
openid,emailundprofileausgewählt. - 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