feat(sso): 应用管理补强 —— CAS service 白名单 / 应用元数据 / 可见范围 / 用户门户
安全修复(重要):CAS 首版未校验 service 白名单,/cas/login?service=https://evil 会把 已登录用户连同 ST-… 一起 302 出去,攻击者可据此换出用户名(开放重定向 + 票据外泄)。 现要求 service 命中某接入方登记的 redirect_uris(精确或忽略 query;绝不做前缀/通配): login 不过 → 403;validate → no;serviceValidate → INVALID_SERVICE(不复用 INVALID_TICKET)。 校验在签发票据之前;白名单复用「应用管理」注册表,不另开配置。 - 注册表增强:接入方新增 protocol(oauth2/cas) / description / logo_url / home_url / visible_roles·depts·groups(三项全空=全员可见),全部 #[serde(default)] 兼容存量 JSON; 元数据收进 AppMeta 并做归一化校验(访问地址必须 http(s),防 javascript:) - 用户门户(新建 portal.rs):GET /apps(按可见范围渲染卡片,CAS 应用直达 /cas/login?service=…) + GET /api/portal/apps(JSON);未登录 302 到 /login?redirect=<绝对地址> - oauth::current_user():管理台会话与终端用户 SSO 会话都认;is_safe_redirect 把 127.0.0.1/[::1] 与 localhost 同待遇(本地才能走完登录回跳) - 管理台:应用管理表单补齐新字段,列表显示协议徽标 + 可见范围提示 - e2e:第 7 套 [B] 改为先登记 CAS 应用,新增白名单断言;新增 [G] 门户段;[F] 补字段断言 → PASS=52 FAIL=0,七套全 rc=0 - 文档:README / CLAUDE.md / maxkey-migration-analysis / roadmap / design.md;技能补「必踩点 4、5」 与「给应用管理加字段的套路」;截图更新(应用管理 + 用户门户)
This commit is contained in:
1 parent
df8b9a08a8
commit
d63beeb15d
18 files changed
+737
-23
No files matched your search
@@ -277,7 +277,7 @@ _ => {
|
||||
**零新增 crate 是硬约束**(禁 crates.io/git 依赖):LDAP 不能用 `ldap3`(async/tokio 冲突)——
|
||||
改为**手工 BER/ASN.1** 编码做 Simple Bind(`ldap.rs`);HTTP 拉取用标准库 `TcpStream`(`sync.rs`)。
|
||||
|
||||
三个必踩点(本仓 2026-09-14 实测):
|
||||
五个必踩点(本仓 2026-09-14 实测):
|
||||
|
||||
1. **新模块读 env 必须进白名单**。nginx 默认剥离全部 env,worker 里 `std::env::var` 恒空。
|
||||
用了 `SYNC_*` / `PASSWORD_RESET_*` / `LDAP_*` 的模块,必须在 `nginx.conf` **和** `nginx.test.conf`
|
||||
@@ -290,6 +290,20 @@ _ => {
|
||||
整轮回归崩掉。正确做法:**一次性账号**闭环(admin 会话 `users/create` → forgot → reset → 新口令登录 →
|
||||
`users/delete`),并在 `trap ... EXIT` 里兜底清理;admin 全程不动。已锁时用
|
||||
`bash scripts/seed-data.sh --force` 复原 users.json(同时清掉账号锁)。
|
||||
4. **协议的安全约束不是可选项**。CAS 首版漏了 `service` 白名单 —— 任意
|
||||
`/cas/login?service=https://evil` 都会被 302 带上 `ST-…`,攻击者据此换出用户名
|
||||
(开放重定向 + 票据外泄)。做法:把白名单**复用「应用管理」的 `redirect_uris`**
|
||||
(`oauth_clients::allows_cas_service`),不另开配置;校验放在**签发票据之前**;
|
||||
各端点都要过(login → 403;validate/serviceValidate → `INVALID_SERVICE`,
|
||||
且不复用 `INVALID_TICKET`,否则排障会把「没登记」误判成「票据过期」)。
|
||||
匹配规则:精确相等 **或** 去掉 query/fragment 后相等(CAS 的 service 常带参数),
|
||||
但**绝不做前缀/通配**。同类:OAuth 的 `state`、PKCE、`redirect_uri` 精确匹配。
|
||||
5. **面向浏览器的端点要认两套登录态**。管理台会话(`session::authenticate`,
|
||||
内核会话表)与终端用户 SSO 会话(`sso_sid` cookie → 共享内存)是**独立存储**;
|
||||
门户 / CAS 登录页这类给人用的端点必须两套都认,否则出现「明明登录了却说未登录」。
|
||||
统一入口:`oauth::current_user(r)`。另外 `is_safe_redirect` 只认 http(s) 绝对 URL,
|
||||
**登录后回跳必须传绝对地址**(相对路径会被判不安全、退化成 JSON);本机回环
|
||||
`127.0.0.1` / `[::1]` 已与 localhost 同待遇,否则本地 e2e 走不完回跳链路。
|
||||
|
||||
---
|
||||
|
||||
@@ -335,6 +349,23 @@ _ => {
|
||||
页面 200 不等于功能可用。至少断言关键字符串:页签名/表格 id/按钮 `data-act`、页面里的表单提交地址、
|
||||
登录页的入口链接。`tests/maxkey-p1p2-e2e.sh` 的 `[F]` 段是范例。
|
||||
|
||||
### 给「应用管理」(接入方注册表)加字段的套路
|
||||
|
||||
本仓的接入方表(`oauth_clients`)就是 MaxKey 的「应用管理」,加字段要**同时**动五处,
|
||||
漏一处就是「存了但读不出」或「前端填了没保存」:
|
||||
|
||||
1. `oauth_state::OAuthClient` 加字段,**必须 `#[serde(default)]`**——否则存量
|
||||
`oauth_clients.json` 直接反序列化失败,等于全站应用消失。
|
||||
2. `oauth_clients::upsert` 的更新分支与新建立分支**都要赋值**(更新分支最容易漏)。
|
||||
3. 新增的元数据别一路加 `upsert` 参数(已 7 个),单独收进 `AppMeta` 结构,
|
||||
在 `impl AppMeta` 里做**归一化 + 校验**(如访问地址必须是 http(s),防 `javascript:`)。
|
||||
4. `oauth_clients::view` 补字段(管理台列表靠它)。
|
||||
5. `admin.html` 三处同步:表单 HTML、`fillClientForm`、`clearClientForm`、提交 payload
|
||||
(共四处,表单/回填/清空/提交缺一不可),列表渲染按需加列或徽标。
|
||||
|
||||
外带一个惯例:**可见范围三项全空 = 全员可见**(不是「谁都看不见」),
|
||||
门户过滤走 `OAuthClient::visible_to(role, dept, groups)`,OR 语义(角色/部门/用户组任一命中)。
|
||||
|
||||
---
|
||||
|
||||
## 高价值排错(症状 → 根因)
|
||||
|
||||
@@ -88,7 +88,7 @@ bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
|
||||
| --- | --- |
|
||||
| `gateway/src/lib.rs` | **装配层**:指令解析、共享内存建表(`state_zone_init`,fork 前一次)、`PLUGINS` 数组、API 的 content 阶段处理器与插件分发、`init_process` 播种 admin |
|
||||
| `crates/ipass-core/src/*` | **内核**:`state`(通用共享内存原语)/ `store`(JSON 原子读写)/ `users`(账号与 Key 的唯一写入口)/ `models`(仅共性字段 + `extra` 透传)/ `config`(仅共性策略常量与键前缀)/ `session`(管理员会话)/ `audit` / `http` / `util` / `plugin`(契约)/ `loc`(location 开关)。**不含** OAuth / TOTP 等个性代码 |
|
||||
| `crates/plugin-sso/src/*` | **身份插件**:`oauth`(OAuth2/OIDC 全部逻辑 + IAP 身份解析)/ `api`(路由表 + handler)/ `oauth_clients` / `oauth_keys`(OAuth/IAP 协议常量与共享内存键前缀,原属内核 `config`)/ `oauth_state`(OAuthClient 模型 + 注册表/授权码/会话状态,原属内核 `state`/`store`)/ `rsa`(手写 RS256)/ `captcha` / `otp`(TOTP 算法 + 账号侧 TOTP,数据存 `User.extra`)/ `scim`(SCIM 2.0 身份供给)/ `cas`(CAS 1.0/2.0 协议端点)/ `ldap`(LDAP/AD 认证源,零依赖手写 BER)/ `sync`(钉钉·企微·飞书同步连接器,手动触发)/ `reset`(自助密码重置)/ `geo`(登录 IP 归属地) |
|
||||
| `crates/plugin-sso/src/*` | **身份插件**:`oauth`(OAuth2/OIDC 全部逻辑 + IAP 身份解析)/ `api`(路由表 + handler)/ `oauth_clients` / `oauth_keys`(OAuth/IAP 协议常量与共享内存键前缀,原属内核 `config`)/ `oauth_state`(OAuthClient 模型 + 注册表/授权码/会话状态,原属内核 `state`/`store`)/ `rsa`(手写 RS256)/ `captcha` / `otp`(TOTP 算法 + 账号侧 TOTP,数据存 `User.extra`)/ `scim`(SCIM 2.0 身份供给)/ `cas`(CAS 1.0/2.0 协议端点)/ `ldap`(LDAP/AD 认证源,零依赖手写 BER)/ `sync`(钉钉·企微·飞书同步连接器,手动触发)/ `reset`(自助密码重置)/ `geo`(登录 IP 归属地)/ `portal`(终端用户门户「我的应用」) |
|
||||
| `crates/plugin-domain/src/*` | **域名插件**:`keys`(`sub:` 前缀、企业域名 zone、子域名形状与 TTL 常量)/ `models`(`DomainEntry`)/ `domains`(校验、申请/审核/删除、写穿共享内存)/ `resolve`(access 阶段解析 Host → `$proxy_backend_addr`)/ `api`(8 条管理态 + 账号态路由)/ `lib`(`DomainPlugin` 装配) |
|
||||
|
||||
> `models.rs` 的 `User` 只含**共性字段**(凭据 / 身份声明 / 锁定);iPass 等插件的个性字段
|
||||
@@ -154,7 +154,7 @@ bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
|
||||
(已用独立 Python 实现逐字节核对;`scripts/seed-data.sh` 里是同一套算法的 Python 版)。
|
||||
|
||||
8. **协议扩展端点(SCIM / CAS / 同步 / 密码重置)走「兄弟模块分发」,不改主路由表**:
|
||||
`api.rs` 的 `route()` 兜底段(`_ =>`)按 `scim → cas → reset → sync` 顺序调用各模块的
|
||||
`api.rs` 的 `route()` 兜底段(`_ =>`)按 `scim → cas → reset → sync → portal` 顺序调用各模块的
|
||||
`route(method, uri)`,命中即用其 `(Guard, Handler)`;各模块自持路径前缀与鉴权级别。
|
||||
新增同类能力**优先照此扩展**,不要往主表里逐条塞路径。`geo::lookup(ip)` 是纯函数,
|
||||
审计写登录事件时补归属地(内网/中国/海外),无状态。
|
||||
@@ -228,6 +228,8 @@ bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
|
||||
| 证书看着没过期却报 TLS 错 | 先 `openssl s_client -servername <域名>` 看链路**实际**收到的证书;acme.sh 产物在 `~/.acme.sh/`,与 `conf/tls/` 是两份,续期后必须拷过去再 reload |
|
||||
| `--with-pcre` 源码树挪位置后编译报 `pcre2.h not found` | 见「构建」小节:必须重新 `./configure && make` |
|
||||
| 新模块读不到 `SYNC_*` / `PASSWORD_RESET_*` 等 env | nginx 默认剥离全部 env;必须在 `nginx.conf`/`nginx.test.conf` **main 上下文**加 `env XXX;`,否则 worker 里 `std::env::var` 恒空 |
|
||||
| CAS `/cas/login?service=…` 返回 403 或 serviceValidate 回 `INVALID_SERVICE` | `service` 不在「应用管理」登记的回调地址里(这是**期望行为**,防开放重定向/票据外泄) | 在管理台该应用的回调地址里登记该 service(协议选 CAS);白名单复用注册表,无独立配置 |
|
||||
| 用户门户 `/apps` 看不到某个应用 | 该应用设了可见范围(角色/部门/用户组),当前用户不在内 | 管理台「OAuth 应用」里清空可见范围 = 全员可见;或把用户角色/部门/用户组加进去 |
|
||||
| CAS `/cas/login` 302 没带 `Location` | `http::redirect` 发了**空 body** → `create_buffer_from_str("")` 返回 None → `NGX_ERROR`;redirect 的 body 必须非空 |
|
||||
| e2e 重置类用例把 admin 锁死 | 别改 admin 种子口令(`123456` 过不了 8 位策略、无法用重置接口还原);用一次性账号,否则后续套件登录失败会触发 600s 账号锁定 |
|
||||
| 终端用户点邮件里的重置链接报 405 / 空白 | 链接指向了 POST 端点 `POST /api/public/reset-password`;必须指向 GET 页面 `/reset?token=…`(见 `reset.rs::send_reset`) |
|
||||
@@ -253,6 +255,8 @@ bash tests/maxkey-p1p2-e2e.sh http://127.0.0.1:18098 # 单跑第 7 套(SCIM/
|
||||
|
||||
# P1/P2 新增端点(网关在跑时;$JAR 为管理员登录后的 cookie 罐)
|
||||
curl -s -b "$JAR" http://127.0.0.1:18098/scim/v2/ServiceProviderConfig | python3 -m json.tool
|
||||
curl -s -b "$JAR" http://127.0.0.1:18098/api/portal/apps | python3 -m json.tool # 门户:我可见的应用
|
||||
curl -s http://127.0.0.1:18098/apps # 门户页面(未登录会 302 到 /login?redirect=…)
|
||||
curl -s -o/dev/null -w '%{redirect_url}\n' -b "$JAR" 'http://127.0.0.1:18098/cas/login?service=http://app/cb' # 应见 ?ticket=ST-
|
||||
curl -s -X POST http://127.0.0.1:18098/api/public/forgot-password --data 'username=alice' # 自助找回
|
||||
curl -s -b "$JAR" -X POST http://127.0.0.1:18098/api/admin/sync/dingtalk # 手动触发同步(需配 SYNC_*_URL)
|
||||
|
||||
@@ -106,7 +106,7 @@ sso/
|
||||
│ ├── rs256-jwks-e2e.sh RS256 + JWKS 本地验签
|
||||
│ ├── admin-users-batch-e2e.sh 管理接口(账号批量维护)
|
||||
│ ├── domain-e2e.sh 域名插件(申请/审核/转发)
|
||||
│ ├── maxkey-p1p2-e2e.sh MaxKey P1/P2(SCIM/CAS/密码重置/同步/LDAP)
|
||||
│ ├── maxkey-p1p2-e2e.sh MaxKey P1/P2(SCIM/CAS/密码重置/同步/LDAP/应用门户)
|
||||
│ └── demo-system/ 演示用「简单业务系统」(Python 标准库)
|
||||
├── scripts/
|
||||
│ ├── run-local-e2e.sh 本机一键起停 + 跑七套 e2e
|
||||
@@ -158,6 +158,8 @@ sso/
|
||||
| POST | `/api/public/forgot-password` | 自助密码找回(发一次性 token;防账号枚举) |
|
||||
| POST | `/api/public/reset-password` | 凭 token 重置口令(单次有效) |
|
||||
| POST | `/api/admin/sync/{dingtalk,workwechat,feishu}` | 手动触发身份同步(管理员) |
|
||||
| GET | `/apps` | **用户门户「我的应用」**(登录后按可见范围列出可访问应用,点击直达) |
|
||||
| GET | `/api/portal/apps` | 门户数据的 JSON(未登录 401) |
|
||||
|
||||
### 管理接口(`/api/admin/*`,需管理员会话 Cookie)
|
||||
|
||||
@@ -166,6 +168,7 @@ sso/
|
||||
| 会话 | `login` · `logout` · `session` |
|
||||
| 账号 | `users`(列表)· `users/create` · `users/key` · `users/password` · `users/display` · `users/profile`(部门/用户组)· `users/role` · `users/unlock` · `users/batch` · `users/totp/setup|enable|disable` · `users/delete` |
|
||||
| 同步 | `sync/dingtalk` · `sync/workwechat` · `sync/feishu`(手动触发,需配 `SYNC_*_URL`) |
|
||||
| 接入方 | `oauth-clients` · `oauth-clients/save` · `…/rotate` · `…/delete`;字段含 **协议类型**(oauth2/cas)、**访问地址**、**描述**、**图标**、**可见范围**(角色/部门/用户组) |
|
||||
| 运维 | `sessions`(在线会话列表)· `sessions/kick`(token / username / all 三种踢法)· `audit`(审计日志,含 IP 归属地) |
|
||||
| 接入方 | `oauth-clients`(列表)· `oauth-clients/save` · `oauth-clients/rotate` · `oauth-clients/delete` |
|
||||
|
||||
@@ -271,8 +274,8 @@ bash tests/maxkey-p1p2-e2e.sh # SCIM / CAS / 密码重置 /
|
||||
## 待执行任务
|
||||
|
||||
见 [`docs/roadmap.md`](docs/roadmap.md)。已完成:v2(RS256 + JWKS)、用户管理界面、
|
||||
v3(MaxKey/JNPF/uc 迁移 P0)、v4(MaxKey 迁移 **P1/P2**:SCIM 2.0 · CAS · LDAP/AD · 同步连接器 ·
|
||||
自助密码重置 · 登录 IP 归属地)。明确跳过:WebAuthn/Passkey、SAML 2.0、社交/扫码、FormBased。
|
||||
v3(MaxKey/JNPF/uc 迁移 P0)、v4(MaxKey 迁移 **P1/P2**:SCIM 2.0 · CAS(含 service 白名单)· LDAP/AD · 同步连接器 ·
|
||||
自助密码重置 · 登录 IP 归属地 · **应用管理增强与用户门户**)。明确跳过:WebAuthn/Passkey、SAML 2.0、社交/扫码、FormBased。
|
||||
明细与依据见 [`docs/maxkey-migration-analysis.md`](docs/maxkey-migration-analysis.md)。
|
||||
|
||||
---
|
||||
|
||||
+9
-3
@@ -636,12 +636,18 @@ DEMO_STYLE=standard DEMO_CLIENT_ID=demo-spa DEMO_PORT=18096 python3 examples/dem
|
||||
| 区块 | 作用 |
|
||||
| --- | --- |
|
||||
| 统一认证端点 | 列出 Discovery / 授权 / 令牌 / 用户信息 的标准端点与 MaxKey 别名,各带「复制」 |
|
||||
| 新建 / 更新接入方 | client_id、名称、机密/公开、密钥、回调地址(一行一个)、授权类型勾选、scope |
|
||||
| 接入方列表 | 类型徽标、回调地址、授权类型、scope、脱敏密钥 + 复制、重置密钥、编辑、删除 |
|
||||
| 新建 / 更新接入方 | client_id、名称、协议类型(OAuth2 / CAS)、机密/公开、密钥、**应用访问地址**、
|
||||
**描述**、**图标 URL**、**可见范围**(角色 / 部门 / 用户组)、回调地址(一行一个,CAS 时即 service 白名单)、授权类型勾选、scope |
|
||||
| 接入方列表 | 协议徽标 + 类型徽标、可见范围提示、回调地址、授权类型、scope、脱敏密钥 + 复制、重置密钥、编辑、删除 |
|
||||
|
||||
顶部统计卡新增「OAuth 接入方」计数。
|
||||
|
||||

|
||||

|
||||
|
||||
终端用户门户 `GET /apps`:登录后按**可见范围**列出可访问的应用,卡片直接进入
|
||||
(CAS 应用走 `/cas/login?service=…`;未配置访问地址的显示为灰底并标注):
|
||||
|
||||

|
||||
|
||||
登录页重做为与管理台同色系的卡片(登录失败时错误条落在卡片内部):
|
||||
|
||||
|
||||
@@ -151,6 +151,9 @@ MaxKey 的 44 张表里,对本项目最有参考价值的三组设计:
|
||||
| ip2location | `plugin-sso/src/geo.rs` | 内嵌代表性 CN IPv4 CIDR 表 + 内网/保留段判定,零依赖粗判「内网/中国/海外」 | 审计日志 / 管理台「会话·审计」页 |
|
||||
| **管理台界面** | `source/www/admin.html` | 新增「身份同步」(钉钉/企微/飞书手动触发 + 结果)、「会话 / 审计」(在线会话 + 踢下线 + 审计含归属地)两个页签;账号行加「双因子」;接入指南补 CAS / SCIM / LDAP 三段 | `tests/maxkey-p1p2-e2e.sh` §F |
|
||||
| **终端用户页面** | `plugin-sso/src/reset.rs`(`GET /forgot`、`GET /reset?token=`)+ `oauth.rs` 登录页入口 | 自助密码重置的可点开入口;`send_reset` 的重置链接改为指向页面 URL(原来指向 POST 端点,点开必然失败) | §F |
|
||||
| **应用管理增强** | `oauth_state.rs` / `oauth_clients.rs` / `admin.html` | 接入方新增 **协议类型**(oauth2/cas)、**访问地址**、**描述**、**图标**、**可见范围**(角色/部门/用户组,三项全空=全员);管理台表单与列表同步(`#[serde(default)]` 向后兼容存量注册表) | §G |
|
||||
| **CAS service 白名单** | `cas.rs` + `oauth_clients::allows_cas_service` | `service` 必须命中已登记回调地址(精确或忽略 query),否则 login → 403、serviceValidate → `INVALID_SERVICE`。**修复开放重定向 + 票据外泄**:原先任意 service 都会被 302 带票据 | §B |
|
||||
| **用户门户「我的应用」** | `plugin-sso/src/portal.rs` | `GET /apps`(会话态,按可见范围过滤后服务端渲染卡片,CAS 应用直接 `/cas/login?service=…` 直达)+ `GET /api/portal/apps`(JSON)。未登录 302 到 `/login?redirect=<绝对地址>` | §G |
|
||||
|
||||
> 环境变量白名单:nginx 默认剥离全部 env,`nginx.conf` / `nginx.test.conf` 已加
|
||||
> `env SYNC_*`、`env PASSWORD_RESET_*`(未声明则 worker 读不到)。
|
||||
+17
-2
@@ -214,11 +214,26 @@
|
||||
接入指南补 CAS 1.0/2.0、SCIM 2.0、LDAP/AD 三段端点与配置说明。接入方/Session/审计均复用既有 API,后端零改动。
|
||||
- [x] **自助密码重置的终端用户页面**:新增 `GET /forgot`(找回)与 `GET /reset?token=…`(设新口令)两个 HTML 页,
|
||||
登录页加「忘记密码?」入口;并修正 `send_reset` 的链接——原本指向 **POST** 端点,用户点开必然失败。
|
||||
- [x] **应用管理增强 + 用户门户**(2026-09-14 追加):
|
||||
· 接入方新增 **协议类型**(oauth2/cas)、**应用访问地址**、**描述**、**图标 URL**、
|
||||
**可见范围**(角色 / 部门 / 用户组,三项全空 = 全员可见);管理台表单与列表同步,
|
||||
存量 `oauth_clients.json` 靠 `#[serde(default)]` 向后兼容。
|
||||
· **CAS `service` 白名单**:`service` 必须命中某个已登记应用的 `redirect_uris`
|
||||
(精确或忽略 query),否则 login → 403、serviceValidate → `INVALID_SERVICE`。
|
||||
修掉一个真实的**开放重定向 + 票据外泄**:原先任意 `service` 都会被 302 带上 `ST-…`。
|
||||
· **用户门户 `GET /apps`**(`portal.rs`):登录后按可见范围列出可访问应用,
|
||||
卡片直接进入(CAS 应用走 `/cas/login?service=…`);另有 `GET /api/portal/apps` 供前端调用。
|
||||
· `oauth::current_user()` 统一登录态:管理台会话与终端用户 SSO 会话都认;
|
||||
`is_safe_redirect` 把 `127.0.0.1` / `[::1]` 与 localhost 同待遇(本地才能走完回跳链路)。
|
||||
- [x] 修复 `http::redirect` 空 body 触发 `NGX_ERROR`(CAS 302 失效根因);全仓修 `$var` 紧跟全角字符的 shell 坑
|
||||
|
||||
> 踩坑留档:① nginx 默认剥离 env,新模块用到的 `SYNC_*` / `PASSWORD_RESET_*` 必须在 conf 里显式 `env`;
|
||||
> ② 重置类 e2e 不得改 admin 种子口令(`123456` 过不了 8 位策略、无法还原),改用一次性账号闭环;
|
||||
> ③ 同步 mock 端口避开 nginx 已占用的 18097;
|
||||
> ④ **页面里 JS 花括号别用 `format!` 拼**——Rust 侧改用「占位符 `replace`」(见 `reset.rs` 的 `FORGOT_PAGE`/`RESET_PAGE`),
|
||||
> 否则每个 `{` 都得写成 `{{`,改一次错一次。
|
||||
> ④ **页面里 JS 花括号别用 `format!` 拼**——Rust 侧改用「占位符 `replace`」(见 `reset.rs` 的 `FORGOT_PAGE`/`RESET_PAGE`、
|
||||
> `portal.rs` 的 `APPS_PAGE`),否则每个 `{` 都得写成 `{{`,改一次错一次。
|
||||
> ⑤ **协议端点别只做「能跑通」**:CAS 的首版就没做 `service` 白名单,等于给任何站点发门票。
|
||||
> 协议规范里的安全约束(service 白名单、state 校验、PKCE)都要落地,并写进 e2e 断言。
|
||||
> ⑥ 登录态有两套(管理台会话 / 终端用户 `sso_sid`),面向浏览器的端点必须**两套都认**
|
||||
> (见 `oauth::current_user`),否则会出现「明明登录了却说未登录」。
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 615 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 633 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 139 KiB |
@@ -148,6 +148,7 @@ fn route(method: &str, uri: &str) -> Option<(Guard, Handler)> {
|
||||
// ---- SCIM 2.0 身份供给(路径含 {id} 变量,走前缀匹配)----------
|
||||
// ---- CAS 1.0/2.0 协议端点(精确 GET,走独立路由)----------------
|
||||
// ---- 自助密码重置(公开端点,精确 POST)------------------------
|
||||
// ---- 终端用户门户「我的应用」(GET /apps,会话态)---------------
|
||||
_ => {
|
||||
if let Some(e) = crate::scim::route(method, uri) {
|
||||
return Some(e);
|
||||
@@ -161,6 +162,9 @@ fn route(method: &str, uri: &str) -> Option<(Guard, Handler)> {
|
||||
if let Some(e) = crate::sync::route(method, uri) {
|
||||
return Some(e);
|
||||
}
|
||||
if let Some(e) = crate::portal::route(method, uri) {
|
||||
return Some(e);
|
||||
}
|
||||
return None;
|
||||
}
|
||||
};
|
||||
@@ -945,6 +949,13 @@ fn h_admin_oauth_clients(r: *mut ngx_http_request_t, _actor: Actor) -> Status {
|
||||
"authorize_v20": format!("{iss}/oauth/v20/authorize"),
|
||||
"token_v20": format!("{iss}/oauth/v20/token"),
|
||||
"profile_v20": format!("{iss}/oauth/v20/me"),
|
||||
// CAS 协议(protocol=cas 的应用用这一组)
|
||||
"cas_login": format!("{iss}/cas/login"),
|
||||
"cas_validate": format!("{iss}/cas/validate"),
|
||||
"cas_service_validate": format!("{iss}/cas/serviceValidate"),
|
||||
"cas_logout": format!("{iss}/cas/logout"),
|
||||
// 终端用户门户(登录后可访问的应用)
|
||||
"portal": format!("{iss}/apps"),
|
||||
},
|
||||
}),
|
||||
"ok",
|
||||
@@ -961,6 +972,17 @@ fn h_admin_oauth_client_save(r: *mut ngx_http_request_t, _actor: Actor) -> Statu
|
||||
// 先记录「此前是否存在」:管理台据此决定要不要弹「请立即复制密钥」
|
||||
let existed = oauth_clients::all().iter().any(|c| c.client_id == client_id);
|
||||
|
||||
// 应用元数据(协议 / 门户展示 / 可见范围)。与凭证字段分开传,避免 upsert 参数爆炸。
|
||||
let meta = oauth_clients::AppMeta {
|
||||
protocol: p.get("protocol").map(String::as_str).unwrap_or("").to_owned(),
|
||||
description: p.get("description").map(String::as_str).unwrap_or("").to_owned(),
|
||||
logo_url: p.get("logo_url").map(String::as_str).unwrap_or("").to_owned(),
|
||||
home_url: p.get("home_url").map(String::as_str).unwrap_or("").to_owned(),
|
||||
visible_roles: parse_list(p.get("visible_roles").map(String::as_str).unwrap_or("")),
|
||||
visible_depts: parse_list(p.get("visible_depts").map(String::as_str).unwrap_or("")),
|
||||
visible_groups: parse_list(p.get("visible_groups").map(String::as_str).unwrap_or("")),
|
||||
};
|
||||
|
||||
match oauth_clients::upsert(
|
||||
&client_id,
|
||||
p.get("name").map(String::as_str).unwrap_or(""),
|
||||
@@ -969,6 +991,7 @@ fn h_admin_oauth_client_save(r: *mut ngx_http_request_t, _actor: Actor) -> Statu
|
||||
parse_list(p.get("scopes").map(String::as_str).unwrap_or("")),
|
||||
confidential,
|
||||
p.get("client_secret").map(String::as_str).unwrap_or(""),
|
||||
meta,
|
||||
) {
|
||||
Ok(c) => {
|
||||
util::log_notice(&format!(
|
||||
|
||||
@@ -8,6 +8,11 @@
|
||||
//! * `/cas/serviceValidate` 走 CAS 2.0 XML,`/cas/validate` 走 CAS 1.0 纯文本,
|
||||
//! `/cas/proxyValidate` 与 serviceValidate 同形(忽略代理链)。
|
||||
//!
|
||||
//! **`service` 必须命中接入方注册表**(某个应用的 `redirect_uris`),否则一律拒绝:
|
||||
//! 缺了这道校验,`/cas/login?service=https://evil.com` 会把已登录用户连同 `ST-…`
|
||||
//! 一起 302 出去,攻击者再拿票据换出用户名——开放重定向 + 票据外泄。
|
||||
//! CAS 协议本身也要求服务端登记白名单,这里复用「应用管理」的登记数据,不另设配置。
|
||||
//!
|
||||
//! 鉴权全部 `Guard::Public`:login 自己读会话、validate 靠 ticket,都不依赖调用方会话。
|
||||
|
||||
use ngx::ffi::ngx_http_request_t;
|
||||
@@ -78,8 +83,7 @@ fn h_cas_login(r: *mut ngx_http_request_t, _actor: crate::api::Actor) -> Status
|
||||
let ip = http::remote_addr(r);
|
||||
let ua = http::header(r, "user-agent").unwrap_or_default();
|
||||
|
||||
let cookie = http::header(r, "cookie");
|
||||
let Some(user) = session::authenticate(cookie.as_deref()) else {
|
||||
let Some(user) = crate::oauth::current_user(r) else {
|
||||
// 未登录:跳登录页(浏览器走完登录后会带着会话回来重放本请求)。
|
||||
// 无 service 时无法回跳,直接 401 让调用方先建会话。
|
||||
if service.is_empty() {
|
||||
@@ -89,6 +93,28 @@ fn h_cas_login(r: *mut ngx_http_request_t, _actor: crate::api::Actor) -> Status
|
||||
return http::redirect(r, "/login");
|
||||
};
|
||||
|
||||
// service 白名单:必须是登记过回调地址的接入方。放在**签发票据之前**——
|
||||
// 先发后查等于已经把一个可换用户名的票据递出去了。
|
||||
if !crate::oauth_clients::allows_cas_service(&service) {
|
||||
util::log_warn(&format!(
|
||||
"[cas] 拒绝未登记的 service:{service}(user={user} ip={ip})"
|
||||
));
|
||||
audit::log(
|
||||
"cas.login.deny",
|
||||
&user,
|
||||
&user,
|
||||
false,
|
||||
&ip,
|
||||
&ua,
|
||||
&format!("service not registered: {service}"),
|
||||
);
|
||||
return http::fail(
|
||||
r,
|
||||
HTTPStatus::FORBIDDEN,
|
||||
"service 未在「应用管理」中登记,拒绝签发票据",
|
||||
);
|
||||
}
|
||||
|
||||
let ticket = new_ticket();
|
||||
let now = util::now();
|
||||
if !issue_ticket(&ticket, &user, &service, now) {
|
||||
@@ -120,6 +146,10 @@ fn h_cas_validate(r: *mut ngx_http_request_t, _actor: crate::api::Actor) -> Stat
|
||||
let ticket = p.get("ticket").map(String::as_str).unwrap_or("").to_owned();
|
||||
let now = util::now();
|
||||
|
||||
// 白名单优先于票据校验:未登记的 service 连「票据是否有效」都不该知道。
|
||||
if !crate::oauth_clients::allows_cas_service(&service) {
|
||||
return http::send_ct(r, HTTPStatus::OK, "no\n", "text/plain; charset=utf-8");
|
||||
}
|
||||
match consume_ticket(&ticket, &service, now) {
|
||||
Some(user) => http::send_ct(r, HTTPStatus::OK, &format!("yes\n{user}\n"), "text/plain; charset=utf-8"),
|
||||
None => http::send_ct(r, HTTPStatus::OK, "no\n", "text/plain; charset=utf-8"),
|
||||
@@ -133,6 +163,17 @@ fn h_cas_service_validate(r: *mut ngx_http_request_t, _actor: crate::api::Actor)
|
||||
let ticket = p.get("ticket").map(String::as_str).unwrap_or("").to_owned();
|
||||
let now = util::now();
|
||||
|
||||
// 未登记服务:CAS 2.0 规范里对应 INVALID_SERVICE,且**不复用** INVALID_TICKET
|
||||
// ——否则运维排障会把「没登记地址」误判成「票据过期」。
|
||||
if !crate::oauth_clients::allows_cas_service(&service) {
|
||||
let body = format!(
|
||||
"<cas:serviceResponse xmlns:cas='http://www.yale.edu/tp/cas'>\n\
|
||||
\x20 <cas:authenticationFailure code='INVALID_SERVICE'>service 未在应用管理中登记</cas:authenticationFailure>\n\
|
||||
</cas:serviceResponse>\n"
|
||||
);
|
||||
return http::send_ct(r, HTTPStatus::OK, &body, "application/xml; charset=utf-8");
|
||||
}
|
||||
|
||||
match consume_ticket(&ticket, &service, now) {
|
||||
Some(user) => {
|
||||
let body = format!(
|
||||
|
||||
@@ -19,6 +19,7 @@ mod ldap;
|
||||
mod scim;
|
||||
mod otp;
|
||||
mod reset;
|
||||
mod portal;
|
||||
mod sync;
|
||||
pub mod oauth;
|
||||
mod oauth_clients;
|
||||
|
||||
@@ -512,6 +512,27 @@ fn parse_cookie(header: Option<&str>, name: &str) -> Option<String> {
|
||||
None
|
||||
}
|
||||
|
||||
/// 当前登录用户:**管理台会话与终端用户 SSO 会话都认**。
|
||||
///
|
||||
/// 两套会话是互相独立的存储:管理台走 `session::authenticate`(内核会话表),
|
||||
/// 终端用户走 `sso_sid` cookie + 共享内存。CAS 登录页与用户门户面向浏览器,
|
||||
/// 用户从任一侧登录进来都可能命中,这里依次尝试——否则会出现「明明已登录,
|
||||
/// 却被告知未登录」的诡异现象。
|
||||
pub fn current_user(r: *mut ngx_http_request_t) -> Option<String> {
|
||||
let cookie = http::header(r, "cookie");
|
||||
if let Some(u) = ipass_core::session::authenticate(cookie.as_deref()) {
|
||||
return Some(u);
|
||||
}
|
||||
let tok = parse_cookie(cookie.as_deref(), OAUTH_SESSION_COOKIE)?;
|
||||
let payload = crate::oauth_state::get_oauth_session(&tok, util::now())?;
|
||||
let name = payload.split('\n').next().unwrap_or("").trim().to_owned();
|
||||
if name.is_empty() {
|
||||
None
|
||||
} else {
|
||||
Some(name)
|
||||
}
|
||||
}
|
||||
|
||||
fn sso_cookie(token: &str, max_age: i64) -> String {
|
||||
let dom = cookie_domain();
|
||||
let dom_part = if dom.is_empty() { String::new() } else { format!("; Domain={dom}") };
|
||||
@@ -1433,7 +1454,14 @@ fn is_safe_redirect(url: &str) -> bool {
|
||||
if host.ends_with(&dom) && !dom.is_empty() {
|
||||
return true;
|
||||
}
|
||||
if host == "localhost" || host.starts_with("localhost:") {
|
||||
// 本机回环与 localhost 同待遇:本地联调(e2e 用 127.0.0.1)必须能走完
|
||||
// 「未登录 → 登录 → 回跳」全链路,否则门户页只能落回 JSON。
|
||||
if host == "localhost"
|
||||
|| host.starts_with("localhost:")
|
||||
|| host == "127.0.0.1"
|
||||
|| host.starts_with("127.0.0.1:")
|
||||
|| host == "[::1]"
|
||||
{
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -60,6 +60,61 @@ pub fn all() -> Vec<OAuthClient> {
|
||||
crate::oauth_state::read_oauth_clients()
|
||||
}
|
||||
|
||||
// ===========================================================================
|
||||
// 应用元数据(管理台新表单字段)
|
||||
// ===========================================================================
|
||||
|
||||
/// 与凭证无关的应用元数据。单独成结构,避免 `upsert` 参数一路加到 13 个。
|
||||
#[derive(Debug, Clone, Default)]
|
||||
pub struct AppMeta {
|
||||
pub protocol: String,
|
||||
pub description: String,
|
||||
pub logo_url: String,
|
||||
pub home_url: String,
|
||||
pub visible_roles: Vec<String>,
|
||||
pub visible_depts: Vec<String>,
|
||||
pub visible_groups: Vec<String>,
|
||||
}
|
||||
|
||||
impl AppMeta {
|
||||
/// 规整 + 校验。**在写盘前拒掉**,别让一个 `javascript:` 的访问地址
|
||||
/// 躺在门户页里等着被点击。
|
||||
fn normalized(mut self) -> Result<Self, String> {
|
||||
self.protocol = self.protocol.trim().to_lowercase();
|
||||
if self.protocol.is_empty() {
|
||||
self.protocol = "oauth2".to_owned();
|
||||
}
|
||||
if self.protocol != "oauth2" && self.protocol != "cas" {
|
||||
return Err(format!(
|
||||
"不支持的协议类型:{}(可选 oauth2 / cas)",
|
||||
self.protocol
|
||||
));
|
||||
}
|
||||
let clean = |v: Vec<String>| -> Vec<String> {
|
||||
let mut out: Vec<String> = v
|
||||
.into_iter()
|
||||
.map(|s| s.trim().to_owned())
|
||||
.filter(|s| !s.is_empty())
|
||||
.collect();
|
||||
out.dedup();
|
||||
out
|
||||
};
|
||||
self.visible_roles = clean(self.visible_roles);
|
||||
self.visible_depts = clean(self.visible_depts);
|
||||
self.visible_groups = clean(self.visible_groups);
|
||||
self.description = self.description.trim().to_owned();
|
||||
for (label, u) in [("访问地址", &self.home_url), ("图标地址", &self.logo_url)] {
|
||||
let u = u.trim();
|
||||
if !u.is_empty() && !(u.starts_with("http://") || u.starts_with("https://")) {
|
||||
return Err(format!("{label}必须是 http(s) 绝对地址:{u}"));
|
||||
}
|
||||
}
|
||||
self.logo_url = self.logo_url.trim().to_owned();
|
||||
self.home_url = self.home_url.trim().to_owned();
|
||||
Ok(self)
|
||||
}
|
||||
}
|
||||
|
||||
// ===========================================================================
|
||||
// 写入(管理接口用)
|
||||
// ===========================================================================
|
||||
@@ -78,7 +133,9 @@ pub fn upsert(
|
||||
scopes: Vec<String>,
|
||||
confidential: bool,
|
||||
secret_in: &str,
|
||||
meta: AppMeta,
|
||||
) -> Result<OAuthClient, String> {
|
||||
let meta = meta.normalized()?;
|
||||
let client_id = util::trim(client_id).to_owned();
|
||||
if client_id.is_empty() {
|
||||
return Err("client_id 不能为空".to_owned());
|
||||
@@ -159,6 +216,13 @@ pub fn upsert(
|
||||
existing.grant_types = grant_types;
|
||||
existing.scopes = scopes;
|
||||
existing.confidential = confidential;
|
||||
existing.protocol = meta.protocol.clone();
|
||||
existing.description = meta.description.clone();
|
||||
existing.logo_url = meta.logo_url.clone();
|
||||
existing.home_url = meta.home_url.clone();
|
||||
existing.visible_roles = meta.visible_roles.clone();
|
||||
existing.visible_depts = meta.visible_depts.clone();
|
||||
existing.visible_groups = meta.visible_groups.clone();
|
||||
if !confidential {
|
||||
existing.client_secret = String::new();
|
||||
} else if !secret_in.is_empty() {
|
||||
@@ -175,6 +239,13 @@ pub fn upsert(
|
||||
scopes,
|
||||
confidential,
|
||||
created_at: now,
|
||||
protocol: meta.protocol.clone(),
|
||||
description: meta.description.clone(),
|
||||
logo_url: meta.logo_url.clone(),
|
||||
home_url: meta.home_url.clone(),
|
||||
visible_roles: meta.visible_roles.clone(),
|
||||
visible_depts: meta.visible_depts.clone(),
|
||||
visible_groups: meta.visible_groups.clone(),
|
||||
};
|
||||
table.push(c.clone());
|
||||
Ok(c)
|
||||
@@ -244,6 +315,44 @@ pub fn delete(client_id: &str) -> Result<(), String> {
|
||||
Ok(())
|
||||
}
|
||||
|
||||
// ===========================================================================
|
||||
// CAS service 白名单 / 门户可见应用
|
||||
// ===========================================================================
|
||||
|
||||
/// CAS `service` 是否可信:必须命中某个已登记接入方的回调地址。
|
||||
///
|
||||
/// 热路径**不读文件**——直接遍历 `ocl:` 共享内存镜像(与授权路径同源)。
|
||||
/// 没有这道校验时,`/cas/login?service=https://evil.com` 会把已登录用户
|
||||
/// 连同 `ST-…` 一起 302 出去,攻击者据此即可换出用户名(开放重定向 + 票据外泄)。
|
||||
pub fn allows_cas_service(service: &str) -> bool {
|
||||
if service.is_empty() {
|
||||
return false;
|
||||
}
|
||||
for (_k, payload, _exp) in state::iter_prefix_ex(KEY_OAUTH_CLIENT_PREFIX) {
|
||||
if let Ok(c) = serde_json::from_str::<OAuthClient>(&payload) {
|
||||
if c.allows_service(service) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
false
|
||||
}
|
||||
|
||||
/// 当前用户可见的应用(门户「我的应用」用)。按可见范围过滤,按展示名排序。
|
||||
pub fn visible_apps(role: &str, dept: &str, groups: &[String]) -> Vec<OAuthClient> {
|
||||
let mut v: Vec<OAuthClient> = state::iter_prefix_ex(KEY_OAUTH_CLIENT_PREFIX)
|
||||
.into_iter()
|
||||
.filter_map(|(_k, payload, _exp)| serde_json::from_str::<OAuthClient>(&payload).ok())
|
||||
.filter(|c| c.visible_to(role, dept, groups))
|
||||
.collect();
|
||||
v.sort_by(|a, b| {
|
||||
a.display_name()
|
||||
.cmp(b.display_name())
|
||||
.then_with(|| a.client_id.cmp(&b.client_id))
|
||||
});
|
||||
v
|
||||
}
|
||||
|
||||
/// 管理台可见投影(含脱敏后的 secret,便于复制)。
|
||||
pub fn view(c: &OAuthClient) -> serde_json::Value {
|
||||
json!({
|
||||
@@ -257,5 +366,12 @@ pub fn view(c: &OAuthClient) -> serde_json::Value {
|
||||
"client_secret_masked": util::mask_key(&c.client_secret),
|
||||
"created_at": c.created_at,
|
||||
"created_at_text": util::fmt_time(c.created_at),
|
||||
"protocol": c.protocol_or_default(),
|
||||
"description": c.description,
|
||||
"logo_url": c.logo_url,
|
||||
"home_url": c.home_url,
|
||||
"visible_roles": c.visible_roles,
|
||||
"visible_depts": c.visible_depts,
|
||||
"visible_groups": c.visible_groups,
|
||||
})
|
||||
}
|
||||
@@ -33,6 +33,30 @@ pub struct OAuthClient {
|
||||
pub scopes: Vec<String>,
|
||||
pub confidential: bool,
|
||||
pub created_at: i64,
|
||||
|
||||
// ---- 应用管理增强(2026-09-14):以下字段全部 `#[serde(default)]`,
|
||||
// 保证存量 `oauth_clients.json`(无这些键)照旧能反序列化。
|
||||
/// 协议类型:`oauth2`(缺省,含 OIDC)| `cas`。决定管理台给出的接入说明,
|
||||
/// 以及门户里「点击卡片如何进入应用」。
|
||||
#[serde(default)]
|
||||
pub protocol: String,
|
||||
/// 应用描述(门户卡片副标题)。
|
||||
#[serde(default)]
|
||||
pub description: String,
|
||||
/// 应用图标 URL(门户卡片)。
|
||||
#[serde(default)]
|
||||
pub logo_url: String,
|
||||
/// 应用访问地址(门户点击直达)。OAuth 应用由**应用侧**发起授权,网关无从
|
||||
/// 推导入口地址,所以要显式登记。
|
||||
#[serde(default)]
|
||||
pub home_url: String,
|
||||
/// 可见范围:三项**全空 = 全员可见**;非空则「属于任一白名单」即可见。
|
||||
#[serde(default)]
|
||||
pub visible_roles: Vec<String>,
|
||||
#[serde(default)]
|
||||
pub visible_depts: Vec<String>,
|
||||
#[serde(default)]
|
||||
pub visible_groups: Vec<String>,
|
||||
}
|
||||
|
||||
pub type OAuthClientTable = Vec<OAuthClient>;
|
||||
@@ -55,6 +79,59 @@ impl OAuthClient {
|
||||
pub fn allows_grant(&self, grant: &str) -> bool {
|
||||
self.grant_types.iter().any(|g| g == grant)
|
||||
}
|
||||
|
||||
/// 协议类型(缺省视为 `oauth2`)。
|
||||
pub fn protocol_or_default(&self) -> &str {
|
||||
if self.protocol.is_empty() { "oauth2" } else { &self.protocol }
|
||||
}
|
||||
|
||||
/// 展示名:名称优先,回落 client_id(门户排序/卡片标题共用)。
|
||||
pub fn display_name(&self) -> &str {
|
||||
if self.name.is_empty() { &self.client_id } else { &self.name }
|
||||
}
|
||||
|
||||
/// 是否为 CAS service 白名单成员。
|
||||
///
|
||||
/// 匹配规则:**精确相等**,或**去掉 query/fragment 后**相等。后者是必要的——
|
||||
/// CAS 客户端的 `service` 常带自定义参数(`https://app/cb?tab=1`),而登记时
|
||||
/// 只填基地址(`https://app/cb`);不做归一化会把合法客户端挡在门外。
|
||||
/// 但绝不做前缀/通配匹配:`https://app/cb` 不能命中 `https://app/cb-evil`。
|
||||
pub fn allows_service(&self, service: &str) -> bool {
|
||||
let base = |u: &str| -> String {
|
||||
u.split(['?', '#'])
|
||||
.next()
|
||||
.unwrap_or("")
|
||||
.trim_end_matches('/')
|
||||
.to_owned()
|
||||
};
|
||||
let target = base(service);
|
||||
if target.is_empty() {
|
||||
return false;
|
||||
}
|
||||
self.redirect_uris
|
||||
.iter()
|
||||
.any(|u| u == service || base(u) == target)
|
||||
}
|
||||
|
||||
/// 门户可见性。三项白名单全空 = 全员可见;否则当前用户的角色 / 部门 /
|
||||
/// 用户组**落在任一白名单内**即可见(OR 语义,便于「角色 + 例外人员」组合)。
|
||||
pub fn visible_to(&self, role: &str, dept: &str, groups: &[String]) -> bool {
|
||||
if self.visible_roles.is_empty()
|
||||
&& self.visible_depts.is_empty()
|
||||
&& self.visible_groups.is_empty()
|
||||
{
|
||||
return true;
|
||||
}
|
||||
if self.visible_roles.iter().any(|r| r == role) {
|
||||
return true;
|
||||
}
|
||||
if !dept.is_empty() && self.visible_depts.iter().any(|d| d == dept) {
|
||||
return true;
|
||||
}
|
||||
groups
|
||||
.iter()
|
||||
.any(|g| self.visible_groups.iter().any(|w| w == g))
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,231 @@
|
||||
//! 终端用户门户「我的应用」(对齐 MaxKey 的统一门户)。
|
||||
//!
|
||||
//! 管理台登记的应用(`oauth_clients` 注册表)在这里以**卡片**形式呈现给终端用户:
|
||||
//! 登录后能看到「自己可访问的应用」并直接进入,不必记住各系统的地址。
|
||||
//!
|
||||
//! * `GET /apps` 门户页(HTML,服务端渲染)
|
||||
//! * `GET /api/portal/apps` 同一份数据的 JSON(给其他前端/脚本用)
|
||||
//!
|
||||
//! 可见范围由应用上的 `visible_roles` / `visible_depts` / `visible_groups` 决定
|
||||
//! (三项全空 = 全员可见),过滤逻辑在 `oauth_clients::visible_apps`。
|
||||
//!
|
||||
//! 鉴权是**会话态**(SSO cookie,`Guard::Public` + 自己读会话),不是 `Guard::User`
|
||||
//! 的 API Key——门户是给人用浏览器打开的,不是给程序调的。
|
||||
|
||||
use ngx::core::Status;
|
||||
use ngx::ffi::ngx_http_request_t;
|
||||
use ngx::http::HTTPStatus;
|
||||
|
||||
use ipass_core::http;
|
||||
use ipass_core::users;
|
||||
|
||||
use crate::accounts::UserExt;
|
||||
use crate::oauth_clients;
|
||||
use crate::oauth_state::OAuthClient;
|
||||
use crate::utilx;
|
||||
|
||||
/// 门户页模板。用占位符 `replace` 拼装,**不用 `format!`**——页面里的 CSS/JS
|
||||
/// 到处都是 `{}`,走 `format!` 得逐个写成 `{{`/`}}`,改一次错一次。
|
||||
const APPS_PAGE: &str = r##"<!DOCTYPE html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width,initial-scale=1">
|
||||
<title>我的应用 · 统一认证</title>
|
||||
<style>
|
||||
*{box-sizing:border-box}
|
||||
body{margin:0;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Hiragino Sans GB","Microsoft YaHei",sans-serif;background:#f5f7fb;color:#1f2937}
|
||||
.top{background:#fff;border-bottom:1px solid #e5e7eb;padding:14px 22px;display:flex;align-items:center;gap:14px}
|
||||
.brand{font-weight:600;font-size:15px}
|
||||
.who{margin-left:auto;font-size:13px;color:#6b7280}
|
||||
.quit{border:1px solid #d1d5db;background:#fff;color:#374151;border-radius:8px;padding:5px 12px;font-size:13px;cursor:pointer}
|
||||
.quit:hover{border-color:#9ca3af;background:#f9fafb}
|
||||
main{max-width:980px;margin:0 auto;padding:26px 18px 60px}
|
||||
h1{font-size:20px;margin:6px 0 4px}
|
||||
.sub{color:#6b7280;font-size:13px;margin-bottom:20px}
|
||||
.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(232px,1fr));gap:14px}
|
||||
.app{display:block;background:#fff;border:1px solid #e5e7eb;border-radius:12px;padding:16px;text-decoration:none;color:inherit;transition:.15s}
|
||||
a.app:hover{border-color:#2563eb;box-shadow:0 6px 18px rgba(37,99,235,.10);transform:translateY(-1px)}
|
||||
.app.off{opacity:.62;cursor:default}
|
||||
.logo{width:42px;height:42px;border-radius:10px;background:#eef2ff;display:flex;align-items:center;justify-content:center;font-weight:600;font-size:17px;color:#2563eb;overflow:hidden}
|
||||
.logo img{width:100%;height:100%;object-fit:cover}
|
||||
.name{margin-top:10px;font-weight:600;font-size:15px;word-break:break-all}
|
||||
.desc{margin-top:4px;font-size:12.5px;color:#6b7280;line-height:1.5;min-height:19px;word-break:break-word}
|
||||
.tags{margin-top:10px;display:flex;gap:6px;flex-wrap:wrap}
|
||||
.tag{font-size:11px;border-radius:999px;padding:2px 8px;background:#eff6ff;color:#2563eb}
|
||||
.tag.gray{background:#f3f4f6;color:#6b7280}
|
||||
.empty{background:#fff;border:1px dashed #d1d5db;border-radius:12px;padding:40px;text-align:center;color:#6b7280;font-size:13.5px;line-height:1.7}
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="top">
|
||||
<span class="brand">统一认证 · 我的应用</span>
|
||||
<span class="who">已登录:{{WHO}}</span>
|
||||
<button class="quit" onclick="doLogout()">退出</button>
|
||||
</div>
|
||||
<main>
|
||||
<h1>我的应用</h1>
|
||||
<div class="sub">共 {{COUNT}} 个可访问应用。灰底卡片未配置访问地址,需管理员在「应用管理」里补全。</div>
|
||||
{{BODY}}
|
||||
</main>
|
||||
<script>
|
||||
function doLogout(){
|
||||
fetch('/logout',{method:'POST',credentials:'same-origin'})
|
||||
.then(function(){location.href='/login';})
|
||||
.catch(function(){location.href='/login';});
|
||||
}
|
||||
</script>
|
||||
</body>
|
||||
</html>"##;
|
||||
|
||||
/// 路由:门户端点。
|
||||
pub fn route(method: &str, uri: &str) -> Option<(crate::api::Guard, crate::api::Handler)> {
|
||||
if method != "GET" {
|
||||
return None;
|
||||
}
|
||||
let g = crate::api::Guard::Public;
|
||||
match uri {
|
||||
"/apps" => Some((g, h_apps_page)),
|
||||
"/api/portal/apps" => Some((g, h_apps_json)),
|
||||
_ => None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 卡片的进入地址。
|
||||
///
|
||||
/// * CAS 应用:走 `/cas/login?service=<登记的 service>`(网关侧发起,能直接落到应用);
|
||||
/// * 其他:用登记的应用访问地址 `home_url`;
|
||||
/// * 都没有则返回空——OAuth 应用由**应用侧**发起授权,网关推不出入口,
|
||||
/// 此时卡片显示为不可点击(比给一个点了没反应的链接好)。
|
||||
fn entry_url(c: &OAuthClient) -> String {
|
||||
if c.protocol_or_default() == "cas" {
|
||||
if let Some(first) = c.redirect_uris.first() {
|
||||
return format!("/cas/login?service={}", utilx::url_encode(first));
|
||||
}
|
||||
}
|
||||
c.home_url.clone()
|
||||
}
|
||||
|
||||
/// 登录用户名 → (展示名, 角色, 部门, 用户组)。查不到用户时给安全兜底(什么权限都没有)。
|
||||
fn actor_scope(username: &str) -> (String, String, String, Vec<String>) {
|
||||
match users::get(username) {
|
||||
Some(u) => {
|
||||
let disp = if u.display_name.is_empty() {
|
||||
u.username.clone()
|
||||
} else {
|
||||
u.display_name.clone()
|
||||
};
|
||||
(disp, u.role.clone(), u.department().to_owned(), u.groups())
|
||||
}
|
||||
None => (username.to_owned(), String::new(), String::new(), Vec::new()),
|
||||
}
|
||||
}
|
||||
|
||||
/// `GET /apps`:门户页。
|
||||
fn h_apps_page(r: *mut ngx_http_request_t, _actor: crate::api::Actor) -> Status {
|
||||
let Some(username) = crate::oauth::current_user(r) else {
|
||||
// 未登录:跳登录页并带上回跳。回跳必须是**绝对地址**——登录成功后的
|
||||
// 安全性校验(`is_safe_redirect`)只认 http(s) 绝对 URL,传 `/apps` 会被
|
||||
// 判为不安全而退化成 JSON 响应(浏览器上就是一片白)。
|
||||
let back = format!("{}/apps", crate::oauth::issuer());
|
||||
return http::redirect(r, &format!("/login?redirect={}", utilx::url_encode(&back)));
|
||||
};
|
||||
|
||||
let (disp, role, dept, groups) = actor_scope(&username);
|
||||
let apps = oauth_clients::visible_apps(&role, &dept, &groups);
|
||||
|
||||
let body = if apps.is_empty() {
|
||||
"<div class='empty'>暂无可访问的应用。<br>请联系管理员在管理台「OAuth 应用」中登记,<br>并把你的角色 / 部门 / 用户组加入该应用的可见范围。</div>".to_owned()
|
||||
} else {
|
||||
let mut cards = String::with_capacity(apps.len() * 512);
|
||||
cards.push_str("<div class='grid'>");
|
||||
for c in &apps {
|
||||
cards.push_str(&card_html(c));
|
||||
}
|
||||
cards.push_str("</div>");
|
||||
cards
|
||||
};
|
||||
|
||||
let html = APPS_PAGE
|
||||
.replace("{{WHO}}", &utilx::html_escape(&disp))
|
||||
.replace("{{COUNT}}", &apps.len().to_string())
|
||||
.replace("{{BODY}}", &body);
|
||||
http::send_ct(r, HTTPStatus::OK, &html, "text/html; charset=utf-8")
|
||||
}
|
||||
|
||||
/// 单张应用卡片。
|
||||
fn card_html(c: &OAuthClient) -> String {
|
||||
let name_raw = c.display_name();
|
||||
let entry = entry_url(c);
|
||||
let logo = if c.logo_url.is_empty() {
|
||||
let initial = name_raw
|
||||
.chars()
|
||||
.next()
|
||||
.map(|ch| ch.to_uppercase().to_string())
|
||||
.unwrap_or_else(|| "?".to_owned());
|
||||
format!("<div class='logo'>{}</div>", utilx::html_escape(&initial))
|
||||
} else {
|
||||
format!(
|
||||
"<div class='logo'><img src=\"{}\" alt=\"\"></div>",
|
||||
utilx::html_escape(&c.logo_url)
|
||||
)
|
||||
};
|
||||
let desc = if c.description.is_empty() {
|
||||
String::new()
|
||||
} else {
|
||||
utilx::html_escape(&c.description)
|
||||
};
|
||||
let proto_tag = if c.protocol_or_default() == "cas" {
|
||||
"<span class='tag'>CAS</span>"
|
||||
} else {
|
||||
"<span class='tag'>OAuth2 / OIDC</span>"
|
||||
};
|
||||
let inner = format!(
|
||||
"{logo}<div class='name'>{}</div><div class='desc'>{desc}</div>\
|
||||
<div class='tags'>{proto_tag}<span class='tag gray'>{}</span></div>",
|
||||
utilx::html_escape(name_raw),
|
||||
utilx::html_escape(&c.client_id)
|
||||
);
|
||||
if entry.is_empty() {
|
||||
// 灰底 + 明确标签:只靠 opacity 不够显眼,用户会以为是加载失败
|
||||
format!(
|
||||
"<div class='app off' title='该应用未登记访问地址'>{inner}\
|
||||
<div class='tags'><span class='tag gray'>未配置访问地址</span></div></div>"
|
||||
)
|
||||
} else {
|
||||
format!("<a class='app' href=\"{}\">{inner}</a>", utilx::html_escape(&entry))
|
||||
}
|
||||
}
|
||||
|
||||
/// `GET /api/portal/apps`:同一份数据的 JSON(未登录 401)。
|
||||
fn h_apps_json(r: *mut ngx_http_request_t, _actor: crate::api::Actor) -> Status {
|
||||
let Some(username) = crate::oauth::current_user(r) else {
|
||||
return http::fail(r, HTTPStatus::UNAUTHORIZED, "未登录或会话已过期");
|
||||
};
|
||||
let (disp, role, dept, groups) = actor_scope(&username);
|
||||
let items: Vec<serde_json::Value> = oauth_clients::visible_apps(&role, &dept, &groups)
|
||||
.iter()
|
||||
.map(|c| {
|
||||
serde_json::json!({
|
||||
"client_id": c.client_id,
|
||||
"name": c.display_name(),
|
||||
"description": c.description,
|
||||
"logo_url": c.logo_url,
|
||||
"protocol": c.protocol_or_default(),
|
||||
"home_url": c.home_url,
|
||||
"redirect_uris": c.redirect_uris,
|
||||
"entry_url": entry_url(c),
|
||||
})
|
||||
})
|
||||
.collect();
|
||||
http::ok(
|
||||
r,
|
||||
serde_json::json!({
|
||||
"username": username,
|
||||
"display_name": disp,
|
||||
"portal": format!("{}/apps", crate::oauth::issuer()),
|
||||
"items": items,
|
||||
}),
|
||||
"ok",
|
||||
)
|
||||
}
|
||||
+69
-5
@@ -292,7 +292,10 @@
|
||||
<h2>新建 / 更新接入方</h2>
|
||||
<div class="desc">登记一个第三方应用。机密客户端(服务端应用)持有密钥,用 <code>client_secret</code> 换令牌;
|
||||
公开客户端(SPA / 移动端)不持有密钥,必须走 PKCE。回调地址必须与申请时传入的 <code>redirect_uri</code>
|
||||
完全一致,否则授权请求会被拒。</div>
|
||||
完全一致,否则授权请求会被拒。<br>
|
||||
<b>协议选 CAS 时,上面的地址同时就是 <code>/cas/login?service=…</code> 的白名单</b>:
|
||||
未登记的 service 会被网关直接拒绝(403 / <code>INVALID_SERVICE</code>),
|
||||
防止有人把带票据的回跳引到外站。可见范围决定该应用在用户门户 <code>/apps</code> 里对谁可见。</div>
|
||||
<form id="upsertClientForm" class="grid-form two">
|
||||
<div><label for="ocId">client_id</label><input id="ocId" class="field-mono" type="text" placeholder="grafana" required></div>
|
||||
<div><label for="ocName">应用名称</label><input id="ocName" type="text" placeholder="Grafana 监控面板"></div>
|
||||
@@ -307,8 +310,35 @@
|
||||
<label for="ocSecret">客户端密钥(留空 = 自动生成 / 不修改)</label>
|
||||
<input id="ocSecret" class="field-mono" type="text" placeholder="留空即可" autocomplete="off">
|
||||
</div>
|
||||
<div>
|
||||
<label for="ocProto">协议类型</label>
|
||||
<select id="ocProto">
|
||||
<option value="oauth2">OAuth2 / OIDC(标准授权码)</option>
|
||||
<option value="cas">CAS 1.0 / 2.0(老应用单点登录)</option>
|
||||
</select>
|
||||
</div>
|
||||
<div>
|
||||
<label for="ocHome">应用访问地址(门户入口)</label>
|
||||
<input id="ocHome" class="field-mono" type="text" placeholder="https://grafana.example.com">
|
||||
</div>
|
||||
<div class="span-all">
|
||||
<label for="ocRedirects">回调地址(一行一个,必须是 http(s) 绝对地址)</label>
|
||||
<label for="ocDesc">应用描述(门户卡片副标题,可空)</label>
|
||||
<input id="ocDesc" type="text" placeholder="监控告警面板">
|
||||
</div>
|
||||
<div class="span-all">
|
||||
<label for="ocLogo">应用图标 URL(门户卡片,可空)</label>
|
||||
<input id="ocLogo" class="field-mono" type="text" placeholder="https://…/logo.png">
|
||||
</div>
|
||||
<div class="span-all">
|
||||
<label>可见范围(三项全空 = 全员可见;多个用逗号或空格分隔)</label>
|
||||
<div style="display:flex;gap:10px;flex-wrap:wrap">
|
||||
<input id="ocVisRoles" class="field-mono" type="text" placeholder="角色,如 admin user" style="flex:1;min-width:180px">
|
||||
<input id="ocVisDepts" class="field-mono" type="text" placeholder="部门,如 研发中心" style="flex:1;min-width:180px">
|
||||
<input id="ocVisGroups" class="field-mono" type="text" placeholder="用户组,如 ops" style="flex:1;min-width:180px">
|
||||
</div>
|
||||
</div>
|
||||
<div class="span-all">
|
||||
<label for="ocRedirects">回调地址 / CAS service(一行一个,必须是 http(s) 绝对地址)</label>
|
||||
<textarea id="ocRedirects" rows="2" class="field-mono" placeholder="https://grafana.example.com/login/generic_oauth"></textarea>
|
||||
</div>
|
||||
<div class="span-all">
|
||||
@@ -835,6 +865,17 @@ env LDAP_AUTO_CREATE; # 1 = LDAP 认证成功后自动建号</code></pre>
|
||||
if (ep.discovery) $("guideDiscovery").textContent = ep.discovery;
|
||||
}
|
||||
|
||||
// 可见范围提示:三项全空 = 全员可见,不显示;否则列出限制项。
|
||||
// 放在名称下方而不是单独一列——列表已经有 8 列了。
|
||||
function visibleCell(c) {
|
||||
var parts = [];
|
||||
if (arr(c.visible_roles).length) parts.push("角色:" + arr(c.visible_roles).join("/"));
|
||||
if (arr(c.visible_depts).length) parts.push("部门:" + arr(c.visible_depts).join("/"));
|
||||
if (arr(c.visible_groups).length) parts.push("用户组:" + arr(c.visible_groups).join("/"));
|
||||
if (!parts.length) return "";
|
||||
return "<div class='muted' style='font-size:11.5px;margin-top:2px'>限 " + esc(parts.join(" · ")) + "</div>";
|
||||
}
|
||||
|
||||
function renderOAuthClients() {
|
||||
var body = $("oauthClientsBody");
|
||||
if (!state.oauthClients.length) {
|
||||
@@ -867,8 +908,10 @@ env LDAP_AUTO_CREATE; # 1 = LDAP 认证成功后自动建号</code></pre>
|
||||
|
||||
return "<tr>" +
|
||||
"<td><b class='mono'>" + esc(c.client_id) + "</b></td>" +
|
||||
"<td>" + esc(c.name || "-") + "</td>" +
|
||||
"<td>" + (c.confidential
|
||||
"<td>" + esc(c.name || "-") + visibleCell(c) + "</td>" +
|
||||
"<td>" + (c.protocol === "cas"
|
||||
? "<span class='badge b-warn'>CAS</span>"
|
||||
: "<span class='badge b-blue'>OAuth2</span>") + " " + (c.confidential
|
||||
? "<span class='badge b-blue'>机密</span>"
|
||||
: "<span class='badge b-gray'>公开</span>") + "</td>" +
|
||||
"<td>" + redirectCell + "</td>" +
|
||||
@@ -918,6 +961,13 @@ env LDAP_AUTO_CREATE; # 1 = LDAP 认证成功后自动建号</code></pre>
|
||||
$("ocGCred").checked = grants.indexOf("client_credentials") !== -1;
|
||||
$("ocGPass").checked = grants.indexOf("password") !== -1;
|
||||
$("ocScopes").value = arr(c.scopes).join(" ");
|
||||
$("ocProto").value = c.protocol === "cas" ? "cas" : "oauth2";
|
||||
$("ocHome").value = c.home_url || "";
|
||||
$("ocDesc").value = c.description || "";
|
||||
$("ocLogo").value = c.logo_url || "";
|
||||
$("ocVisRoles").value = arr(c.visible_roles).join(" ");
|
||||
$("ocVisDepts").value = arr(c.visible_depts).join(" ");
|
||||
$("ocVisGroups").value = arr(c.visible_groups).join(" ");
|
||||
syncClientTypeUI();
|
||||
}
|
||||
|
||||
@@ -933,6 +983,13 @@ env LDAP_AUTO_CREATE; # 1 = LDAP 认证成功后自动建号</code></pre>
|
||||
$("ocGCred").checked = false;
|
||||
$("ocGPass").checked = false;
|
||||
$("ocScopes").value = "openid profile email";
|
||||
$("ocProto").value = "oauth2";
|
||||
$("ocHome").value = "";
|
||||
$("ocDesc").value = "";
|
||||
$("ocLogo").value = "";
|
||||
$("ocVisRoles").value = "";
|
||||
$("ocVisDepts").value = "";
|
||||
$("ocVisGroups").value = "";
|
||||
syncClientTypeUI();
|
||||
}
|
||||
|
||||
@@ -1237,7 +1294,14 @@ env LDAP_AUTO_CREATE; # 1 = LDAP 认证成功后自动建号</code></pre>
|
||||
redirect_uris: $("ocRedirects").value,
|
||||
grant_types: grants.join(","),
|
||||
scopes: $("ocScopes").value,
|
||||
confidential: $("ocType").value === "confidential"
|
||||
confidential: $("ocType").value === "confidential",
|
||||
protocol: $("ocProto").value,
|
||||
home_url: $("ocHome").value.trim(),
|
||||
description: $("ocDesc").value.trim(),
|
||||
logo_url: $("ocLogo").value.trim(),
|
||||
visible_roles: $("ocVisRoles").value,
|
||||
visible_depts: $("ocVisDepts").value,
|
||||
visible_groups: $("ocVisGroups").value
|
||||
};
|
||||
// 密钥留空就不传这个字段:新建时后端自动生成,更新时保留原值
|
||||
var secret = $("ocSecret").value.trim();
|
||||
|
||||
@@ -6,11 +6,12 @@
|
||||
# 这是第 7 套(在原有 6 套之后跑),只新增断言,不改既有 6 套行为。
|
||||
# 覆盖:
|
||||
# - SCIM 2.0:ServiceProviderConfig / Users 全 CRUD + PATCH(管理员会话)
|
||||
# - CAS 1.0/2.0:登录签发 ST → serviceValidate 返回 XML / validate 返回纯文本
|
||||
# - CAS 1.0/2.0:service 白名单(未登记一律拒)+ 签发 ST → serviceValidate XML / validate 纯文本
|
||||
# - 自助密码重置:forgot →(token 落 sink 文件)→ reset → 用新口令登录成功
|
||||
# - 同步连接器:本地 mock 用户目录 → /api/admin/sync/dingtalk → 账号 upsert
|
||||
# - LDAP:禁用时管理员登录正常、未知账号 401(不 panic、不尝试 bind)
|
||||
# - 界面:管理台单页含新增页签/按钮、终端用户 /forgot 与 /reset 页面可访问
|
||||
# - 应用管理:协议类型 / 门户字段 / 可见范围;用户门户 /apps 按可见范围过滤
|
||||
#
|
||||
# 前置:网关以 source/conf/nginx.test.conf 运行(见 scripts/run-local-e2e.sh)
|
||||
# 依赖:curl、python3
|
||||
@@ -32,7 +33,7 @@ SYNC_MOCK_PORT="${SYNC_MOCK_PORT:-18088}"
|
||||
|
||||
JAR="$(mktemp -t sso_p1p2_cookies.XXXXXX.txt)"
|
||||
JAR2="$(mktemp -t sso_p1p2_cookies2.XXXXXX.txt)"
|
||||
trap 'rm -f "$JAR" "$JAR2"; [ -n "${MOCK_PID:-}" ] && kill "$MOCK_PID" 2>/dev/null || true; [ -n "${RSTU:-}" ] && curl -s -o /dev/null -b "$JAR" -X POST "$BASE/api/admin/users/delete" -d "username=$RSTU" >/dev/null 2>&1 || true' EXIT
|
||||
trap 'rm -f "$JAR" "$JAR2"; [ -n "${MOCK_PID:-}" ] && kill "$MOCK_PID" 2>/dev/null || true; [ -n "${RSTU:-}" ] && curl -s -o /dev/null -b "$JAR" -X POST "$BASE/api/admin/users/delete" -d "username=$RSTU" >/dev/null 2>&1 || true; for _a in "${CAS_APP:-}" "${HID_APP:-}"; do [ -n "$_a" ] && curl -s -o /dev/null -b "$JAR" -X POST "$BASE/api/admin/oauth-clients/delete" -d "client_id=$_a" >/dev/null 2>&1 || true; done' EXIT
|
||||
|
||||
PASS=0; FAIL=0
|
||||
ok() { echo " ✅ $1"; PASS=$((PASS+1)); }
|
||||
@@ -96,8 +97,29 @@ code="$(curl -s -o /dev/null -w '%{http_code}' -b "$JAR" -X DELETE "$BASE/scim/v
|
||||
|
||||
# ===========================================================================
|
||||
echo
|
||||
echo "############ [B] CAS 1.0 / 2.0 协议 ############"
|
||||
echo "############ [B] CAS 1.0 / 2.0 协议(含 service 白名单) ############"
|
||||
# CAS 的 service 必须命中「应用管理」里登记过的回调地址,否则一律拒绝。
|
||||
# 缺了这道校验,/cas/login?service=https://evil 会把带票据的回跳引到外站,
|
||||
# 攻击者再拿票据换用户名(开放重定向 + 票据外泄)。
|
||||
# 所以先登记一个 protocol=cas 的应用,再用它声明的地址走完整流程。
|
||||
CAS_APP="cas_e2e_$(head -c4 /dev/urandom | xxd -p)"
|
||||
SVC="http://app.example.com/cb"
|
||||
curl -s -o /dev/null -b "$JAR" -X POST "$BASE/api/admin/oauth-clients/delete" -d "client_id=$CAS_APP" >/dev/null 2>&1 || true
|
||||
sresp="$(curl -s -b "$JAR" -X POST "$BASE/api/admin/oauth-clients/save" \
|
||||
--data-urlencode "client_id=$CAS_APP" --data-urlencode "name=CAS E2E 应用" \
|
||||
--data-urlencode "protocol=cas" --data-urlencode "confidential=1" \
|
||||
--data-urlencode "redirect_uris=$SVC" --data-urlencode "grant_types=authorization_code")"
|
||||
[ "$(jget "$sresp" data.protocol)" = "cas" ] \
|
||||
&& ok "登记 CAS 应用(protocol=cas)并回显 protocol" || bad "登记 CAS 应用失败:$sresp"
|
||||
|
||||
# 未登记的 service:login 必须拒绝,且**不签发票据**
|
||||
code="$(curl -s -o /dev/null -w '%{http_code}' -b "$JAR" "$BASE/cas/login?service=http://evil.example.net/cb")"
|
||||
[ "$code" = "403" ] && ok "未登记 service 的 /cas/login → 403(白名单生效)" || bad "未登记 service 应 403,实际 $code"
|
||||
|
||||
# 未登记的 service:serviceValidate 回 INVALID_SERVICE(与「票据过期」区分开)
|
||||
xbad="$(curl -s "$BASE/cas/serviceValidate?service=http://evil.example.net/cb&ticket=ST-nope")"
|
||||
echo "$xbad" | grep -q "INVALID_SERVICE" && ok "未登记 service 的 serviceValidate → INVALID_SERVICE" || bad "应回 INVALID_SERVICE:$xbad"
|
||||
|
||||
loc="$(curl -s -o /dev/null -w '%{redirect_url}' -b "$JAR" "$BASE/cas/login?service=$SVC")"
|
||||
if echo "$loc" | grep -q "ticket="; then ok "CAS /cas/login 签发 ST 并 302 回跳"; else bad "CAS login 未返回带 ticket 的 302,loc=$loc"; fi
|
||||
TICKET="$(echo "$loc" | sed -n 's/.*[?&]ticket=\([^&]*\).*/\1/p')"
|
||||
@@ -115,6 +137,10 @@ t3="$(echo "$loc3" | sed -n 's/.*[?&]ticket=\([^&]*\).*/\1/p')"
|
||||
ptext="$(curl -s -b "$JAR" "$BASE/cas/validate?service=$SVC&ticket=$t3")"
|
||||
if echo "$ptext" | head -1 | grep -qx "yes"; then ok "CAS 1.0 /cas/validate 返回 yes"; else bad "CAS 1.0 应为 yes,实际:'$ptext'"; fi
|
||||
|
||||
# service 归一化:带 query 的 service 只要基地址登记过就应放行
|
||||
loc4="$(curl -s -o /dev/null -w '%{redirect_url}' -b "$JAR" "$BASE/cas/login?service=http%3A%2F%2Fapp.example.com%2Fcb%3Ftab%3D1")"
|
||||
if echo "$loc4" | grep -q "ticket="; then ok "带 query 的 service 命中基地址白名单"; else bad "带 query 的 service 应放行,loc=$loc4"; fi
|
||||
|
||||
# ===========================================================================
|
||||
echo
|
||||
echo "############ [C] 自助密码重置 ############"
|
||||
@@ -182,7 +208,7 @@ echo "$ulist" | grep -q "ding_e2e_1" && ok "同步账号 ding_e2e_1 已落地" |
|
||||
|
||||
# 清理:删除同步账号,保持 data 干净
|
||||
curl -s -o /dev/null -b "$JAR" -X POST "$BASE/api/admin/users/delete" -d "username=ding_e2e_1" >/dev/null
|
||||
kill "$MOCK_PID" 2>/dev/null || true; MOCK_PID=""
|
||||
kill "$MOCK_PID" 2>/dev/null || true; wait "$MOCK_PID" 2>/dev/null || true; MOCK_PID=""
|
||||
|
||||
# ===========================================================================
|
||||
echo
|
||||
@@ -207,6 +233,10 @@ adm="$(curl -s "$BASE/admin")"
|
||||
[[ "$adm" == *"scimEndpointsBody"* ]] && ok "管理台接入指南含 SCIM 端点表" || bad "管理台缺少 SCIM 端点表"
|
||||
[[ "$adm" == *"data-act='totp'"* ]] && ok "管理台账号行含双因子按钮" || bad "管理台缺少双因子按钮"
|
||||
[[ "$adm" == *"auditBody"* ]] && ok "管理台含审计日志表" || bad "管理台缺少审计日志表"
|
||||
[[ "$adm" == *'id="ocProto"'* ]] && ok "接入方表单含「协议类型」" || bad "接入方表单缺少协议类型"
|
||||
[[ "$adm" == *'id="ocHome"'* ]] && ok "接入方表单含「应用访问地址」" || bad "接入方表单缺少应用访问地址"
|
||||
[[ "$adm" == *'id="ocVisRoles"'* ]] && ok "接入方表单含「可见范围」" || bad "接入方表单缺少可见范围"
|
||||
[[ "$adm" == *"visibleCell"* ]] && ok "接入方列表渲染可见范围提示" || bad "接入方列表缺少可见范围提示"
|
||||
|
||||
# --- 终端用户页面:自助密码重置的真正入口 ---
|
||||
# 只有 API 没有页面时,发给用户的邮件链接会指向 POST 端点(点开必然失败)。
|
||||
@@ -239,6 +269,47 @@ else
|
||||
bad "sink 未取到 token(无法验证重置链接形态)"
|
||||
fi
|
||||
|
||||
# ===========================================================================
|
||||
echo
|
||||
echo "############ [G] 应用管理:用户门户 /apps 与可见范围 ############"
|
||||
# 门户只列「该用户可访问」的应用。CAS_APP([B] 段登记、未设可见范围)应全员可见。
|
||||
code="$(curl -s -o /tmp/sso-apps.html -w '%{http_code}' -b "$JAR" "$BASE/apps")"
|
||||
[ "$code" = "200" ] && ok "已登录 GET /apps → 200" || bad "/apps 应为 200,实际 $code"
|
||||
grep -q "CAS E2E 应用" /tmp/sso-apps.html && ok "门户列出已登记的 CAS 应用" || bad "门户未列出 CAS 应用"
|
||||
grep -q ">CAS<" /tmp/sso-apps.html && ok "门户卡片标注协议(CAS)" || bad "门户卡片缺少协议标注"
|
||||
|
||||
# 未登录:302 到登录页,且必须带**绝对**回跳(相对路径过不了回跳安全校验)
|
||||
locp="$(curl -s -o /dev/null -w '%{http_code} %{redirect_url}' "$BASE/apps")"
|
||||
case "$locp" in
|
||||
302*"/login"*"redirect="*) ok "未登录访问 /apps → 302 到登录页(带回跳)" ;;
|
||||
*) bad "未登录 /apps 应 302 到 /login?redirect=…,实际:$locp" ;;
|
||||
esac
|
||||
|
||||
# JSON 接口:未登录 401、已登录回显用户
|
||||
code="$(curl -s -o /dev/null -w '%{http_code}' "$BASE/api/portal/apps")"
|
||||
[ "$code" = "401" ] && ok "未登录 /api/portal/apps → 401" || bad "未登录应为 401,实际 $code"
|
||||
j="$(curl -s -b "$JAR" "$BASE/api/portal/apps")"
|
||||
[ "$(jget "$j" data.username)" = "$ADMIN_USER" ] && ok "/api/portal/apps 回显当前用户" || bad "JSON 未回显用户:$j"
|
||||
|
||||
# 可见范围:登记一个只对「不存在的角色」可见的应用 → 不应出现在 admin 的门户里
|
||||
HID_APP="hid_e2e_$(head -c4 /dev/urandom | xxd -p)"
|
||||
hresp="$(curl -s -b "$JAR" -X POST "$BASE/api/admin/oauth-clients/save" \
|
||||
--data-urlencode "client_id=$HID_APP" --data-urlencode "name=隐藏应用 E2E" \
|
||||
--data-urlencode "protocol=oauth2" --data-urlencode "confidential=0" \
|
||||
--data-urlencode "scopes=openid" --data-urlencode "visible_roles=no_such_role_xyz" \
|
||||
--data-urlencode "grant_types=authorization_code" --data-urlencode "redirect_uris=http://hidden.example.com/cb")"
|
||||
[ -n "$(jget "$hresp" data.client_id)" ] && ok "登记受限应用(可见范围=不存在的角色)" || bad "登记受限应用失败:$hresp"
|
||||
j2="$(curl -s -b "$JAR" "$BASE/api/portal/apps")"
|
||||
if printf '%s' "$j2" | grep -q "$HID_APP"; then
|
||||
bad "可见范围未生效:$HID_APP 不该对 admin 可见"
|
||||
else
|
||||
ok "可见范围过滤生效(角色不匹配则不列出)"
|
||||
fi
|
||||
|
||||
# 清理两个临时应用,保持 data 干净
|
||||
curl -s -o /dev/null -b "$JAR" -X POST "$BASE/api/admin/oauth-clients/delete" -d "client_id=$HID_APP"
|
||||
curl -s -o /dev/null -b "$JAR" -X POST "$BASE/api/admin/oauth-clients/delete" -d "client_id=$CAS_APP"
|
||||
|
||||
# ===========================================================================
|
||||
echo
|
||||
echo "## [summary] P1/P2 新增能力:PASS=$PASS FAIL=$FAIL"
|
||||
|
||||
Reference in new issue
Block a user