Anleitung für MS Integrator » History » Version 2
Matthias Uhde, 07/06/2026 03:07 PM
| 1 | 1 | Matthias Uhde | # Anleitung für MS Integrator |
|---|---|---|---|
| 2 | 2 | Matthias Uhde | Einrichtung von Microsoft Entra ID (OIDC) für Redmine Single Sign-on |
| 3 | Guten Tag, |
||
| 4 | 1 | Matthias Uhde | |
| 5 | 2 | Matthias Uhde | wir möchten unsere Redmine-Installation künftig über Microsoft 365 authentifizieren, sodass sich unsere Mitarbeiter mit ihrem bestehenden Microsoft-Konto anmelden können (Single Sign-on). |
| 6 | |||
| 7 | Dazu benötigen wir die Einrichtung einer OpenID-Connect-Anwendung (OIDC) in Microsoft Entra ID. |
||
| 8 | |||
| 9 | Bitte führen Sie die folgenden Schritte durch: |
||
| 10 | |||
| 11 | 1 | Matthias Uhde | Eine neue App-Registrierung in Microsoft Entra ID erstellen |
| 12 | Name: Redmine |
||
| 13 | Unterstützte Kontotypen: Nur Konten in dieser Organisation (Single Tenant) |
||
| 14 | Redirect URI konfigurieren |
||
| 15 | Typ: Web |
||
| 16 | Die genaue Redirect-URI teilen wir nach Installation des OIDC-Plugins mit. |
||
| 17 | Voraussichtlich wird sie folgendes Format haben: |
||
| 18 | 2 | Matthias Uhde | https://redmine.<unsere-domain>/auth/openid_connect/callback |
| 19 | 1 | Matthias Uhde | Client Secret erstellen |
| 20 | 2 | Matthias Uhde | Gültigkeit gemäß Ihren Sicherheitsrichtlinien (z. B. 12 oder 24 Monate) |
| 21 | 1 | Matthias Uhde | Bitte den Secret-Wert sicher an uns übermitteln. |
| 22 | Folgende Informationen benötigen wir: |
||
| 23 | Tenant ID |
||
| 24 | Application (Client) ID |
||
| 25 | Client Secret |
||
| 26 | 2 | Matthias Uhde | |
| 27 | 1 | Matthias Uhde | API-Berechtigungen |
| 28 | Bitte folgende Microsoft Graph-Berechtigungen als Delegated Permissions hinzufügen: |
||
| 29 | 2 | Matthias Uhde | |
| 30 | 1 | Matthias Uhde | openid |
| 31 | profile |
||
| 32 | |||
| 33 | User.Read |
||
| 34 | 2 | Matthias Uhde | |
| 35 | Weitere Berechtigungen sind zunächst nicht erforderlich. |
||
| 36 | |||
| 37 | 1 | Matthias Uhde | Benutzerzugriff |
| 38 | Die Anwendung soll nur von Benutzern unserer Organisation verwendet werden. |
||
| 39 | Falls gewünscht, kann der Zugriff zusätzlich auf eine bestimmte Benutzergruppe beschränkt werden. |
||
| 40 | Optional (empfohlen) |
||
| 41 | Falls Gruppeninformationen später für die Rollenvergabe in Redmine genutzt werden sollen, bitten wir darum, Gruppen-Claims im ID-Token zu aktivieren. |
||
| 42 | 2 | Matthias Uhde | |
| 43 | 1 | Matthias Uhde | Nach der Einrichtung benötigen wir folgende Informationen: |
| 44 | 2 | Matthias Uhde | |
| 45 | 1 | Matthias Uhde | Tenant ID |
| 46 | Client ID |
||
| 47 | Client Secret |
||
| 48 | Issuer-URL (falls abweichend vom Standard) |
||
| 49 | Bestätigung der konfigurierten Redirect URI |
||
| 50 | 2 | Matthias Uhde | |
| 51 | 1 | Matthias Uhde | Die eigentliche Konfiguration der Redmine-Anwendung übernehmen anschließend wir. |
| 52 | 2 | Matthias Uhde | |
| 53 | 1 | Matthias Uhde | Vielen Dank! |