数字化技能提升教程,数字化时代生存宝典

Sub2API多实例OIDC隔离配置与安全验收:Authentik、PKCE及回调测试

浏览:28

当同一套环境中运行多个 Sub2API 实例时,OIDC 身份认证不仅要保证登录流程正常,还需要确保各实例的 Application、Provider、Client ID 和回调地址相互独立,避免凭据串用或身份绑定错误。

本文以 sub2a、sub2b 两个实例为例,介绍如何通过 Authentik 完成多实例 OIDC 隔离验证,重点检查 Discovery 配置、严格回调地址、PKCE、nonce、state 校验,以及无效回调是否会产生身份绑定,帮助在正式上线前排查配置交叉和认证安全问题。

1. 隔离验收目标

两套实例配置不得串用。

隔离验收要证明每个实例从 Application、Provider 到回调和身份绑定均独立。按 sub2a、sub2b 成对记录;任何配置交叉都应判定为隔离验收失败,但是否返回 invalid oauth state 取决于回调阶段的 state 校验,不能把两者直接等同。

sub2a: one Application + one Provider
sub2b: one Application + one Provider

2. 双实例命名与地址

slug 为 sub2a、sub2b,端口为 :20443。

auth.lab.test:20443
sub2a.lab.test:20443 / sub2b.lab.test:20443

双实例命名与地址

地址核对协议、主机名、端口和路径。Authentik 使用 auth.lab.test:20443,两个应用使用各自主机名;slug 还进入 issuer、Discovery 路径。对象归属须打开详情确认。

3. 检查 Authentik 两套对象

两类列表均应各有 A、B 对象。

Application count: 2
Provider count: 2

检查 Authentik 两套对象

 

先查数量,再查名称和关联。两类 count 为 2 仍须确认 sub2a、sub2b 各关联自己的 Provider;发现重复、空关联或交叉时先修正对象。

4. 比较 Client ID 与 issuer

Client ID、Issuer 不交叉。

sub2a client_id: sub2a-lab-client
sub2b client_id: sub2b-lab-client

Client ID、Secret、issuer 属于同一实例。Client ID 可比对,Secret 只查状态不打印;issuer 必须以对应 slug 结尾,不能把 A 值复制到 B。

5. 比较严格回调地址

回调使用 strict,地址必须对应。

sub2a: https://sub2a.lab.test:20443/api/v1/auth/oauth/oidc/callback
sub2b: https://sub2b.lab.test:20443/api/v1/auth/oauth/oidc/callback

strict 回调要求主机名、20443 端口和 /api/v1/auth/oauth/oidc/callback 路径完整一致。不得增加通配符或尾斜杠;回错实例时先核对回调及对象关联。

6. 检查 Sub2API 安全开关

分别回读 OIDC 设置,敏感字段只查状态。

检查 Sub2API 安全开关

oidc_connect_enabled: true
oidc_connect_use_pkce: true
oidc_connect_validate_id_token: true

两个实例都启用连接、PKCE 和 ID Token 校验。回读只记布尔状态,Secret 记“已配置/未配置”;开关缺失时先修复并保存,再继续验证。

7. 验证两实例 Discovery

每个 slug 返回自己的 issuer 和端点。

.../application/o/sub2a/.well-known/openid-configuration
.../application/o/sub2b/.well-known/openid-configuration

检查 Sub2API 安全开关

 

分别请求两条 Discovery,核对 issuer、授权端点、令牌端点与 slug。可访问不等于回调成功;非 200 或 issuer 不匹配时按健康、slug、关联、端口顺序修复。

8. 验证 PKCE、nonce、state

授权请求使用 S256,并带 challenge、nonce、state。

code_challenge_method: S256
code_challenge: present; nonce: present; state: present

检查请求本身:code_challenge_method 为 S256,challenge、nonce、state 均存在。任一缺失或跨实例,停止验收并检查对应设置。

9. 执行无效 state 故障测试

向 B callback 发送无效值,观察拒绝结果。

GET /api/v1/auth/oauth/oidc/callback?code=invalid&state=invalid
expected: invalid oauth state

验证两实例 Discovery

 

该测试只验证拒绝路径,不使用真实授权码或秘密值。B callback 携带无效 code、state,预期为 invalid oauth state;若被接受或跳到另一实例即未通过。

10. 确认错误回调不写入身份

错误回调不得创建 OIDC 身份记录,回读状态确认无变化。

after invalid callback: no new identity binding

发送无效回调前记录身份 profile 或绑定状态,之后回读比较。预期无新的 identity binding;若变化,停止验收并检查 state 校验、callback 路由。

11. 检查容器和网关健康

健康检查覆盖 Authentik、网关和两个 Sub2API 应用。 

执行无效 state 故障测试

authentik server/worker/postgres: healthy
sub2a-app/sub2b-app/gateway: healthy

健康矩阵覆盖 Authentik server、worker、PostgreSQL、网关、sub2a-app、sub2b-app 及各自 PostgreSQL/Redis。组件异常时先恢复并重做 Discovery,再测登录或错误回调。

12. 上线验收与故障处理

登录错实例先比对 Client ID、Issuer、回调;state 错误从对应 HTTPS 重试。不要共享凭据。

修复顺序为:健康状态、slug 与对象关联、Client ID/issuer/strict callback、PKCE/nonce/state 和 ID Token 校验。每次只改目标实例,回读对象、Discovery、设置后重跑登录与无效 state。

上线前保留本地管理员入口,使用独立 Client Secret;截图、日志和验收记录不输出 Secret、Token、nonce 或身份材料。对象、路径、安全开关、Discovery、错误 state、无身份写入和健康矩阵全通过后才算完成。

pass: objects=2+2; issuer/callback isolated; PKCE=S256
pass: invalid state rejected; no identity created

相关阅读:

《Sub2API生产域名HTTPS接入与安全初始化》

《Sub2API双实例部署与基础验收指南》

相关文章
猜你喜欢