← Cloudflare Flagship / flagship

API tokeny

Flagship podporuje dva druhy API tokenů. Oba používají stejné Vytvoření API tokenu tok. Rozdíl je v prostředku, na který se zásada oprávnění vztahuje.

Použijte token platný pro celý účet, pokud důvěryhodný proces na straně serveru potřebuje přístup ke všem aplikacím Flagship. Použijte token vázaný na aplikaci, pokud má daný proces pracovat jen s vybranými aplikacemi, například s CI nebo backendovou službou pro jeden produkt.

Oba typy tokenů podporují Čtení, Zápis, a Vyhodnocení. Názvy se liší podle prostředku:

Musíte vytvořit aplikaci Flagship než budete moci vytvořit token vázaný na aplikaci. Dashboard dokáže zobrazit pouze aplikace, které již existují.

Vytvořte token Flagship platný pro celý účet ↗ k otevření stránky Account API tokens. Poté vytvořte vlastní token a ponechte sadu zdrojů nastavenou na Entire Account.

Chcete-li si token vytvořit sami:

1. V dashboardu Cloudflare přejděte na API tokeny účtu stránce.

   Přejděte na API tokeny účtu ↗

   Uživatelský token můžete také vytvořit z My Profile ↗ > API Tokens.

2. Vyberte Create Token.

3. Vyberte Create Custom Token > Začínáme.

4. Zadejte název tokenu.

5. V části Zásady oprávnění, ponechte rozevírací nabídku prostředků nastavenou na Entire Account.

6. Vyhledejte Flagship a vyberte Flagship Evaluate, Flagship Read, nebo Flagship Write.

7. (Volitelné) Omezte token pomocí Filtrování podle IP adresy nebo TTL.

8. Vyberte Zkontrolujte token > Create Token.

9. Zkopírujte token secret a uložte ho na bezpečné místo.

Vytvořte token Flagship s omezením na aplikaci ↗ k otevření formuláře tokenu s Zadané aplikace Flagship a Flagship App Evaluate již vybraný. Poté zvolte aplikaci a vytvořte token.

Chcete-li si token vytvořit sami:

1. V dashboardu Cloudflare přejděte na API tokeny účtu stránce.

   Přejděte na API tokeny účtu ↗

   Uživatelský token můžete také vytvořit z My Profile ↗ > API Tokens.

2. Vyberte Create Token.

3. Vyberte Create Custom Token > Začínáme.

4. Zadejte název tokenu, který popisuje, kde ho budete používat, například checkout-service-ci.

5. V části Zásady oprávnění, otevřete rozevírací nabídku prostředků (výchozí hodnota je Entire Account) a vyberte Zadané aplikace Flagship.

6. V Vyberte aplikace Flagship, vyberte aplikaci nebo aplikace, ke kterým by měl mít tento token přístup.

7. V části Developer Platform, vyberte Flagship App oprávnění:

   Případ použití	Oprávnění
   Vyhodnocení příznaků ve vybraných aplikacích	Flagship App Evaluate
   Čtení konfigurace příznaku pro vybrané aplikace	Flagship App Read
   Správa flagů ve vybraných aplikacích	Flagship App Write

8. (Volitelné) Omezte token pomocí Filtrování podle IP adresy nebo TTL.

9. Vyberte Zkontrolujte token > Create Token.

10. Zkopírujte token secret a uložte ho na bezpečné místo.

Předejte token do OpenFeature SDK jako authToken (TypeScript) nebo ekvivalentní možnost v Python a Go.

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>",
	}),
);

Nahraďte <APP_ID> a <ACCOUNT_ID> s aplikací a účtem, na které je token omezen. Token omezený na aplikaci je odmítnut, pokud vyhodnocujete jinou aplikaci.

Uvnitř Cloudflare Workeru upřednostněte binding. Vazba se ověřuje automaticky a nepotřebuje API token.

• Nastavení TypeScript Server SDK mimo Workers.
• Omezte použití tokenu pomocí Filtrování IP nebo TTL.