Richten Sie 2FA/MFA für Headless/Entkoppeltes Drupal ein

Übersicht

Schützen Sie Ihre Headless-/Decoupled-Drupal-Website mit einer robusten Zwei-Faktor-Authentifizierung (2FA) mithilfe der Drupal-Zwei-Faktor-Authentifizierung – 2FA / Passwortlose Anmeldung . Diese Anleitung hilft Ihnen bei der Konfiguration der Zwei-Faktor-Authentifizierung (2FA/MFA) für Ihre Headless-Drupal-Website. Das Drupal-2FA-Modul fügt Ihrem Drupal-Konto eine zweite Authentifizierungsebene hinzu und erhöht so die Sicherheit Ihrer Website vor unerwünschten Hacks und unberechtigten Anmeldeversuchen. Die Drupal- Zwei-Faktor-Authentifizierung – 2FA / Passwortlose Anmeldung ist für Drupal 7, Drupal 8, Drupal 9, Drupal 10 und Drupal 11 verfügbar.

Konfigurationsschritte

Drupal Headless 2FA einrichten

• Navigieren Sie zu der Headless-Unterstützung Tab.
• Aktivieren Sie die Aktivieren Sie Headless Two-Factor Umschaltknopf im Headless/Entkoppelte 2FA-Konfiguration Abschnitt zur Aktivierung des Headless/Decoupled 2FA-Dienstes.

• Wählen Sie die Authentifizierungsmethode von aus 2FA-Methode Dropdown-Liste.

• Wähle aus Feld „Telefonnummer auswählen“ aus dem Dropdown-Menü. Sie können auf den Link in der Notiz klicken, um die verfügbaren Felder auf der Drupal-Website zu überprüfen.
• Klicken Sie auf Einstellungen speichern .

Schritte zur Integration von Headless/Entkoppelter 2FA:

• Mindestanforderung für die Integration von 2FA mit Drupal:
• Anmeldeseite: Mit Feldern für Benutzername und Passwort
• OTP-Seite: Mit OTP-Feldern

Benutzer werden durch Senden von Benutzername und Passwort authentifiziert.

• Der erste Schritt besteht darin, Benutzer zu authentifizieren, indem Sie Benutzernamen und Passwort an senden /headless/authentifizieren Endpunkt (API), damit sie sich bei der Drupal-Datenbank authentifizieren können. Sobald der Benutzer erfolgreich authentifiziert wurde, wird das OTP an das registrierte Mobiltelefon/die E-Mail-Adresse gesendet (abhängig von der Konfiguration).

  API: POST {drupal-base-URL}/headless/authenticate.
  Was Sie senden werden:
  {"Benutzername": "xxxxx", Passwort: "xxxxx", apiKey: "xxxxx"}
  Bei Erfolg erhalten Sie folgende Antwort zurück:
  {"username": "xxxxx", "status": ERFOLGREICH, "message": "xxxxx", "transactionID": "xxxxx", "authType": "xxxxx"}
  

• Mit folgenden Parametern:
  

PARAMETER	TYP	ERFORDERLICH?	BESCHREIBUNG
Benutzername	Schnur	falls angefordert	Wird vom Benutzer im Anmeldeformular eingegeben.
Passwort	Schnur	falls angefordert	Wird vom Benutzer im Anmeldeformular eingegeben.
API-Schlüssel	Schnur	falls angefordert	Senden Sie den im Modul bereitgestellten APIKey.

Validieren Sie den Benutzer, indem Sie OTP senden

• Der zweite Schritt besteht darin, den Benutzer durch Senden eines OTP (Einmalpasscode) an zu validieren /headless/login Endpunkt (API).

  API: POST {drupal-base-URL}/headless/login
  Was Sie senden werden:
  {"username": "xxxxx", "transactionID": "xxxxx", "authType": "xxxxx", "otp": "xxxxx", "apiKey": "xxxxx"}
  Bei Erfolg erhalten Sie folgende Antwort zurück:
  {"Benutzername": "xxxxx", "Status": ERFOLGREICH, "Nachricht": "xxxxx", "Benutzerprofil": "xxxxx"}
  

• Mit folgenden Parametern:

PARAMETER	TYP	ERFORDERLICH?	BESCHREIBUNG
Benutzername	Schnur	falls angefordert	Sie erhalten dies als Antwort auf den ersten API-Aufruf.
Transaktions-ID	Schnur	falls angefordert	Sie erhalten dies als Antwort auf den ersten API-Aufruf.
Authentifizierungstyp	Schnur	falls angefordert	Sie erhalten dies als Antwort auf den ersten API-Aufruf.
oTP	Schnur	falls angefordert	Sie erhalten dies als Antwort auf den ersten API-Aufruf.
API-Schlüssel	Schnur	falls angefordert	Senden Sie den im Modul bereitgestellten APIKey.

Mögliche Fehler

FEHLERCODE	BESCHREIBUNG
400 Authentifizierung fehlgeschlagen	API-Authentifizierung fehlgeschlagen
404 Not Found	Die Headless 2FA-Einstellung ist nicht aktiviert. Bitte aktivieren Sie dasselbe auf der Registerkarte Headless 2FA Setup des Moduls.
401 Nicht autorisiert	Der Benutzer hat ungültige Anmeldeinformationen eingegeben (Benutzername/Passwort).
403 Verboten	Der Benutzer hat das falsche OTP (Einmalpasswort) eingegeben.
500 Internal Server Error	Aus verschiedenen Gründen erhalten Sie die Meldung „500 Internal Server Error“. Weitere Informationen finden Sie in den Drupal-Protokollen.