diff --git a/.workbuddy/skills/ipass-core-add-plugin/SKILL.md b/.workbuddy/skills/ipass-core-add-plugin/SKILL.md index 64734f8..ab442a2 100644 --- a/.workbuddy/skills/ipass-core-add-plugin/SKILL.md +++ b/.workbuddy/skills/ipass-core-add-plugin/SKILL.md @@ -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 语义(角色/部门/用户组任一命中)。 + --- ## 高价值排错(症状 → 根因) diff --git a/CLAUDE.md b/CLAUDE.md index 9592960..b164950 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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) diff --git a/README.md b/README.md index 3ea4f9f..98b590b 100644 --- a/README.md +++ b/README.md @@ -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)。 --- diff --git a/docs/design.md b/docs/design.md index 2fa6071..c19eedd 100644 --- a/docs/design.md +++ b/docs/design.md @@ -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 接入方」计数。 -![管理台 · OAuth 应用](screenshots/admin-oauth-apps.png) +![管理台 · 应用管理(OAuth 应用)](screenshots/admin-oauth-app-management.png) + +终端用户门户 `GET /apps`:登录后按**可见范围**列出可访问的应用,卡片直接进入 +(CAS 应用走 `/cas/login?service=…`;未配置访问地址的显示为灰底并标注): + +![用户门户 · 我的应用](screenshots/portal-my-apps.png) 登录页重做为与管理台同色系的卡片(登录失败时错误条落在卡片内部): diff --git a/docs/maxkey-migration-analysis.md b/docs/maxkey-migration-analysis.md index 1fbf9c3..0f4578c 100644 --- a/docs/maxkey-migration-analysis.md +++ b/docs/maxkey-migration-analysis.md @@ -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 读不到)。 diff --git a/docs/roadmap.md b/docs/roadmap.md index 82d3e7d..e41478f 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -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`),否则会出现「明明登录了却说未登录」。 diff --git a/docs/screenshots/admin-oauth-app-management.png b/docs/screenshots/admin-oauth-app-management.png new file mode 100644 index 0000000..6d95100 Binary files /dev/null and b/docs/screenshots/admin-oauth-app-management.png differ diff --git a/docs/screenshots/admin-oauth-apps.png b/docs/screenshots/admin-oauth-apps.png deleted file mode 100644 index d791d10..0000000 Binary files a/docs/screenshots/admin-oauth-apps.png and /dev/null differ diff --git a/docs/screenshots/portal-my-apps.png b/docs/screenshots/portal-my-apps.png new file mode 100644 index 0000000..675ddfe Binary files /dev/null and b/docs/screenshots/portal-my-apps.png differ diff --git a/source/rust/crates/plugin-sso/src/api.rs b/source/rust/crates/plugin-sso/src/api.rs index c6b6c40..1e8b729 100644 --- a/source/rust/crates/plugin-sso/src/api.rs +++ b/source/rust/crates/plugin-sso/src/api.rs @@ -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!( diff --git a/source/rust/crates/plugin-sso/src/cas.rs b/source/rust/crates/plugin-sso/src/cas.rs index ba4e7c5..cd34305 100644 --- a/source/rust/crates/plugin-sso/src/cas.rs +++ b/source/rust/crates/plugin-sso/src/cas.rs @@ -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!( + "\n\ + \x20 service 未在应用管理中登记\n\ + \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!( diff --git a/source/rust/crates/plugin-sso/src/lib.rs b/source/rust/crates/plugin-sso/src/lib.rs index 9da3930..e8b9ad5 100644 --- a/source/rust/crates/plugin-sso/src/lib.rs +++ b/source/rust/crates/plugin-sso/src/lib.rs @@ -19,6 +19,7 @@ mod ldap; mod scim; mod otp; mod reset; +mod portal; mod sync; pub mod oauth; mod oauth_clients; diff --git a/source/rust/crates/plugin-sso/src/oauth.rs b/source/rust/crates/plugin-sso/src/oauth.rs index 73c3f96..fe0804b 100644 --- a/source/rust/crates/plugin-sso/src/oauth.rs +++ b/source/rust/crates/plugin-sso/src/oauth.rs @@ -512,6 +512,27 @@ fn parse_cookie(header: Option<&str>, name: &str) -> Option { None } +/// 当前登录用户:**管理台会话与终端用户 SSO 会话都认**。 +/// +/// 两套会话是互相独立的存储:管理台走 `session::authenticate`(内核会话表), +/// 终端用户走 `sso_sid` cookie + 共享内存。CAS 登录页与用户门户面向浏览器, +/// 用户从任一侧登录进来都可能命中,这里依次尝试——否则会出现「明明已登录, +/// 却被告知未登录」的诡异现象。 +pub fn current_user(r: *mut ngx_http_request_t) -> Option { + 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; } } diff --git a/source/rust/crates/plugin-sso/src/oauth_clients.rs b/source/rust/crates/plugin-sso/src/oauth_clients.rs index b115f9b..ac3419f 100644 --- a/source/rust/crates/plugin-sso/src/oauth_clients.rs +++ b/source/rust/crates/plugin-sso/src/oauth_clients.rs @@ -60,6 +60,61 @@ pub fn all() -> Vec { 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, + pub visible_depts: Vec, + pub visible_groups: Vec, +} + +impl AppMeta { + /// 规整 + 校验。**在写盘前拒掉**,别让一个 `javascript:` 的访问地址 + /// 躺在门户页里等着被点击。 + fn normalized(mut self) -> Result { + 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| -> Vec { + let mut out: Vec = 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, confidential: bool, secret_in: &str, + meta: AppMeta, ) -> Result { + 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::(&payload) { + if c.allows_service(service) { + return true; + } + } + } + false +} + +/// 当前用户可见的应用(门户「我的应用」用)。按可见范围过滤,按展示名排序。 +pub fn visible_apps(role: &str, dept: &str, groups: &[String]) -> Vec { + let mut v: Vec = state::iter_prefix_ex(KEY_OAUTH_CLIENT_PREFIX) + .into_iter() + .filter_map(|(_k, payload, _exp)| serde_json::from_str::(&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, }) } diff --git a/source/rust/crates/plugin-sso/src/oauth_state.rs b/source/rust/crates/plugin-sso/src/oauth_state.rs index 3bd5eba..af9cbcb 100644 --- a/source/rust/crates/plugin-sso/src/oauth_state.rs +++ b/source/rust/crates/plugin-sso/src/oauth_state.rs @@ -33,6 +33,30 @@ pub struct OAuthClient { pub scopes: Vec, 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, + #[serde(default)] + pub visible_depts: Vec, + #[serde(default)] + pub visible_groups: Vec, } pub type OAuthClientTable = Vec; @@ -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)) + } } diff --git a/source/rust/crates/plugin-sso/src/portal.rs b/source/rust/crates/plugin-sso/src/portal.rs new file mode 100644 index 0000000..c240e1b --- /dev/null +++ b/source/rust/crates/plugin-sso/src/portal.rs @@ -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##" + + + + +我的应用 · 统一认证 + + + +
+ 统一认证 · 我的应用 + 已登录:{{WHO}} + +
+
+

我的应用

+
共 {{COUNT}} 个可访问应用。灰底卡片未配置访问地址,需管理员在「应用管理」里补全。
+ {{BODY}} +
+ + +"##; + +/// 路由:门户端点。 +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) { + 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() { + "
暂无可访问的应用。
请联系管理员在管理台「OAuth 应用」中登记,
并把你的角色 / 部门 / 用户组加入该应用的可见范围。
".to_owned() + } else { + let mut cards = String::with_capacity(apps.len() * 512); + cards.push_str("
"); + for c in &apps { + cards.push_str(&card_html(c)); + } + cards.push_str("
"); + 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!("", utilx::html_escape(&initial)) + } else { + format!( + "", + 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" { + "CAS" + } else { + "OAuth2 / OIDC" + }; + let inner = format!( + "{logo}
{}
{desc}
\ +
{proto_tag}{}
", + utilx::html_escape(name_raw), + utilx::html_escape(&c.client_id) + ); + if entry.is_empty() { + // 灰底 + 明确标签:只靠 opacity 不够显眼,用户会以为是加载失败 + format!( + "
{inner}\ +
未配置访问地址
" + ) + } else { + format!("{inner}", 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 = 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", + ) +} diff --git a/source/www/admin.html b/source/www/admin.html index de77aab..a953cf0 100644 --- a/source/www/admin.html +++ b/source/www/admin.html @@ -292,7 +292,10 @@

新建 / 更新接入方

登记一个第三方应用。机密客户端(服务端应用)持有密钥,用 client_secret 换令牌; 公开客户端(SPA / 移动端)不持有密钥,必须走 PKCE。回调地址必须与申请时传入的 redirect_uri - 完全一致,否则授权请求会被拒。
+ 完全一致,否则授权请求会被拒。
+ 协议选 CAS 时,上面的地址同时就是 /cas/login?service=… 的白名单: + 未登记的 service 会被网关直接拒绝(403 / INVALID_SERVICE), + 防止有人把带票据的回跳引到外站。可见范围决定该应用在用户门户 /apps 里对谁可见。
@@ -307,8 +310,35 @@ +
+ + +
+
+ + +
- + + +
+
+ + +
+
+ +
+ + + +
+
+
+
@@ -835,6 +865,17 @@ env LDAP_AUTO_CREATE; # 1 = LDAP 认证成功后自动建号 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 "
限 " + esc(parts.join(" · ")) + "
"; + } + function renderOAuthClients() { var body = $("oauthClientsBody"); if (!state.oauthClients.length) { @@ -867,8 +908,10 @@ env LDAP_AUTO_CREATE; # 1 = LDAP 认证成功后自动建号 return "" + "" + esc(c.client_id) + "" + - "" + esc(c.name || "-") + "" + - "" + (c.confidential + "" + esc(c.name || "-") + visibleCell(c) + "" + + "" + (c.protocol === "cas" + ? "CAS" + : "OAuth2") + " " + (c.confidential ? "机密" : "公开") + "" + "" + redirectCell + "" + @@ -918,6 +961,13 @@ env LDAP_AUTO_CREATE; # 1 = LDAP 认证成功后自动建号 $("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 认证成功后自动建号 $("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 认证成功后自动建号 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(); diff --git a/tests/maxkey-p1p2-e2e.sh b/tests/maxkey-p1p2-e2e.sh index 8cd2ab2..4c4b7c7 100644 --- a/tests/maxkey-p1p2-e2e.sh +++ b/tests/maxkey-p1p2-e2e.sh @@ -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"