← 中文资源

简体中文版本

用 Fetch 白名单阻断 SSRF

在 fetch 前对照主机白名单验证每个出站 URL,使用户提供的 URL 无法到达内部元数据端点。

阅读英文原文

关闭攻击面

先测量问题。在 fetch 前对照主机白名单验证每个出站 URL,使用户提供的 URL 无法到达内部元数据端点。 最常见的错误是未确认门禁能捕获你关心的问题就先加上。在接入 CI 之前,先对当前代码库运行 if (!ALLOWED_HOSTS.has(new URL(url).hostname)) throw new Error(‘blocked’); 并检查输出。

if (!ALLOWED_HOSTS.has(new URL(url).hostname)) throw new Error('blocked');

验证与监控

门禁就位后,让失败可操作。if (!ALLOWED_HOSTS.has(new URL(url).hostname)) throw new Error(‘blocked’); 失败时应指向具体文件和行号,而非泛泛的错误。在锁文件中固定工具版本,防止上游发布悄悄改变行为。每次拉取请求都应像审查测试结果一样审查门禁输出。

验证

在本地运行 if (!ALLOWED_HOSTS.has(new URL(url).hostname)) throw new Error(‘blocked’); 确认通过后推送。CI 中门禁应阻断不合规的拉取请求。若人为绕过门禁直接推送,应在下次定期扫描中被发现。

注意事项

  • The gate only runs on events that trigger the workflow; locally pushed commits bypass it.
  • Configuration drift is possible if someone edits settings outside version control.