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

API 令牌

最后更新 查看 MarkdownAgent 设置

Flagship 支持两种 API 令牌。两者都使用相同的 创建 API 令牌 流程。区别在于权限策略所应用的资源。

令牌类型 资源 可访问的内容
账户范围 Entire Account(整个账户) 账户中的每一个 Flagship 应用
应用范围 Specified Flagship apps(指定的 Flagship 应用) 仅您选择的 Flagship 应用

当受信任的服务端工作流需要访问每一个 Flagship 应用时,使用账户范围令牌。当该工作流应仅接触您选择的应用时(例如某个产品的 CI 或后端服务),使用应用范围令牌。

两种令牌类型都支持 Read、Write 和 Evaluate。名称会随资源而变化:

访问权限 账户范围 应用范围
评估标志 Flagship Evaluate Flagship App Evaluate
读取标志配置 Flagship Read Flagship App Read
管理标志 Flagship Write Flagship App Write

创建应用范围令牌之前,必须先创建 Flagship 应用。仪表板只能列出已存在的应用。

创建账户范围令牌

创建账户范围 Flagship 令牌 ↗ 会打开 Account API tokens 页面。然后创建自定义令牌,并将资源保持为 Entire Account(整个账户)。

要自行创建令牌:

  1. 在 Cloudflare 仪表板中,前往 Account API tokens(账户 API 令牌) 页面。

    前往 Account API tokens(账户 API 令牌) ↗

    您也可以从 My Profile(我的个人资料) ↗ > API Tokens 创建用户令牌。

  2. 选择 Create Token(创建令牌)。

  3. 选择 Create Custom Token(创建自定义令牌) > Get started(开始)。

  4. 输入令牌名称。

  5. 在 Permission policies(权限策略) 下,将资源下拉菜单保持为 Entire Account(整个账户)。

  6. 搜索 Flagship,然后选择 Flagship Evaluate、Flagship Read 或 Flagship Write。

  7. (可选)使用 IP 地址过滤或 TTL 限制令牌。

  8. 选择 Review token(审阅令牌) > Create Token(创建令牌)。

  9. 复制令牌密钥并安全存储。

创建应用范围令牌

创建应用范围 Flagship 令牌 ↗ 会打开已预先选中 Specified Flagship apps(指定的 Flagship 应用) 和 Flagship App Evaluate 的令牌表单。然后选择应用并创建令牌。

要自行创建令牌:

  1. 在 Cloudflare 仪表板中,前往 Account API tokens(账户 API 令牌) 页面。

    前往 Account API tokens(账户 API 令牌) ↗

    您也可以从 My Profile(我的个人资料) ↗ > API Tokens 创建用户令牌。

  2. 选择 Create Token(创建令牌)。

  3. 选择 Create Custom Token(创建自定义令牌) > Get started(开始)。

  4. 输入描述使用场景的令牌名称,例如 checkout-service-ci。

  5. 在 Permission policies(权限策略) 下,打开资源下拉菜单(默认为 Entire Account(整个账户)),然后选择 Specified Flagship apps(指定的 Flagship 应用)。

  6. 在 Select Flagship apps(选择 Flagship 应用) 中,选择此令牌应访问的一个或多个应用。

  7. 在 Developer Platform 下,选择一项 Flagship App 权限:

    使用场景 权限
    在所选应用中评估标志 Flagship App Evaluate
    读取所选应用的标志配置 Flagship App Read
    管理所选应用中的标志 Flagship App Write
  8. (可选)使用 IP 地址过滤或 TTL 限制令牌。

  9. 选择 Review token(审阅令牌) > Create Token(创建令牌)。

  10. 复制令牌密钥并安全存储。

使用令牌

将令牌作为 authToken(TypeScript)或 Python 和 Go 中的等效选项传递给 OpenFeature SDK。

import { OpenFeature } from "@openfeature/server-sdk";
import { FlagshipServerProvider } from "@cloudflare/flagship/server";

await OpenFeature.setProviderAndWait(
	new FlagshipServerProvider({
		appId: "<APP_ID>",
		accountId: "<ACCOUNT_ID>",
		authToken: "<APP_SCOPED_API_TOKEN>",
	}),
);

将 <APP_ID> 和 <ACCOUNT_ID> 替换为令牌所限定的应用和账户。如果您评估的是另一个应用,应用范围令牌会被拒绝。

在 Cloudflare Worker 内部,优先使用绑定(binding)。绑定会自动完成身份验证,不需要 API 令牌。

后续步骤

这篇文档对您有帮助吗?