Sangfor Edr Use
Apps & Automationsangfor-edr-useSangfor Edr Use is an Agent Skill for apps & automation published in the AgentFlocks/flocks repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
用于处理深信服 EDR(终端检测与响应)相关任务,通过浏览器(CDP 直连)进行以下任务:终端状态查询、终端概况统计、失陷设备排查、设备运行状态查看等。只要用户提到 深信服 EDR、EDR、sangfor EDR 等需求时,必须先加载本 skill。本 skill 是 EDR 平台操作的唯一决策入口:在未阅读本 skill 前,不要直接使用 browser-use skill。
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/AgentFlocks/flocks/blob/HEAD/.flocks/plugins/skills/sangfor-edr-use/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/sangfor-edr-use, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
深信服 EDR Use
First
登录态处理规则
当用户需要打开深信服 EDR 页面,或需要通过 Web2CLI 抓取 EDR 页面请求时,必须按下面顺序处理登录态,不要一开始就要求用户提供账密:
- 先调用
sangfor_edr_auth的action=status_auth_state或action=validate_auth_state,检查~/.flocks/browser/sangfor-edr/auth-state.json是否存在且可用。 - 如果登录态可用,直接复用该 state,继续打开 EDR 页面或执行 Web2CLI 抓取流程。
- 如果 state 不存在或已失效,但本地已经保存了 EDR 地址、用户名和密码,调用
sangfor_edr_auth的action=ensure_auth_state自动刷新登录态。 - 如果没有可用 state,也没有保存账密配置,再引导用户选择:
- 提供 EDR 访问地址、用户名和密码,自动登录并保存账密配置,后续 state 失效时可直接自动刷新;
- 不提供账密,走浏览器手动登录流程。打开 EDR 页面后由用户在可视化浏览器中完成登录,登录成功后保存完整浏览器登录态(包括 cookies、localStorage 等)。
无论采用哪种方式,只要获得可用登录态,就继续原有浏览器 / Web2CLI 流程:加载登录态、打开目标 EDR 页面、按需注入 Web2CLI hook、执行页面操作并导出捕获到的请求。后续再次打开页面时,仍必须先校验 auth-state.json;若登录态失效且已保存账密,则自动重新走 CDP 登录并刷新 state。
若自动登录过程中出现验证码识别失败、MFA 校验、页面选择器变化、未检测到登录成功或有效 sessionid 等情况,立即回退到原有浏览器手动登录流程。
⚠️ EDR 没有开放 API,所有操作必须通过浏览器(CDP 直连)完成。
浏览器模式使用指南
请阅读以下文档获取完整流程:
CDP 模式适用场景
- 首页仪表盘(
/ui/#/index):设备 CPU/内存/硬盘使用率、终端概况(在线/离线/服务器/PC)、失陷设备统计 - 威胁资产分析:已失陷终端列表(需点击"已失陷终端"标签页,不是默认的"全部")
- 页面详情、交互式筛选
可用工具脚本
| 脚本路径 | 功能 | 必需参数 |
|---|---|---|
references/fetch_edr_system_state.py | 设备状态抓取 | --url {EDR_URL} |
脚本位于 skill 目录的 references/ 下,无硬编码 URL 或敏感信息。
执行示例
脚本位于 <flocks-plugins-root>/skills/sangfor-edr-use/references/fetch_edr_system_state.py,请按当前平台选择对应命令。
Windows(PowerShell)
powershell -Command "& '<FLOCKS_VENV>\Scripts\python.exe' '<FLOCKS_PLUGINS>\skills\sangfor-edr-use\references\fetch_edr_system_state.py' --url '{EDR_URL}'"
macOS / Linux(bash / zsh)
"<FLOCKS_VENV>/bin/python" "<FLOCKS_PLUGINS>/skills/sangfor-edr-use/references/fetch_edr_system_state.py" --url "{EDR_URL}"
占位符说明
| 占位符 | Windows 典型值 | macOS/Linux 典型值 |
|---|---|---|
<FLOCKS_VENV> | D:\Flocks Project\flocks\.venv | ~/Flocks/flocks/.venv(取决于实际安装位置) |
<FLOCKS_PLUGINS> | %USERPROFILE%\.flocks\plugins | ~/.flocks/plugins |
必须使用 Flocks 虚拟环境(
.venv)执行;系统 Python 可能缺少依赖。如不确定 venv 位置,先执行flocks --version或检查 Flocks 安装目录。
关键坑点(必须避免)
| 坑 | 原因 | 解法 |
|---|---|---|
flocks browser -c js(...) 返回空文本 | daemon session 指向错误的 tab | 用 Python socket 直连 daemon,通过 Runtime.evaluate 在正确 context 执行 |
flocks browser -c new_tab() 后后续命令无响应 | tab 切换导致 session 错位 | 用 switch_tab(targetId) 明确切到 EDR tab |
| 多行代码转义失败 | PowerShell 引号嵌套 | 使用 fetch_edr_system_state.py 脚本,无需手动转义 |
| EDR 页面数据为空 | EDR 内容在跨域 iframe 中 | 用 CDP direct 方式 attach 到 EDR tab,在正确 frame context 执行 JS |
| 失陷设备数量不匹配 | 读取的是"全部"筛选而非"已失陷"筛选 | 需点击"已失陷终端"标签页获取准确数量 |
失陷设备查询 SOP
问题:首页仪表盘显示"已失陷 N 台",但威胁资产分析页面默认只列出部分。
成功路径:
- 在 EDR 首页仪表盘确认"已失陷 N 台"的数量
- 如需具体清单,进入
威胁资产分析→ 点击已失陷终端标签页(不是默认的"全部") - 只有点击"已失陷终端"标签页,列表数量才会与仪表盘一致
⚠️ 必须避免:直接读取威胁资产分析的默认"全部"筛选结果作为失陷设备清单,这是错误的。
执行规范
必须使用 Flocks 虚拟环境(.venv)执行 Python 脚本,禁止使用系统 Python。
- ✅ 正确:
<FLOCKS_VENV>/bin/python(Unix)或<FLOCKS_VENV>\Scripts\python.exe(Windows) - ❌ 禁止:
python script.py/python3 script.py(直接调用 PATH 中的 Python)
原因:Flocks 虚拟环境包含了所有项目依赖,系统 Python 可能缺少必要的包。完整跨平台示例见上一节"执行示例"。