集成能力总览

入口在哪

技术入口可以按调用链理解：前端 element-login 负责登录入口，web-gateway 负责请求校验和转发，平台后端服务承载空间、应用、菜单、文件等能力，proinnova-sso 承接第三方登录中转。产品入口则从工作台进入对应配置页，按 SSO、API Key、文件资源和排障场景继续下钻。

操作步骤

1. 先判断接入类型：用户登录走 /login 或 SSO，接口访问走 X-Deepfos-Key，文件上传下载走平台文件服务。

2. 再确认调用链层级：前端路由、网关过滤器、平台后端服务、SSO 中转或文件服务，避免直接跳到某个服务里盲查。

3. 对登录类问题，先查 element-login 路由，再查 web-gateway token 校验，最后查账号服务或 SSO 中转。

4. 对接口类问题，先确认请求头 X-Deepfos-Key、space、app，再查 API Key 校验接口。

5. 对文件类问题，先确认上传接口、文件 ID、space/app 上下文，再查下载或预览路径。

浏览器/前端
   │
   ├─ element-login：/login、/login/redirect、/login/do-redirect
   │
   ├─ web-gateway：token、API Key、space/app、安全策略校验
   │
   ├─ deepfos-platform：space-server、app-server、menu-server、platform-file-server
   │
   └─ proinnova-sso：CAS/OAUTH2/免密等中转登录

如何验证配置成功

1. 正向校验 1：登录链路能从 element-login 路由映射到网关和账号/SSO 服务日志，用户最终进入正确空间或应用。

2. 正向校验 2：API Key 请求带齐 X-Deepfos-Key、space、app 后，网关日志显示 API Key 验证通过，后端服务能识别空间和应用上下文。

3. 正向校验 3：文件上传后能拿到文件 ID，下载或预览时仍能通过权限和路径校验。

4. 负向校验：如果需求是“任意外部系统集成”，但找不到登录、API Key 或文件服务证据，不要写入平台主文档。

常见问题

问：平台是否支持所有集成方式？ 答：本章只写有代码证据的登录/SSO、API Key、文件资源接入；其他方式先作为待补证据。

问：技术顾问先看哪一页？ 答：登录问题看“登录链路与网关校验”，第三方身份看“单点登录配置”，接口访问看“API Key 与接口访问”。

问：为什么集成和运维放在同一章？ 答：接入失败通常需要同时查配置、网关、日志和接口返回，分开会降低排障效率。