Skip to main content
場合によっては、Auth0 Management Dashboard ではなく、Auth0 の Management API を使ってアプリケーションや API を管理したいことがあります。 のエンドポイントを呼び出すには、Management API トークン と呼ばれる専用の Access Token を使用して認証する必要があります。Management API Tokens は、呼び出す Management API エンドポイントに対して付与された特定の権限 (scopes とも呼ばれます) を含む JSON Web Tokens (JWTs) です。

​
制限事項

シングルページアプリケーション (SPA) はであり、機密情報 ( など) を安全に保存できないため、他のアプリケーションの種類とは異なり、Management API トークン はフロントエンドから取得する必要があります。つまり、SPA 向けの Management API トークン には一定の制限があります。具体的には、これらのトークンは現在 Auth0 にサインインしているユーザーのコンテキストで発行されるため、更新できるのはログイン中のユーザー自身のデータに限られます。このため Management API の用途は制限されますが、ログイン中のユーザーのユーザープロファイルを更新する操作には引き続き利用できます。
Auth0 は、ユーザーが user metadata を変更できる Management API トークン をフロントエンドに置くことを推奨していません。これにより、ユーザーが自身の metadata を操作して、アプリケーションの動作に悪影響を及ぼすおそれがあります。また、大量のリクエストを送ってレート制限に達させるだけで、他のユーザーの management API に対して DoS 攻撃を仕掛けられてしまう可能性もあります。

​
利用可能なスコープとエンドポイント

SPA 向けに発行された Management API トークン を使用すると、以下のスコープ (および対応するエンドポイント) にアクセスできます。
PATCH /api/v2/users/ エンドポイントを使用したパスワード変更は、SPA 向けに発行された Management API トークン では 実行できません。
上記のスコープとエンドポイントには、レート制限 が適用されます。

​
SPA から Management API を呼び出すための Management API トークンの使用

SPA から Management API トークンを取得し (生成には Management API の を使用) 、そのトークンを使って Management API を呼び出すことで、現在ログインしているユーザーの完全なユーザープロファイルを取得できます。
  1. Management API トークンを取得する。
    1. ユーザーを Authorization エンドポイントにリダイレクトして認証します。これは、ユーザーがログインまたはサインアップ時に移動する先です。
    2. Management API トークンを受け取ると、JSON Web Token 形式 になっています。
    3. トークンをデコードし、その内容を確認します。
  2. Management API を呼び出して、Get User by ID エンドポイントからログイン中のユーザーのユーザープロファイルを取得します。
    1. エンドポイントを呼び出すには、取得したエンコード済みの Management API トークンをリクエストの Authorization ヘッダーに含めます。
    2. USER_ID と MGMT_API_ACCESS_TOKEN のプレースホルダー値は、それぞれログイン中のユーザーのユーザー ID (デコードした Management API トークンの sub の値) と Management API access token に置き換えてください。

​
詳しくはこちら