¶ IdToken 添加扩展字段
更新时间: 2024-10-10 07:28:40
¶ 什么是 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
。