Import ECS deployed relay source and historical patches (2026-10-27)
This commit is contained in:
@@ -0,0 +1,77 @@
|
||||
# 海能Work私有化平台接入 · 长连接增量
|
||||
|
||||
## 已确认与未确认
|
||||
|
||||
用户提供App ID及App Secret,Secret未写入本项目源码或交付包。本文App ID可公开配置,Secret必须在ECS交互输入,不作为命令参数传入。
|
||||
|
||||
2026-10-26从本机**未携带任何密钥**验证:
|
||||
|
||||
| 请求 | 结果 | 判断 |
|
||||
|---|---|---|
|
||||
| GET https://open.w.cnooc.com.cn/app/ | HTTP200、HTML | 开发者后台页面,不是API根路径 |
|
||||
| POST https://open.w.cnooc.com.cn/open-apis/auth/v3/app_access_token/internal,空JSON | HTTP200、JSON code10003 | API路由存在;未验证凭据 |
|
||||
| POST https://open.w.cnooc.com.cn/open-apis/auth/v3/tenant_access_token/internal,空JSON | HTTP200、JSON code10003 | API路由存在;未验证凭据 |
|
||||
|
||||
所以API基址应为 `https://open.w.cnooc.com.cn`,不加 `/app/`。长连接配置的WSS目标由平台接口返回,不猜测地址或固定使用公有云。
|
||||
|
||||
## ECS更新与配置
|
||||
|
||||
将 `hainuo-relay-feishu-update-20261026.tar.gz`上传到/home/cnooc:
|
||||
|
||||
```bash
|
||||
tar -xzf /home/cnooc/hainuo-relay-feishu-update-20261026.tar.gz \
|
||||
-C /home/cnooc/hainuo-offline-arm64
|
||||
cd /home/cnooc/hainuo-offline-arm64/hainuo-relay
|
||||
sudo bash scripts/start-feishu-longconn.sh
|
||||
```
|
||||
|
||||
脚本离线构建已含官方SDK的服务镜像,不下载新依赖。提示 `App Secret (hidden input):`时,在服务器终端输入实际密钥,不回显,也不发到聊天。
|
||||
|
||||
配置工具依次验证app token、tenant token和 `/callback/ws/endpoint`(只获取连接配置,不发送平台消息);成功后才备份并原子写入.env。任何一步失败不会提交新配置。输出只显示成功状态、业务错误码或WSS主机名,不显示密钥、令牌、完整WSS URL或上游响应正文。
|
||||
|
||||
长连接不需要Webhook的Encrypt Key/Verification Token,已修正原配置校验;Webhook缺少鉴权参数时继续拒绝请求。OAuth保持关闭,避免在未核验IP回调白名单前把H5授权当成可用;当前PC配对H5不受影响。
|
||||
|
||||
脚本保留旧镜像标签、已有数据库、设备证书、绑定和H5,重建B1并启动独立longconn。继续使用compose.work.yaml及已有edge/H5覆盖文件。PC无需重注册。
|
||||
|
||||
检查:
|
||||
|
||||
```bash
|
||||
sudo docker compose logs --tail 30 longconn
|
||||
sudo docker compose ps connector longconn
|
||||
```
|
||||
|
||||
`platform_connected`证明SDK建立了平台连接;`platform_event_accepted`证明事件已转交B1,不等同已执行或平台回复成功。
|
||||
|
||||
## 平台后台仍必须配置
|
||||
|
||||
在https://open.w.cnooc.com.cn/app/选择对应应用:
|
||||
|
||||
1. 启用机器人,事件订阅选择长连接;不要同时配置另一个公网Webhook消费同一流。
|
||||
2. 订阅 `im.message.receive_v1`。
|
||||
3. 开通该私有化版本要求的私聊接收、机器人消息回复权限。精确scope以平台实际权限列表为准,不猜公有云名称。
|
||||
4. 发布应用,先只对两名测试人员可见。
|
||||
5. 用户在海能Work私聊机器人,发送 `/回显 海能Work消息已通`。此时尚未绑定真实open_id,若未绑定诊断会提示设备不可用;先发送 `/绑定`验证能收到绑定码。
|
||||
|
||||
当前机器人接入阶段只开放 /绑定、/解绑、/主机名、/回显。尚未将本机Profile全工具权限开放给IM,符合领导方案先做身份与归属验证的顺序;H5现有受控工具试验不因此关闭。
|
||||
|
||||
## 测试身份迁移到真实open_id
|
||||
|
||||
**先确认机器人能收消息并回复绑定码,再做迁移;不要在平台未通时先解绑。**
|
||||
|
||||
1. 停止PC桥接端,完成当前所有任务。
|
||||
2. ECS执行管理员解绑,只移除模拟owner,不吊销设备证书:
|
||||
|
||||
```bash
|
||||
sudo docker compose exec -T connector python -m relay.cli unbind \
|
||||
--host-id 79cb2127dd554a1fb592101945df5230 --url http://127.0.0.1:8000
|
||||
```
|
||||
|
||||
旧H5会话与配对码失效,模拟账号不再能调用。设备私钥、host_id和证书保留。
|
||||
|
||||
3. 本人在海能Work私聊 `/绑定`,取得新的5分钟绑定码。
|
||||
4. Windows运行原 `relay.cli bind --directory D:\HainuoRelayDevice --url https://10.77.76.13 --tls-ca D:\HainuoRelayDevice\server.pem`,输入新码。
|
||||
5. 重启使用hainuo-config的PC桥接端,海能Work发 `/主机名`,应返回LAPTOP-4N7G74MO。
|
||||
6. ECS status应显示真实平台open_id,而非ou_test_tianzeyuan。两人两机各自重复,验证不串机。
|
||||
7. 需要继续H5时,在PC重新生成网页配对码,不复用旧会话。
|
||||
|
||||
现有Secret曾出现在聊天中,正式试点前应在平台重置,使用本工具在ECS隐藏输入新值;不把新Secret发到聊天或打进镜像。
|
||||
Reference in New Issue
Block a user