IDトークンの構造

IDトークンがJWT標準にどのように準拠しているか、また、トークン自体について表明されたJWTクレーム、認証されたユーザーに関する標準OIDCクレーム、さらにルールを使用して定義、管理し、トークンに追加するカスタムクレームが含まれることを説明します。

IDトークンは、JSON Web Token (JWT) 標準に従っています。つまり、基本構造は一般的な JWT Structure に準拠しており、トークン自体について表明された標準の JWT Claims が含まれます。

JWT に必要な内容に加えて、IDトークンには認証されたユーザーについて表明されたクレームも含まれます。これらは OpenID Connect (OIDC) プロトコルであらかじめ定義されているため、標準OIDCクレームと呼ばれます。標準OIDCクレームには、次のようなものがあります。

• name
• nickname
• picture
• email
• email_verified

標準OIDCクレームの一覧については、OIDC specification: Standard Claims を参照してください。custom claims を作成することもできます。これは、Auth0 Actions を使用して定義、管理し、トークンに追加するクレームです。

ユーザーの認証時にトークンをリクエストする際、パラメーターに特定の OpenID Connect Scopes を含めることで、アプリケーションが使用するIDトークンにどのOIDCクレームを含めるかを制御できます。IDトークンのリクエスト方法については、Get ID Tokens を参照してください。

​

ID トークンの例

この例では、ID トークンの内容を示しています。audience の値 (aud クレームに含まれる値) はアプリケーションの識別子に設定されています。つまり、このトークンを利用できるのはこの特定のアプリケーションのみです。この例に含まれるクレームの詳細については、JSON Web Token Claims を参照してください。

{
  "iss": "http://my-domain.auth0.com",
  "sub": "auth0|123456",
  "aud": "my_client_id",
  "exp": 1311281970,
  "iat": 1311280970,
  "name": "Jane Doe",
  "given_name": "Jane",
  "family_name": "Doe",
  "gender": "female",
  "birthdate": "0000-10-31",
  "email": "[e-mail]",
  "picture": "http://example.com/janedoe/me.jpg"
}

​

詳細

• IDトークン を取得する
• IDトークン を検証する
• IDトークン の有効期限を更新する