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(整个账户)。
要自行创建令牌:
-
在 Cloudflare 仪表板中,前往 Account API tokens(账户 API 令牌) 页面。
前往 Account API tokens(账户 API 令牌) ↗您也可以从 My Profile(我的个人资料) ↗ > API Tokens 创建用户令牌。
-
选择 Create Token(创建令牌)。
-
选择 Create Custom Token(创建自定义令牌) > Get started(开始)。
-
输入令牌名称。
-
在 Permission policies(权限策略) 下,将资源下拉菜单保持为 Entire Account(整个账户)。
-
搜索 Flagship,然后选择 Flagship Evaluate、Flagship Read 或 Flagship Write。
-
(可选)使用 IP 地址过滤或 TTL 限制令牌。
-
选择 Review token(审阅令牌) > Create Token(创建令牌)。
-
复制令牌密钥并安全存储。
创建应用范围 Flagship 令牌 ↗ 会打开已预先选中 Specified Flagship apps(指定的 Flagship 应用) 和 Flagship App Evaluate 的令牌表单。然后选择应用并创建令牌。
要自行创建令牌:
-
在 Cloudflare 仪表板中,前往 Account API tokens(账户 API 令牌) 页面。
前往 Account API tokens(账户 API 令牌) ↗您也可以从 My Profile(我的个人资料) ↗ > API Tokens 创建用户令牌。
-
选择 Create Token(创建令牌)。
-
选择 Create Custom Token(创建自定义令牌) > Get started(开始)。
-
输入描述使用场景的令牌名称,例如
checkout-service-ci。 -
在 Permission policies(权限策略) 下,打开资源下拉菜单(默认为 Entire Account(整个账户)),然后选择 Specified Flagship apps(指定的 Flagship 应用)。
-
在 Select Flagship apps(选择 Flagship 应用) 中,选择此令牌应访问的一个或多个应用。
-
在 Developer Platform 下,选择一项 Flagship App 权限:
使用场景 权限 在所选应用中评估标志 Flagship App Evaluate 读取所选应用的标志配置 Flagship App Read 管理所选应用中的标志 Flagship App Write -
(可选)使用 IP 地址过滤或 TTL 限制令牌。
-
选择 Review token(审阅令牌) > Create Token(创建令牌)。
-
复制令牌密钥并安全存储。
将令牌作为 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 令牌。
- 在 Workers 之外设置 TypeScript Server SDK。
- 使用 IP 过滤或 TTL 限制令牌使用。