执行数据脱敏
提示
Feature availability 功能可用性
执行数据脱敏适用于:
- n8n Cloud: Enterprise
- Self-hosted: Enterprise
工作流级执行数据脱敏从 n8n 2.16.0 起可用。实例级执行数据脱敏强制从 n8n 2.26.0 起可用。
执行数据脱敏可让您隐藏工作流执行的输入和输出数据。这有助于保护个人数据、身份验证令牌和财务记录等敏感信息,避免不需要查看底层数据但可以查看工作流的用户看到这些信息。
启用脱敏后,执行元数据(状态、计时、节点名称)仍然可见,但 n8n 会用脱敏指示器替换每个节点处理的实际数据负载。
您可以为每个工作流配置脱敏,或在实例范围内强制执行,使所有工作流都对执行数据进行脱敏。
为什么使用执行数据脱敏
工作流通常会处理工作流构建者或查看者在 n8n 之外无权访问的数据。常见场景包括:
- PII and compliance PII 和合规性:处理客户个人数据(电子邮件、地址、财务记录)的工作流程需要满足 GDPR、SOC 2 或内部安全标准。
- Cross-department workflows 跨部门工作流程:一个团队构建的工作流程处理来自另一个团队的敏感数据,否则构建者将无法访问这些数据。
- Least privilege principle 最小权限原则:将数据可见性仅限于那些需要它的人,而不是具有工作流视图访问权限的每个人。
在执行数据脱敏之前,唯一的选择是在工作流级别完全禁用执行历史记录,这会移除工作流成功或失败状态的所有可见性。执行数据脱敏可以在隐藏敏感数据负载的同时保留执行监控。
配置脱敏设置
您可以在工作流设置中为每个工作流配置脱敏。您需要 workflow:enableRedaction 或 workflow:disableRedaction 权限范围(或两者)才能更改这些设置。
配置脱敏:
- 打开您的工作流程。
- 选择右上角的Workflow menu 工作流菜单
。 - 选择Settings 设置。
- 找到 Redact production execution data 脱敏生产执行数据 和 Redact manual execution data 脱敏手动执行数据 设置。
- 对于每个设置,选择 Default - Do not redact 默认 - 不脱敏 或 Redact 脱敏。
- 选择 Save 保存。
提示
Settings locked by instance enforcement 由实例强制执行锁定的设置
当实例级强制执行处于活动状态时,n8n 会将强制范围涵盖的设置锁定为 Redact 脱敏。您无法在工作流级别关闭它们。
脱敏设置说明
有两个独立的开关可以控制脱敏:
| 设置 | 它控制什么 |
|---|---|
| Redact production execution data 脱敏生产执行数据 | 控制 n8n 是否对生产(非手动触发)执行中的数据进行脱敏。生产执行包括工作流保持激活时由 Webhook、计划或其他触发器触发的执行。 |
| Redact manual execution data 脱敏手动执行数据 | 控制 n8n 是否对手动触发的执行中的数据进行脱敏。手动执行包括在编辑器中选择 Execute Workflow 执行工作流 启动的执行。 |
实例级强制执行
实例所有者和管理员可以对实例上的所有工作流强制执行脱敏,而不是依赖每个工作流的单独设置。强制执行会设置适用于所有位置的最低脱敏策略(“下限”)。
要启用强制执行,请转到 Settings 设置 > Policies 策略 并配置 Data redaction 数据脱敏 部分。请参阅安全设置了解分步说明。
执行范围
执行范围控制 n8n 在实例中编辑哪些执行:
| 范围 | 它强制执行什么 |
|---|---|
| Production executions 生产执行 | n8n 对每个工作流中的生产执行数据进行脱敏。手动执行遵循每个工作流自己的设置。这是推荐设置:它保护实时数据,同时保留手动测试运行以便调试。 |
| Manual and production executions 手动和生产执行 | n8n 对每个工作流中的所有执行数据进行脱敏。当测试数据也很敏感时可以使用此选项。 |
强制执行如何与工作流程设置交互
- Enforcement applies when execution data is read. 读取执行数据时应用强制执行。 每当有人查看执行时,n8n 都会对强制范围涵盖的数据进行脱敏,包括来自自身未启用脱敏设置的工作流的执行。
- Workflow settings can't be weaker than the enforced scope. 工作流设置不能弱于强制范围。 工作流设置 UI 会锁定受影响的脱敏开关,并且公共 API会拒绝使用低于下限的脱敏策略创建或更新工作流。工作流仍可选择比下限更严格的脱敏策略。
- New workflows start at the floor. 新工作流从下限开始。 强制执行处于活动状态时创建工作流,其脱敏策略默认为强制范围。通过公共 API 创建工作流而不指定脱敏策略时,n8n 会将其设置为下限。
- Existing workflow settings stay as they are. 现有工作流设置保持不变。 启用强制执行不会更改现有工作流的存储设置。其执行数据仍会按强制范围脱敏;如果之后禁用强制执行,每个工作流会恢复到自身设置。
脱敏内容
当 n8n 对执行进行脱敏时,会脱敏以下内容:
- Item JSON data 项目 JSON 数据:n8n 用空对象替换每个节点的所有输入和输出数据(
item.json)。 - Binary data 二进制数据:n8n 删除文件和图像等二进制数据(
item.binary)。 - Declared sensitive fields 已声明的敏感字段:n8n 始终对节点作者标记为敏感的字段(使用
sensitiveOutputFields)进行脱敏,即使用户具有查看权限,也不会允许查看这些字段。 - Error metadata 错误元数据:n8n 对错误消息进行脱敏,仅保留错误类型和 HTTP 状态代码(对于 API 错误)以帮助排查问题。
在编辑后的执行中:
- 执行查看器显示带有碎纸机图标的 "Data redacted" 数据已脱敏 指示器,而不是通常的数据表。
- 执行元数据仍然可见:节点名称、执行状态(成功/失败)、计时信息和工作流结构。
提示
Error information 错误信息
当 n8n 对执行数据进行脱敏时,也会对错误详细信息进行脱敏,防止敏感信息通过错误消息泄露。仅保留错误类型(例如 NodeApiError)和 HTTP 状态代码。这提供了足够的信息来识别故障类别,而不会暴露数据。
查看已脱敏数据
具有 Reveal execution data 查看执行数据(execution:reveal)权限范围的用户可以临时查看特定执行的已脱敏数据。实例所有者和管理员默认拥有此权限范围。
查看数据:
- 在执行查看器中打开执行。
- 选择脱敏数据区域中显示的 Reveal data 查看数据 按钮。
- 查看确认对话框。它解释说: * 系统将操作记录在审计跟踪中。 * 只有在有正当理由的情况下才应该透露数据。 * 不必要的访问可能违反您组织的政策。
- 选择 Reveal data 查看数据 进行确认。
该执行的数据会在当前会话中变为可见。
提示
Executions using dynamic credentials 使用动态凭证执行
n8n 会拒绝查看使用动态凭据的执行,无论用户权限或当前脱敏策略如何。这可以防止暴露在运行时解析的凭据。
审计日志
日志流会跟踪查看操作和强制策略变化。可以使用以下审计事件:
| 活动 | 描述 |
|---|---|
n8n.audit.execution.data.revealed |
用户查看已脱敏执行数据时,n8n 会发出此事件。包括用户、执行 ID、工作流 ID、时间戳、IP 地址和当前脱敏策略。 |
n8n.audit.execution.data.reveal_failure |
n8n 拒绝查看请求时(例如权限不足),会发出此事件。包括相同字段以及拒绝原因。 |
n8n.audit.redaction-enforcement.updated |
用户更改实例级强制策略时,n8n 会发出此事件。包括更改前后的用户和策略值。 |
这些事件会与您现有的日志流目标(syslog、webhooks、Sentry)集成,并支持合规报告和访问审计。
权限范围
执行数据脱敏引入以下权限范围,您可以通过自定义项目角色分配这些权限:
| 范围 | 目的 |
|---|---|
workflow:enableRedaction |
允许在工作流设置中启用脱敏。在角色配置 UI 中显示为 Enable data redaction 启用数据脱敏。 |
workflow:disableRedaction |
允许在工作流设置中禁用脱敏。在角色配置 UI 中显示为 Disable data redaction 禁用数据脱敏。 |
默认情况下,实例所有者、管理员和项目管理员有权启用或禁用脱敏以及查看已脱敏数据。您可以创建自定义角色,为更多用户(例如工作流构建者)独立授予其中一个或两个权限范围。
哪些修订不包括
当用户查看执行时,编辑控制执行数据的可见性。它不是后端访问控制,并且某些数据路径超出了其范围。在评估修订的合规性时,请记住这些限制:
- Code node
console.logoutput 代码节点console.log输出:代码节点使用console.log记录的数据未经过编辑。在手动执行中,输出显示在编辑器的“日志”面板中。在生产执行中,输出将发送到服务器的标准输出 (stdout) 以及附加到它的任何日志记录基础设施。 - Data flowing between nodes 数据在节点之间流动:脱敏不限制下游节点接收的内容。在执行过程中,数据在节点之间流动不受限制,因此工作流中的任何节点都可以向外部系统发送执行数据。脱敏控制用户在执行查看器中看到的内容,而不是工作流本身对数据执行的操作。
- Webhook responses Webhook 响应:工作流返回给调用者的响应正文(例如,通过响应 Webhook 节点或节点的响应选项)是原始数据,而不是经过编辑的版本。
- Authentication headers in outbound requests 出站请求中的身份验证标头:编辑不会改变工作流向外部服务发出的请求,包括它们包含的任何身份验证标头。
- No field-level redaction 无字段级脱敏:脱敏适用于节点的整个数据负载。您无法为数据中的各个字段配置脱敏。节点作者声明为敏感的字段是例外,n8n 始终会对其进行脱敏。
- Stored data stays as it is 存储的数据保持原样:编辑不会加密或更改数据库中的执行数据。 n8n 在通过 API 提供数据时应用修订。任何能够直接访问数据库的人都可以读取底层数据。
- Enforcement doesn't propagate through source control 强制执行不会通过源代码控制传播:实例级强制是一项实例策略,当您使用源代码管理 推送工作流时,不包括在内。从强制实例推送到非强制实例的工作流不会在目标实例上进行编辑。这与其他实例级策略的行为相匹配,例如双因素身份验证强制实施。
最佳实践
选择正确的编辑策略
| 场景 | 推荐设置 |
|---|---|
| 生产中处理 PII、财务数据或身份验证令牌的工作流程 | 编辑生产执行数据 |
| 即使测试数据也很敏感的工作流程(例如,使用生产数据的副本) | 编辑生产和手动执行数据 |
| 处理非敏感数据或初始开发期间的工作流程 | 没有编辑 |
一般建议
- Start with production redaction 从生产编辑开始:对于大多数处理敏感数据的工作流程,编辑生产执行同时保持手动执行可见,可以在安全性和易于调试之间实现良好的平衡。
- Redact manual data when needed 需要时编辑手动数据:如果您的测试环境使用真实或类似生产的数据,还可以启用手动执行编辑。
- Use log streaming 使用日志流:启用日志流以捕获揭示审计事件。这提供了合规性审计跟踪,并允许您监控谁访问敏感执行数据。
- Review redaction settings during workflow reviews 在工作流审核期间检查脱敏设置:将脱敏策略纳入工作流审核或批准流程,特别是对于处理跨部门或面向客户数据的工作流。
安全考虑
- n8n 在 API 级别应用脱敏,并且从不将已脱敏数据发送到浏览器。
- 当您创建自定义节点 时,您可以将特定输出字段声明为敏感(在节点类型定义中使用
sensitiveOutputFields)。 n8n 始终会编辑这些字段并防止泄露它们,即使对于具有泄露访问权限的用户也是如此。 - 如果编辑服务无法解析节点的类型定义(例如,卸载社区节点后),n8n 会完全编辑该节点的所有输出数据。这种故障关闭方法可以防止未知节点泄漏敏感字段。
- 启用编辑后,执行数据也会自动从日志流 和日志输出中编辑。