协议同意门禁

平台协议更新后 authorize 会先跳协议确认页:触发条件、标准 OIDC 库的兼容性、prompt=none 的规范行为。

更新于 2026-10-10

协议同意门禁

本文说明通行证的协议同意机制对接入方的影响:什么情况下授权会被拦截、需要做什么(大多数情况:什么都不用做)。

通行证按「用户 × 协议版本 × 平台」记录协议同意。出现以下任一情况时, /oauth2/authorize 不会直接发 code,而是 302 到协议确认页:

  • 该用户首次登录你的平台;
  • 你的平台适用协议发布了新版本;
  • 用户在通行证「协议中心」撤回了对协议的同意。

用户侧流程

  1. 被拦截后用户看到协议确认页,列出待同意的协议(可点开看全文);
  2. 勾选同意后,通行证自动跳回原 authorize 地址继续发 code;
  3. 之后正常走授权码流程,直到协议再次更新前不会再打扰。

接入方需要做什么

标准 OIDC 库无需改造——跟随 302 即可。若你的 HTTP 客户端禁止跨站 302 (例如服务端渲染时用代码直接请求 authorize),请改为引导用户在浏览器中完成授权跳转。

prompt=none(静默授权)

使用 prompt=none 的平台:用户协议未同意时不弹确认页,按 OIDC 规范返回:

回调带 error=consent_required

请捕获该错误并引导用户走一次交互式登录(不带 prompt=none)。

用户管理入口

用户可在通行证顶栏「协议中心」查看各协议版本、自己的同意状态,并可撤回同意; 撤回后再次登录你的平台时会重新进入协议确认页。