8.3 KiB
集团身份改造契约
本轮:集团主 GID、公司管理与成员关系、公司分组菜单、互联网医院一键登录。其他子系统之后接入,不虚构已接入应用。医院员工凭据和业务授权保留原服务;集团 GID 是独立、不可回收的主身份编号。
授权以“用户 → 角色 → 菜单/按钮”为准,多角色取并集,同一角色可跨公司授权。公司、任职和旧成员 can_login 仅是组织信息,不增加或撤销权限;应用响应中的 can_login 则由当前真实角色资格计算。公司和菜单停用仍使相应资源不可用。
集团 API(identity-admin)
GET /adminapi/group/context:认证后返回以下上下文。POST /adminapi/group/company/save:集团管理员;{id?,code?,name,parent_id,disable},新增 code 唯一且不可变。公司只支持停用,不提供删除。GET /adminapi/group/members?company_id=1:集团管理员,返回{lists:[{id,gid,account,name,disable,member_status,can_login}],company_id};id 为原用户 ID。POST /adminapi/group/member/save:集团管理员;{company_id,admin_id,member_status:0|1,can_login:0|1}。POST /adminapi/group/sso/authorize:当前登录用户;{client_id:'internet-hospital',redirect_uri,state,code_challenge,code_challenge_method:'S256'}。返回{redirect_url},精确已注册回调,code 有效 60 秒且只消费一次。POST /adminapi/group/sso/exchange:公开,医院浏览器提交{client_id,redirect_uri,code,code_verifier},返回{ticket,gid,company_id,exchange_path:'/adminapi/identity.hospitalSso/exchange'}。重查源会话、源账号、实际医院源权限及公司启用状态;此处不返回医院 token。
{
"group":{"name":"甄养堂集团"},
"identity":{"gid":"gid_<随机32位hex>","source_admin_id":1},
"is_group_admin":true,
"default_company_id":1,
"companies":[{"id":1,"code":"zyt-hospital","name":"甄养堂互联网医院","parent_id":0,"disable":0,"is_directory_company":true,"permission_prefix":"company.zyt-hospital.application.internet-hospital","member_status":1,"can_login":1}],
"applications":[{"id":"internet-hospital","company_id":1,"name":"互联网医院","entry_url":"http://127.0.0.1:8090/admin/group-login","ready":true,"can_login":true,"status_message":"可进入"}]
}
health 增 group_enabled。mySelf 增加 gid/is_group_admin/company_permissions,以及分离的 source_permissions/source_menus、native_permissions/native_menus/native_company_ids。兼容字段 permissions/menus 返回两者并集;医院鉴权只检查 source 权限。native_menus 为完整有效授权树,含按钮与隐藏节点,导航自行过滤。集团管理员以显式 IAM_GROUP_OWNER_IDS 配置限定,并再次要求源 root;不能因任意医院 root 自动升级。
用户、角色和 options 属于全局目录,前端不携公司 Header;后端不以当前公司或任职限制这三类操作,仍检查真实源权限。仅部门和菜单请求携 X-Company-Id:公司 1 直接访问原医院服务,其他公司的结构在集团独立保存,通过同一 /auth.dept/*、/auth.menu/* 接口按公司分流。原生操作逐项匹配 company.<code>.dept.dept/{lists,add,edit,delete} 或 company.<code>.auth.menu/{lists,add,edit,delete},源 * 与成员归属均不能代替这些授权。显式集团 owner 保留配置特权。公司及完整上级公司链停用时拒绝结构读写。
公司公开字段增加 structure_mode: 'hospital' | 'group'、structure_permissions: string[] 和 can_manage_structure: boolean。实际操作使用精确 structure_permissions,不能用汇总布尔字段授权全部动作。is_directory_company 仅表示已绑定医院业务目录。
原生部门允许 pid=0 创建顶级,空顶级可删除;原生菜单支持目录、页面和按钮。节点编号为 1000000000 + 本地行号,与医院编号分区。读取、修改、删除及父节点引用同时校验公司和类型,禁止跨公司/跨类型、父子环和超过 64 层。删除有子节点的记录被拒绝。原生页面和按钮权限以该公司的 company.<code>. 开头,目录可留空。有效角色菜单投影到固定 /company/<company_id>/menu/<id>,白名单部门/菜单组件进入内置页面,其他组件进入安全占位。任意组件和外链不会执行,也不会授予医院权限。
新账号在全局用户页分配角色和部门,仍写入原服务;集团为原用户 ID 建立稳定 GID。角色授权树汇总不同公司的真实菜单,公司展示标题不保存成菜单 ID。医院菜单只写原角色表,原生菜单只写集团 role_native_menu。新增角色依赖原服务本次响应的精确 {id},禁止猜测角色 ID。跨两个存储不能提供共同原子事务:先校验、收回旧原生授权、写医院角色、写原生授权;失败明确报告并保持原生权限收回,管理员刷新核对后重试。
前端以“部门管理 → 公司”和“菜单管理 → 公司”组织导航,对应 /system/depts?company_id=ID 与 /system/menus?company_id=ID。公司参数只允许当前上下文中已知的公司 ID。新公司空列表直接提供新增入口;集团原生结构管理入口不依赖医院对应业务菜单是否存在。医院自身入口仍按原授权。切换公司会重建页面并清理旧表单,异步校验或确认期间即使切到别家公司再切回,也不能提交旧表单。
客服 SSO
配置 IAM_KEFU_BASE_URL 与 IAM_KEFU_COMPANY_CODE 后注册独立客户端 kefu,按实际公司编码查询资源。所有有效且完成账号验证的 zyt 员工可进入客服,不依赖医院菜单或公司成员资格;公司和祖先停用时拒绝登录。此资格仅用于首次基础登录,不授予客服业务权限。
客服授权请求沿用五字段 {client_id,redirect_uri,state,code_challenge,code_challenge_method},不带 response_type。回调严格为 <客服前端>/auth/group-login。客服后端调用同一 /group/sso/exchange,S256 PKCE 和一次性授权码验证后只返回 {client_id:'kefu',gid,source_admin_id,account,name,company_id},不返回医院 token、root、角色、权限或手机号,也不调用医院 ticket 签发接口。
客服按稳定 GID 创建本地基础用户,之后由本地管理员授权;集团登记的客服菜单仅控制集团入口。详见 客服接入。原医院客户端和 ticket 契约保持以下定义。
医院 SSO(原 server)
POST /adminapi/identity.hospitalSso/issue:仅持有效原 token 的调用者,推导本人的身份,拒绝 admin_id;请求{code_challenge,code_challenge_method:'S256'},返回{ticket}。30 秒、一次性、绑定源 session ID/token 摘要和 S256 challenge,重查停用/软删/改密/企微门禁。POST /adminapi/identity.hospitalSso/exchange:医院浏览器同源调用{ticket,code_verifier}。原子消费、验证 PKCE、重查源会话与账号;在真实浏览器请求上下文签发独立终端 10 的医院会话,保留 IP 绑定和原角色,禁止顶掉集团源会话。返回原登录 payload{token,is_paw,need_bind_work_wechat,...}。不得接受浏览器传入身份或终端。- 前端医院
/admin/group-login:在医院 origin 创建 crypto verifier/state,sessionStorage 仅保存短时事务,跳集团/sso/authorize。回调先清除 URL code/state,校验本地 state/超时,再请求集团 exchange,随后同源请求医院 exchange,存入医院现有 auth cache,并按现有改密/企微门禁进入原医院系统。 - 所有入口和回调来自固定服务器配置。远程 HTTPS;仅回环允许 HTTP。URL 不含 bearer/source token。此为当前医院的专用登录桥,不冒充完整 OAuth/OIDC Provider。
本地配置
集团 IAM_GROUP_ENABLED=1、IAM_GROUP_OWNER_IDS=1、IAM_GROUP_NAME=甄养堂集团、IAM_HOSPITAL_BASE_URL=http://127.0.0.1:8090/admin、IAM_CORS_ORIGINS 追加医院 origin。集团元数据默认 identity-admin/server/runtime/group.sqlite,不复制医疗数据、密码或原 session。
公司归组与新登录资格不代替医院医疗数据范围。已建立医院会话的停权仍依赖原用户停用/改密/退出等机制;本轮不声称跨子系统全局会话撤销已完成。