メタデータの制限とベストプラクティス

​

制限事項

​

メタデータフィールドの制限

• メタデータフィールドでサポートされるのは、JSON 互換のデータ型 (文字列、数値、配列、オブジェクトなど) のみです。
• フィールド名に . (ドット) や $ (ドル記号) を含めることはできません。
  Disallowed

  {
    "preference.color": "pink"
  }
  

  Allowed

  {
      "preference": { 
          "color": "pink" 
      }
  }
  
• app_metadata フィールドには、次のプロパティを含めることはできません。
  • __tenant
  • _id
  • blocked
  • clientID
  • created_at
  • email_verified
  • email
  • globalClientID
  • global_client_id
  • identities
  • lastIP
  • lastLogin
  • loginsCount
  • metadata
  • multifactor_last_modified
  • multifactor
  • updated_at
  • user_id
• Auth0 Authentication API のSignup エンドポイントを使用して user_metadata フィールドを設定する場合、各値が 500 文字以下の文字列フィールドを最大 10 個まで含めることができます。カスタムのサインアッププロセスでメタデータを扱う例については、Custom Signupを参照してください。

​

ユーザープロファイルのサイズ制限

• Auth0 ユーザープロファイルのサイズ上限は 10 KB です。現在は、このサイズ上限を超えるプロファイルへの書き込みも成功しますが、今後失敗する可能性があります。テナントログではサイズ超過のプロファイルにフラグが付けられるため、エラーを回避するためにユーザープロファイルをサイズ上限内に収めることを強くお勧めします。
• サイズ制限導入前から存在するサイズ超過のユーザープロファイルについては、Management API の List または Search Users エンドポイントを使用してインデックス化、クエリ、および返却できるユーザーデータに、ユーザーごとに 1 MB の上限があります。大きなユーザープロファイルのすべてのユーザー属性を取得するには、ID またはメールでユーザーを取得します。

​

ベストプラクティス

​

機密情報

​

動的なフィールド名

{
    "participants": [
        "Alice": {
            "role": "sender"
         },
        "Bob": {
            "role": "receiver"
        }
    ]
}

{
    "participants": [
        {
            "name": "Alice",
            "role": "sender"
        },
        {
            "name" : "Bob",
            "role": "receiver"
        }
    ]
}

​

名前の競合

{
    "user_id": "samlp|example-samlp-connection|username@domain.com",
    "groups": [
        "external-group-1",
        "external-group-2"
    ],
    "app_metadata": {
        "groups": [
            "internal-group-1",
            "internal-group-2"
        ]
    }
}

​

データ型の統一

​

データの保存