シングルページアプリケーション向けの Management API アクセストークン を取得する

シングルページアプリケーション（SPA）向けの Management API トークンで利用できるスコープとエンドポイントについて説明します。

場合によっては、Auth0 Management Dashboard ではなく、Auth0 の Management API を使ってアプリケーションや API を管理したいことがあります。

Management API のエンドポイントを呼び出すには、Management API トークン と呼ばれる専用の アクセストークン を使用して認証する必要があります。Management API トークン は、呼び出す Management API エンドポイントに対して付与された特定の権限 (スコープ とも呼ばれます) を含む JSON Web Tokens (JWTs) です。

制限事項

シングルページアプリケーション (SPA) はパブリッククライアントであり、機密情報 (Client Secret など) を安全に保存できないため、他のアプリケーションの種類とは異なり、Management API トークン はフロントエンドから取得する必要があります。つまり、SPA 向けの Management API トークン には一定の制限があります。具体的には、これらのトークンは現在 Auth0 にサインインしているユーザーのコンテキストで発行されるため、更新できるのはログイン中のユーザー自身のデータに限られます。このため Management API の用途は制限されますが、ログイン中のユーザーのユーザープロファイルを更新する操作には引き続き利用できます。

Auth0 は、ユーザーが user metadata を変更できる Management API トークン をフロントエンドに置くことを推奨していません。これにより、ユーザーが自身の metadata を操作して、アプリケーションの動作に悪影響を及ぼすおそれがあります。また、大量のリクエストを送ってレート制限に達させるだけで、他のユーザーの management API に対して DoS 攻撃を仕掛けられてしまう可能性もあります。

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

SPA向けに発行されたManagement APIトークンを使用すると、以下のスコープ (およびそれに対応するエンドポイント) にアクセスできます。

SPA向けに発行されたManagement APIトークンでは、PATCH /api/v2/users/エンドポイントを使用したパスワード変更はできません。

現在のユーザー用のスコープ	エンドポイント
read:current_user	GET /api/v2/users/ GET /api/v2/users//enrollments
update:current_user_identities	POST/api/v2/users//identities DELETE /api/v2/users//identities//
update:current_user_metadata	PATCH /api/v2/users/
create:current_user_metadata	PATCH /api/v2/users/
create:current_user_device_credentials	POST /api/v2/device-credentials
delete:current_user_device_credentials	DELETE /api/v2/device-credentials/

上記のスコープとエンドポイントにはレート制限が適用されます。

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

SPA から Management API トークンを取得し (生成には Management API の audience を使用) 、そのトークンを使って 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 アクセストークン に置き換えてください。

詳しくはこちら

• テスト用の Management API アクセストークンを取得する
• 本番環境用の Management API アクセストークンを取得する