¶ IdToken 添加扩展字段
更新时间: 2025-08-20 12:33:28
¶ 什么是 IdToken
id_token 相当于用户的身份证,开发者的前端访问后端接口时应当携带 id_token,开发者服务器需要校验前端传递的 id_token。可用 OIDC 应用的密钥或 OIDC 应用公钥验签,然后可以得到此 token 对应的用户 ID 以及基本信息。示例代码请见:使用应用密钥验证 Token。
在 Authing 中,用户信息的 token 字段就是一个 IdToken。
¶ IdToken 默认字段
一个 OIDC IdToken 默认包含以下字段,参考 OIDC 规范 (opens new window):
| 字段名 | 含义 | 
|---|---|
| sub | subject 的缩写,为用户 ID | 
| name | 姓名 | 
| given_name | 名字 | 
| family_name | 姓氏 | 
| middle_name | 中间名 | 
| nickname | 昵称 | 
| preferred_username | 希望被称呼的名字 | 
| profile | 基础资料 | 
| picture | 头像 | 
| website | 网站链接 | 
| 电子邮箱 | |
| email_verified | 邮箱是否被认证 | 
| gender | 性别 | 
| birthdate | 生日 | 
| zoneinfo | 时区 | 
| locale | 区域 | 
| phone_number | 手机号 | 
| phone_number_verified | 认证手机号 | 
| address | 地址 | 
| formatted | 详细地址 | 
| street_address | 街道地址 | 
| locality | 城市 | 
| region | 省 | 
| postal_code | 邮编 | 
| country | 国家 | 
| updated_at | 信息更新时间 | 
¶ IdToken 添加扩展字段
你可以使用 Authing 的 Pipeline 能力在用户认证流程中插入自定义代码段,给用户添加自定义 IdToken 字段。例如下面的例子中,我们给用户的 id_token 添加了 KEY 这个字段,值为 VALUE:
async function pipe(user, context, callback) {
  user.addToken('KEY', 'VALUE')
  callback(null, user, context)
}
你可以在这个网站 (opens new window)解析
id_token。