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

  1. Im Entra Admin Center: Identity → Applications → App registrations → New registration.
  2. Name Kontris, Kontotyp Single tenant.
  3. Redirect URI: Plattform Web, https://contracthub.example.com/auth/callback.
  4. 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

  1. API permissions: Die delegierten Berechtigungen openid, profile und email genügen. Klicke Grant admin consent.
  2. 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=true prüft Kontris jede Nacht, ob Konten in Entra deaktiviert oder gelöscht wurden. Dafür braucht die App-Registrierung die Anwendungsberechtigung User.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