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

> SMS 認証方式でパスワードレス接続を使用する方法を説明します。

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

<Tooltip tip="パスワードレス: 第1認証要素としてパスワードを使用しない認証方式。" cta="用語集を表示" href="/docs/ja-jp/glossary?term=Passwordless">パスワードレス</Tooltip>認証を設定すると、SMS を通じてユーザーにワンタイムパスワード (OTP) を送信できます。詳細については、[パスワードレス認証用の Email または SMS を設定する](/docs/ja-jp/authenticate/login/auth0-universal-login/passwordless-login/email-or-sms)を参照してください。

Auth0 では、OTP の送信に [Twilio](https://www.twilio.com) とカスタム電話プロバイダーを使用できます。Auth0 Actions でカスタム電話プロバイダーを使用する場合は、[カスタム電話プロバイダーを設定する](/docs/ja-jp/customize/phone-messages/configure-phone-messaging-providers/configure-a-custom-phone-provider)または [Terraform でカスタム電話プロバイダーを設定する](/docs/ja-jp/customize/phone-messages/configure-phone-messaging-providers/configure-a-custom-phone-provider/configure-a-custom-phone-provider-with-terraform)を参照してください。

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

新しいユーザーがコードを受け取り、それを初めてあなたのアプリケーションに入力すると、Auth0 による認証の前に、そのユーザーのユーザープロファイルが `sms` 接続に作成されます。

OTP の送信先の電話番号が既存のユーザーと一致する場合、Auth0 はそのユーザーを認証します:

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

<Frame>
  <img src="https://mintcdn.com/docs-dev-feat-init-gt-translations/ga3rC1_4s-OF6Vr-/docs/images/cdy7uua7fh8z/7A1AOmvvAQXheVt9swOtqM/cd38a66a41e3be5f95d9fb0a473b9079/Embedded-login.png?fit=max&auto=format&n=ga3rC1_4s-OF6Vr-&q=85&s=87bd8b05719d60d983941b16e84c5f6d" alt="パスワードレス認証のSMSフロー" width="1400" height="635" data-path="docs/images/cdy7uua7fh8z/7A1AOmvvAQXheVt9swOtqM/cd38a66a41e3be5f95d9fb0a473b9079/Embedded-login.png" />
</Frame>

<h3 id="universal-login">
  Universal Login
</h3>

<Frame>
  <img src="https://mintcdn.com/docs-dev-feat-init-gt-translations/ZC0XT2ZcfW-tPJd_/docs/images/cdy7uua7fh8z/5EmFoTLgH2ByPcFYdsQvXA/fdaf1add4592c70cda7e12e6b1ae60dd/Unvirsal-login.png?fit=max&auto=format&n=ZC0XT2ZcfW-tPJd_&q=85&s=7de4c2782223978712ce31ef065b4bda" alt="Universal Login のパスワードレス SMS ワークフロー図" width="1400" height="554" data-path="docs/images/cdy7uua7fh8z/5EmFoTLgH2ByPcFYdsQvXA/fdaf1add4592c70cda7e12e6b1ae60dd/Unvirsal-login.png" />
</Frame>

<h2 id="configure-the-phone-provider">
  電話プロバイダーを設定する
</h2>

1. Auth0 Dashboard で、[Branding > Phone Provider](https://manage.auth0.com/#/phone/templates/phone/provider) に移動します。
2. `Phone Message Provider` トグルを有効にします。

   <Frame>
     <img src="https://mintcdn.com/docs-dev-feat-init-gt-translations/2ut5cR-lHY2UVI81/docs/images/cdy7uua7fh8z/1k93jvdxDq2FZLiRdvr5aR/d917431cd0265943c5118174a8673118/2025-02-24_16-43-14.png?fit=max&auto=format&n=2ut5cR-lHY2UVI81&q=85&s=ace7800dddf5b21a4a702d746a950f7d" alt="Auth0 Dashboard > Branding > Phone Provider > Phone Message Provider を有効にする" data-og-width="798" width="798" data-og-height="633" height="633" data-path="docs/images/cdy7uua7fh8z/1k93jvdxDq2FZLiRdvr5aR/d917431cd0265943c5118174a8673118/2025-02-24_16-43-14.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/docs-dev-feat-init-gt-translations/2ut5cR-lHY2UVI81/docs/images/cdy7uua7fh8z/1k93jvdxDq2FZLiRdvr5aR/d917431cd0265943c5118174a8673118/2025-02-24_16-43-14.png?w=280&fit=max&auto=format&n=2ut5cR-lHY2UVI81&q=85&s=1ed6b5aef9efae0e29e855c1ee446f64 280w, https://mintcdn.com/docs-dev-feat-init-gt-translations/2ut5cR-lHY2UVI81/docs/images/cdy7uua7fh8z/1k93jvdxDq2FZLiRdvr5aR/d917431cd0265943c5118174a8673118/2025-02-24_16-43-14.png?w=560&fit=max&auto=format&n=2ut5cR-lHY2UVI81&q=85&s=bf0a51f8ce42df43b7925cb3993f7ad4 560w, https://mintcdn.com/docs-dev-feat-init-gt-translations/2ut5cR-lHY2UVI81/docs/images/cdy7uua7fh8z/1k93jvdxDq2FZLiRdvr5aR/d917431cd0265943c5118174a8673118/2025-02-24_16-43-14.png?w=840&fit=max&auto=format&n=2ut5cR-lHY2UVI81&q=85&s=b43713d1671b42eeca9f9cb262835e0f 840w, https://mintcdn.com/docs-dev-feat-init-gt-translations/2ut5cR-lHY2UVI81/docs/images/cdy7uua7fh8z/1k93jvdxDq2FZLiRdvr5aR/d917431cd0265943c5118174a8673118/2025-02-24_16-43-14.png?w=1100&fit=max&auto=format&n=2ut5cR-lHY2UVI81&q=85&s=8018510c944141b4e0d29941eddf99b1 1100w, https://mintcdn.com/docs-dev-feat-init-gt-translations/2ut5cR-lHY2UVI81/docs/images/cdy7uua7fh8z/1k93jvdxDq2FZLiRdvr5aR/d917431cd0265943c5118174a8673118/2025-02-24_16-43-14.png?w=1650&fit=max&auto=format&n=2ut5cR-lHY2UVI81&q=85&s=fc0542bfecc0f9dce8b912a5949f965b 1650w, https://mintcdn.com/docs-dev-feat-init-gt-translations/2ut5cR-lHY2UVI81/docs/images/cdy7uua7fh8z/1k93jvdxDq2FZLiRdvr5aR/d917431cd0265943c5118174a8673118/2025-02-24_16-43-14.png?w=2500&fit=max&auto=format&n=2ut5cR-lHY2UVI81&q=85&s=1a5c2aaf90dabb68ef8d090f4d4156fd 2500w" />
   </Frame>
3. 電話メッセージプロバイダーを選択します。

   1. Twilio を使用する場合は、[Configure Twilio as a Phone Messaging Provider](/docs/ja-jp/customize/phone-messages/configure-phone-messaging-providers/configure-twilio-as-a-phone-messaging-provider) の手順に従ってください。
   2. カスタムプロバイダーを使用する場合は、Auth0 Actions を使用するために、[カスタム電話プロバイダーを設定する](/docs/ja-jp/customize/phone-messages/configure-phone-messaging-providers/configure-a-custom-phone-provider) の手順に従ってください。
4. 配信方法を選択します。
5. 変更を **Save** します。

<h2 id="legacy-sms-gateway">
  レガシーSMSゲートウェイ
</h2>

Auth0 Action のカスタム電話プロバイダーでユースケースに対応できない場合は、<Tooltip tip="Management API：お客様が管理タスクを実行できるようにする製品。" cta="用語集を表示" href="/docs/ja-jp/glossary?term=Management+API">Management API</Tooltip> を使用して、[パスワードレス SMS 接続](/docs/ja-jp/authenticate/passwordless) のカスタムSMSゲートウェイを管理できます。詳細については、[Set Up Custom SMS Gateway for Passwordless Connections](/docs/ja-jp/authenticate/passwordless/authentication-methods/use-sms-gateway-passwordless) を参照してください。

<h3 id="configure-passwordless-sms-settings">
  パスワードレス SMS の設定
</h3>

1. **Message** に、SMS の本文を入力します。

   <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
     `@@password@@` プレースホルダーは、ユーザーに送信されるワンタイムパスワードに自動的に置き換えられます。
   </Callout>
2. **OTP Expiry** と **OTP Length** の設定を調整します。

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

<h4 id="multi-language-support">
  多言語対応
</h4>

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

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

<h4 id="message-syntax">
  Message の構文
</h4>

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

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

```liquid lines theme={null}
{% if request_language contains 'dutch' %}
   Hier is uw verificatie code: {{ password }}
{% endif %}
{% if request_language contains 'fr-FR' %}
   Ceci est votre code: {{ password }}
{% endif %}
```

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

| Parameter            | Description               |
| -------------------- | ------------------------- |
| `password` or `code` | 使用するパスワード。                |
| `phone_number`       | ユーザーの電話番号。                |
| `application.name`   | ユーザーがサインアップするアプリケーションの名前。 |
| `request_language`   | メッセージ内容の要求言語。             |

Liquid の使い方について詳しくは、[GitHub の Liquid for Designers](https://github.com/Shopify/liquid/wiki/Liquid-for-Designers)を参照してください。

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

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

<h2 id="learn-more">
  詳細はこちら
</h2>

* [Auth0のUnified Phone Experience](/docs/ja-jp/customize/phone-messages/unified-phone)
* [パスワードレスでUnified Phone Experienceを使用する](/docs/ja-jp/customize/phone-messages/unified-phone/unified-phone-experience-passwordless)
* [Auth0のUnified Phone Experienceを設定する](/docs/ja-jp/customize/phone-messages/unified-phone/configure-unified-phone)