メインコンテンツへスキップ
Auth0 の正規化されたユーザープロファイルは、いくつかの異なるコンポーネントで構成されています。
  • 詳細: コア ユーザープロファイルオブジェクトです。事前定義された属性に、名前、メールアドレス、ユーザーの最新ログイン時刻のタイムスタンプなどの基本情報が含まれます。このオブジェクトには、ユーザーの接続元から取得した情報が含まれる場合もあります。ユーザー属性の大半はルート属性 (user オブジェクトの最初の、つまりルートレベルに格納される属性) で、その一部は編集可能です。
  • メタデータ: カスタマイズ可能な属性に追加のユーザー情報を格納するための補助ストレージとして機能する 2 つのサブオブジェクトです。user_metadata と app_metadata があります。app_metadata と user_metadata の使い分けを含む詳細については、ユーザープロファイルでのメタデータの仕組みを理解する を参照してください。

​
ユーザープロファイル属性

以下の属性は、ユーザープロファイルで利用できます。多くはルート属性 (user オブジェクトの先頭、つまりルートレベルに格納される属性) であり、以下の説明のとおり、一部は更新、インポート、およびエクスポートが可能です。 プライバシー上の理由から Auth0 に保存すべきでないユーザーフィールドがある場合は、Auth0 データベースに保持したくない属性を DenyList に追加できます。詳細については、Add User Attributes to the Deny List を参照してください。 デフォルトでは、Auth0 以外の (Google、Facebook、X など) から提供されるユーザープロファイル属性は、ユーザーがログインするたびに IDプロバイダー から更新されるため、直接編集できません。IDプロバイダー 由来の属性の詳細については、Configure Identity Provider Connection for User Profile Updates を参照してください。 正規化されたユーザープロファイルの name、nickname、given_name、family_name、picture の各ルート属性を編集できるようにするには、Auth0 との接続同期を設定 し、ユーザー属性が IDプロバイダー から更新されるのはユーザープロファイル作成時のみとなるようにする必要があります。これにより、これらのルート属性は個別に編集することも、一括インポートで編集することも可能になります
名前型説明検索可否更新可否インポート可?インポート時にアップサート可?エクスポート可?
app_metadataobjectサポートプラン、セキュリティロール (Authorization Core 機能セットを使用していない場合) 、アクセス制御グループなど、ユーザーのアクセスに影響する情報を格納するカスタムフィールドです。詳細については、Metadata Overview を参照してください。YYYYY
blockedbooleanユーザーがブロックされているかどうかを示します。インポートすると、Auth0 への移行時にもユーザーをブロック状態のまま維持できます。Y可可不可可
blocked_for配列 (オブジェクト)ブルートフォース攻撃の疑いでブロックされた IP アドレス。NNNNN
created_at日時ユーザープロファイルが最初に作成された日時を示すタイムスタンプ。YNNNY
emailテキスト(一意) ユーザーのメールアドレス。YYYNY
email_verified真偽値ユーザーがメールアドレスを確認済みかどうかを示します。YYYYY
family_nametextユーザーの姓です。YYYYY
given_nametextユーザーの名。YYYYY
guardian_authenticators配列 (オブジェクト)SMS やリカバリーコードを含む、ユーザーが設定した Guardian のバックアップ認証方法の詳細情報。NNNNN
identities配列 (オブジェクト)ユーザーが最初に認証したIDプロバイダーから取得した情報が含まれます。ユーザーは自分のプロフィールを複数のIDプロバイダーにリンクすることもできます。その場合、それらのIDもこの配列に含まれます。各IDプロバイダーオブジェクトの内容はプロバイダーによって異なりますが、通常は次の項目が含まれます。
  • connection (text): ユーザーの認証に使用されるAuth0接続の名前。
  • isSocial (boolean): 接続がソーシャル接続かどうかを示します。
  • provider (text): Facebook、Google、SAML、または独自のプロバイダーなど、ユーザーを認証するエンティティの名前。
  • user_id (text): この接続/プロバイダーにおけるユーザーの一意の識別子。
  • profileData (object): 接続に関連付けられたユーザー情報。プロフィールがリンクされている場合は、セカンダリアカウントに関連付けられたユーザー情報が格納されます。
場合によっては、プロバイダーで使用するAPIアクセストークンも含まれます。		YNNNY
last_ip文字列ユーザーの前回ログイン時のIPアドレス。YNNNY
last_login日時ユーザーが最後にログインした日時を示すタイムスタンプです。ユーザーがブロックされている状態でログインした場合でも、ブロックされたセッションによって last_login は更新されます。user< オブジェクトを使用して Rule 内からこのプロパティを参照している場合、その値はその Rule をトリガーしたログインに対応します。これは、Rule がログイン後に実行されるためです。YNNNY
last_password_reset日時ユーザーのパスワードが最後にリセットまたは変更された日時を示すタイムスタンプです。ユーザーの作成時点では、このフィールドは存在しません。このプロパティは、データベース接続でのみ使用できます。NNNNY
logins_count整数ユーザーのログイン回数。ユーザーがブロックされている状態でログインした場合も、そのセッションは logins_count に含まれます。可不可不可不可Y
multifactor配列 (文字列)ユーザーが登録している多要素認証プロバイダーのリスト。NNNNY
multifactor_last_modified日時ユーザーの多要素認証が最後に更新された日時。NNNNY
nametextユーザーのフルネーム。YYYYY
nicknameテキストユーザーのニックネーム。YYYYY
phone_numbertextユーザーの電話番号。SMS接続のユーザーにのみ有効です。YYNNY
phone_verifiedブール値ユーザーの電話番号が確認済みかどうかを示します。SMS 接続のユーザーに対してのみ有効です。YYNいいえはい
pictureテキストユーザーのプロフィール画像のURL。いいえはいYYY
tenanttext使用中のテナントの名前。NNNNN
updated_at日時ユーザーのプロフィールが最後に更新された日時を示すタイムスタンプです。last_login の変更も更新と見なされるため、ほとんどの場合、updated_at は last_login と一致します。はいいいえいいえNY
user_idtext(一意) ユーザーの識別子です。インポートすると、マッピングテーブルを使用せずに複数のシステム間でユーザーレコードを同期できます。YNYNY
user_metadataobject勤務先住所、自宅住所、ユーザー設定など、ユーザーがアクセスできる内容に影響しない情報を格納するカスタムフィールドです。詳細は、メタデータの概要を参照してください。YYYYY
usernametext(一意) ユーザーのusernameです。YYはいいいえはい

​
ユーザープロファイルの検証

Auth0 では、ユーザープロファイル内の特定のフィールドに対して、所定の検証スキーマを受け付けます。プロファイル属性値を設定する際の要件については、以下の表を参照してください。
ユーザープロファイルに保存される際、すべての文字は小文字に変換されます。これはすべての Auth0 データベース接続に当てはまります。Auth0 DB が信頼できる情報源ではない場合 (たとえば、import mode が off の custom DB) や、Auth0 が信頼できる情報源ではないその他のソーシャル接続やエンタープライズ接続では、メールアドレスは元のまま保持され、小文字には変換されません。
フィールド型文字数制限検証
emailメールアドレス最大長は、ユーザー名/ローカル部が 64 文字、ドメイン部が 256 文字です。JSON 検証スキーマ。
username文字列username のデフォルトの許容長は 1～15 文字です。最大長は 128 文字です。username フィールドでは、次の文字を使用できます。
英数字 (アクセント記号なし。保存時に自動的に小文字へ変換) ;
アットマーク (@) 文字 (ただし、メールアドレスは使用不可) ;
キャレット (^) 文字;
ドル記号 ($) 文字;
ドット (.) 文字;
感嘆符 (!) 文字;
グレーブアクセント (`) 文字;
ハイフン (-) 文字;
シャープ (#) 文字;
プラス (+) 文字;
シングルクォート (’) 文字;
チルダ (~) 文字;
アンダースコア (_) 文字;
これ以外の文字や記号は使用できません。また、Auth0 はカスタムデータベース入力の検証やサニタイズを行いません。
phone&#95;number電話番号標準形式
電話番号は E.164 形式である必要があります
password文字列設定できるパスワードの最小長は 1 バイト、最大長は 72 バイトです。標準文字: 33～126 の範囲の ASCII 文字が有効で、次が含まれます。
A から Z の大文字,
a から z の小文字,
0 から 9 の数字,
使用可能な特殊文字。
name文字列1～150 文字すべての UTF-8 文字がサポートされます
nickname文字列1～350 文字すべての UTF-8 文字がサポートされます
family&#95;name文字列1～150 文字すべての UTF-8 文字がサポートされます
`given_name`文字列1～150 文字すべての UTF-8 文字がサポートされます
技術的にはユーザープロファイルの一部ではありませんが、ユーザーのインポート時に重要となる可能性があるフィールドが、ほかに 3 つあります。
  • password_hash (text): ユーザーの接続用のハッシュ化済みパスワードです。ユーザーの作成時、Auth0 はパスワードの保護に bcrypt を使用します。互換性のあるハッシュ化済みパスワードをインポートすると、ユーザーは既存のパスワードを保持できるため、よりスムーズな利用体験を提供できます。互換性のあるパスワードは、bcrypt または を使用し、saltRounds が 10 でハッシュ化されている必要があります。なお、このフィールドを指定できるのはユーザーの初回インポート時のみで、後から更新することはできません。
  • custom_password_hash (object): 別のアルゴリズムを使用して作成された、ユーザーの接続用のハッシュ化済みパスワードです。password_hash フィールドの代わりに使用されます。一括インポート処理中、ユーザーが最初にインポートされた custom_password_hash を使用してログインしていない場合は、custom_password_hash を更新できます。

​
詳しく見る