协议同意门禁
平台协议更新后 authorize 会先跳协议确认页:触发条件、标准 OIDC 库的兼容性、prompt=none 的规范行为。
更新于 2026-10-10
协议同意门禁
本文说明通行证的协议同意机制对接入方的影响:什么情况下授权会被拦截、需要做什么(大多数情况:什么都不用做)。
通行证按「用户 × 协议版本 × 平台」记录协议同意。出现以下任一情况时,
/oauth2/authorize 不会直接发 code,而是 302 到协议确认页:
- 该用户首次登录你的平台;
- 你的平台适用协议发布了新版本;
- 用户在通行证「协议中心」撤回了对协议的同意。
用户侧流程
- 被拦截后用户看到协议确认页,列出待同意的协议(可点开看全文);
- 勾选同意后,通行证自动跳回原 authorize 地址继续发 code;
- 之后正常走授权码流程,直到协议再次更新前不会再打扰。
接入方需要做什么
标准 OIDC 库无需改造——跟随 302 即可。若你的 HTTP 客户端禁止跨站 302 (例如服务端渲染时用代码直接请求 authorize),请改为引导用户在浏览器中完成授权跳转。
prompt=none(静默授权)
使用 prompt=none 的平台:用户协议未同意时不弹确认页,按 OIDC 规范返回:
回调带 error=consent_required
请捕获该错误并引导用户走一次交互式登录(不带 prompt=none)。
用户管理入口
用户可在通行证顶栏「协议中心」查看各协议版本、自己的同意状态,并可撤回同意; 撤回后再次登录你的平台时会重新进入协议确认页。