4.5 KiB
海能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:
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无需重注册。
检查:
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/选择对应应用:
- 启用机器人,事件订阅选择长连接;不要同时配置另一个公网Webhook消费同一流。
- 订阅
im.message.receive_v1。 - 开通该私有化版本要求的私聊接收、机器人消息回复权限。精确scope以平台实际权限列表为准,不猜公有云名称。
- 发布应用,先只对两名测试人员可见。
- 用户在海能Work私聊机器人,发送
/回显 海能Work消息已通。此时尚未绑定真实open_id,若未绑定诊断会提示设备不可用;先发送/绑定验证能收到绑定码。
当前机器人接入阶段只开放 /绑定、/解绑、/主机名、/回显。尚未将本机Profile全工具权限开放给IM,符合领导方案先做身份与归属验证的顺序;H5现有受控工具试验不因此关闭。
测试身份迁移到真实open_id
先确认机器人能收消息并回复绑定码,再做迁移;不要在平台未通时先解绑。
- 停止PC桥接端,完成当前所有任务。
- ECS执行管理员解绑,只移除模拟owner,不吊销设备证书:
sudo docker compose exec -T connector python -m relay.cli unbind \
--host-id 79cb2127dd554a1fb592101945df5230 --url http://127.0.0.1:8000
旧H5会话与配对码失效,模拟账号不再能调用。设备私钥、host_id和证书保留。
- 本人在海能Work私聊
/绑定,取得新的5分钟绑定码。 - Windows运行原
relay.cli bind --directory D:\HainuoRelayDevice --url https://10.77.76.13 --tls-ca D:\HainuoRelayDevice\server.pem,输入新码。 - 重启使用hainuo-config的PC桥接端,海能Work发
/主机名,应返回LAPTOP-4N7G74MO。 - ECS status应显示真实平台open_id,而非ou_test_tianzeyuan。两人两机各自重复,验证不串机。
- 需要继续H5时,在PC重新生成网页配对码,不复用旧会话。
现有Secret曾出现在聊天中,正式试点前应在平台重置,使用本工具在ECS隐藏输入新值;不把新Secret发到聊天或打进镜像。