次のような場合に使用: アプリケーションにMFA（多要素認証。パスワード以外の追加検証）やステップアップ認証を追加する場合。ユーザーがログイン時または機密性の高い操作の前に、2つ目の確認方法（TOTP・時間ベースのワンタイムパスワード、SMS・ショートメッセージ、パスキー、プッシュ通知など）での本人確認を必須にする場合に適しています。 また、リスクレベルに応じた柔軟なMFAや、HIPAA（医療情報の保護規制）やPCI-DSS（クレジットカード情報の保護基準）といった規制への対応が必要な場合にも使用します。 ユーザーが単に「2段階認証を追加してほしい」「この操作の前にMFAを必須にしてほしい」と言った場合でも、このスキルが適切です。
Use when adding MFA or step-up authentication to an app — requiring users to verify with a second factor (TOTP, SMS, passkey, push) for login or before a sensitive action. Also use for adaptive/risk-based MFA or compliance requirements like HIPAA or PCI-DSS, even if the user just says "add two-factor auth" or "require MFA before this action".
多要素認証（MFA）を追加してユーザーアカウントを保護し、機密性の高い操作に対して追加の本人確認を要求します。
多要素認証（MFA: Multi-Factor Authentication）は、ユーザーがアカウントにアクセスする際に2つ以上の認証要素を提示することを要求する仕組みです。 Auth0 は複数の MFA 要素をサポートしており、機密性の高い操作に対するステップアップ認証も有効化できます。
| 要素 | 種別 | 説明 |
|---|---|---|
| TOTP | 所持情報 | 時間ベースのワンタイムパスワード（Google Authenticator、Authy） |
| SMS | 所持情報 | SMS によるワンタイムコード |
| 所持情報 | メールによるワンタイムコード | |
| Push | 所持情報 | Auth0 Guardian アプリによるプッシュ通知 |
| WebAuthn | 所持情報 / 生体情報 | セキュリティキー、生体認証、パスキー |
| Voice | 所持情報 | 音声通話によるワンタイムコード |
| リカバリーコード | バックアップ | 使い切りのリカバリーコード |
| 概念 | 説明 |
|---|---|
acr_values |
認証時に MFA を要求するパラメータ |
amr クレーム |
Authentication Methods Reference — ユーザーがどの方法で認証したかを示す |
| ステップアップ認証 | 初回ログイン後、特定の操作に対して MFA を要求する仕組み |
| アダプティブ MFA | リスクシグナルに基づいて条件付きで MFA を要求する仕組み |
# 現在の MFA 設定を確認する
auth0 api get "guardian/factors"
# TOTP（ワンタイムパスワード）を有効化する
auth0 api put "guardian/factors/otp" --data '{"enabled": true}'
# SMS を有効化する
auth0 api put "guardian/factors/sms" --data '{"enabled": true}'
# プッシュ通知を有効化する
auth0 api put "guardian/factors/push-notification" --data '{"enabled": true}'
# WebAuthn（ローミング — セキュリティキー）を有効化する
auth0 api put "guardian/factors/webauthn-roaming" --data '{"enabled": true}'
# WebAuthn（プラットフォーム — 生体認証）を有効化する
auth0 api put "guardian/factors/webauthn-platform" --data '{"enabled": true}'
# Email を有効化する
auth0 api put "guardian/factors/email" --data '{"enabled": true}'
# MFA ポリシーを設定する: "all-applications" または "confidence-score"
auth0 api patch "guardian/policies" --data '["all-applications"]'
ステップアップ認証は、すべてのログインに MFA を要求することなく、機密性の高い操作に対してのみ MFA を求める仕組みです。
acr_values パラメータ認可リクエストに acr_values を含めることで MFA を要求できます:
acr_values=http://schemas.openid.net/pape/policies/2007/06/multi-factor
すべてのフレームワークに共通する基本パターンは以下のとおりです:
amr クレームを検査）acr_values パラメータを使って MFA を要求するフレームワーク別の完全なコード例は サンプルガイド を参照してください:
このスキルは整理しやすくするために複数のファイルに分割されています。
全フレームワーク向けの完全なコード例:
バックエンドで MFA ステータスを検証する方法:
より高度な MFA 実装パターン:
よく使われるパターンとトラブルシューティング:
auth0-quickstart — Auth0 の基本セットアップauth0-passkeys — WebAuthn / パスキーの実装auth0-actions — カスタム認証ロジックAdd Multi-Factor Authentication to protect user accounts and require additional verification for sensitive operations.
Multi-Factor Authentication (MFA) requires users to provide two or more verification factors to access their accounts. Auth0 supports multiple MFA factors and enables step-up authentication for sensitive operations.
| Factor | Type | Description |
|---|---|---|
| TOTP | Something you have | Time-based one-time passwords (Google Authenticator, Authy) |
| SMS | Something you have | One-time codes via text message |
| Something you have | One-time codes via email | |
| Push | Something you have | Push notifications via Auth0 Guardian app |
| WebAuthn | Something you have/are | Security keys, biometrics, passkeys |
| Voice | Something you have | One-time codes via phone call |
| Recovery Code | Backup | One-time use recovery codes |
| Concept | Description |
|---|---|
acr_values |
Request MFA during authentication |
amr claim |
Authentication Methods Reference - indicates how user authenticated |
| Step-up auth | Require MFA for specific actions after initial login |
| Adaptive MFA | Conditionally require MFA based on risk signals |
# View current MFA configuration
auth0 api get "guardian/factors"
# Enable TOTP (One-time Password)
auth0 api put "guardian/factors/otp" --data '{"enabled": true}'
# Enable SMS
auth0 api put "guardian/factors/sms" --data '{"enabled": true}'
# Enable Push notifications
auth0 api put "guardian/factors/push-notification" --data '{"enabled": true}'
# Enable WebAuthn (Roaming - Security Keys)
auth0 api put "guardian/factors/webauthn-roaming" --data '{"enabled": true}'
# Enable WebAuthn (Platform - Biometrics)
auth0 api put "guardian/factors/webauthn-platform" --data '{"enabled": true}'
# Enable Email
auth0 api put "guardian/factors/email" --data '{"enabled": true}'
# Set MFA policy: "all-applications" or "confidence-score"
auth0 api patch "guardian/policies" --data '["all-applications"]'
Step-up auth requires MFA for sensitive operations without requiring it for every login.
acr_values ParameterRequest MFA by including acr_values in your authorization request:
acr_values=http://schemas.openid.net/pape/policies/2007/06/multi-factor
The general pattern for all frameworks:
amr claim)acr_values parameterFor complete framework-specific examples, see Examples Guide:
This skill is split into multiple files for better organization:
Complete code examples for all frameworks:
Learn how to validate MFA status on your backend:
Advanced MFA implementation patterns:
Common patterns and troubleshooting:
auth0-quickstart - Basic Auth0 setupauth0-passkeys - WebAuthn/passkey implementationauth0-actions - Custom authentication logic原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。