> ## 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.
> Guardian の仕組みと、Guardian SDK を使用して独自の認証器や Guardian のようなアプリケーションを構築する方法を説明します。
# Auth0 Guardian
Auth0 Guardian は、iOS および Android デバイス向けのモバイルアプリケーションで、ユーザーはプッシュ通知または一時的なワンタイムパスワードを使用して[多要素認証 (MFA)](/docs/ja-jp/secure/multi-factor-authentication)を完了できます。
Auth0 Guardian は、ユーザーの登録済みデバイス (通常は携帯電話やタブレット) にプッシュ通知を送信したり、アプリ内で直接ワンタイムパスワードを生成したりできます。ユーザーはこれらのプッシュ通知にすばやく応答するか、ワンタイムパスワードを取得してログインを完了できます。
ユーザーは、[Apple App Store](https://apps.apple.com/us/app/auth0-guardian/id1093447833) または [Google Play Store](https://play.google.com/store/apps/details?id=com.auth0.guardian) から Auth0 Guardian アプリをダウンロードできます。あるいは、Guardian SDK を使用して、独自のカスタムアプリに Auth0 Guardian の機能を組み込むこともできます。
## プッシュ通知
プッシュ通知を使用するには、ユーザーのデバイスに Auth0 Guardian アプリ、または Guardian SDK を使用して構築したカスタムアプリのいずれかがインストールされている必要があります。ユーザーが認証を試みると、インストール済みのアプリにプッシュ通知が送信されます。ログインを完了するには、ユーザーはその通知に応答する必要があります。これにより、ユーザーがログイン情報を把握しており、かつ MFA 用に設定されたデバイスを所持していることを証明できます。
Auth0 のプッシュ通知は、AWS Simple Notification Service (SNS) または以下のベンダー直結サービスを 1 つ以上使用して実装でき、ベンダー固有の連携を設定できます。
* Firebase Cloud Messaging (FCM)
* プッシュ通知の内容を変更する方法の詳細については、[FCM のドキュメント](https://firebase.google.com/docs/cloud-messaging/concept-options)を参照してください。
* Apple Push Notification (APN)
* プッシュ通知の内容を変更する方法の詳細については、[Apple のドキュメント](https://developer.apple.com/documentation/usernotifications/modifying-content-in-newly-delivered-notifications)を参照してください。
### プッシュ通知を登録する
Auth0 Guardian を使用してプッシュ通知を設定すると、ユーザーは初回のサインアップ時またはアプリケーションへの初回ログイン時に、モバイルアプリのダウンロードを求められます。Guardian SDK を使用してカスタムアプリにプッシュ通知を実装する場合、登録時にアプリケーションのダウンロードを求められることはありません。
プッシュ通知は、Auth0 Dashboard の [Security > Multi-factor Auth > Push Notification using Auth0 Guardian](https://manage.auth0.com/#/security/mfa/guardian) から有効にできます。
ユーザーが初めてサインアップするかアプリケーションにログインすると、[Universal Login](/docs/ja-jp/authenticate/login/auth0-universal-login) に、Auth0 Guardian アプリまたはカスタム Guardian SDK アプリを第 2 の認証要素として登録するための QR コードが表示されます。ユーザーは登録を完了するために、指定されたアプリでこのコードを短時間のうちにスキャンする必要があります。
登録が完了すると、ユーザーはプッシュ通知を認証要素として使用できるようになります。以後、ユーザーがアプリケーションへのログインを試みるたびに、Auth0 Guardian またはカスタム Guardian SDK アプリを介して、ユーザーのデバイスにプッシュ通知が送信されます。ユーザーは、アプリケーションに正常にログインするために、このrequestを承認する必要があります。
デバイスまたは recovery code を紛失したユーザーの MFA をリセットする方法については、[Reset Multi-Factor Authentication and Recovery Codes](/docs/ja-jp/secure/multi-factor-authentication/reset-user-mfa) を参照してください。
## 一時的なワンタイムパスワード
Auth0 Guardian アプリと Guardian SDK は、第2の認証要素として一時的なワンタイムパスワード (OTP) にも対応しています。アプリと SDK はどちらも一時的な OTP を生成でき、ユーザーはそれを使って Universal Login の MFA チャレンジを完了できます。
デフォルトでは、Auth0 Guardian アプリには、ユーザーが登録しているアプリケーションの一覧が表示されます。アプリケーションを選択すると、そのアプリケーションに対応する OTP が表示されます。6 桁の OTP はそれぞれ 30 秒間有効です。有効期限が近づいた OTP は赤色で表示されます。有効期限が切れると、アプリはすぐに新しい OTP を生成します。認証の失敗を防ぐため、ユーザーは赤色の OTP を使用しないでください
カスタム Guardian SDK アプリでは、OTP の表示が異なる場合があります。
### 一時的なワンタイムパスワードを使用する
OTPは主に次の2つの方法で活用できます。
* Auth0 Guardianアプリまたはその他のカスタムアプリがプッシュリクエストを受信しない場合に、プッシュ通知のフォールバック手段として使用する。
* テナントで[One-Time Password認証要素](/docs/ja-jp/secure/multi-factor-authentication/multi-factor-authentication-factors)を有効にしている場合は、MFAチャレンジとして使用する。
ユーザーがAuth0 Guardianまたはその他のカスタムアプリ経由でプッシュ通知を受信できない場合は、代わりに一時的なOTPを使用してMFAチャレンジを完了できます。
**ユーザーフローの例**:
1. ユーザーがアプリケーションへのログインを試みます。Universal LoginのMFA画面までは進みますが、プッシュ通知を受信しません。
2. MFA画面で、ユーザーは**Manually Enter Code**ボタンを選択します。OTPを使用して認証するには、このオプションを選択する必要があります。
3. ユーザーはAuth0 GuardianまたはカスタムGuardian SDKアプリを開き、アクセスしようとしているアプリケーションを選択します。
4. ユーザーは、Account Detailページの下部に表示されているOTPをコピーします。
5. ユーザーはMFA画面にOTPを入力して、チャレンジを完了します。
ユーザーがOTPで認証できるようにするには、テナントで**One-Time Password**を[MFA認証要素](/docs/ja-jp/secure/multi-factor-authentication/multi-factor-authentication-factors)として有効にする必要があります。有効にすると、ユーザーはUniversal Login経由でログインする際に、OTPを使用してMFA画面を完了できます。MFA認証要素を有効にするには、[Auth0 Dashboard > Security > Multi-factor Auth](https://manage.auth0.com/#/security/mfa)に移動します。
ユーザーは、初回のサインアップ時またはアプリケーションへのログイン時に、MFA認証要素としてOTPを登録できます。使用しているデバイスの種類に応じて、[Universal Login](/docs/ja-jp/authenticate/login/auth0-universal-login)には次のいずれかが表示されます。
* **モバイル以外のデバイスの場合**: Universal Loginには、登録を続行するためにユーザーがスキャンできるQRコードが表示されます。
* **モバイルデバイスの場合**: Universal LoginではQRコードは表示されず、代わりに登録コードが直接表示されます。
どちらの方法でも、ユーザーは画面上の手順に従って、Auth0 GuardianアプリまたはカスタムGuardian SDKアプリを第2の認証要素として登録できます。通常、このプロセスでは、ユーザーが該当するアプリに自分のアプリケーションを追加し、そのアプリケーション用に生成されたOTPを取得します。その後、ユーザーはUniversal Login画面にOTPを入力して、登録プロセスを完了します。
ユーザーが登録完了後に次回アプリケーションへのログインを試みる際は、Auth0 GuardianまたはカスタムGuardian SDKアプリのOTPをチャレンジに入力して認証できます。
## Auth0 Guardian アプリの設定
### ユーザーのセキュリティ設定
Auth0 Guardian アプリでは、iOS と Android で、アプリのセキュリティ層としてパスコードや生体認証を有効にできます。ユーザーがこれらのオプションを 1 つ以上有効にすると、プッシュ通知に応答したり OTP を取得したりする前に、これらの認証を完了する必要があります。
iOS または Android デバイスでこれらのオプションを有効にするには、以下の手順に従ってください。
iOS で Auth0 Guardian アプリのセキュリティ設定を有効にするには、次の手順を実行します。
1. アプリで **歯車アイコン** を選択して、設定メニューを開きます。
2. **Passcode** を選択して、パスコード保護を有効にします。
3. 6 桁のパスコードを設定し、確認します。
これで、アプリはパスコードで保護されます。ユーザーは、プッシュ通知に応答したり OTP を取得したりする前に、このパスコードを入力する必要があります。
パスコード保護を有効にすると、代替のセキュリティ対策としてデバイスの生体認証も設定できます。デバイスの生体認証を有効にするには、次の手順を実行します。
1. アプリで **歯車アイコン** を選択して、設定メニューを開きます。
2. **Face ID** や **Touch ID** など、利用可能なオプションのいずれかを選択して、デバイスの生体認証を有効にします。
Android で Auth0 Guardian アプリのセキュリティ設定を有効にするには、次の手順を実行します。
1. アプリで **3 点メニュー** を選択して、設定メニューを開きます。
2. **Always Ask for Passphrase** オプションのスイッチを有効にします。
3. Auth0 Guardian アプリの設定時に設定したパスフレーズを入力します。
これで、アプリは Auth0 Guardian のパスフレーズで保護されます。ユーザーは、プッシュ通知に応答したり OTP を取得したりする前に、このパスフレーズを入力する必要があります。
パスフレーズ保護を有効にすると、代替のセキュリティ対策としてデバイスの生体認証も設定できます。デバイスの生体認証を有効にするには、次の手順を実行します。
1. アプリで **3 点メニュー** を選択して、設定メニューを開きます。
2. **Use Biometrics to unlock** オプションのスイッチを有効にします。
### ローカライズ設定
Auth0 Guardian アプリは、iOS と Android で複数の言語および方言のローカライズに対応しています。
Settings メニューの Language セクションでは、ユーザーは使用する言語を選択できます。デフォルトでは、アプリはデバイスのシステム言語と同じ言語を使用します。
プッシュ通知の内容の大半は、ユーザーが選択した言語で表示されます。ただし、プッシュ通知のタイトルは翻訳されません。タイトルが設定された時点では、まだ言語設定が取得されていないためです。
Auth0 Guardian アプリは、次の言語および方言に対応しています。
| 言語 | コード |
| ------------------ | -------- |
| アルバニア語 | `sq` |
| アムハラ語 | `am` |
| アラビア語\* | `ar` |
| アラビア語 (エジプト) \* | `ar-EG` |
| アラビア語 (サウジアラビア) \* | `ar-SA` |
| アルメニア語 | `hy` |
| アゼルバイジャン語 | `az` |
| バスク語 | `eu-ES` |
| ベンガル語 | `bn` |
| ボスニア語 | `bs` |
| ブルガリア語 | `bg` |
| カタルーニャ語 | `ca-ES` |
| 中国語 - 香港 | `zh-HK` |
| 中国語 - 簡体字 | `zh-CN` |
| 中国語 - 繁体字 | `zh-TW` |
| クロアチア語 | `hr` |
| チェコ語 | `cs` |
| デンマーク語 | `da` |
| オランダ語 | `nl` |
| 英語 | `en` |
| 英語 - カナダ | `en-CA` |
| エストニア語 | `et` |
| ファルシ語 (ペルシア語) \* | `fa` |
| フィンランド語 | `fi` |
| フランス語 | `fr-FR` |
| フランス語 - カナダ | `fr-CA` |
| ガリシア語 | `gl-ES` |
| ジョージア語 | `ka` |
| ドイツ語 | `de` |
| ギリシャ語 | `el` |
| グジャラート語 | `gu` |
| ヘブライ語\* | `he` |
| ヒンディー語 | `hi` |
| ハンガリー語 | `hu` |
| アイスランド語 | `is` |
| インドネシア語 | `id` |
| イタリア語 | `it` |
| 日本語 | `ja` |
| カンナダ語 | `kn` |
| 韓国語 | `ko` |
| ラトビア語 | `lv` |
| リトアニア語 | `lt` |
| マケドニア語 | `mk` |
| マレー語 | `ms` |
| マラヤーラム語 | `ml` |
| マラーティー語 | `mr` |
| モンゴル語 | `mn` |
| モンテネグロ語 | `cnr` |
| ミャンマー語 | `my` |
| ノルウェー語 | `no` |
| ノルウェー語 - ブークモール | `nb` |
| ノルウェー語 - ニーノシュク | `nn` |
| ポーランド語 | `pl` |
| ポルトガル語 - ブラジル | `pt-BR` |
| ポルトガル語 - ポルトガル | `pt-PT` |
| パンジャブ語 | `pa` |
| ルーマニア語 | `ro` |
| ロシア語 | `ru` |
| セルビア語 | `sr` |
| スロバキア語 | `sk` |
| スロベニア語 | `sl` |
| ソマリ語 | `so` |
| スペイン語 | `es` |
| スペイン語 - アルゼンチン | `es-AR` |
| スペイン語 - ラテンアメリカ | `es-419` |
| スペイン語 - メキシコ | `es-MX` |
| スワヒリ語 | `sw` |
| スウェーデン語 | `sv` |
| タガログ語 | `tl` |
| タマジグト語 | `zgh` |
| タミル語 | `ta` |
| テルグ語 | `te` |
| タイ語 | `th` |
| トルコ語 | `tr` |
| ウクライナ語 | `uk` |
| ウルドゥー語\* | `ur` |
| ベトナム語 | `vi` |
| ウェールズ語 | `cy` |
### Guardian アプリのテーマ
iOS と Android 向けの Auth0 Guardian アプリは、ライトモードとダークモードのテーマに対応しています。
設定メニューの Theme セクションでは、次のオプションを選択できます。
* **System**: デフォルトのシステムテーマを使用します
* **Light**: ライトモードのテーマを有効にします
* **Dark**: ダークモードのテーマを有効にします
### 保護対象のアプリケーションのカスタマイズ オプション
Auth0 Guardian アプリで保護対象のアプリケーションをユーザーが区別しやすいように、各アプリケーションはそれぞれ異なる名前、アクセントカラー、アイコンでカスタマイズできます。
Auth0 Guardian アプリでアプリケーションに割り当てられるデフォルト名は、[テナント名](/docs/ja-jp/get-started/tenant-settings/find-your-tenant-name-or-tenant-id)または[テナント設定](/docs/ja-jp/get-started/tenant-settings)で設定した Friendly Name によって決まります。同様に、デフォルトのロゴは、テナント設定で指定した Logo URL に基づきます。
テナント設定を編集するには、[Auth0 Dashboard > Settings > General](https://manage.auth0.com/dashboard/#/tenant/general) に移動します。
保護対象のアプリケーションをカスタマイズするには、次の手順に従います。
1. 一覧からアプリケーションを選択します。
* **ヒント**: アプリケーションを左にスワイプすると、Edit と Delete のオプションを表示することもできます。
2. Account Detail ページで **Edit** を選択します。
3. 必要に応じて、アプリケーションの名前、色、アイコンを変更します。
4. **Save** を選択します。
## Guardian SDK
[Guardian SDK をインストール](/docs/ja-jp/secure/multi-factor-authentication/multi-factor-authentication-developer-resources/install-guardian-sdk) ([iOS](/docs/ja-jp/secure/multi-factor-authentication/auth0-guardian/guardian-for-ios-sdk) と [Android](/docs/ja-jp/secure/multi-factor-authentication/auth0-guardian/guardian-for-android-sdk) で利用可能) すると、ブランディングやルック＆フィールを完全にコントロールしながら、独自の多要素認証アプリケーションを構築できます。Guardian SDK を使用すれば、Guardian のように動作する独自のカスタムモバイルアプリケーションを開発したり、既存のモバイルアプリケーションにプッシュ通知の受信など Guardian の機能の一部を組み込んだりできます。代表的なユースケースとしては、銀行アプリが挙げられます。たとえば、ATM で取引が行われた際にプッシュ通知を受信して承認できるように、既存のモバイルアプリで Guardian SDK を使用できます。
## Actions を使用して Auth0 Guardian の多要素認証を有効にする
Action 内で Auth0 Guardian を有効にするには、多要素認証を有効にする際に `provider` パラメーターに `guardian` を指定します。
```js lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
api.multifactor.enable('guardian', { allowRememberBrowser: false });
};
```
ユーザーに毎回 Auth0 Guardian でのログインを求めるには、`allowRememberBrowser: false` を指定した Action を作成します。
## Auth0 Guardian と Authorization Extension を使用した多要素認証
このテンプレートは、条件が満たされたときに、プッシュ通知のために Auth0 Guardian で多要素認証をトリガーするための例と出発点を示しています。
初回ログイン時に、ユーザーはデバイスを登録できます。M の詳細については、Enable Multi-Factor Authentication を参照してください。
```js lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
const groups = event.user.app_metadata.authorization.groups;
const GROUPS_WITH_MFA = {
// MFAが必要なグループをここに追加してください
// 例
admins: true
};
const needsMFA = !!groups.find(function (group) {
return GROUPS_WITH_MFA[group];
});
if (needsMFA) {
// 省略可能。デフォルトはtrueです。毎回Guardian認証を強制するにはfalseに設定してください。
// 詳細はhttps://auth0.com/docs/secure/multi-factor-authentication/customize-mfa#change-frequency-of-mfa-prompts を参照してください
api.multifactor.enable('guardian', { allowRememberBrowser: false });
}
};
```
## 詳細はこちら
* [Guardian SDKをインストールする](/docs/ja-jp/secure/multi-factor-authentication/multi-factor-authentication-developer-resources/install-guardian-sdk)
* [Guardian.swift iOS SDK](/docs/ja-jp/secure/multi-factor-authentication/auth0-guardian/guardian-for-ios-sdk)
* [Android向けGuardian SDK](/docs/ja-jp/secure/multi-factor-authentication/auth0-guardian/guardian-for-android-sdk)
* [MFA用のプッシュ通知を設定する](/docs/ja-jp/secure/multi-factor-authentication/multi-factor-authentication-factors/configure-push-notifications-for-mfa)
* [ユーザーの多要素認証とリカバリーコードをリセットする](/docs/ja-jp/secure/multi-factor-authentication/reset-user-mfa)
* [Guardianエラーコードリファレンス](/docs/ja-jp/secure/multi-factor-authentication/multi-factor-authentication-developer-resources/guardian-error-code-reference)