Cloudflare Gateway 推出 Forward 动作与自定义函数，接入 Workers 实现可编程安全网关

市面上每一款安全Web网关的工作方式都如出一辙：流量匹配某个条件，触发一个终端动作。允许、阻止、隔离、记录。这个模型近30年来一直是网络安全的基础，它很好地处理了常见情况。但它存在上限，而拥有复杂环境的客户经常会触及这个上限。

今年早些时候，我们分享了构建真正可编程的SASE平台的愿景。我们还概述了可编程性 一词如何被安全行业稀释。大多数厂商声称具备可编程性，只是因为他们有公开API、Terraform provider、webhook和告警功能。Cloudflare也提供所有这些，但这还不够。真正的可编程性意味着运行你自己的代码——你为特定环境编写的任意逻辑——内联在策略评估路径中，在安全决策做出的那一刻。

今天，我们很高兴地宣布，Cloudflare通过将Cloudflare Gateway和DLP（数据防泄漏）与我们整个边缘计算平台集成，为其带来了真正的可编程性。我们发布了一种新型的Gateway动作——Forward，以及自定义验证函数，面向所有Zero Trust套餐开放。这些能力让你可以使用Cloudflare Worker来转换和操控流量，或者将你自己的数据引入策略评估。

每个安全团队都面临的权衡

自从防火墙诞生以来，企业就面临着一个二元选择。你可以维护自己的安全检测引擎——自己的防火墙、自己的代理基础设施——以高维护开销和低可移植性为代价，换取最大程度的自定义能力。或者，你可以接受厂商的约束，将可观的维护成本外包出去，代价是牺牲解决特定环境问题的灵活性。

在构建Cloudflare Gateway的六年里，我们听到成千上万的客户在这项权衡中挣扎。一个安全团队正在为某个关键内部应用迁移访问控制，需要根据其身份提供商（IdP）的JSON Web Token（JWT）声明注入HTTP头。数据存在于请求上下文中，但Gateway无法读取JWT并写入头。于是该团队搭建了一组NGINX代理，仅仅为了执行这个转换。这些基础设施现在必须打补丁、监控并保障安全……而且是无限期的。

另一个团队希望在某位员工注册新的SaaS服务的瞬间收到Slack通知。策略引擎可以检测到注册事件，但它只能执行允许或阻止。于是该团队构建了一条从Logpush到SIEM再到Slack的管道，延迟5到15分钟，且不保证送达。又堆上了另一块基础设施。

数十家企业客户要求提供警告页面，在允许访问敏感目标之前提示用户说明理由。大多数人随后希望根据关于用户身份和所请求访问级别的额外上下文来自定义后续行为。但从策略引擎提供自定义的动态响应极其困难。

多年来我们为客户提供了许多扩展点。但与其他所有防火墙厂商一样，我们不可能以威胁载体出现的速度来构建覆盖它们的特性。不过，我们也认识到，最好的解决方案是那些能够无限扩展以适应你的环境的方案。

为什么只有 Cloudflare 能解决这个问题

Cloudflare 不仅仅是一个防火墙，也不仅仅是一个安全 Web 网关、内容分发网络或边缘服务。Cloudflare 是一个可组合的计算平台。Cloudflare Workers 已经允许客户在我们遍布全球的 330 多个位置中的任意一个，在我们的网络边缘运行复杂的逻辑。Cloudflare Gateway 已经可以在这些相同的位置、相同的机器、相同的数据中心，对用户流量进行安全策略的评估与执行。

只有 Cloudflare 在同一张全球分布式网络中，同时运行分布式客户计算和功能完备的安全 Web 网关及防火墙。我们拥有独一无二的机会和能力，将这些功能整合为业界首个完全可编程、可定制的 SASE 平台。

Gateway 和 Workers 从一开始就构建在相同的基础设施之上。当 Gateway 将流量转发给 Worker 时，这次分发是一次本地函数调用。没有发卡回环。不会因跨越网络边界而产生额外延迟。这是客户第一次能够对其代理流量的处理方式拥有绝对控制权，无需任何妥协，使用他们自己编写和执行的代码，而无需维护任何形式的基础设施。

没有自己计算平台的独立 SASE 提供商，要求你在一个单独的云中部署自动化，手动配置 webhooks，并接受将彼此断开的系统拼接在一起所带来的往返延迟和管理开销。这个领域没有其他厂商拥有与其安全网关同址部署的可编程边缘计算平台。随着威胁以 AI 驱动的速度演进，这将为安全组织提供亟需的灵活性和敏捷性。

两个 Gateway 入口点：Forward 操作和 Custom Functions

一种名为 Forward 的新 Gateway 操作类型和一种名为 Custom Function 的新策略资源，是从 Gateway 策略调用 Worker 的两种不同方式。Forward 操作今天已进入公开测试阶段，Custom Functions 将在今年年底前推出。

Forward 操作：流量转换与代理

你可以通过一个名为 Forward 的新策略操作来自定义 HTTP 流量行为，该操作会将匹配到的 HTTP 请求作为代理路由到一个 Worker。带有 Forward 操作的策略会针对 HTTP 策略所允许的流量进行评估。第一条匹配的 Forward 规则随后将应用于你的流量，流量将被发送到其绑定的 Cloudflare Worker。该 Worker 充当内联中间件：它接收完整的标头和请求正文。你的逻辑随后可以选择修改其中任意一项（或采取某种其他异步操作），将请求转发到源站，接收响应，也可以修改该响应，并将最终响应返回给用户。

import { WorkerEntrypoint } from "cloudflare:workers";
import type {
  GatewayMiddlewareContext,
  GatewayMiddlewareNext,
} from "@cloudflare/zt-types";

export class GatewayMiddleware extends WorkerEntrypoint {
  async handle(
    request: Request,
    context: GatewayMiddlewareContext,
    next: GatewayMiddlewareNext,
  ): Promise<Response> {
    // Read a value from the Gateway context
    const clientIP = context.srcIp;

    // Add headers before the request reaches the origin
    request.headers.set("X-Gateway-Client-IP", clientIP);

    // Forward upstream and get the response
    const response = await next(request);

    // Modify the response before it reaches the user
    response.headers.set("X-Processed-By", "gateway-middleware");

    return response;
  }
}

Gateway 负责处理 TCP 连接、TLS 终止与重新加密、证书管理以及 HTTP 版本协商。Worker 只负责转换逻辑。你为现有的安全栈获得了一个可定制、类代理的扩展点，而无需承担托管传统 HTTP 代理的任何运营成本。

你的 Worker 也不必转换请求。规则的唯一目的可以是将请求异步代理到一个 Worker，该 Worker 会收到匹配请求的完整上下文：发送 Slack 消息、写入 R2、记录到外部管道、调用 webhook、更新 KV 存储。流量可以不受打扰地继续前往其目的地。

自定义函数：内联策略评估

自定义函数在 Gateway 策略评估期间内联调用 Worker 并返回一个值。随后，该函数作为选择器暴露在 Gateway 策略构建器中，并针对其值进行评估。该选择器可用于任何网络或 HTTP Gateway 规则的条件中，就像如今内置选择器如 Source IP 或 Content Category 的工作方式一样。

Worker 会收到关于请求的上下文：源 IP、目的地、用户身份、设备状态、HTTP 头等，具体取决于策略阶段。Worker 返回一个带类型的值（字符串、数字或布尔值），供 Gateway 在规则条件中使用。约定很简单：数据输入，值输出。

下面是一个自定义函数，它解析 JWT Authorization 头并返回用户角色：

export class GatewayCustomSelector extends WorkerEntrypoint {
  async compute(ctx: GatewayContext): Promise<string> {
    const authHeader = ctx.request.headers.get("Authorization");
    if (!authHeader) return "anonymous";

    const token = authHeader.replace("Bearer ", "");
    const payload = JSON.parse(atob(token.split(".")[1]));
    return payload.groups?.[0] ?? "unknown";
  }
}

部署此函数后，管理员可以创建一条 HTTP 策略规则：自定义函数“JWT Role”包含“finance_contractor” ，操作为允许。该自定义函数成为规则条件的一部分，与其他所有选择器一起被评估。

自定义函数并不限于 HTTP 流量。由于它们接收的是身份、设备状态和连接元数据，而不是完整的 HTTP 请求，因此你也可以在 Gateway 网络策略规则构建器中，将其用于任意的第 4 层端口和协议流量。

Worker 本身可以做 Worker 已经能做的任何事情——调用外部 API、从 KV 或 D1 读取，或调用 Workers AI。但从 Gateway 的角度来看，该函数是确定性的：数据输入，值输出。

何时使用自定义函数或 Forward 操作

自定义函数旨在对数据执行快速、有界、无状态的评估，并可以返回一个塑造后的响应。你应当将其用途类比为 Gateway 选择器中已经可以评估的数据；也就是说，对一组标准中存在的数据进行计算，例如“处于此范围内的端口”或“匹配此正则模式的 URL 路径”。其强大之处在于能够用任意或内部数据源扩展你的结构化评估，下面你会看到一些示例。

Forward 操作需要更多的规划和准备。它可用于对用户的实时请求进行强大的内联转换，并可以复杂的方式在出口和返回源服务时操纵这些请求。这些应被视为转换函数，如今很少有企业安全代理甚至设想过这一点。使用 Forward 操作的 Worker 应当目标明确并精心设计，以避免对最终用户的整体体验产生不利影响。

你可以构建什么

目的说明和插页页面

Worker 会拦截发往敏感目标的请求，并返回一个插页页面，要求最终用户提供访问的书面理由。Worker 调用 Cloudflare KV 写入一个带 TTL 的会话，因此用户在配置的时间段内只会被提示一次。它将用户身份及其陈述的理由写入 Cloudflare D1，从而创建审计跟踪。或者，你可以使用 Hyperdrive 将该记录写入你已在运营的任何内部数据库。

四年多来，这一直是我们被请求最多的功能之一。有了能够处理和操作 HTTP 流量的 Worker，按照你自己的标准进行构建就变得很容易。

动态 HTTP 头部注入

自定义函数会从请求的 Authorization 头部解析 JWT，提取用户的角色或组成员身份，并将其作为选择器值返回。Gateway 规则根据该值进行匹配，并在上游请求上设置一个 X-App-Role 头部。无需 NGINX 代理池。无需维护额外的基础设施。

文件检查与日志记录

当文件下载符合某些条件时，Worker 可以将该文件发送到第三方沙箱服务进行引爆和分析。或者，它可以将文件完整写入 Cloudflare R2 作为永久记录以供日后检查，而文件永远不会离开 Cloudflare 网络。

策略匹配时的实时告警

绑定到转发策略的 Worker 会在数据丢失防护（DLP）配置文件匹配时接收流量。Worker 会向 Slack 频道或 PagerDuty 端点发送一条消息，包含用户的电子邮件、触发的规则以及目标 URL。

export default {
  async invoke(ctx: GatewayContext, env: Env): Promise<void> {
    await fetch(env.SLACK_WEBHOOK_URL, {
      method: "POST",
      body: JSON.stringify({
        text: `DLP alert: ${ctx.identity.email} triggered "${ctx.rule.name}" accessing ${ctx.request.url}`
      })
    });
  }
}

复杂的评估逻辑

传统的防火墙表达式构建器并非为某些组织在评估时所需的计算类型而设计。如果你维护跨多个数据源执行行为分析的内部风险评分系统，或者你有用户、组和条件成员资格的复杂映射，其中多个条件必须各自独立为真，你可以使用自定义函数作为计算扩展，评估所有这些逻辑并向 Gateway 返回单个值。

性能与可靠性

由于 Gateway 和 Workers 服务运行在 Cloudflare 网络中的同一批机器上，因此分发到 Worker 不会引入网络跳跃。性能影响仅限于你的 Worker 代码本身的执行时间。

当自定义函数失败时——抛出异常、超时或返回意外值——你可以按函数配置回退行为。自定义函数契约中要求提供 Default values ，以便于确定行为。

可用性与定价

Forward 操作及其与 Workers 的集成从今天起进入公开测试阶段，Custom Functions 预计将在今年年底前可用。正式发布时，两者将面向所有计划类型的所有客户提供。

分发到你的 Workers 的流量按标准 Worker 请求计费。该功能适用于 Workers Free、Workers Paid 和 Workers for Enterprise，功能上没有任何限制。Workers Free 确实有执行时间限制和每日请求限制，当你扩大发送到 Workers 的 Gateway 流量规模时，这一点值得考虑。

用于内联检测验证的 DLP 自定义函数

一个完全可编程的 SASE 平台远不止于 Gateway。我们的 DLP 产品——已集成到 Gateway、AI Gateway、Email Security 等之中——现在也通过与 Compute 平台的集成支持自定义结果。

大多数数据安全产品的工作原理是寻找与已知模式匹配的数据。客户通常可以定义正则表达式、单词列表或类似内容来运行这些检测。他们还可以通过对请求正文进行关键词或上下文分析来提高匹配的置信度。但这些方法有一个核心缺陷：这类检测只能告诉你某些内容何时与贵组织相关的数据模式匹配，而不能判断这一具体实例的数据是否表明数据外泄或滥用。

随着攻击者日益高级，且智能体可被用于无情地利用系统，仅仅提高我们准确检测模式的能力是不够的。要提高对重要数据的准确性，你需要知道相关数据是否与贵组织切实相关。

为解决这个问题，大多数方案采用精确数据匹配，但这有其自身的取舍。客户必须准备、维护和传输参考数据集，然后决定在多大程度上允许供应商管理来自其最敏感系统的数据。

DLP 的自定义验证函数弥合了这一差距，并且从今天起即可使用。这些自定义函数允许客户使用自己的真实数据源，直接在 Cloudflare Worker 中定义自己的验证逻辑……并将其应用于他们使用 DLP 保护敏感数据的所有地方。

凭证与密钥验证

当匹配到某个 DLP 检测条目时，可以派发一个出站 Worker，在做出策略执行决定之前运行验证逻辑。如果你有用于检测 GitHub 密钥使用的配置文件，但只关心活跃的密钥，你可以使用 Worker 先查询被检测到的密钥的状态，从相应的 GitHub 端点返回响应，然后决定 DLP 配置文件是否应匹配该流量。

import {
  DlpValidation,
  type DlpValidationInput,
  type DlpValidationResult,
} from "@cloudflare/zt-types";

export class DlpValidationEntrypoint extends DlpValidation {
  async validate({ excerpt, start, end }: DlpValidationInput): Promise<DlpValidationResult> {
    const bytes = Uint8Array.from(atob(excerpt), (c) => c.charCodeAt(0));
    const token = new TextDecoder().decode(bytes.slice(start, end));

    const res = await fetch("https://api.GitHub.com/user", {
      headers: {
        Authorization: `Bearer ${token}`,
        "User-Agent": "dlp-GitHub-validator",
        Accept: "application/vnd.GitHub+json",
      },
    });

    if (res.ok) return { score: 1.0 }; // token is valid and active
    if (res.status === 401) return { score: "veto" }; // token is invalid, discard
    return { score: 0 };
  }
}

下一步

这仅仅是完全可编程 SASE 平台的开始。我们正在积极增加可派发自定义功能的入口，以覆盖整个 Cloudflare One 套件，接下来是 Email Security。这并不意味着我们已经完成构建：这一新架构将使我们更容易、更灵活地为所有 Cloudflare One 服务构建第一方功能，并改善开发者体验。

如今，使用 Cloudflare One 来保护你的 Workers、智能体及其流量也正变得越来越容易。如果你是 Enterprise 客户，希望获得实施策略会议、即将推出的功能预览，或希望收到有关自定义函数测试版的通知，请联系你的客户团队。

贵组织的安全能力现在可以做到 Cloudflare Worker 能做的任何事情。我们迫不及待想看到你构建的作品。