Files
ecs-relay-service/deployment-source/docs/FEISHU_PRIVATE_LONGCONN.md

4.5 KiB
Raw Permalink Blame History

海能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/选择对应应用:

  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,不吊销设备证书:
sudo docker compose exec -T connector python -m relay.cli unbind \
  --host-id 79cb2127dd554a1fb592101945df5230 --url http://127.0.0.1:8000

旧H5会话与配对码失效,模拟账号不再能调用。设备私钥、host_id和证书保留。

  1. 本人在海能Work私聊 /绑定,取得新的5分钟绑定码。
  2. Windows运行原 relay.cli bind --directory D:\HainuoRelayDevice --url https://10.77.76.13 --tls-ca D:\HainuoRelayDevice\server.pem,输入新码。
  3. 重启使用hainuo-config的PC桥接端,海能Work发 /主机名,应返回LAPTOP-4N7G74MO。
  4. ECS status应显示真实平台open_id,而非ou_test_tianzeyuan。两人两机各自重复,验证不串机。
  5. 需要继续H5时,在PC重新生成网页配对码,不复用旧会话。

现有Secret曾出现在聊天中,正式试点前应在平台重置,使用本工具在ECS隐藏输入新值;不把新Secret发到聊天或打进镜像。