管理 API 令牌和密钥

了解如何创建 API 密钥和令牌来管理 Cloudflare 帐户设置。


概述

Cloudflare API 通过编程接口公开了整个 Cloudflare 功能。 您可以使用 Cloudflare API 管理帐户设置、配置产品和开发应用程序。

使用 Cloudflare API 需要 API 令牌或 API 密钥来验证 API 请求的来源。要了解有关身份验证过程的更多信息,请查看 Cloudflare API 文档

API 密钥对于每个 Cloudflare 用户都是唯一的,并且仅用于身份验证。API 密钥不会授权访问帐户或区域。 

API 令牌可让您授权访问特定 Cloudflare 页面、帐户和区域,但权限有限。每个 Cloudflare 用户最多可以有 50 个与他们的 Cloudflare 帐户关联的 API 令牌。

API 令牌与创建它们的用户相关联。如果您的 Cloudflare 帐户无效或您的权限变化,您将失去对 API 令牌的访问权限。

如果您管理多用户帐户,Cloudflare 建议创建一个服务帐户来发行令牌,使生产流程自动化。

要了解有关 API 令牌的更多信息,请阅读我们的博客文章。


生成 API 令牌

如需生成 API 令牌:

1.登录 Cloudflare 仪表板。

2.在 My Profile 下拉菜单下,单击 My Profile

3.单击 API tokens 选项卡。

4.单击 Create Token 按钮。您将看到 Create Token 屏幕。 api_tokens.png

5.您有两个配置选项可供选择:

5a. 选择 Custom 以手动设置所需的令牌配置。然后,前进到第 6 步。create_api_token.png

5b.选择 Start with a template 以从常用配置列表中进行选择。 选择模板,然后单击 Use template。然后,前进到第 6 步。api_token_from_template.png

6.选择以下编辑或阅读 Permissions

  • AccountZone Resources:API 令牌将包括或排除您的帐户或与您的帐户相关联的域名和子域名。

7.选择以下编辑或阅读 Resources

  • AccountZone:API 令牌将应用于您的帐户或与您的帐户相关联的域名和子域名。

api_token_permission___zone_resources.png

8.单击 Continue to summary

9.审查 API 令牌详细信息,然后单击 Create Token 以结束。您会看到一条带有 API 令牌的确认消息。

10.单击 Copy 将您的 API 令牌保存在计算机上。该令牌包含您的密钥,因此请确保将其保存在安全的位置。

这是系统唯一一次向您展示 API 令牌密钥。

api_token_screenshot.png


滚动 API 令牌

如果您的 API 令牌被盗或丢失,则可以创建一个新令牌,也可以将您的密钥 Roll 成新的密钥。滚动您的密钥将授权与上一个密钥相同的访问和权限。

要滚动 API 令牌,请在 Cloudflare 仪表板的 API Tokens 部分单击 Roll 

api_tokens_roll.png

然后,单击 Confirm 继续,您将看到一个新的 API 令牌密钥。


查看 API 秘钥

要检索您的 API 密钥:

1.登录 Cloudflare 仪表板。

2.在 My Profile 下拉菜单下,单击 My Profile

3.单击 API tokens 选项卡。

4.在 API keys 部分,选择以下两个选项之一:Global API Key 或 Origin CA Key。选择您要查看的 API 密钥。

全局 API 密钥是您的主要 API 密钥。仅当使用 API 创建原始证书时才使用原始 CA 密钥。

5.要更改您的 API 密钥,请单击 Change。您需要先填写验证码,然后方可应用变更。

api_keys_multiuseraccount.png

全局 API 密钥不适用于托管合作伙伴 API。要检索托管合作伙伴密钥(也称为“主机 API 密钥”),请查看这些说明。 如果您想成为服务器托管合作伙伴,请联系我们的服务器托管合作伙伴团队。

相关资源

Not finding what you need?

95% of questions can be answered using the search tool. This is the quickest way to get a response.

由 Zendesk 提供技术支持