SSO-Anmeldung bei Drupal mit Microsoft Entra ID als OAuth/OpenID Connect-Anbieter
Übersicht
Die Drupal Microsoft Entra ID SSO-Integration ermöglicht es den Benutzern, sich mit den Microsoft Entra ID-Anmeldeinformationen bei der Drupal-Site anzumelden. Diese SSO-Integration wird erreicht durch die miniOrange OAuth-Client Modul, das das OAuth 2.0- und OpenID Connect (OIDC)-Protokoll verwendet. Dieses Modul ist mit Drupal 7, Drupal 8, Drupal 9, Drupal 10 und Drupal 11 kompatibel.
In diesem Dokument helfen wir Ihnen bei der Konfiguration der Single Sign-On-Anmeldung mit dem OAuth-Protokoll zwischen der Drupal-Site und der Microsoft Entra-ID.
Installationsschritte
- Alte Version
- New Version
- Verwenden von Composer
- Mit Drush
- Manuelle Installation
- Laden Sie das Modul herunter:
Composer benötigt 'drupal/miniorange_oauth_client'
- Navigieren Erweitern Menü auf Ihrer Drupal-Administratorkonsole und suchen Sie nach miniOrange OAuth-Client-Konfiguration über das Suchfeld.
- Aktivieren Sie das Modul, indem Sie das Kontrollkästchen aktivieren und auf klicken Installieren .
- Sie können das Modul konfigurieren unter:
{BaseURL}/admin/config/people/miniorange_oauth_client/config_clc
- Installieren Sie das Modul:
drush und drupal/miniorange_oauth_client
- Leeren Sie den Cache:
drush cr
- Sie können das Modul konfigurieren unter:
{BaseURL}/admin/config/people/miniorange_oauth_client/config_clc
Hinweis: Manuelle Installation nur kompatibel mit Drupal 7, Drupal 8 und Drupal 9.
- Navigieren Erweitern Menü auf Ihrer Drupal-Administratorkonsole und klicken Sie auf Neues Modul installieren.
- Installieren Sie Drupal OAuth- und OpenID Connect-Anmeldung – OAuth2-Client-SSO-Anmeldung Modul entweder durch Herunterladen der ZIP-Datei oder über die URL des Paket (tar/zip).
- Klicken Sie auf Aktivieren Sie neu hinzugefügte Module.
- Aktivieren Sie dieses Modul, indem Sie das Kontrollkästchen aktivieren und auf klicken installieren .
- Sie können das Modul konfigurieren unter:
{BaseURL}/admin/config/people/miniorange_oauth_client/config_clc
- Verwenden von Composer
- Mit Drush
- Manuelle Installation
- Laden Sie das Modul herunter:
Composer benötigt 'drupal/miniorange_oauth_client'
- Navigieren Erweitern Menü auf Ihrer Drupal-Administratorkonsole und suchen Sie nach miniOrange OAuth-Client-Konfiguration über das Suchfeld.
- Aktivieren Sie das Modul, indem Sie das Kontrollkästchen aktivieren und auf klicken Installieren .
- Sie können das Modul konfigurieren unter:
{BaseURL}/admin/config/people/mo-oauth-client/mo-client-config
- Installieren Sie das Modul:
drush und drupal/miniorange_oauth_client
- Leeren Sie den Cache:
drush cr
- Sie können das Modul konfigurieren unter:
{BaseURL}/admin/config/people/mo-oauth-client/mo-client-config
Hinweis: Manuelle Installation nur kompatibel mit Drupal 7, Drupal 8 und Drupal 9.
- Navigieren Erweitern Menü auf Ihrer Drupal-Administratorkonsole und klicken Sie auf Neues Modul installieren.
- Installieren Sie Drupal OAuth- und OpenID Connect-Anmeldung – OAuth2-Client-SSO-Anmeldung Modul entweder durch Herunterladen der ZIP-Datei oder über die URL des Paket (tar/zip).
- Klicken Sie auf Aktivieren Sie neu hinzugefügte Module.
- Aktivieren Sie dieses Modul, indem Sie das Kontrollkästchen aktivieren und auf klicken installieren .
- Sie können das Modul konfigurieren unter:
{BaseURL}/admin/config/people/mo-oauth-client/mo-client-config
Konfigurationsschritte
Konfigurieren Sie Drupal als OAuth-Client
- Gehe zu Konfiguration → Personen → miniOrange OAuth-Client-Konfiguration im Administrationsmenü. (/admin/config/people/miniorange_oauth_client)
- Wählen Sie unter der Registerkarte „OAuth konfigurieren“ den gewünschten OAuth-Anbieter aus der Dropdown-Liste aus.
Hinweis: Wenn der gewünschte OAuth-Anbieter nicht in der Dropdown-Liste aufgeführt ist, wählen Sie bitte Benutzerdefinierter OAuth-Anbieter / Benutzerdefinierter OpenID-Anbieter und fortsetzen.
- Kopieren Sie die Rückruf-/Umleitungs-URL und halten Sie es griffbereit. Dies wird bei der Konfiguration des OAuth-Anbieters benötigt.
- Geben Sie den Namen des OAuth-Providers in das Display Name Textfeld.
Hinweis: Wenn Ihr Anbieter nur HTTPS-Callback-/Redirect-URLs unterstützt und Sie eine HTTP-Site haben, aktivieren Sie bitte unten auf der Registerkarte das Kontrollkästchen „HTTPS-Callback-URL erzwingen“.
Konfigurieren Sie Drupal als OAuth-Client
- Gehe zu Konfiguration → Personen → miniOrange OAuth-Client im Administrationsmenü. (admin/config/people/mo-oauth-client/mo-client-config)
- Im Verwalten Abschnitt unter dem Client-Konfiguration Klicken Sie auf die Registerkarte + Neu hinzufügen Schaltfläche, um den gewünschten OAuth-Client zu konfigurieren.
- Unter dem Speichern Wählen Sie auf der Registerkarte „OAuth-Anwendung“ die gewünschte OAuth-Anwendung aus der Dropdown-Liste aus.
Hinweis: Wenn der gewünschte OAuth-Anbieter nicht in der Dropdown-Liste aufgeführt ist, wählen Sie bitte Benutzerdefinierter OAuth-Anbieter / Benutzerdefinierter OpenID-Anbieter und fortsetzen.
- Geben Sie den OAuth-Providernamen in das Feld Benutzerdefinierter App-Name Textfeld. Kopieren Sie die Rückruf-/Umleitungs-URL und halten Sie es griffbereit. Dies wird bei der Konfiguration des OAuth-Anbieters benötigt.
- Wenn Ihr Anbieter nur HTTPS-Callback/Redirect-URLs unterstützt und Sie eine HTTP-Site haben, überprüfen Sie bitte die HTTPS-Rückruf-URL erzwingen Kontrollkästchen in der Einstellungen Tab.
- Microsoft Azure-Portal
- Microsoft Entra-ID
SSO-Anwendung in Microsoft Entra ID erstellen:
- Melden Sie sich bei der Microsoft Azure Portal aus.
- Auswählen Microsoft Entra-ID von dem Azure-Dienste .
- Klicken Sie auf + hinzufügen Link, dann wählen Sie App Registrierung aus dem Dropdown-Menü.
- Im Registrieren Sie eine Anwendung Geben Sie im Fenster die folgenden Informationen ein:
- Name: Geben Sie den Anwendungsnamen ein.
- Unterstützte Kontotypen: Wählen Sie die 1. Option, Nur Konten in diesem Organisationsverzeichnis (Nur Test – Einzelmandant). Sie können sich auf die Auswahlhilfe Link.
- Weiterleitungs-URI (optional): Wählen Web von dem Wählen Sie eine Plattform Dropdown-Liste. Fügen Sie dann in das Textfeld die zuvor kopierteRückruf-/Umleitungs-URL.
- Klicken Sie auf Registrieren .
- Die Microsoft Entra ID weist Ihrer Anwendung eine eindeutige Anwendungs-ID zu. Kopiere das Anwendungs-ID (Client-ID).Das ist Ihr Kunden-ID.
- Klicken Sie nun auf Fügen Sie ein Zertifikat oder Geheimnis hinzu Link.
- Klicken Sie auf Neues Kundengeheimnis Taste. In dem Fügen Sie ein Client-Geheimnis hinzu Geben Sie im Popup die erforderlichen Informationen ein:
- Beschreibung: Geben Sie die Beschreibung für dieses Geheimnis ein.
- Läuft ab: Wählen Sie im Dropdown-Menü eine Ablaufdauer für dieses Geheimnis aus.
- Klicken Sie auf Speichern .
- Kopieren Sie die Wert von dem Kundengeheimnisse Tab. Das ist Client-Geheimnis.
- Navigieren Sie zu der Übersicht von der linken Seite.
- Der Essentials Abschnitt, kopieren Sie die Verzeichnis (Mieter) ID. Dies wird Ihre Mieter-ID sein.
Erstellen Sie eine SSO-Anwendung in Microsoft Entra ID:
- Melden Sie sich bei der Microsoft Entra-ID Portal aus.
- Auswählen App-Registrierungen aus der linken Navigationsleiste unter dem Anwendungen .
- Klicken Sie nun auf + Neue Registrierung .
- Im Registrieren Sie eine Anwendung Geben Sie im Fenster die folgenden Informationen ein:
- Name: Geben Sie den Anwendungsnamen ein.
- Unterstützte Kontotypen: Wählen Sie die 1. Option, Nur Konten in diesem Organisationsverzeichnis (Nur Test – Einzelmandant). Sie können sich auf die Auswahlhilfe Link.
- Weiterleitungs-URI (optional): Wählen Web von dem Wählen Sie eine Plattform Dropdown-Liste. Fügen Sie dann in das Textfeld die zuvor kopierte Rückruf-/Umleitungs-URL.
- Klicken Sie auf Registrieren .
- Die Microsoft Entra ID weist Ihrer Anwendung eine eindeutige Anwendungs-ID zu. Kopiere das Anwendungs-ID (Client-ID). Dies ist dein Kunden-ID.
- Klicken Sie nun auf Fügen Sie ein Zertifikat oder Geheimnis hinzu Link.
- Klicken Sie auf Neues Kundengeheimnis Taste. In dem Hinzufügen eines Client-Geheimnisses Geben Sie im Popup die erforderlichen Informationen ein:
- Beschreibung: Geben Sie die Beschreibung für dieses Geheimnis ein.
- Läuft ab: Wählen Sie im Dropdown-Menü eine Ablaufdauer für dieses Geheimnis aus.
- Klicken Sie auf Speichern .
- Kopieren Sie die Wert von dem Kundengeheimnisse Tab. Das ist Kundengeheimnis.
- Navigieren Sie zu der Übersicht von der linken Seite.
- Der Essentials Abschnitt, kopieren Sie die Verzeichnis (Mieter) ID. Dies wird Ihre Mieter-ID sein.
Integration von Drupal mit Microsoft Entra ID:
- Gehen Sie zum miniOrange OAuth-Clientmodul.
- Fügen Sie auf der Registerkarte „OAuth konfigurieren“ die kopierte Anwendungs-ID (Client-ID) und das Client-Geheimnis aus der Microsoft Entra-ID in das Kunden-ID kombiniert mit einem nachhaltigen Materialprofil. Kundengeheimnis Textfeld
- Ersetzen Sie das zuvor kopierte Verzeichnis (Mieter) ID an. Nach der Installation können Sie HEIC-Dateien mit der {Mieter-ID} in England, Endpunkt autorisieren kombiniert mit einem nachhaltigen Materialprofil. Zugriffstoken-Endpunkt Textfelder bzw.
| Geltungsbereich | openid-E-Mail-Profil |
| Endpunkt autorisieren: | https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize |
| Zugriffstoken-Endpunkt: | https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token |
| Endpunkt zum Abrufen von Benutzerinformationen: | https://graph.microsoft.com/oidc/userinfo |
- Klicken Sie auf Konfiguration speichern .
Integration von Drupal mit Microsoft Entra ID:
- Gehen Sie zum miniOrange OAuth-Clientmodul.
- In Speichern Registerkarte, fügen Sie die kopierte Kunden-ID kombiniert mit einem nachhaltigen Materialprofil. Kundengeheimnis von Microsoft Entra ID in der Kunden-ID kombiniert mit einem nachhaltigen Materialprofil. Kundengeheimnis Textfeld.
- Ersetzen Sie das zuvor kopierte Verzeichnis (Mieter) ID an. Nach der Installation können Sie HEIC-Dateien mit der {Mieter-ID} in England, Endpunkt autorisieren kombiniert mit einem nachhaltigen Materialprofil. Zugriffstoken-Endpunkt Textfelder bzw.
| Geltungsbereich | openid-E-Mail-Profil |
| Endpunkt autorisieren: | https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize |
| Zugriffstoken-Endpunkt: | https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token |
| Endpunkt zum Abrufen von Benutzerinformationen: | https://graph.microsoft.com/oidc/userinfo |
- Die Senden Sie die Client-ID und das Geheimnis im Header oder Body Mit dem Kontrollkästchen können Sie angeben, ob die Client-ID und das Geheimnis im Header oder im Text der Token-Endpunktanforderung enthalten sein sollen. Wenn Sie sich nicht sicher sind, welche Option Sie auswählen sollen, können Sie die Standardeinstellungen beibehalten.
- Klicken Sie auf das Kontrollkästchen, um Aktivieren Sie die Anmeldung mit OAuth, scrollen Sie nach unten und klicken Sie auf Konfiguration speichern .
Testen der Verbindung zwischen Drupal und OAuth-Anbieter
- Nachdem Sie die Konfigurationen erfolgreich gespeichert haben, klicken Sie bitte auf Testkonfiguration durchführen Schaltfläche, um die Verbindung zwischen Drupal und OAuth-Provider zu testen.
- Wenn Sie im selben Browser keine aktiven Sitzungen haben, werden Sie in einem Popup zur Testkonfiguration aufgefordert, sich beim OAuth-Anbieter anzumelden. Nach erfolgreicher Anmeldung erhalten Sie eine Liste der vom OAuth-Anbieter erhaltenen Attribute.
- Wähle aus E-Mail-Attribut aus dem Dropdown-Menü, in dem die E-Mail-ID des Benutzers abgerufen wird, und klicken Sie auf die Erledigt .
Hinweis: Die Zuordnung des E-Mail-Attributs ist obligatorisch, um SSO durchzuführen, d. h. sich mit den Anmeldeinformationen des OAuth-Anbieters bei der Drupal-Site anzumelden.
- Auf dem Attribut- und Rollenzuordnung Wählen Sie bitte die Registerkarte aus Benutzernamensattribut aus der Dropdown-Liste und klicken Sie auf das Konfiguration speichern .
- Melden Sie sich nun ab und rufen Sie die Anmeldeseite Ihrer Drupal-Site auf. Dort finden Sie automatisch einen Link zur Anmeldung mit OAuth-Provider. Wenn Sie den SSO-Link auch auf anderen Seiten hinzufügen möchten, folgen Sie bitte den Schritten im folgenden Bild:
Testen der Verbindung zwischen Drupal und OAuth-Anbieter
- Nachdem Sie die Konfigurationen erfolgreich gespeichert haben, klicken Sie auf Testkonfiguration durchführen Schaltfläche, um die Verbindung zwischen Drupal und OAuth-Provider zu testen.
- Wenn Sie im selben Browser keine aktiven Sitzungen haben, werden Sie in einem Popup zur Testkonfiguration aufgefordert, sich beim OAuth-Anbieter anzumelden. Nach erfolgreicher Anmeldung erhalten Sie eine Liste der vom OAuth-Anbieter erhaltenen Attribute.
- Klicken Sie auf Zuordnungen konfigurieren .
- Auf dem Attributzuordnung Wählen Sie bitte die Registerkarte aus E-Mail-Attribut kombiniert mit einem nachhaltigen Materialprofil. Benutzernamensattribut aus der Dropdown-Liste und klicken Sie auf Konfiguration speichern .
Hinweis: Die Zuordnung des E-Mail-Attributs ist obligatorisch, um SSO durchzuführen, d. h. sich mit den Anmeldeinformationen des OAuth-Anbieters bei der Drupal-Site anzumelden.
- Melden Sie sich nun ab und rufen Sie die Anmeldeseite Ihrer Drupal-Site auf. Dort finden Sie automatisch einen Link zur Anmeldung mit OAuth-Provider. Wenn Sie den SSO-Link auch auf anderen Seiten hinzufügen möchten, folgen Sie bitte den Schritten im folgenden Bild:
Brauchen Sie Hilfe?
Wenn bei der Konfiguration Probleme auftreten oder Sie zusätzliche Funktionen wünschen, kontaktieren Sie uns bitte unter drupalsupport@xecurify.com.
Zusatzfunktionen:
-
Attributzuordnung - Ordnen Sie vom OAuth-Anbieter empfangene Benutzerattribute den Drupal-Feldern zu.
-
Rollenzuordnung - Weisen Sie Benutzern eine Drupal-Rolle auf der Grundlage ihrer Rolle/ihres Attributs beim OAuth-Anbieter zu.
-
Einmalige Abmeldung aktivieren - Benutzer vom OAuth-Anbieter (z. B. AWS Cognito, Azure AD B2C, Keycloak, Okta) abmelden, wenn sie sich von Drupal abmelden.
-
Beschränken Sie den anonymen Zugriff auf die gesamte Site oder einen bestimmten Abschnitt der Site
-
Fügen Sie mehrere OAuth-Angebote hinzu
-
Entdecken Sie alle vom OAuth-Client angebotenen Funktionen
Fehlerbehebung:
Weitere FAQs ➔Fehlermeldung: „Benutzername nicht erhalten. Überprüfen Sie Ihre Attributzuordnungskonfiguration.“ ODER Fehlermeldung: „E-Mail nicht erhalten. Überprüfen Sie Ihre Attributzuordnungskonfiguration.“
Befolgen Sie die genannten Schritte Mehr erfahren!
Ich erhalte die Meldung „Client-Anmeldeinformationen wurden weder in den Kopfzeilen noch im Textkörper gefunden“
wenn ich versuche, eine Testkonfiguration durchzuführen
Befolgen Sie die genannten Schritte Mehr erfahren!
Nachdem ich in Drupal auf Abmelden geklickt habe, werde ich zurück zur Drupal-Startseite geleitet. Wenn ich jedoch versuche, mich mit einem anderen Benutzer anzumelden, werde ich nicht aufgefordert, mich anzumelden, sondern werde automatisch mit demselben Benutzer angemeldet.
Die Abmeldefunktion, die Sie hier erwähnt haben, ist das Standardverhalten eines Moduls. Sie meldet Sie von Drupal ab, aber nicht von Ihrer Anwendung/Ihrem Anbieter. Um dem Modul die Abmeldung von Ihrem Anbieter-/Anwendungskonto zu ermöglichen (was Sie suchen), müssen Sie die folgenden Konfigurationen vornehmen: [mehr wissen]
Ich habe das kostenpflichtige Drupal-Modul gekauft und es durch das kostenlose Modul ersetzt, kann die kostenpflichtigen Funktionen jedoch immer noch nicht nutzen.
Da Sie auf eine unserer kostenpflichtigen Versionen des Drupal-Moduls aktualisiert und das kostenlose Modul durch das kostenpflichtige ersetzt haben, müssen Sie zuerst das kostenpflichtige Modul aktivieren. Bitte beachten Sie die folgenden Schritte. [WEITERE INFORMATIONEN ]
24/7-Unterstützung
Die Drupal-Entwickler bei miniOrange bieten schnellen und aktiven Support bei Ihren Fragen. Wir unterstützen Sie bei der Auswahl der besten Lösung für Ihren Anwendungsfall.
Fallstudien
miniOrange hat mit seinen äußerst flexiblen/anpassbaren Drupal-Lösungen die Anwendungsfälle von über 400 vertrauenswürdigen Kunden erfolgreich umgesetzt.
Andere Lösungen
Entdecken Sie gerne auch die anderen von uns angebotenen Drupal-Lösungen. Zu den beliebten Lösungen unserer treuen Kunden zählen 2FA, User Provisioning und Website Security.

Kontaktieren Sie uns