GenAuth DocsDocuments
Concepts
User Guide
Development Integration
Metadata
Development Integration
Multi-tenant (beta)
Console Documentation
Multi-tenant Console
Tenant Console
Saas Application Demo
Concepts
User Guide
Development Integration
Metadata
Development Integration
Multi-tenant (beta)
Console Documentation
Multi-tenant Console
Tenant Console
Saas Application Demo
Old version
Concepts
  • What is GenAuth
  • What is User Pool
  • What is Application
  • What is Authentication
  • What is Federation Authentication
  • What is Zero Trust Network
  • Single Sign-On and Single Sign-Out
  • What is Authorization
  • Authentication vs Authorization
  • What is JWT Token
  • What is ID Token
  • What is Access Token
  • What is Refresh Token
  • Access Token vs Id Token
  • Understanding OIDC and OAuth2.0 Protocol

  • Understanding SAML2 Protocol

  • What is Multi-Factor Authentication
  • Account Lifecycle Management
  • Hosted Login Page vs Embeddable Login Component
  • CIAM and EIAM
  • What is LDAP
  • How QR Code Login Works
  • Basic Concepts of Cryptography
  1. Concepts
  2. /
  3. What is ID Token

¶ What is ID Token

Update time: 2025-04-11 11:21:15
Edit

In the OIDC protocol, you will encounter three types of tokens: id_token, access_token and refresh_token. This article will introduce what is ID Token, you can also read separately:

  • What is Access Token
  • What is Refresh Token

The most important extension of the OIDC (OpenID Connect) protocol (opens new window) to the OAuth 2.0 protocol (opens new window) is the ID Token data structure. ID Token is equivalent to the user's identity credential. The developer's front-end can carry ID Token when accessing the back-end interface. Developer server can verify the user's ID Token to determine the user's identity. After passing verification, relevant resources are returned.

ID Token is essentially a JWT Token, which contains key/value pairs related to the user's identity information, for example:

{
  "iss": "https://server.example.com",
  "sub": "24400320", // Abbreviation of subject, which is the user ID
  "aud": "s6BhdRkqt3",
  "nonce": "n-0S6_WzA2Mj",
  "exp": 1311281970,
  "iat": 1311280970,
  "auth_time": 1311280969,
  "acr": "urn:mace:incommon:iap:silver"
}

ID Token is essentially a JWT Token, which means:

  • The user's identity information is directly encoded into id_token, you don't need to request additional resources to obtain user information;
  • id_token can verify that it has not been tampered with. For details, please see How to Verify ID Token.

¶ ID Token complete field meaning

Field nameTranslation
subAbbreviation of subject, unique identifier, usually user ID
namegiven name
given_namegiven name
family_namesurname
middle_namemiddle name
nicknamenickname
preferred_usernamepreferred name
profilebasic information
pictureavatar
websitewebsite link
emailemail
email_verifiedwhether the email is verified
gendergender
birthdatebirthday
zoneinfotime zone
localeregion
phone_numbermobile number
phone_number_verifiedverified mobile number
addressaddress
formatteddetailed address
street_addressstreet address
localitycity
regionprovince
postal_codezip code
countrycountry
updated_atinformation update time

Refer to OIDC specification (opens new window)

Previous article: What is JWT Token Next article: What is Access Token
  • ID Token complete field meaning

User identity management

Integrated third-party login
Customized authentication process

Enterprise internal management

Single sign-on
Multi-factor authentication
Permission management

Developer

Development Documentation
GitHub (opens new window)

Company

official@genauth.ai
16th Floor, Building B, Beichen Century Center, Chaoyang District, Beijing (Total)
Room 406, 4th Floor, Block B, No. 200, Tianfu Fifth Street, High-tech Zone, Chengdu (Branch)

© Beijing Steamory Technology Co., Ltd.