Einrichten der Authentifizierung externer Identitätsanbieter in Drupal

Die Authentifizierungsmethode mit externen Identitätsanbietern ermöglicht es Ihnen, den Zugriff auf Ihre Drupal REST-APIs mithilfe von Tokens von Drittanbietern wie Google, Azure AD, Keycloak, Okta oder GitLab zu sichern und einzuschränken. Durch die Integration Ihres Identitätsanbieters stellt diese Methode sicher, dass nur authentifizierte Benutzer auf Ihre Drupal-APIs zugreifen können. Das in dieser Methode verwendete Zugriffstoken wird ausschließlich von einem externen Identitätsanbieter (IdP) bezogen. Das Drupal-API-Authentifizierungsmodul unterstützt Drupal 8, 9, 10 und 11.

Konfigurationsschritte

1. Richten Sie die Authentifizierungsmethode des externen Identitätsanbieters ein:

• In diesem Schritt richten wir ein Externer Identitätsanbieter als API-Authentifizierung. Navigieren Sie dazu zum API-Authentifizierung Registerkarte des Moduls (/admin/config/people/rest_api_authentication/auth_settings).
• Der Grundlegende Einstellung, aktivieren Sie die Aktivieren Sie die Authentifizierung Umschalten.
• Geben Sie die Anwendungsname und wählen Sie Externer Identitätsanbieter von der Authentifizierungsmethode .

• Scrollen Sie nach unten zum Konfiguration des externen Identitätsanbieters Abschnitt auf derselben Registerkarte.
• Geben Sie die Benutzerinfo-Endpunkt Ihres Identitätsanbieters in das angegebene Feld ein, damit das Modul mithilfe des bereitgestellten Tokens Benutzerdetails abrufen kann.
• Im BenutzernamensattributGeben Sie den Attributschlüssel oder Namen Ihres Identitätsanbieters ein, der den vom externen Anbieter gesendeten Benutzernamen enthält.
• Klicken Sie auf die Konfiguration speichern .

• Sie haben die Methode „Externer Identitätsanbieter“ erfolgreich konfiguriert.


Hinweis: Verwenden Sie den anwendungsspezifischen eindeutigen Header bei der Authentifizierung der API.

Erteilen von Rollenberechtigungen zum Erstellen von Benutzern

• Bei Bedarf können Sie auch Benutzern ohne Administratorrechte das Erstellen von Benutzern in Drupal erlauben. Weisen Sie dazu den gewünschten Rollen auf der Seite „Berechtigungen“ (/admin/people/permissions) Ihrer Drupal-Site die Berechtigung „Benutzer verwalten“ zu.

2. Beispiel:

• Zum besseren Verständnis betrachten wir als Beispiel das Hinzufügen einer auf externen Identitätsanbietern basierenden Authentifizierung zur API zum Erstellen von Benutzern in Drupal.


Hinweis: Die /entity/user API in Drupal wird verwendet, um einen neuen Benutzer anzulegen.



• Um einen Benutzer in Drupal zu erstellen, senden Sie eine POST-Anfrage zusammen mit dem Token, das Sie von Ihrem Identitätsanbieter erhalten haben.

HTML-Anforderungsformat – Anforderung: POST /entity/user?_format=json Header: AUTH-METHOD: Anwendungs-ID Token: Akzeptieren: application/json Inhaltstyp: application/json Text: { "Name": { "Wert": " " }, "mail": { "value": " " }, "pass": { "value": " " }, "status": { "value": "1" } } CURL-Anforderungsformat - curl --location --request POST ' /entity/user?_format=json' \ --header 'AUTH-METHOD: Anwendungs-ID' \ --header 'Token: ' \ --header 'Akzeptieren: application/json' \ --header 'Inhaltstyp: application/json' \ --data-raw ' { "name": [ { "value": "Benutzername" } ], "mail": [ { "value": "email" } ], "pass": [ { "value": "Passwort" } ], "status": [ { "value": "1" } ] }

• Sie können sich auch auf das unten gezeigte Postman-Anforderungsbild beziehen.

• Bei einer erfolgreichen Antwort werden die Details des von Ihnen erstellten Benutzers zurückgegeben (siehe Abbildung unten).

Herzlichen Glückwunsch! Sie haben die Methode „Externer Identitätsanbieter“ mithilfe des Drupal-API-Authentifizierungsmoduls erfolgreich eingerichtet.

Falls die Konfiguration nicht erfolgreich war, kontaktieren Sie uns bitte unter drupalsupport@xecurify.com . Bitte fügen Sie einen Screenshot des Fehlerfensters bei. Wir helfen Ihnen gerne bei der Problemlösung und unterstützen Sie bei der Einrichtung.