マジックリンクを使用したパスワードレス認証

マジックリンク認証要素を使用するパスワードレス接続の設定方法を学びます。

パスワードレス接続を設定すると、認証を完了するためのマジックリンクをメールでユーザーに送信できます。

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

​

仕組み

ユーザーがマジックリンクを開くと、Auth0によってそのままログインされます。これは、ワンタイムパスワード (OTP) が記載されたメールを受け取り、アプリケーションに戻ってOTPを入力するのと機能的には似ていますが、実際にそれらの手順を行う必要はありません。

​

制限事項

マジックリンク は、Universal Login ではサポートされていません。

クラシックログインで マジックリンク を使用する場合、最初のリクエストとその応答は、どちらも同じブラウザー内で行われる必要があります。そうでないと、トランザクションは失敗します。これは、デフォルトの Web ブラウザーを変更できない iOS ユーザーにとって特に重要です。

たとえば、ユーザーが最初のリクエストを Chrome ブラウザーで行っても、メール内の マジックリンク を開くと、iOS によって自動的に Safari (デフォルトのブラウザー) で開かれます。この場合、トランザクションは失敗します。

​

マジックリンク を使用するクラシックログインフロー

その後、ユーザーはメール内のボタンまたはリンクをクリックすると、自動的にアプリケーションにサインインします。

​

接続を設定する

1. Auth0 Dashboard で Authentication > Passwordless に移動し、Email トグルを有効にします。

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

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

3. 生成されるサインインリンクに含める Authentication Parameters を入力します。

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

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 %}

メッセージテンプレートを定義する際は、次のパラメーターを使用できます。

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

​

クラシックログインの設定を更新する

アプリケーションでクラシックログインを使用している場合、マジックリンク を実装するにはページテンプレートを更新する必要があります。

1. Auth0 Dashboard で、Branding > Universal Login > Advanced Options に移動します。

2. Login ビューに切り替え、Default Templates ドロップダウンで Lock (passwordless) を選択します。

3. 次に、Auth0LockPasswordless のコードセクションに新しいパラメーターを追加します。テンプレートに passwordlessMethod を追加してください。

   passwordlessMethod: 'link',
   

4. Save を選択します。

埋め込みログインの設定オプションの詳細については、埋め込みログインでのパスワードレス認証 を参照してください。

​

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

アプリケーションビューに切り替え、パスワードレスEmailを使用するアプリケーションを有効化します。

​

メールプロバイダー

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

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

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

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