Cloudflare API 密钥和 API 令牌采用带前缀、便于扫描的格式,凭据扫描工具可以识别这种格式。下表中的每种凭据类型都有唯一前缀,后接 40 个字符和校验和。
| 凭证类型 | 说明 | 格式 |
|---|---|---|
| 全局 API 密钥 | 与您的用户账户绑定的全局密钥(完整访问权限) | cfk_[40 characters][checksum] |
| 用户 API 令牌 | 您为特定权限创建的范围限定令牌 | cfut_[40 characters][checksum] |
| 账户 API 令牌 | 由账户拥有、不与特定用户绑定的令牌 | cfat_[40 characters][checksum] |
现有令牌继续有效。您创建的每个新令牌或轮换后的令牌都会自动使用可扫描格式。
前缀格式和校验和使凭证扫描工具能够高置信度地检测泄露的 Cloudflare 令牌。Cloudflare 与凭证扫描提供商合作,主动发现您泄露的令牌并在被恶意使用之前将其撤销。
Cloudflare 参与 GitHub 的 Secret Scanning 计划 ↗。GitHub 会扫描每个提交,查找公共和私有仓库中的 Cloudflare API 凭证。
- 公共仓库 — 当 GitHub 检测到泄露的 Cloudflare 令牌时,会使用校验和验证该令牌并向 Cloudflare 发送 webhook。Cloudflare 会自动撤销该令牌并通过电子邮件通知您,以便您生成替代令牌。
- 私有仓库 — GitHub 会通知您任何泄露的 Cloudflare 令牌,以便您进行轮换。
在引入可扫描格式之前创建的令牌使用无前缀字符串。这些令牌继续有效。Cloudflare 会扫描并撤销旧格式和新格式中泄露的令牌。
| 凭证类型 | 旧格式 |
|---|---|
| 全局 API 密钥 | 37–45 字符的小写十六进制字符串 |
| 用户 API 令牌 | 40 字符字母数字字符串 |
| 账户 API 令牌 | 40 字符字母数字字符串 |
使用 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。