← Artifacts / artifacts / guides

Ověřování

Artifacts používá pro každé rozhraní jiný způsob ověřování. Vyberte ověřování podle toho, jak váš kód k repozitáři přistupuje.

Zkontrolujte Jmenné prostory nejprve a poté používejte jeden název jmenného prostoru jednotně napříč všemi rozhraními.

Porovnání metod ověřování

Rozhraní	Ověřování pomocí	Oprávnění nebo rozsahy	Použijte pro
Workers binding	Nakonfigurováno `artifacts` binding	Autentizace Wrangler slouží pouze pro lokální příkazy Wrangler, jako je `dev` a `deploy`.	Kód Workeru, který volá `env.ARTIFACTS`
REST API	Token Cloudflare API v `Authorization: Bearer ...`	Artefakty > Čtení pro čtecí trasy a Artefakty > Úprava pro zápisové trasy.	Požadavky HTTP na řídicí rovinu
Git protokol	Token Artifacts vázaný na repozitář	`read` pro clone, fetch a pull. `write` pro push.	Standardní Git přes HTTPS

Tokeny Cloudflare API ověřují přístup k řídicí rovině. Tokeny Artifacts s rozsahem na repozitář ověřují přístup k Gitu.

Ověřování bindingu Workers

Workers binding používá artifacts binding, který nakonfigurujete ve Wrangleru. Kód vašeho Workeru nepředává token při volání env.ARTIFACTS.

Přidejte binding do konfigurace Wrangler:

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "name": "artifacts-worker",
  "main": "src/index.ts",
  // Set this to today's date
  "compatibility_date": "2026-08-28",
  "artifacts": [
    {
      "binding": "ARTIFACTS",
      "namespace": "default"
    }
  ]
}

name = "artifacts-worker"
main = "src/index.ts"
# Set this to today's date
compatibility_date = "2026-08-28"

[[artifacts]]
binding = "ARTIFACTS"
namespace = "default"

Za běhu nasazené Workery používají nakonfigurovaný binding přímo. Pro místní příkazy Wrangler, například wrangler dev, wrangler deploy, nebo wrangler types, nejprve se ověřte pomocí Wrangler. Informace o místní autentizaci OAuth najdete v wrangler login. Pro prostředí CI nebo headless prostředí najdete informace v Spouštění Wrangler v CI/CD.

Ověřování REST API

REST API používá token Cloudflare API v Authorization hlavička.

export ACCOUNT_ID="<YOUR_ACCOUNT_ID>"
export ARTIFACTS_NAMESPACE="default"
export CLOUDFLARE_API_TOKEN="<YOUR_API_TOKEN>"
export ARTIFACTS_BASE_URL="https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/artifacts/namespaces/$ARTIFACTS_NAMESPACE"

Čtěte metadata repozitáře:

curl "$ARTIFACTS_BASE_URL/repos/starter-repo" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Vytvoření repozitáře:

curl --request POST "$ARTIFACTS_BASE_URL/repos" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "starter-repo"
  }'

Ověřování protokolu Git

Git používá tokeny Artifacts vázané na repozitář, nikoli tokeny Cloudflare API. Tyto tokeny vytvářejte pomocí vazby Workers nebo REST API a poté je použijte s repozitářem remote URL.

Rozsah tokenu	Povolené příkazy
`read`	`git clone`, `git fetch`, `git pull`
`write`	`git clone`, `git fetch`, `git pull`, `git push`

Použijte přesný repozitář remote hodnota vrácená vazbou Workers nebo REST API:

export ARTIFACTS_REMOTE="<PASTE_REMOTE_FROM_CREATE_OR_GET_RESPONSE>"

Ke klonování použijte token pro čtení:

git -c http.extraHeader="Authorization: Bearer <YOUR_READ_TOKEN>" clone "$ARTIFACTS_REMOTE" artifacts-clone

K push použijte token se zápisem:

git -c http.extraHeader="Authorization: Bearer <YOUR_WRITE_TOKEN>" push "$ARTIFACTS_REMOTE" HEAD:main

Další informace o správě tokenů a autentizovaných vzdálených repozitářích najdete v Git protokol.