メインコンテンツへスキップ
RulesとHooksのサポート終了(EOL)日は2026年11月18日 であり、2023年10月16 日の時点で作成された新しいテナントは使用できなくなります。Hooksが有効な既存のテナントは、サポート終了までHooksを利用できます。今後はActionsに移行して、Auth0の機能を拡張することを強くお勧めします。Actionsを使用すると、豊富な情報やインラインドキュメント、パブリックnpmパッケージにアクセスして、外部統合を使って全体的な拡張エクスペリエンスを強化することができます。Actionsの詳細については、「Auth0 Actionsの仕組みを理解する」をお読みください。当社では、移行の参考資料として、RulesからActionsへの移行HooksからActionsへの移行に関するガイドを提供しています。また、専用の「Actionsへの移行」ページでは、機能の比較やActionsのデモ、その他のリソースを掲載して、円滑な移行をサポートしています。RulesとHooksの廃止の詳細については、当社のブログ記事「RulesとHooksの提供終了について」をお読みください。
userオブジェクトはIDプロバイダーから返され、ログイン済みユーザーについての情報が保管されます。ユーザーの認証時、ルールの実行前に生成されます。ユーザー認証ではイベントに順序があるため、ルール内からユーザープロファイルに対して実行された変更内容は、その同じルール内からユーザーオブジェクトに対して変更内容を保存すると、現在のユーザーオブジェクトでのみ使用可能になります。 認証トランザクションフローの詳細については、「ルールを作成する」にある「ルールの仕組み」セクションをお読みください。
ユーザーオブジェクトのルートプロパティとapp_metadata内のプロパティには、一意の名前を使用します。app_metadata内のプロパティがユーザーオブジェクトにマージされるため、app_metadata内のプロパティと同じ名前を持つルートプロパティは、ルールの実行時に値が上書きされる可能性があります。

プロパティ

以下のプロパティはuserオブジェクトで使用することができます。
プロパティデータタイプ説明
user.app_metadataオブジェクトサポートプラン、セキュリティロール、アクセス制御グループなどのユーザーアクセスに影響するユーザーについての情報を保存するカスタムフィールドです。デフォルトでは、undefinedです。詳細はメタデータをご覧ください。
user.created_at日時ユーザープロファイルが最初に作成された日時を示すタイムスタンプ。
user.emailテキスト(一意)ユーザーのメールアドレス。
user.email_verifiedブール値ユーザーがメールアドレスを確認済みかどうかを示します。
user.family_nameテキストユーザーの姓。
user.given_nameテキストユーザーの名。
user.identities配列(オブジェクト)ユーザーを最初に認証したIDプロバイダーから取得された情報を格納します。ユーザーはプロファイルを複数のIDプロバイダーにリンクすることもできますが、その場合にはそれらのアイデンティティーもこの配列に含まれます。個別のIDプロバイダーオブジェクトのコンテンツはプロバイダーによって異なりますが、一般的には次のものを含みます:
  • connection (テキスト):ユーザーの認証に使用されるAuth0接続の名前。
  • isSocial(ブール値):接続がソーシャルのものか示します。
  • provider(テキスト):Facebook、Google、SAML、または独自のプロバイダーといったユーザーを認証するエンティティの名前。
  • user_id (テキスト):この接続/プロバイダーのユーザーの一意ID。最初のuser_idリンクはユーザーの主要の一意IDになります。
  • profileData(オブジェクト):接続に関連づけられたユーザー情報。プロファイルがリンクされると、そこにはセカンダリアカウントの関連するユーザー情報が入力されます。
場合によっては、プロバイダーに使用されるAPIアクセストークンを含むものもあります。
user.last_password_reset日時ユーザーパスワードがリセット/変更された最終日時を示すタイムスタンプ。ユーザーの作成時に、このフィールドは存在しません。このフィールドは、データベース接続でのみ利用できます。
user.multifactor配列(テキスト)ユーザーが登録された多要素認証()プロバイダーのリスト。この配列は、ユーザーがMFAに登録されたときと管理者がユーザーのMFA登録をリセットするときに更新されます。
user.nameテキストユーザーの氏名。
user.nicknameテキストユーザーのニックネーム。
user.permissionsテキスト認可拡張機能を使用した場合にユーザーのIDトークンに割り当てられる許可。
user.phone_numberテキストユーザーの電話番号。SMS接続のあるユーザーに対してのみ有効です。
user.phone_verifiedブール値ユーザーが電話番号を確認済みかどうかを示します。SMS接続のあるユーザーに対してのみ有効です。
user.pictureテキストユーザーのプロファイル写真 を指すURL。
user.updated_at日時ユーザーのプロファイルが最後に更新/変更された日時を示すタイムスタンプ。last_loginの変更は更新と見なされます。そのため、ほとんどの場合、updated_atlast_loginに一致します。
user.user_idテキスト(一意)ユーザーの一意のプライマリID。
user.user_metadataオブジェクト勤務先住所、自宅住所、ユーザーの設定など、ユーザーのアクセスに影響を与えないユーザーの情報を保存するカスタムフィールド。詳細はメタデータをご覧ください。
user.usernameテキスト(一意)ユーザーのユーザー名。
I