OIDC mit Entra
OpenID Connect OIDC ist ein Identitätsprotokoll, das auf OAuth 2.0 aufbaut und eine sichere Authentifizierung sowie Autorisierung für Web- und Mobile-Anwendungen ermöglicht. Es erlaubt Nutzer, sich sicher bei verschiedenen Diensten anzumelden, während Dienstanbieter gleichzeitig auf verifizierte Identitätsinformationen zugreifen können. In diesem Artikel wird die Konfiguration von OIDC in Relution Schritt für Schritt am Beispiel von Microsoft Azure erklärt.
<Name des Anbieters> Users hinzu und legt diese Gruppe bei Bedarf in der Organisation an. Über diese Gruppe lassen sich Berechtigungen vergeben.Einstellungen in Relution
OpenID Connect OIDC kann im Relution-Portal unter Einstellungen → Benutzerverwaltung → OpenID Connect konfiguriert werden.
Die folgenden Screenshots zeigen eine funktionierende Konfiguration mit Microsoft Azure.

Details zur Konfiguration
Name des Anbieters: Pflichtfeld. Wird auf dem Login Button im Relution-Portal angezeigt und kann nach dem Speichern nicht mehr geändert werden. Unbekannte Benutzer in Relution anlegen: Aktiviert die automatische Erstellung neuer, unbekannter Benutzer beim ersten Login in Relution. Standardmäßig ist der Schalter deaktiviert. Dann ist ein Login nur für Benutzer möglich, die bereits in Relution vorhanden sind. Konfiguration prüfen: Prüft vor dem Speichern, ob die Konfiguration gültig ist.
Erfolgt ein Login mit einem unbekannten Benutzer auf der Store Organisation mit aktivierter OIDC-Konfiguration, wird dieser automatisch in der Store Organisation angelegt. Bei mehreren Mandanten mit OIDC Konfiguration muss der Login über die Organisations-URL erfolgen, damit der unbekannte Benutzer in der entsprechenden Organisation angelegt wird. Diese URL wird im Portal bei den OIDC Verbindungen angezeigt.
Client-Details
ClientID Entspricht in Azure der Anwendungs-ID Client Secret Entspricht in Azure dem geheimen Clientschlüssel zur Anwendungs-ID. Beim Bearbeiten einer gespeicherten Konfiguration bleibt das Feld leer. Wird kein neuer Wert eingetragen, bleibt das bisherige Secret unverändert, ab Relution 27.0.1 jedoch nur, solange Issuer URI, Autorisierungs-URI, Token-URI, JWK Set URI und User Info URI unverändert sind.
Wurde einer dieser Endpunkte geändert und bleibt Client Secret leer, lehnt Relution das Speichern ab. Client Secret wird zum Pflichtfeld, Platzhalter und Hinweis „Lassen Sie das Client-Secret Feld leer, um das Secret unverändert zu lassen“ entfallen, und unter dem Feld erscheint die Meldung „Der Verbindungsendpunkt wurde geändert. Bitte geben Sie das Passwort bzw. Geheimnis erneut ein.“ Nach erneuter Eingabe des Secrets lässt sich die Konfiguration speichern. Auch ein Wechsel zwischen Discovery-Endpunkt verwenden und Manuelle Konfiguration der Endpunkte gilt als Änderung. Unterschiede nur in der Schreibweise (Leerzeichen am Anfang oder Ende, abschließender Schrägstrich, Groß-/Kleinschreibung von Schema und Host) zählen nicht, ebenso wenig Änderungen an Endpunkt der Sitzung beenden, ClientID, Umfang oder anderen Feldern. Ist noch kein Secret gespeichert, entfällt die Prüfung. Über die REST API antwortet der Server in diesem Fall mit HTTP 422 und dem Fehlercode 3418.
Server URIs
Discovery-Endpunkt verwenden Wenn vom Provider unterstützt, erfolgt eine automatische Konfiguration der benötigten URIs Manuelle Konfiguration der Endpunkte Notwendig, sobald das automatische Discovery nicht funktioniert.
Bei Verwendung von Microsoft Azure müssen die Endpunkte manuell eingetragen werden.

Autorisierungs-URI
https://login.microsoftonline.com/$-Ihre-Mandanten-ID/oauth2/v2.0/authorizeJWK Set URI
https://login.microsoftonline.com/common/discovery/keysToken-URI
https://login.microsoftonline.com/$-Ihre-Mandanten-ID/oauth2/v2.0/tokenEndpunkt der Sitzung beenden (optional, für die Abmeldung beim IdP, siehe Logout-Verifizierung)
https://login.microsoftonline.com/$-Ihre-Mandanten-ID/oauth2/v2.0/logout
Erweiterte Konfiguration
Benutzername-Attribut vom OIDC-Provider: Das Attribut des OIDC-Providers, das den eindeutigen Benutzernamen des authentifizierten Nutzers enthält (Standard: email).
Benutzernamen-Attribut von Relution: Legt fest, mit welcher Relution-Benutzereigenschaft (Benutzername, E-Mail, UUID oder Fremdschlüssel (UID); Standard: E-Mail) der Wert aus dem Benutzername-Attribut vom OIDC-Provider abgeglichen wird. Bei UUID werden unbekannte Benutzer auch dann nicht angelegt, wenn Unbekannte Benutzer in Relution anlegen aktiv ist.
Autorisierung-Grant Type: Legt fest, über welchen OAuth-Mechanismus die Anwendung Zugriff erhält (Standard: authorization_code).
Umfang: Bestimmt als OAuth-Scope, welche Informationen oder Ressourcen von Relution über OIDC angefordert werden dürfen (Standard: openid, email, profile).
Erweiterte Optionen
Benutzer von OIDC abmelden, wenn er sich von Relution abmeldet: Leitet den Browser beim Ausloggen aus Relution zusätzlich zum Logout-Endpunkt des IdP weiter (Standard: deaktiviert). Details dazu stehen unter Logout-Verifizierung.
Neue App-Registrierung anlegen
- Anmeldung im Azure Portal, weiter auf Microsoft Entra ID

- Neue
App-Registrierung→Neue Registrierungfür OIDC anlegen
- Anwendung benennen, Kontotyp Nur Konten in diesem Organisationsverzeichnis wählen und registrieren

Für die reine Anmeldung über OIDC sind keine zusätzlichen API-Berechtigungen und keine Administratorzustimmung nötig. Die Anwendungsberechtigungen für Microsoft Graph (z. B. User.Read.All) werden nur für die Verknüpfung mit Microsoft Entra ID → benötigt und dort eingerichtet.
Geheimen Clientschlüssel (Client Secret) unter Zertifikate & Geheimnisse hinzufügen
- Das benötigte Client Secret wird unter Ein Zertifikat oder Geheimnis hinzufügen erstellt

- Über Neuer geheimer Clientschlüssel kann die Beschreibung und Gültigkeitsdauer Gültig bis festgelegt werden

- Der Client Schlüssel kann direkt kopiert werden

Umleitungs-URI hinzufügen
Neu in 26.4Die Umleitungs-URI wird im Relution-Portal angezeigt sobald die Verbindung konfiguriert und gespeichert wurde.


Migrationshinweis — Scoped Redirect-URIs (ab 26.4.0). Mit 26.4.0 hat sich das Schema der Redirect-URIs geändert: Login-Callbacks sind nun scoped, sodass sie am Reverse-Proxy zukünftig pfadbasiert abgesichert werden können. Welche Redirect-URIs registriert werden müssen, hängt von der jeweiligen OIDC-Konfiguration ab: Ab 26.4 neu angelegte Konfigurationen verwenden immer die scoped Redirect-URIs. Konfigurationen, die vor 26.4 angelegt wurden, verwenden weiterhin die bisherige Redirect-URI (/login/oauth2/code/), bis sie auf die scoped Pfade umgestellt werden (siehe Bestehende Konfigurationen umstellen).
Ab 26.5.0 laufen außerdem die Logins während einer Geräte-Einschreibung (enrollment), im Relution Agent (agent), in Relution Assets (assets) und im Self-Service-Portal (selfService) über eigene Scopes. Nutzt die Konfiguration die scoped Pfade und werden diese Logins mit OIDC genutzt, müssen die zugehörigen URIs beim Identity Provider eingetragen sein.
Wo sie zu finden sind: Die Redirect-URIs für die jeweilige Instanz werden im Relution-Portal unter Einstellungen → Benutzerverwaltung → OpenID Connect in der Konfiguration im Abschnitt Geltungsbereichsbeschränkte OIDC URLs angezeigt, sobald die Verbindung gespeichert wurde, und lassen sich dort kopieren. Das Portal zeigt allerdings nur die Einträge Redirect-URL (management), Redirect-URL (device) und, mit Education-Lizenz, Redirect-URL (teacher) an. Die URIs für die Geräte-Einschreibung (/api/enrollment/), den Relution Agent (/api/agent/), Relution Assets (/api/assets/), das Self-Service-Portal (/api/selfService/) und Relution als Identity Provider → (/api/idp/) zeigt es derzeit nicht an. Sie werden nach dem unten aufgeführten Schema manuell ergänzt, soweit die jeweilige Funktion mit OIDC genutzt wird.
Bisherige Pfade (vor 26.4 angelegte Konfigurationen, eine Redirect-URI):
https://<host>/login/oauth2/code/<registrationId>
Scoped Pfade (ab 26.4 angelegte oder umgestellte Konfigurationen, alle zutreffenden registrieren):
https://<host>/api/management/login/oauth2/code/<registrationId> # Relution-Portal
https://<host>/api/enrollment/login/oauth2/code/<registrationId> # Geräte-Einschreibung (ADE, User Enrollment, Android Enterprise), ab 26.5
https://<host>/api/teacher/login/oauth2/code/<registrationId> # nur Education-Lizenz
https://<host>/api/agent/login/oauth2/code/<registrationId> # Relution Agent, ab 26.5
https://<host>/api/assets/login/oauth2/code/<registrationId> # Relution Assets, ab 26.5
https://<host>/api/selfService/login/oauth2/code/<registrationId> # Self-Service-Portal, ab 26.5
https://<host>/api/idp/login/oauth2/code/<registrationId> # Relution als Identity Provider (Beta), ab 26.5
https://<host>/api/device/login/oauth2/code/<registrationId> # nur 26.4.x, ab 26.5 von keinem Login mehr genutzt
Die <registrationId> ist die OIDC-Konfigurations-UUID, die in Relution angezeigt wird.
Logout-URLs: Zusätzlich zeigt das Portal im selben Abschnitt zwei Logout-URLs an. Sie sind keine Redirect-URIs:
- Logout-URL für Front-Channel:
https://<host>/api/management/v1/logout/connect/front-channel/<registrationId> - URL für Back-Channel-Logout:
https://<host>/api/management/logout/connect/back-channel/<registrationId>
Bestehende Konfigurationen umstellen
Konfigurationen, die vor 26.4 angelegt wurden, verwenden nach dem Update weiterhin die bisherige Redirect-URI. In der Konfiguration erscheint dann zusätzlich der Abschnitt OIDC bisherige URLs mit der aktuell aktiven Redirect-URL und der bisherigen URL für Back-Channel-Logout. Die Umstellung erfolgt in zwei Schritten:
- Alle zutreffenden scoped URIs werden zur bestehenden Entra App-Registrierung hinzugefügt. Die bisherige URI bleibt vorerst eingetragen.
- In Relution wird unter
Einstellungen→Benutzerverwaltung→OpenID Connectdie Konfiguration geöffnet, im Abschnitt OIDC bisherige URLs auf Bereichbeschränkte OIDC-Pfade aktivieren geklickt und der folgende Dialog bestätigt.
Bei neu angelegten Konfigurationen erscheint der Abschnitt nicht, da sie die scoped URIs von Anfang an verwenden. Die bisherige URI ist veraltet und kann in einer zukünftigen Version entfernt werden.
Redirect-URI für die Geräte-Einschreibung
Neu in 26.5Ab Relution 26.5.0 laufen alle Logins während einer Einschreibung über den eigenen Scope enrollment. Das betrifft die Automatische Geräteregistrierung (ADE, im Portal: DEP) von Apple, das Apple Account-Driven User Enrollment, die Android Enterprise Einschreibung sowie die Anmeldung im Android Enterprise DPC. Bei Konfigurationen mit scoped Pfaden funktionieren diese Logins nur, wenn die oben aufgeführte /api/enrollment/-URI beim Identity Provider registriert ist. Konfigurationen mit den bisherigen Pfaden nutzen auch für Einschreibungen weiterhin die bisherige URI.
Fehlerbild bei fehlender URI: Die Anmeldung am Relution-Portal funktioniert weiterhin, da sie über die /api/management/-URI läuft. Erst die Einschreibung eines Geräts schlägt fehl, beispielsweise die ADE-Einschreibung eines Mac mit der Meldung AADSTS50011: The redirect URI ... does not match. Tritt dieser Fehler bei einer Konfiguration mit scoped Pfaden während einer Einschreibung auf, fehlt die /api/enrollment/-URI in der Entra App-Registrierung.
Backchannel Logout
Relution unterstützt den Backchannel Logout.
Beispiel-Szenario: Ein Benutzer ist gleichzeitig über SSO bei mehreren Anwendungen angemeldet. Beim Logout vom SSO-Dienst sorgt der Backchannel Logout dafür, dass die Sitzungen in allen anderen Anwendungen ebenfalls beendet werden, auch wenn diese im Hintergrund laufen.
Voraussetzungen für Entra Benutzer für OIDC

Logout-Verifizierung
Vor der Inbetriebnahme werden die Logout-Pfade überprüft:
- Abmeldung beim IdP beim Ausloggen aus Relution: Nach Klick auf Ausloggen in Relution wird die Sitzung widerrufen. Der Browser wird nur dann zusätzlich zum Logout-Endpunkt des IdP weitergeleitet, wenn unter Erweiterte Optionen der Schalter Benutzer von OIDC abmelden, wenn er sich von Relution abmeldet aktiviert ist und ein Endpunkt zum Beenden der Sitzung bekannt ist. Da die Endpunkte für Entra manuell konfiguriert werden, muss dafür das Feld Endpunkt der Sitzung beenden ausgefüllt sein.
- Front-Channel-Logout: Meldet sich der Benutzer beim IdP ab, ruft der IdP die im Portal angezeigte Logout-URL für Front-Channel auf und Relution widerruft die Sitzung. Dafür muss diese URL beim IdP hinterlegt sein.
- Back-Channel-Logout: Der IdP sendet eine Logout-Benachrichtigung an die URL für Back-Channel-Logout — die Sitzung wird ohne Benutzerinteraktion widerrufen.
Durch Tests dieser Pfade wird sichergestellt, dass eine vom IdP initiierte Sitzungsbeendigung (z. B. über die IdP-Administrationskonsole) korrekt an Relution weitergegeben wird.