My Account API

​

My Account API を有効化する

1. Applications > APIs に移動します。
2. MyAccount API バナーを見つけます。
3. 有効化 を選択します。

• ユーザーフローには require_client_grant
• クライアント (machine-to-machine) フローには deny_all

​

デフォルトポリシー

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

​

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

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

​

認証要件の階層

1. テナント MFA ポリシー: テナント内のすべての認証に適用される基本のデフォルト設定
2. デフォルトポリシー: My Account API に限り、テナントレベルの設定を上書きします
3. Actions: Actions 内の MFA コマンドは、常にこの両方より優先されます

​

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

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

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

​

access token を取得する

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

• Resource Owner Password Flow を使用して API を呼び出す
• Native Passkeys API を使用したログインフロー

​

Audience

​

スコープ

​

アクセストークンの例

​

認可コードフローでのUniversal Login

​

Native パスキーを使用する埋め込みログイン

​

認証方法を管理する

​

登録フロー

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

​

認証方法の管理例

​

TOTP 認証器を登録する

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"
  }
]

​

認証方法をDelete

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

HTTP 204 No Content

​

クロスオリジン リクエスト

1. Auth0 Dashboard > アプリケーション に移動し、表示するアプリケーションを選択します。
2. Cross-Origin Authentication で、Allow Cross-Origin Authentication をオンにします。
3. Allowed Origins (CORS) を見つけて、アプリケーションの origin URL を入力します。
4. 保存 を選択します。