> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> メール認証要素を使用してパスワードレス接続を利用する方法を学びます。

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

<Tooltip tip="パスワードレス: 第1要素としてパスワードに依存しない認証方式です。" cta="用語集を表示" href="/ja/docs/glossary?term=Passwordless">パスワードレス</Tooltip>接続を構成すると、認証を完了するためのワンタイムパスワード (OTP) をユーザーにメールで送信できます。

詳しくは、[パスワードレス認証用のメールまたは SMS を構成する](/ja/docs/authenticate/login/auth0-universal-login/passwordless-login/email-or-sms)を参照してください。

<div id="how-it-works">
  ## 仕組み
</div>

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

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

<div id="embedded-login">
  ### 埋め込みログイン
</div>

<Frame>
  <img src="https://mintcdn.com/translations/3nS3prIggmJG9TUI/docs/images/cdy7uua7fh8z/3HMLxPTq9eCsq1eR21s0bL/ad401ee9fbe0716250d49ea04993a056/SMS_Email_Flow_Updated.png?fit=max&auto=format&n=3nS3prIggmJG9TUI&q=85&s=4fc8635f77924e0696c6c2fc370e4489" alt="埋め込みログインにおけるパスワードレスのメールワークフロー図" width="1400" height="851" data-path="docs/images/cdy7uua7fh8z/3HMLxPTq9eCsq1eR21s0bL/ad401ee9fbe0716250d49ea04993a056/SMS_Email_Flow_Updated.png" />
</Frame>

<div id="universal-login">
  ### Universal Login
</div>

<Frame>
  <img src="https://mintcdn.com/translations/6GE5Z24GDCZehiJ9/docs/images/cdy7uua7fh8z/5p3cKrJwmc7MxpQ7pbXsjC/285f3b54caba8a05075b6a0036990aaa/Screenshot_2024-10-29_at_11.54.03.png?fit=max&auto=format&n=6GE5Z24GDCZehiJ9&q=85&s=79d64b1b5b2456e4bdbda7aad8bfea3f" alt="Universal Login を使用したメールによるパスワードレスのワークフロー図" width="1400" height="771" data-path="docs/images/cdy7uua7fh8z/5p3cKrJwmc7MxpQ7pbXsjC/285f3b54caba8a05075b6a0036990aaa/Screenshot_2024-10-29_at_11.54.03.png" />
</Frame>

<div id="configure-the-connection">
  ## 接続を設定する
</div>

1. [Auth0 Dashboard > Authentication > Passwordless](https://manage.auth0.com/#/connections/passwordless) に移動し、**Email** トグルを有効にします。
2. **Email** を選択して設定ウィンドウを開き、**Settings** ビューに切り替えて、メールの **From**、**Subject**、**Message** を入力します。

   <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
     Auth0 でカスタムメールテンプレートを送信するには、**From** の値を `auth0.com` ドメイン以外のメールアドレスに変更する必要があります。変更しない場合、Auth0 はデフォルトのメールテンプレートを送信します。
   </Callout>
3. **OTP Expiry** と **OTP Length** を設定します。

   * 受け付けられるのは、最後に発行された OTP (またはリンク) のみです。新しいものが発行されると、それ以前のものはすべて無効になります。また、最新のものも使用すると無効になります。
   * OTP の入力に失敗できるのは 3 回までです。その後は、新しい code をリクエストする必要があります。
   * 発行された OTP は、有効期限が切れるまで (デフォルトでは) 3 分間有効です。
   * OTP の有効期限を延長する場合は、OTP の長さも長くする必要があります。そうしないと、攻撃者が短い code を推測するための猶予が長くなります。
4. **Disable Sign Ups** を有効にするかどうかを決定します。この設定を有効にすると、既存のユーザーにのみパスワードレスアクセスを許可できますが、アプリケーションがユーザー列挙攻撃の脅威にさらされる可能性があります。詳細については、[Passwordless Connections Best Practices](/ja/docs/authenticate/passwordless/best-practices) を参照してください。
5. **Save** を選択します。

<div id="multi-language-support">
  ### 多言語サポート
</div>

**Message** 領域では複数の言語を使用できます。

言語を指定するには、[Auth0 Authentication API Get Code or Link endpoint](https://auth0.com/docs/api/authentication#get-code-or-link) を呼び出し、`x-request-language` ヘッダーに値を設定します。このヘッダーが設定されていない場合、ブラウザーによって自動的に設定される `accept-language` ヘッダーから言語が取得されます。

<div id="message-syntax">
  ### メッセージ構文
</div>

**Message** 領域では、Liquid 構文を使用できます。この構文をパラメーター値と組み合わせることで、メッセージの要素をプログラムによって組み立てることができます。

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

```liquid lines theme={null}
{% 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` です。 |

ユーザーが [組織](/ja/docs/manage-users/organizations/organizations-overview) を通じてログインしている場合は、次のパラメーターも使用できます。

* `organization.id`
* `organization.display_name`
* `organization.name`
* `organization.metadata`
* `organization.branding.logo_url`
* `organization.branding.colors.primary`
* `organization.branding.colors.page_background`

これらのパラメーターとその値について詳しくは、Auth0 の <Tooltip tip="Management API: お客様が管理タスクを実行できるようにする製品。" cta="用語集を見る" href="/ja/docs/glossary?term=Management+API">Management API</Tooltip> の [Get organization](https://auth0.com/docs/api/management/v2#!/Organizations/get_organizations_by_id) エンドポイントを参照してください。

<div id="enable-applications">
  ## アプリケーションを有効にする
</div>

**Applications** ビューに切り替え、パスワードレスメールを利用するアプリケーションを有効にします。

<div id="email-providers">
  ## メールプロバイダー
</div>

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

メールの管理、監視、トラブルシューティングや、メールテンプレートのカスタマイズを行うには、[独自の SMTP メールプロバイダーを設定してください](/ja/docs/customize/email/smtp-email-providers)。

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

* [Mandrill](/ja/docs/customize/email/smtp-email-providers/configure-mandrill-as-external-smtp-email-provider)
* [Amazon SES](/ja/docs/customize/email/smtp-email-providers/configure-amazon-ses-as-external-smtp-email-provider)
* [Azure Communication Services](/ja/docs/customize/email/smtp-email-providers/configure-azure-comm-service-as-smtp-email-provider)
* [SendGrid](/ja/docs/customize/email/smtp-email-providers/configure-sendgrid-as-external-smtp-email-provider)
* [SparkPost](/ja/docs/customize/email/smtp-email-providers/configure-sparkpost-as-external-smtp-email-provider)
* [Mailgun](/ja/docs/customize/email/smtp-email-providers/configure-mailgun-as-external-smtp-email-provider)
* [カスタム SMTP 外部メールプロバイダー](/ja/docs/customize/email/smtp-email-providers/configure-custom-external-smtp-email-provider)