飞连
飞连
- 文档首页
飞连管理员指南AI 安全运行时安全Agent 行为护栏
复制全文
下载 pdf
文档反馈
问问助手Agent 行为护栏用于管理终端上 Agent 的文件访问、网络访问、命令执行和注册表访问行为，帮助管理员保护本地凭证、敏感配置和系统资源。
功能介绍
员工使用 Claude Code、Codex、WorkBuddy 等 Agent 工具完成任务时，Agent 可能需要读取本地文件、访问网络或执行命令。即使工具本身已获准使用，其中的某些操作也可能超出企业允许的范围，例如读取 SSH 凭证，或下载并执行来源不明的脚本。
Agent 行为护栏通过飞连客户端在操作系统侧检查这些行为，并按照管理员配置的路径、地址和命令规则执行审计或阻断。管理员可以先记录命中规则的行为，了解其使用情况；也可以直接阻断相关操作，并向员工发送终端通知。日志会记录尝试访问的对象、执行的动作、命中策略以及相关人员和设备，便于核查具体操作。
每台终端只生效一条 Agent 行为护栏策略，策略之间不叠加或合并。终端同时命中多条策略时，优先执行优先级数值最高的一条；数值相同时，执行最近一次添加或修改的策略。
前提条件
企业已开通AI 安全授权，详细计费说明请参看计费项。不同 Agent 支持的管控能力可参见AI 工具管控能力列表。
新增 Agent 行为护栏策略
护栏策略用于指定需要管控的 Agent、禁止访问或执行的对象，以及命中规则后的处理方式。根据需要保护的资源和适用人员，按以下步骤创建策略。
登录飞连管理后台。
进入AI 安全 > 运行时安全 > Agent 行为护栏。
切换至策略配置页签，单击创建策略。
在新增策略页面，完成以下配置，然后单击确定。
基础信息
配置项 说明 策略名称 自定义名称，用于标识当前策略。 策略描述 补充说明策略用途，不参与逻辑判断。最多输入 100 个字符。 优先级 取值范围为 0～100，数值越大优先级越高。终端同时命中多条策略时，仅执行优先级最高的一条；数值相同时，执行最近一次添加或修改的策略。 管控动作
配置项 说明 审计 允许 Agent 执行命中该策略的行为，同时生成审计日志。员工可继续操作，管理员可在日志中核查相关行为。 阻断 拦截 Agent 命中该策略的行为，同时生成审计日志。 管控对象
配置项 说明 适用 Agent 根据管控需要勾选 AI 工具。当前支持管控的工具及各工具支持的能力，请参见AI 工具管控能力列表。 防护能力
按管控需求开启相应的防护能力，支持多选。说明
macOS 终端需在系统设置 > 隐私与安全性中授予完全磁盘访问权限，文件访问管控、网络访问管控和命令执行管控均需要此权限。网络访问管控还需要网络扩展权限；未完成相应授权时，相关管控策略无法生效。
配置项 说明 文件访问管控
管控 Agent 对系统文件或目录的访问行为。选择需要管控的操作系统，输入需要保护的文件路径；管控动作为阻断时，禁止命中路径的文件被读取、修改或外发。
支持通配符和变量。将鼠标悬浮在文件路径旁的问号图标上，可查看填写规则。管控整个目录时，Windows 路径以
\*结尾，macOS 路径以/*结尾。例如，保护用户的 SSH 配置和凭证目录：
- Windows：
%USERPROFILE%\.ssh\*。 - macOS：
~/.ssh/*。
网络访问管控
管控 Agent 对指定 IP 或域名的访问行为。选择地址类型，输入需要管控的 IP 或域名；管控动作为阻断时，拦截命中的网络请求。支持以下填写方式。
- 单个 IP：
192.168.1.10。 - IP 范围：
192.168.1.10-192.168.1.50。 - CIDR 网段：
192.168.1.0/24。 - 精准域名：
example.com。 - 泛域名：
*.example.com。
命令执行管控
管控 Agent 执行指定命令的行为，例如下载脚本、变更权限或修改系统。选择需要管控的操作系统，输入需要管控的系统命令；管控动作为阻断时，禁止执行命中的命令。
支持使用通配符和变量。将鼠标悬浮在系统命令旁的问号图标上，可查看填写规则。例如：
- Windows：
powershell *.ps1。 - macOS：
curl * \| bash。
注册表访问管控
仅支持 Windows。管控 Agent 对指定注册表路径的访问；管控动作为阻断时，只允许读取，禁止写入。对于内置 Agent，工具自身注册表的读写行为默认放行，不受该策略影响。
系统默认提供高风险注册表路径，可直接使用，也可按需要调整。单击恢复默认可恢复预置路径。
例如：
HKCU\Software\Microsoft\Windows\CurrentVersion\Run*。- Windows：
通知
配置项 说明 终端通知 仅当管控动作为阻断时可配置。开启后，终端会向员工发送 Agent 行为风险提示。单击右侧配置，进入通知弹窗模板页面，新建或复用 Agent 行为管控通知模板。详细说明请参看配置通知弹窗模板。 生效对象
配置项 说明 生效对象 指定策略适用的人员或设备。可选择全部对象，也可选择部分对象，按员工或设备维度指定范围。 排除对象 从已选择的生效对象中排除特定员工或设备，使其不受该策略影响。
管理策略
进入AI 安全 > 运行时安全 > Agent 行为护栏 > 策略配置，可检查策略下发情况，筛选策略并调整管控规则。
页面顶部展示生效设备数和配置同步进度。服务端配置版本是当前策略库的全局版本标识；新增、编辑或删除任一策略后，该版本会自动更新。终端成功拉取当前最新的服务端版本，表示其命中的策略配置已同步至最新状态。管理员可据此判断配置是否已经下发。
可按生效状态、员工或部门、设备名称、策略 ID、Agent 名称组合筛选，并按编辑时间、优先级或创建时间排序。通过全部、审计、阻断切换，可快速筛选相同管控动作的策略。列表中可执行以下操作。
| 操作 | 说明 |
|---|---|
| 调整优先级 | 单击策略的优先级数值，调整策略匹配顺序。数值越大，优先级越高。 |
| 开启或关闭 | 通过生效状态开关启用或停用策略。关闭后，受影响终端会按优先级匹配下一条适用策略。 |
| 复制 | 以现有策略为模板创建新策略。 |
| 编辑 | 修改策略参数、管控动作或生效对象。 |
| 删除 | 移除不再需要的策略。删除后无法恢复；操作前请确认对生效终端的影响。 |
查看审计日志
Agent 的行为命中护栏策略后，飞连会记录发生时间、尝试操作的对象及处理结果。管理员可以据此核查哪些操作被审计或阻断，以及涉及哪些员工和终端。
进入AI 安全 > 运行时安全 > Agent 行为护栏，选择审计日志页签。
按管控动作（全部、审计、阻断）、时间、策略名称、员工或设备、操作系统、行为类型和 Agent 名称筛选记录。
查看列表中的行为信息。
单击右上角自定义列，可设置展示的字段。
| 字段 | 说明 |
|---|---|
| 发生时间 | Agent 行为触发策略的时间。 |
| 管控动作 | 该次行为被审计或阻断的结果。 |
| 行为类型 | 触发的是文件访问、网络访问、命令执行还是注册表访问管控。 |
| 目标对象 | Agent 尝试访问的文件路径、网站 URL、IP 或域名、注册表路径，或尝试执行的命令。单击复制图标可复制具体内容。 |
| 命中策略 | 处理该次行为的护栏策略。单击策略名称可查看规则。 |
| Agent 名称 | 触发管控的 Agent 工具。 |
| 用户信息 | 使用该 Agent 的员工。将鼠标悬浮在此列，可查看员工详情。 |
| 设备信息 | 发生该次行为的终端。将鼠标悬浮在此列，可查看设备详情。 |
| 操作系统 | 发生该次行为的终端操作系统。 |
外发日志
需要将护栏日志纳入企业统一分析，或保留更长时间时，可将 Agent 行为护栏日志实时外发至企业自有的 Syslog 或 Elasticsearch 服务。配置步骤请参见配置日志外发。