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

概要

堅牢な 2 要素認証 (XNUMXFA) を使用してヘッドレス/分離型 Drupal を保護します。 Drupal 2要素認証 - XNUMXFA / パスワードレスログインこのガイドは、ヘッドレスDrupalサイトの2要素認証（2FA / MFA）を構成するのに役立ちます。Drupal XNUMXFAモジュールは、DrupalアカウントにXNUMX番目の認証レイヤーを追加し、望ましくないハッキングや不正なログイン試行からサイトのセキュリティを強化します。Drupal 2要素認証 - XNUMXFA / パスワードレスログイン Drupal 7、Drupal 8、Drupal 9、Drupal 10、Drupal 11 で利用できます。

構成手順

Drupal ヘッドレス 2FA のセットアップ

• に移動します ヘッドレス2FA タブには何も表示されないことに注意してください。
• ソフトウェアの制限をクリック ヘッドレス XNUMX 要素を有効にする トグルボタンを使用して、ヘッドレス/デカップルド 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 ログを確認してください。