← Cloudflare Fundamentals / fundamentals / api / how-to

Adresy URL šablon API tokenů

Pomocí URL šablon generujte tokeny Cloudflare API s předem nakonfigurovanými oprávněními. Díky URL šablonám můžete uživatelům sdílet požadavky na token, aniž by museli oprávnění ručně vybírat v dashboardu.

Template URL adresy využívají parametry dotazu k předvyplnění stránky pro vytvoření API tokenu v Cloudflare dashboardu. Když uživatel otevře Template URL, dashboard automaticky nastaví zadaná oprávnění a nastavení.

Cloudflare podporuje šablony URL pro uživatelské tokeny API a API tokeny účtu. Další informace o rozdílu mezi těmito typy tokenů najdete v API tokeny účtu.

URL šablony uživatelských tokenů otevřou formulář pro vytvoření tokenu na úrovni uživatelského profilu (/profile/api-tokens). Tokeny vytvořené tímto způsobem vlastní uživatel.

Základní struktura adresy URL šablony je:

https://dash.cloudflare.com/profile/api-tokens?permissionGroupKeys=[ENCODED_PERMISSIONS]&accountId=*&zoneId=all&name=[TOKEN_NAME]

Šablonové URL adresy tokenu účtu otevírají formulář pro vytvoření tokenu na úrovni účtu. Tokeny vytvořené tímto způsobem vlastní účet (tokeny service principal) a nejsou vázány na žádného konkrétního uživatele. Vytváření tokenů účtu vyžaduje oprávnění Super Administrator nebo Administrator.

Základní struktura adresy URL šablony je:

https://dash.cloudflare.com/?to=/:account/api-tokens&permissionGroupKeys=[ENCODED_PERMISSIONS]&name=[TOKEN_NAME]

:account segment je zástupný symbol. Když uživatel otevře adresu URL, dashboard ho vyzve k výběru účtu, pokud má přístup k více než jednomu.

Šablony URL adres pro uživatelské i účtové tokeny používají stejné kódování oprávnění. Oprávnění jsou kódována jako pole JSON s touto strukturou:

[{ "key": "permission_name", "type": "read|edit|revoke|run|purge" }]

Uveďte oprávnění, která váš případ použití potřebuje. Podívejte se na reference oprávnění tabulka.

Naformátujte svá oprávnění jako pole JSON:

[
	{ "key": "dns", "type": "edit" },
	{ "key": "analytics", "type": "read" }
]

Pomocí URL kodéru převeďte řetězec JSON:

%5B%7B%22key%22%3A%22dns%22%2C%22type%22%3A%22edit%22%7D%2C%7B%22key%22%3A%22analytics%22%2C%22type%22%3A%22read%22%7D%5D

Pro token uživatele, zkombinujte všechny komponenty do výsledné šablony URL:

https://dash.cloudflare.com/profile/api-tokens?permissionGroupKeys=[ENCODED_JSON]&accountId=*&zoneId=all&name=Custom%20Token

Pro token účtu, použijte místo toho cestu na úrovni účtu:

https://dash.cloudflare.com/?to=/:account/api-tokens&permissionGroupKeys=[ENCODED_JSON]&name=Custom%20Token

V této tabulce najdete klíče oprávnění pro vlastní šablony.

Použijte tyto předpřipravené URL šablony pro běžné scénáře. Každý příklad obsahuje URL pro uživatelský token i URL pro účtový token.

Vytvářejte tokeny pro správu DNS záznamů.

Vytvářejte tokeny pro Workers, úložiště KV a související služby.

Vytvářejte tokeny pro přístup k analytickým datům a protokolům.

Vytvářejte tokeny pro správu Cloudflare Zero Trust.

Při vytváření a sdílení šablonových adres URL se řiďte těmito pokyny.

• Princip nejnižších oprávnění: Vyžadujte pouze minimální oprávnění nezbytná pro váš případ použití. Tím se sníží bezpečnostní rizika v případě, že dojde ke zneužití tokenu.
• Používejte popisné názvy tokenů: do URL šablon zahrňte jasné a popisné názvy, aby uživatelé snadno pochopili účel tokenu.
• Zdokumentujte použití tokenu: Uveďte jasně, k čemu se každý token používá a jak ho v případě potřeby zneplatnit.
• Pravidelná rotace tokenů: Vybízejte uživatele k pravidelné rotaci tokenů a kontrole oprávnění.
• Otestujte před sdílením: Template URL adresy vždy nejprve vyzkoušejte ve zkušebním prostředí, než je poskytnete uživatelům.

Prohlédněte si seznam běžných problémů a jejich řešení.

Před sdílením adresy URL šablony si navíc projděte kontrolní seznam.

• Všechny klíče oprávnění jsou správné
• Syntaxe JSON je platná
• Kódování adresy URL je správné
• Název tokenu je popisný
• Oprávnění dodržují princip nejnižších oprávnění

• Oprávnění API tokenů
• Vytváření API tokenů
• API tokeny účtu
• Ověřování API