2FAメールテンプレートの使用

2 要素認証 (2FA) API を電子メールで使用すると、ユーザーの好みや認証の可用性に合わせて別のオプションをユーザーに提供できます。2FA API は PIN を生成し、要求された受信者の電子メールに送信して、検証できるようにします。

Email を認証チャネルとして使用すると、次の利点があります。

メールベースの2FA（二要素認証）を設定するプロセスには、次のものが含まれます。

始める前に、次のものがあることを確認してください。

2FA API の設定の詳細については、一般的な 2FA (OTP) の設定を参照してください。

ブロードキャストテンプレートを設定する

電子メールの 2FA サービスを有効にするには、まずブロードキャストテンプレートを作成する必要があります。

Web インターフェースにログインし、Moments → [Templates (テンプレート)] に移動します。
**[Content Email Templates (コンテンツメールテンプレート)]をクリックし、[Create Template (テンプレートを作成)]**をクリックします。
- テンプレートには、PIN が表示される "pin" プレースホルダー {$pin} を含めます。
- または、People → [Configuration (設定)] → [Person Custom Attributes (個人のカスタム属性)] で "pin" というカスタム属性を作成します。
- コンテンツを作成するときは、プレースホルダーメニュー から PIN を入力してオートコンプリート機能を使用し、PIN プレースホルダーを作成します。
[Save Content Template (コンテンツテンプレートを保存)] をクリックします。
Moments → [Templates (テンプレート)] に戻り、[Broadcast Templates (ブロードキャストテンプレート)] をクリックします。
- 右上隅で、チャネルを [Email (メール)] に変更します。
- [Content (コンテンツ)] セクションで、[Choose a Template (テンプレートを選択)] を選択します。
- 作成したコンテンツメールテンプレート を追加します。
[Save Broadcast Template (ブロードキャストテンプレートを保存)] をクリックします。

大事な

ブロードキャストテンプレート番号をメモします。たとえば、#350140 です。

このサービスには、2FA PIN コードを電子メールで送信できるようにするエンドポイントが 2 つあります。

2FA（二要素認証）アプリケーション (opens in a new tab)の作成: POST /2fa/2/applications
2FA メールメッセージテンプレートを作成します。emailTemplateId はブロードキャストテンプレート番号 (例: #350140) であることに注意してください。
json
```
 
   POST  /2fa/2/applications/{appId}/email/messages
      {
      "pinType": "NUMERIC",
      "pinLength": 4,
      "emailTemplateId": 350140
      }
 
```
POST /2fa/2/pin/emailを使用して、2FA（二要素認証）PINコードを電子メールで送信します( PINコードを電子メールで送信2FA（二要素認証） (opens in a new tab)を参照)。
POST /2fa/2/pin/\{pinId\}/verifyを使用して2FA（二要素認証）PINを確認します( 「リクエストの確認」 (opens in a new tab)を参照)。