DSH 客户端二开实战(四):业务登录如何接入原生桌面与本地 Host

前三篇解决了代码交付和原生 UI 扩展。接下来,我们需要让已有企业账号进入定制后的 DSH 首页,并让部分业务页面复用登录状态。

这里有三个容易混淆的身份:业务系统里的用户、本机 DSH Host 的调用者,以及模型服务的使用者。三者会出现在同一个桌面应用里,却承担不同的授权职责。

把业务身份与模型身份分开

模型 API key 可用,只能说明模型请求可能成功。它不能证明用户可以查看某份业务资料。同样,业务账号登录成功,也不意味着模型已经配置完成。

因此在正常运行路径中,原生主页的进入条件由业务身份检查决定,模型配置由原有模型机制处理。本机 Host 还保留自己的认证边界,避免任意网页因为和客户端运行在同一台电脑上,就能调用文件或 Agent 能力。

工程另有未打包开发模式专用的主页预览入口。它可以显示界面,但不会建立业务身份,也不会授予业务权限。因此单凭"看到了主页"仍不能判断登录成功。

这一划分也改善了错误定位:业务接口返回未登录、Host 拒绝调用和模型服务认证失败,应当分别解释,不能统一归成"登录失败"。

由主进程持有登录生命周期

本次普通密码链路可以简化为:

sequenceDiagram participant U as 独立登录页 participant M as Electron 主进程 participant B as 业务认证 Broker participant I as 企业身份服务 U->>B: 提交登录信息 B->>I: 普通密码认证与身份复核 I-->>B: 认证结果 B-->>U: 建立业务 Cookie 会话 U->>M: 到达专用完成路由 M->>B: 再次查询当前业务身份 B-->>M: 有效用户身份 M->>M: 关闭登录窗并显示原生主页

身份服务的长期 token 由服务端保存和轮换。客户端使用隔离业务会话中的 Cookie,登录页和业务页面都不需要读取这些 token。

主进程也不会仅凭"跳到了完成地址"就放行。页面导航只是一次信号,主进程仍要查询业务身份,确认会话已经建立。

HTTP 成功、业务成功和身份有效分别判断

联调中出现过一种误导性响应:HTTP 状态是失败,响应体却带着成功业务码和"请求成功"。还有一种情况是登录接口返回成功摘要,但其中没有完整用户身份。

处理这些响应时,需要按层检查。下面是简化后的判断顺序,具体身份结构由项目定义:

javascript 复制代码
if (!response.ok) {
  throw new Error(`Authentication endpoint returned HTTP ${response.status}`)
}

if (body.code !== '10000' || body.success !== true) {
  throw new Error('Business authentication was rejected')
}

// 登录摘要成功后,继续调用当前用户接口,验证有效身份。
await verifyCurrentBusinessIdentity()

verifyCurrentBusinessIdentity 在这里代表项目自己的复核逻辑,并非 DSH 内置 API。

Cookie 存在也不是充分条件:它可能已经过期、对应旧会话,或者并未被后端接受。进入主页的依据应来自有效身份检查。

复用业务页面时,只开放必要动作

原生主窗口需要复用已有 Web 页面,但这些页面不需要获得完整的原生桥。

项目为业务页面保留受限的认证通道,用于请求刷新登录、重新登录和退出。消息处理同时检查来源、所属框架、消息结构和允许的动作;主进程仍然验证 IPC 调用者。

这与给页面提供一个"任意 IPC 调用"方法有很大差别。受限通道的能力可以直接列举,也便于对每个动作编写测试。

同样,业务代理拥有进程内调用凭证。普通业务页面不需要拿到凭证字符串,更不需要自行构造能够访问任意 Host 接口的请求。

退出是一次状态转换

只删除页面里的用户信息,会留下明显漏洞:原生主窗口还可以从托盘重新显示,在途请求也可能把旧身份写回来。

我们的处理顺序是先隐藏主窗口并暂停相关访问,再清理本机业务登录状态和释放相关资源。远端退出失败时,应分别记录本机清理和远端吊销的结果。

重新登录后,主进程复核新身份,重载原生 Client 和业务面板,再恢复工作台。异步响应还需要检查当前认证版本,拒绝退出前或旧账号发起的迟到结果。

本地工作空间是否按账号隔离,则属于另外的产品规则。接入企业登录本身不会自动建立一套账号间数据迁移方案。

联调要覆盖整个生命周期

最小的验证范围应包括首次登录、已有会话启动、会话失效、退出与重新登录,以及退出期间到达的异步响应。涉及续登时,还要实际检查服务端部署、Cookie 配置和身份服务有效期。

历史记录中既有真实开发客户端可登录的确认,也有后续重启停在登录页、某环境路由未部署的情况。它们属于不同时间和环境,不能合并成"所有认证流程均已完成验收"。

完成身份边界之后,下一篇把认证后的能力接入本地 Agent:由 Host 注册工具、通过受控通道调用业务代理,并接入 DSH 现有审批流程。

相关推荐
小七-七牛开发者39 分钟前
Anthropic:Agent 不必一直运行,也能持续工作
agent·claude·deepseek·anthropic·alwaysonagent
苍梧问道1 小时前
SQL Server I/O性能优化:从等待类型到存储配置
架构
super_Omni2 小时前
突破前端防御重围:现代 Web 媒体资产嗅探、CDN 逆向还原与反爬破壁架构实战
前端·架构·媒体
im_AMBER3 小时前
IO 多路复用:select、poll 和 epoll
后端·面试·架构
真上帝的左手4 小时前
26. AI-Agent-技术架构:Harness、Runtime、Orchestrator、Framework
人工智能·架构·agent·ai编程·智能体
真上帝的左手4 小时前
7、网络安全-认证鉴权
web安全·架构·系统架构·系统安全
一条Go5 小时前
Pod 终端与日志:为什么浏览器建连要先换一张 60 秒的票
后端·架构·github
大模型真好玩7 小时前
做好真人分身却不知道拍什么?8个视频应用场景直接抄
人工智能·agent·deepseek
真上帝的左手7 小时前
26. AI-大语言模型-基础
人工智能·ai·架构·llm·大语言模型