Management API を使用したユーザー管理

Management API を使用してユーザーを作成し、ユーザーとそのプロファイルの詳細を表示する方法を説明します。

Auth0 Dashboard を使用するだけでなく、Management API を使ってユーザーの取得、作成、更新、削除を行うこともできます。Management API を直接呼び出す場合は、まず適切な アクセストークン を生成する必要があります。詳しくは、Management API 用のアクセストークン を参照してください。あるいは、SDK を使用して、アプリケーションから Management API を呼び出すために必要な機能を実装することもできます。利用可能な SDK の一覧については、Support Matrix の SDK セクション を参照してください。

チームメンバーの Auth0 Dashboard へのアクセスを管理する方法については、Manage Dashboard Access を参照してください。

​

権限

Machine-to-Machine アプリケーションのアクセストークンを取得するには、以下の権限を使用します。詳しくは、Register Machine-to-Machine Applications. を参照してください。

権限	説明
read:users	アプリケーションは、Auth0 テナントに保存されているすべてのユーザーレコードを検索および取得できます。これには、/api/v2/users、/api/v2/users-by-email、/api/v2/jobs/users-export エンドポイントを使用した読み取りが含まれます。
create:users	アプリケーションは、Auth0 テナント内の任意のデータベース接続またはパスワードレス接続でユーザーを作成できます。これには、/api/v2/users および /api/v2/jobs/users-import エンドポイントを使用した作成が含まれます。
update:users	アプリケーションは、Auth0 テナントに保存されているすべてのユーザーを更新できます。これには、/api/v2/users エンドポイントを使用した更新が含まれます。
update:users_app_metadata	アプリケーションは、Auth0 テナントに保存されているすべてのユーザーについて、user.app_metadata 属性のみを更新できます。これには、/api/v2/users endpoint を使用した更新が含まれます。
delete:users	アプリケーションは、Auth0 テナントに保存されているすべてのユーザーを削除できます。これには、/api/v2/users エンドポイントを使用した削除が含まれます。

​

制限事項

デフォルトでは、Auth0 以外 (Google、Facebook、X など) のアイデンティティプロバイダーから提供されるユーザープロファイル属性は、ユーザーがログインするたびにアイデンティティプロバイダーから更新されるため、直接編集できません。アイデンティティプロバイダー由来の属性の詳細については、ユーザープロファイル更新のための Identity Provider Connection の設定を参照してください。

正規化されたユーザープロファイルの name、nickname、given_name、family_name、picture のルート属性を編集できるようにするには、ユーザー属性がユーザープロファイルの作成時にのみアイデンティティプロバイダーから更新されるよう、接続の同期を Auth0 で設定する必要があります。これにより、これらのルート属性を個別に、または一括インポートで編集できるようになります。

create または update エンドポイントを使用してパスワードを設定できますが、セキュリティ上の理由から、get または list user コマンドでパスワードを表示することはできません。API Explorer の右側には、各呼び出しで表示または変更できるユーザープロファイル属性に関するヒントが表示されます。

​

エンドポイント

• すべてのユーザーの情報を取得するには、/users エンドポイントを使用します。検索条件を指定して、特定のユーザーを見つけることもできます。
• user_id に基づいて1 人のユーザーの情報を取得するには、/user_id を使用します。user_id は、接続名とユーザー固有の識別子で構成される内部識別子です。user_id は ID トークン とは異なります。
• /userinfo エンドポイントは、Auth0 アクセストークンを入力として受け取り、ユーザープロファイル情報を返します。このエンドポイントには、認証トランザクション中にユーザープロファイルを変更したルールの結果も含まれますが、返されるユーザープロファイルは Scoping によってフィルタリングされません。
• /tokeninfo エンドポイントは、Auth0 ID トークンを入力として受け取り、ユーザープロファイル情報を返します。このエンドポイントが返す結果には、ユーザープロファイルを変更するルールの結果は含まれません。

​

詳しく見る

• Auth0.swift: ユーザー管理
• Auth0.Android: ユーザー管理