Wissen / Einrichtung
Anmeldung über Microsoft Entra ID
App-Registrierung, Rollen und die passenden Einstellungen in Kontris.
Kontris meldet Benutzer über OpenID Connect an und liest ihre Rolle aus den App-Rollen der Registrierung. Du brauchst in Entra die Rolle Application Administrator.
https://contracthub.example.com steht im Folgenden für deine APP_BASE_URL.
1. App registrieren
- Im Entra Admin Center: Identity → Applications → App registrations → New registration.
- Name
Kontris, Kontotyp Single tenant. - Redirect URI: Plattform Web,
https://contracthub.example.com/auth/callback. - Notiere von der Übersichtsseite die Application (client) ID und die Directory (tenant) ID.
2. Secret oder Zertifikat
Secret: Certificates & secrets → New client secret. Kopiere den Value sofort, er wird nur einmal angezeigt. Merke dir das Ablaufdatum.
Zertifikat (empfohlen): Der private Schlüssel bleibt auf deinem Server, zu Entra geht nur das Zertifikat.
sudo mkdir -p /opt/contracthub/oidc && cd /opt/contracthub/oidc
sudo openssl req -x509 -newkey rsa:3072 -nodes -days 730 \
-subj "/CN=Kontris" -keyout client.key -out client.crt
sudo chown 1000:1000 client.key && sudo chmod 400 client.key
Lade client.crt unter Certificates & secrets → Certificates hoch und binde den Ordner in der compose.yaml ein:
volumes:
- ./oidc:/oidc:ro
3. App-Rollen anlegen
Unter App roles → Create app role dreimal, jeweils für Users/Groups:
| Anzeigename | Value | Bedeutung |
|---|---|---|
| Kontris Admin | ContractHub.Admin |
Vollzugriff |
| Kontris Auditor | ContractHub.Auditor |
Lesezugriff auf alles, auch das Audit-Log |
| Kontris User | ContractHub.User |
Zugriff nach Ordnerberechtigungen |
Die Werte müssen genau so geschrieben sein. Hat jemand mehrere Rollen, gilt die höchste.
4. Berechtigungen und Claims
- API permissions: Die delegierten Berechtigungen
openid,profileundemailgenügen. Klicke Grant admin consent. - Token configuration → Add optional claim → ID →
email.
Gruppen-Claims braucht Kontris nicht.
5. Benutzer zuweisen
Unter Enterprise applications → Kontris → Users and groups weist du Benutzern oder Gruppen eine der drei Rollen zu. Wer keine Rolle hat, wird bei der Anmeldung abgewiesen.
6. Kontris konfigurieren
In contracthub.env:
OIDC_ENABLED=true
OIDC_PROVIDER=entra
OIDC_TENANT_ID=<Directory (tenant) ID>
OIDC_CLIENT_ID=<Application (client) ID>
# entweder Secret …
OIDC_CLIENT_SECRET=<Value>
# … oder Zertifikat
# OIDC_CLIENT_CERT_FILE=/oidc/client.crt
# OIDC_CLIENT_KEY_FILE=/oidc/client.key
Danach neu starten:
docker compose up -d --force-recreate contracthub
Auf der Anmeldeseite erscheint Mit Microsoft anmelden. Lokale Konten bleiben als zweiter Weg erhalten, solange LOCAL_AUTH_ENABLED=true gesetzt ist.
Gut zu wissen
- Bestehende lokale Benutzer werden bei der ersten Anmeldung über Entra anhand der E-Mail-Adresse übernommen (
OIDC_LINK_LOCAL_USERS, Standard an). - Gruppen aus Entra: Legst du weitere App-Rollen an, kannst du sie in Kontris unter Verwaltung → Gruppen einer Gruppe zuordnen. Die Mitglieder werden bei jeder Anmeldung abgeglichen.
- Deaktivierte Konten: Mit
ENTRA_ACCOUNT_CHECK_ENABLED=trueprüft Kontris jede Nacht, ob Konten in Entra deaktiviert oder gelöscht wurden. Dafür braucht die App-Registrierung die AnwendungsberechtigungUser.Read.All. - Notfallzugang: Für den Fall, dass Entra nicht erreichbar ist, gibt es ein Notfallkonto (
BREAK_GLASS_*). Jede Nutzung steht im Audit-Log.
Stand 15.11.2026 · Kommst du nicht weiter? Schreib uns