Files

78 lines
4.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 海能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发到聊天或打进镜像。