跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

令牌格式

最后更新 查看 MarkdownAgent 设置

Cloudflare API 密钥和 API 令牌采用带前缀、便于扫描的格式,凭据扫描工具可以识别这种格式。下表中的每种凭据类型都有唯一前缀,后接 40 个字符和校验和。

凭证类型 说明 格式
全局 API 密钥 与您的用户账户绑定的全局密钥(完整访问权限) cfk_[40 characters][checksum]
用户 API 令牌 您为特定权限创建的范围限定令牌 cfut_[40 characters][checksum]
账户 API 令牌 由账户拥有、不与特定用户绑定的令牌 cfat_[40 characters][checksum]

现有令牌继续有效。您创建的每个新令牌或轮换后的令牌都会自动使用可扫描格式。

泄露令牌检测

前缀格式和校验和使凭证扫描工具能够高置信度地检测泄露的 Cloudflare 令牌。Cloudflare 与凭证扫描提供商合作,主动发现您泄露的令牌并在被恶意使用之前将其撤销。

GitHub 密钥扫描

Cloudflare 参与 GitHub 的 Secret Scanning 计划 ↗。GitHub 会扫描每个提交,查找公共和私有仓库中的 Cloudflare API 凭证。

  • 公共仓库 — 当 GitHub 检测到泄露的 Cloudflare 令牌时,会使用校验和验证该令牌并向 Cloudflare 发送 webhook。Cloudflare 会自动撤销该令牌并通过电子邮件通知您,以便您生成替代令牌。
  • 私有仓库 — GitHub 会通知您任何泄露的 Cloudflare 令牌,以便您进行轮换。

2026 年之前的格式

在引入可扫描格式之前创建的令牌使用无前缀字符串。这些令牌继续有效。Cloudflare 会扫描并撤销旧格式和新格式中泄露的令牌。

凭证类型 旧格式
全局 API 密钥 37–45 字符的小写十六进制字符串
用户 API 令牌 40 字符字母数字字符串
账户 API 令牌 40 字符字母数字字符串

Wrangler OAuth 访问令牌

使用 wrangler login进行身份验证时,Wrangler 会收到以 cfoat_ 开头的用户 OAuth 访问令牌。运行 wrangler auth token可获取当前令牌,以供其他工具或脚本使用。如果令牌已过期,该命令会自动刷新。

请将返回值视为机密。不要将其提交到源代码管理系统或与他人分享。

验证令牌

如需检查用户 API 令牌是否有效,请将其发送到验证令牌端点:

curl "https://api.cloudflare.com/client/v4/user/tokens/verify" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

如果令牌有效,响应会包含该令牌的 id 和值为 active 的 status。

这篇文档对您有帮助吗?