¶ OIDC

更新时间: 2025-02-18 09:00:47

¶ 场景介绍

概述：不同的 OIDC 身份服务商创建 OIDC Client 的过程可能会有所不同，你需要参考你的 OIDC 身份服务商的文档指引创建 OIDC Client。OIDC 是一个基于 OAuth2 协议的身份认证标准协议。
应用场景：创建 OIDC Client
终端用户预览图：

不同的 OIDC 身份服务商创建 OIDC Client 的过程可能会有所不同，你需要参考你的 OIDC 身份服务商的文档指引创建 OIDC Client。

你需要在合适的地方配置 OIDC Client 的回调链接。OIDC 客户端发起登录请求的时指定的回调链接需要和在 OIDC Identity Provider 处配置的回调链接匹配，否则会报错。

Authing 的 OIDC 回调链接为：https://core.authing.cn/connections/oidc/callback。

字段 / 功能	描述
唯一标识	唯一标识由小写字母、数字、- 组成，且长度小于 32 位。这是此连接的唯一标识，设置之后不能修改。
显示名称	这个名称会显示在终端用户的登录界面的按钮上。
应用 Logo	Authing 登录表单将在 "使用 {Display Name} 登录" 的按钮上显示此图标，该图标会展示为 20 * 20。
模式	前端模式会使用 response_mode=form_post 和 response_type=id_token 模式，后端模式会使用 response_type=code 授权码模式。
Issuer URL	你想要连接的 OpenID Connect provider 的 Issuer URL。
Client ID	OIDC 身份服务商提供的 Client ID。
Client Secret	OIDC 身份服务商提供的 Client Secret。
回调地址	有效跳转 URI。需要将此 URL 配置到 OIDC 身份服务商上。
登录模式	开启「仅登录模式」后，只能登录既有账号，不能创建新账号，请谨慎选择。
账号身份关联	不开启「账号身份关联」时，用户通过身份源登录时默认创建新用户。开启「账号身份关联」后，可以允许用户通过「字段匹配」或「询问绑定」的方式直接登录到已有的账号。

配置完成后，点击「创建」或者「保存」按钮完成创建。

前端模式：这种模式下，用户信息的交换会全部在浏览器前端完成，会使用 response_mode=form_post 和 response_type=id_token 模式，请确保你的 OIDC 应用打开了 implicit 模式，并且返回类型勾选上了 id_token
后端模式: 这种模式下，用户信息的交换会在 Authing 的服务器进行，会使用 response_type=code 授权码模式，所以需要提供你 OIDC 应用的密钥。

推荐开发接入方式：使用托管登录页
优劣势描述：运维简单，由 Authing 负责运维。每个用户池有一个独立的二级域名;如果需要嵌入到你的应用，需要使用弹窗模式登录，即：点击登录按钮后，会弹出一个窗口，内容是 Authing 托管的登录页面，或者将浏览器重定向到 Authing 托管的登录页。
详细接入方法：