Cloudflare

Cloudflare kobles til med et kontoeid, skrivebeskyttet API-token. Polylane undersøker og forklarer hva den finner uten noen gang å endre noe i kontoen din; når fiksen er kode, kommer den som en pull request du kan gjennomgå. Tokenet ditt krypteres før det lagres, og agenten ser det aldri.

Oppsett

1. Klikk på Create read-only token over, eller Create API token i konsollens tilkoblingsskjema. Begge åpner Cloudflares skjerm for konto-API-tokener med hver tillatelse Polylane trenger forhåndsvalgt.
2. Velg kontoen du vil koble til. Du må være Super Administrator på den kontoen for å opprette et kontoeid token.
3. Gjennomgå de forhåndsutfylte tillatelsene, og klikk så på Continue to summary og Create Token.
4. Kopier tokenet og lim det inn i Polylane.
5. Polylane validerer tokenet og begynner å synkronisere.

Du må være på Workers Paid plan for full ressursoppdagelse.

Tillatelser

Den forhåndskonfigurerte lenken oppretter et kontoeid token: en varig tjenesteidentitet som fortsetter å virke selv om personen som opprettet det, forlater kontoen. Hver tillatelse er skrivebeskyttet, på tvers av hele kontoen:

• Developer Platform: Workers, KV, R2, D1, Queues, Pipelines, Hyperdrive, Durable Objects, Containers, Secrets Store, Artifacts og mer
• AI & Machine Learning: Workers AI, AI Gateway, AutoRAG, Vectorize, AI Search
• DNS & Zones: DNS, soneinnstillinger, registrar, DNS firewall
• Network Services: Load Balancing, Magic Transit/WAN, Spectrum, tunneler
• App Security: WAF, regelsett, DDoS, bot management, page rules, sertifikater
• Cache, Email, Media, Rules, Analytics & Logs

Ingenting i tokenet kan opprette, endre eller slette noe i kontoen din: ingen deployer, ingen konfigurasjonsendringer, ingen rollbacks, ingen administrasjon av fakturering eller API-tokener. Utbedring kommer som pull requester i stedet.

Frakobling

Koble kontoen fra i Polylane, og trekk så tilbake API-tokenet fra Cloudflare-dashbordet ditt under My Profile → API Tokens (eller Manage Account → API Tokens for kontoeide tokener).

Å koble til Cloudflare trenger ingen nettleser: det samme endepunktet konsollen kaller, passer i en CI-jobb. Én autentisert POST oppretter tilkoblingen og starter den første synkroniseringen.

Forutsetninger

• En Polylane-API-nøkkel med omfangene cloud_accounts:write og cloud_accounts:read. Se API-nøkler og OAuth.
• Workspace-ID-en din, som starter med ws_. Les den fra GET /v1/workspaces med den samme nøkkelen.
• Et kontoeid Cloudflare-API-token. Lenken Create read-only token over forhåndsvelger hver tillatelse Polylane trenger.

Opprett tilkoblingen

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "cloudflare",
    "workspaceId": "ws_0abc123",
    "token": "<cloudflare-api-token>",
    "readOnly": true
  }'

Ett kall kobler til hver Cloudflare-konto tokenet kan nå, hver som sin egen tilkobling.

• readOnly registrerer at tokenet ble opprettet skrivebeskyttet; utelat det (eller false) for et token som kan skrive.
• createMonitoringAlarms (valgfritt, standard true) styrer standardvarslene for Workers-observerbarhet.

Svaret lister hva som ble koblet til, med den første synkroniseringen allerede i gang. Trimmet til de to feltene resten av flyten leser:

{
  "success": true,
  "result": {
    "provider": "cloudflare",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

En konto som allerede er tilkoblet, lander i failures i stedet for accounts, så å gjenta kallet dupliserer aldri en tilkobling.

Vent på den første synkroniseringen

Spør etter hver returnert konto på id-en dens til status når ready (new ved registrering, syncing mens ressurser strømmer inn):

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

Gi løkken en frist slik at en feilet tilkobling får jobben til å feile i stedet for å henge. Når kontoen er ready, er ressursene dens i topologien, og Polylane har startet sin første sjekk.

Koble fra via API-et

Å slette tilkoblingen stopper hver synkronisering og sjekk og sletter legitimasjonen Polylane hadde. Kallet trenger omfanget cloud_accounts:delete:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

Trekk så tilbake Cloudflare-legitimasjonen på leverandørsiden, som beskrevet under Koble fra nedenfor.