My Account API

​

My Account APIを有効にする

1. **［アプリケーション］>［API］**に移動します。
2. MyAccount APIのバナーを見つけます。
3. **［アクティブ化］**を選択します。

• ユーザーフローの場合はrequire_client_grant
• クライアント（マシンツーマシン）フローの場合はdeny_all

​

デフォルトポリシー

• ユーザーが登録済みのMFA要素を持っている場合、ログイン時に2FAを完了する必要があります。また、トークンの発行から15分を超えた後にも、再度2FAを完了する必要があります。
• ユーザーに登録可能な要素がない場合、Auth0は初回アクセスを許可しますが、15分経過後のリフレッシュトークン交換時にunmet_authentication_requirementsエラーを返します。

​

デフォルトポリシーを有効にする

1. ［アプリケーション］>［API］に移動し、**［My Account API］**を選択します。
2. **［設定］**タブを選択します。
3. **［デフォルトポリシー］で［2FAを必須にする］**をオンにします。
4. **［保存］**を選択します。

​

認証要件の優先順位

1. テナントのMFAポリシー：ベースとなるデフォルトで、テナント内のすべての認証に適用されます。
2. デフォルトポリシー：My Account APIに対して、テナントレベルのポリシーを上書きします。
3. Actions：ActionsのMFAコマンドは、常に上記2つより優先されます。

​

デフォルトポリシーの動作

1. ログイン時、Auth0はトークンを発行する前に、登録済みの要素を使用して認証するようユーザーにチャレンジを行います。
2. リフレッシュトークンには、認証方法とタイムスタンプ（AMR）が記録されます。
3. 最後のチャレンジから15分以内にリフレッシュトークンを交換した場合、Auth0は再度チャレンジせずに新しいアクセストークンを発行します。
4. 15分経過後にリフレッシュトークンを交換した場合、Auth0はトークンを発行する前に、再度ユーザーにチャレンジを行います。

1. ログイン時、Auth0は2つ目の要素なしでアクセスを許可します。
2. 15分以内にリフレッシュトークンを交換した場合、Auth0は再度チャレンジせずに新しいアクセストークンを発行します。
3. 15分経過後にリフレッシュトークンを交換した場合、Auth0はunmet_authentication_requirementsエラーを返します。

​

アクセストークン取得する

• 認可コードフローを使用してAPIを呼び出す
• PKCEを使った認可コードフローでAPIを呼び出す

• リソース所有者のパスワードフローを使ってAPIを呼び出す
• ネイティブPasskeys APIを使用したログインフロー

​

オーディエンス

​

スコープ

​

アクセストークンの例

​

認可コードフローを使用したユニバーサルログイン

​

ネイティブパスキーを使用した埋め込みログイン

​

認証方法を管理する

​

登録フロー

1. 登録を開始するには、メソッドのタイプと必要なフィールドを指定して、/me/authentication-methodsに対してPOSTを送信します。Auth0は、auth_sessionトークンと、メソッドのタイプに応じた登録情報を返します。
2. 登録を確認するには、auth_sessionと、そのメソッドのタイプに応じた検証資格情報（OTPコード、新しいパスワード、またはWebAuthnレスポンス）を指定して、/me/authentication-methods/{id}/verifyに対してPOSTを送信します。

​

認証方法の管理の例

​

TOTP Authenticatorを登録する

curl --request POST \
  --url 'https://{yourDomain}/me/v1/authentication-methods' \
  --header 'Authorization: Bearer {yourAccessToken}' \
  --header 'Content-Type: application/json' \
  --data '{"type": "totp"}'

{
  "id": "amr_abc123",
  "auth_session": "eyJhbGci...",
  "barcode_uri": "otpauth://totp/YourApp:user%40example.com?secret=JBSWY3DPEHPK3PXP&issuer=YourApp",
  "manual_input_code": "JBSWY3DPEHPK3PXP"
}

curl --request POST \
  --url 'https://{yourDomain}/me/v1/authentication-methods/{id}/verify' \
  --header 'Authorization: Bearer {yourAccessToken}' \
  --header 'Content-Type: application/json' \
  --data '{"auth_session": "{yourAuthSession}", "otp_code": "{yourOtpCode}"}'

{
  "id": "amr_abc123",
  "type": "totp",
  "confirmed": true,
  "created_at": "2024-01-15T10:30:00.000Z",
  "updated_at": "2024-01-15T10:35:00.000Z"
}

​

認証方法の一覧を取得する

curl --request GET \
  --url 'https://{yourDomain}/me/v1/authentication-methods' \
  --header 'Authorization: Bearer {yourAccessToken}'

[
  {
    "id": "amr_abc123",
    "type": "totp",
    "confirmed": true,
    "created_at": "2024-01-15T10:30:00.000Z",
    "updated_at": "2024-01-15T10:35:00.000Z"
  },
  {
    "id": "amr_def456",
    "type": "email",
    "email": "user@example.com",
    "confirmed": true,
    "created_at": "2024-01-10T08:00:00.000Z",
    "updated_at": "2024-01-10T08:05:00.000Z"
  }
]

​

認証方法を削除する

curl --request DELETE \
  --url 'https://{yourDomain}/me/v1/authentication-methods/{id}' \
  --header 'Authorization: Bearer {yourAccessToken}'

HTTP 204 No Content

​

Cross-Originリクエスト

1. ［ダッシュボード］>［アプリケーション］に移動します。［アプリケーション］ビューを選択します。
2. **［Cross-Origin認証］で、［Cross-Origin認証を許可する］**をオンにします。
3. **［許可されたオリジン（CORS）］**を見つけて、アプリケーションのオリジンURLを入力します。
4. **［保存］**を選択します。