telecom-rd-project-template/.agents/references/quick-guides/12-rd-cloud-interoperability.md

12-研发云平台互联互通

研发云平台与外部系统的集成规范

---

一、互联互通方式（5 类）

方式	说明
系统接入	外部平台与研发云集成，单点登录、界面跳转/集成
能力开放	通过 OpenAPI 及消息事件订阅向外部开放平台能力
数据开放	提供研发效能类数据（系统级/组织级）
数据接入	外部平台研发过程数据同步到研发云
服务接入	脚手架等服务接入研发云

---

二、系统接入

认证方式（三种）

1. 天翼认证 — 按天翼认证系统要求
2. 云认证 — 按云认证系统要求
3. 研发云认证 — 通过 OIDC/OAuth2.0 协议

集成方式

• 界面跳转：研发云菜单点击跳转
• 界面集成：iframe 嵌入，使用 postMessage 通信

window.postMessage({
  valueType: "xxx", // 双方约定事件名称
  data: {},         // 具体参数
}, "*");

系统接入安全要求

• 系统接入须提交安全扫描、漏洞扫描、渗透测试报告
• 集成页面须使用 HTTPS + 公网可信证书
• CSP 头严格限制 iframe 来源
• 链接跳转实施白名单机制

---

三、OpenAPI 能力开放

鉴权方式

方式	适用场景
平台级鉴权	使用"外部用户账号"，SHA256 + Base64 签名
用户级鉴权	OAuth 获取 auth_token，通过 id_token 传递

已开放的能力模块

用户管理、安全中心、版本中心、部署中心、测试中心、代码库、流水线、敏捷管理、文档空间、问需管理、我的工作、Wiki、自研工作项、数据中台、组件广场、Codefree、制品中心、资源中心

平台级鉴权格式

Header:
  srdcloud-user-account: <外部账号>
  time-stamp: <时间戳>
  authorization: SHA256({account},{timestamp},{secret}) 再 Base64

---

四、数据开放与接入

数据开放范围

• 基本对象维度信息（组织、项目、用户）
• 研发过程效能度量明细数据
• 效能度量汇总模型数据
• 研发成果数据（专利等）
• 不涉及源代码文件、制品内容

数据订阅方式

方式	说明
DCOOS（云桥）	推送至 DCOOS 地址
HTTPS/HTTP	仅组织级，推荐 HTTPS
Kafka	需 1124VPN，JDK 11+

数据接入方式

• 通过消息中心（CloudEvents 格式）
• 通过其他中心（如测试中心，按业务要求）

---

五、消息事件订阅

已开放事件

中心	事件
用户中心	账号开通、密码重置
代码中心	代码库变更
集成中心（流水线）	配置变更、任务执行状态、错误日志
安全中心	Sonar 扫描结果
部署中心	资源部署对象删除事件

---

六、网络对接方案

方案	适用条件
CN2-1124 直通	主机可直接访问 CN2-1124 VPN
CN2-1124 代理	有服务器同时接入 CN2-1124 和本地内网
SASE 打通	不能直接访问 CN2-1124，但可访问公网

---

七、安全运营

• 重大安全事件：边处置、边报告
• 重大安全风险：及时排查、整改、反馈
• 日志保留 ≥ 6 个月
• 【禁止】 研发云与接入系统间批量同步用户信息、项目信息、用户角色和权限