メールによるパスワードレス認証

メール認証要素を使用したパスワードレス接続の使い方を説明します。

パスワードレス接続を設定すると、認証を完了するためのワンタイムパスワード (OTP) をユーザーにメールで送信できます。

詳しくは、パスワードレス認証用の Email または SMS を設定するをご覧ください。

​

仕組み

新規ユーザーが OTP を受け取り、初めてあなたのウェブサイトでその OTP を入力すると、Auth0 による認証前に、そのユーザーのユーザープロファイルが email 接続上に作成されます。

OTP の送信先メールアドレスが既存ユーザーのものと一致する場合、Auth0 はそのユーザーを認証します:

​

埋め込みログイン

​

Universal Login

​

接続を設定する

1. Auth0 Dashboard > Authentication > パスワードレス に移動し、Email トグルを有効にします。

2. Email を選択して設定ウィンドウを開き、設定ビューに切り替えてから、メールの From、件名、Message テキストを入力します。

   Auth0 でカスタムメールテンプレートを送信するには、From の値を auth0.com ドメイン以外のメールアドレスに変更する必要があります。変更しない場合、Auth0 はデフォルトのメールテンプレートを送信します。

3. OTP Expiry と OTP Length を設定します。

   • 発行された OTP (またはリンク) のうち、有効なのは最新のものだけです。新しいものが発行されると、それ以前のものはすべて無効になります。また、最新のものも一度使用すると無効になります。
   • OTP の入力に失敗できる回数は 3 回までです。3 回失敗すると、新しいコードをリクエストする必要があります。
   • 発行された OTP の有効期間は、デフォルトで 3 分です。
   • OTP の有効期限を延ばす場合は、OTP の長さも長くする必要があります。そうしないと、攻撃者が短いコードを推測するための猶予が大きくなります。

4. Disable Sign Ups を有効にするかどうかを決定します。この設定を有効にすると、既存ユーザーにのみパスワードレスアクセスを許可できますが、アプリケーションがユーザー列挙攻撃にさらされる可能性があります。詳しくは、パスワードレス接続のベストプラクティス を参照してください。

5. Save を選択します。

​

多言語サポート

Message エリアは複数の言語に対応しています。

言語を指定するには、Auth0 Authentication API Get Code or Link endpoint を呼び出し、x-request-language ヘッダーの値を設定します。このヘッダーが設定されていない場合、言語はブラウザーによって自動的に設定される accept-language ヘッダーから取得されます。

​

Message の構文

Message 欄では Liquid 構文を使用できます。この構文をパラメーター値と組み合わせることで、メッセージの要素を動的に作成できます。

たとえば、request_language パラメーターを参照して、メッセージの言語を変更できます。

{% if request_language contains 'dutch' %}
   Hier is uw verificatie code: {{ code }}
{% endif %}
{% if request_language contains 'fr-FR' %}
   Ceci est votre code: {{ code }}
{% endif %}

メッセージテンプレートの定義時に使用できるパラメーターは次のとおりです。

Parameter	Description
code	使用するパスワード。
link	生成されたサインインリンク。
application.name	ユーザーがサインアップに使用しているアプリケーションの名前。
request_language	メッセージ内容に対してリクエストされた言語。
operation	API を介したユーザーのメールアドレス更新によってテンプレートがトリガーされたかどうかを示します。トリガーされた場合、値は change_email、それ以外の場合は null です。

ユーザーが 組織 経由でログインしている場合は、次のパラメーターも使用できます。

• organization.id
• organization.display_name
• organization.name
• organization.metadata
• organization.branding.logo_url
• organization.branding.colors.primary
• organization.branding.colors.page_background

これらのパラメーターとその値の詳細については、Auth0 の Management API の Get organization エンドポイントを参照してください。

​

アプリケーションを有効にする

アプリケーションビューに切り替え、Passwordless Email を使用するアプリケーションを有効にします。

​

メールプロバイダー

Auth0 はデフォルトで独自の SMTP プロバイダーを使用してメールを送信します。Auth0 に組み込まれているメールプロバイダーはテスト専用であり、メールテンプレートのカスタマイズには対応していません。

独自の SMTP メールプロバイダーを設定すると、メール送信の管理、監視、トラブルシューティングに加え、メールテンプレートのカスタマイズも行えます。

Auth0 では、次のメールプロバイダーをサポートしています。

• Mandrill
• Amazon SES
• Azure Communication Services
• SendGrid
• SparkPost
• Mailgun
• カスタム SMTP 外部メールプロバイダー