ヘッドレス/分離型 Drupal の 2FA/MFA のセットアップ

概要

堅牢な 2 要素認証 (XNUMXFA) を使用してヘッドレス/分離型 Drupal を保護します。 Drupalの二要素認証 - 2FA / パスワードなしログインこのガイドでは、ヘッドレス Drupal サイトの二要素認証 (2FA / MFA) の設定について説明します。Drupal 2FA モジュールは、Drupal アカウントに第二の認証レイヤーを追加し、不要なハッキングや不正ログインの試みからサイトのセキュリティを強化します。 二段階認証 - 2FA / パスワードなしログイン Drupal 7、Drupal 8、Drupal 9、Drupal 10、Drupal 11 で利用できます。

構成手順

Drupal Headless 2FAの設定

• に移動します ヘッドレスサポート タブには何も表示されないことに注意してください。
• 有効にします ヘッドレス XNUMX 要素を有効にする トグルボタン ヘッドレス/デカップルド2FA設定 ヘッドレス/デカップルド2FAサービスを有効にするためのセクション。

• 認証方法を次から選択します 2FA法 ドロップダウン。

• まず 電話番号フィールドを選択 ドロップダウンメニューから選択してください。Drupalサイトで利用可能なフィールドを確認するには、注記にあるリンクをクリックしてください。
• 以下を行うには、 [設定の保存]

ヘッドレス/分離型 2FA を統合する手順:

• 2FA と Drupal を統合するための最小要件:
• ログインページ: ユーザー名とパスワードのフィールドがある
• OTP ページ: OTP フィールドがある

ユーザー名とパスワードを送信してユーザーを認証します

• 最初のステップは、ユーザー名とパスワードを送信してユーザーを認証することです。 /headless/認証 エンドポイント (API) を使用して、Drupal データベースに対して認証できるようにします。 ユーザーが正常に認証されると、OTP が登録された携帯電話/電子メールに送信されます (設定に応じて)。

  API: POST {drupal-base-URL}/headless/authenticate.
  お送りするもの:
  {"ユーザー名":"xxxxx"、"パスワード":"xxxxx"、"apiKey":"xxxxx"}
  成功すると、次の応答が返されます。
  {"ユーザー名":"xxxxx"、"ステータス":"成功"、"メッセージ":"xxxxx"、"トランザクションID":"xxxxx"、"authType":"xxxxx"}
  

• 次のパラメータを使用します。
  

パラメータ	タイプ	必須？	DESCRIPTION
ユーザ名	string		ユーザーがログインフォームに入力します。
password	string		ユーザーがログインフォームに入力します。
APIキー	string		モジュールで提供される apiKey を送信します。

OTP を送信してユーザーを検証する

• XNUMX 番目のステップは、OTP (ワンタイム パスコード) を送信してユーザーを検証することです。 /ヘッドレス/ログイン エンドポイント (API)。

  API: POST {drupal-base-URL}/headless/login
  お送りするもの:
  {"ユーザー名":"xxxxx"、"トランザクションID":"xxxxx"、"authType":"xxxxx"、"otp":"xxxxx"、"apiKey":"xxxxx"}
  成功すると、次の応答が返されます。
  {"ユーザー名":"xxxxx"、"ステータス":"成功"、"メッセージ":"xxxxx"、"ユーザープロフィール":"xxxxx"}
  

• 次のパラメータを使用します。

パラメータ	タイプ	必須？	DESCRIPTION
ユーザ名	string		これは、最初の API 呼び出しに応答して取得されます。
トランザクションID	string		これは、最初の API 呼び出しに応答して取得されます。
認証タイプ	string		これは、最初の API 呼び出しに応答して取得されます。
otp	string		これは、最初の API 呼び出しに応答して取得されます。
APIキー	string		モジュールで提供される apiKey を送信します。

考えられるエラー

エラーコード	DESCRIPTION
400 認証に失敗しました	API認証に失敗しました
404が見つかりません	ヘッドレス 2FA 設定が有効になっていません。 モジュールの [ヘッドレス 2FA セットアップ] タブで同じ設定を有効にしてください。
401未承認	ユーザーが無効な認証情報 (ユーザー名/パスワード) を入力しました
禁断403	ユーザーが間違った OTP (ワンタイム パスコード) を入力しました
500内部サーバーエラー	さまざまな理由により 500 Internal Server Error が発生します。詳細については Drupal ログを確認してください。