Vantaggi del collegamento
Il collegamento del vostro account Cloudflare ci consente di pubblicare siti statici su Cloudflare Pages sul vostro account e di gestire da lì il DNS e la cache dei vostri siti. Tutto risiede nella vostra dashboard Cloudflare e sul vostro piano Cloudflare.
Prima di iniziare
Un account Cloudflare, con i domini che desiderate utilizzare aggiunti come zone. Il piano gratuito è sufficiente per il collegamento; le azioni eseguibili su ciascuna zona dipendono da quanto consentito dal vostro piano.
1. Creare la chiave su Cloudflare
Nella dashboard di Cloudflare aprite My Profile → API Tokens e scegliete Create Token, quindi Create Custom Token. Assegnatele un nome, aggiungete le autorizzazioni indicate di seguito e alla voce Zone Resources scegliete le zone che desiderate consentirci di raggiungere: tutte le zone o solo quelle specificate. Verificatela e premete Create Token. Cloudflare mostra il token una sola volta; copiatelo subito.
Aggiungete queste autorizzazioni:
L'alternativa meno recente. Invece di un token, potete effettuare il collegamento con la vostra Global API Key e l'indirizzo email con cui effettuate l'accesso (My Profile → API Tokens → API Keys → Global API Key → View). Cloudflare ne sconsiglia l'uso: la Global API Key include qualsiasi autorizzazione posseduta dal vostro login, su ogni zona, e non può essere limitata. Utilizzate un token se possibile.
2. Effettuare il collegamento qui
Aprite Integrations nella vostra dashboard e scegliete Connect an account. Selezionate Cloudflare account (Pages, CDN & DNS) come gruppo e Cloudflare come account, compilate il campo API token o, in alternativa, API key e Account email, quindi premete Connect account.
Verifichiamo ciò che incollate prima che venga salvato qualsiasi elemento. Una chiave non funzionante non viene mai memorizzata e la risposta indica l'errore riscontrato. Una chiave funzionante viene conservata in forma crittografata nel nostro archivio sicuro (mai nel nostro database) e non viene più mostrata, nemmeno a voi.
Cosa accade dopo
- Cloudflare Pages compare come destinazione di distribuzione quando create o spostate un
sito statico, e noi pubblichiamo la build su un progetto Pages del vostro account.
- Le vostre zone possono gestire il DNS di un dominio e la cache di un sito da questo account.
- Verifichiamo che il token sia in grado di leggere le vostre zone, modificare il DNS, ripulire la cache e cambiare le impostazioni delle zone.
L'elenco di controllo accanto al collegamento mostra quali di queste operazioni siamo stati in grado di confermare.
Se desiderate mantenere CDN e DNS su account Cloudflare differenti, collegateli separatamente come Cloudflare CDN e Cloudflare DNS — ciascuno dispone di una propria guida.
In caso di mancato collegamento
Un'autorizzazione risulta non confermata. Cloudflare non sempre consente a un token di elencare le proprie autorizzazioni, pertanto alcune vengono confermate la prima volta che le utilizziamo. Se in seguito un'azione non va a buon fine restituendo un errore di autorizzazione, modificate il token in My Profile → API Tokens e aggiungete l'autorizzazione mancante: il valore del token non cambia, quindi non è necessario ricollegare nulla.
Manca una zona. Il campo Zone Resources del token non la include. Modificate il token per includere tale zona o tutte le zone.
Viene indicato che la chiave è stata rifiutata. Quasi sempre si tratta di una di queste tre cause: uno spazio o un'interruzione di riga copiati insieme alla chiave, una chiave scaduta o una chiave revocata o rigenerata dopo la copia. Create una nuova chiave e incollatela nuovamente.
Il collegamento riesce, ma in seguito si verifica un errore. La chiave viene autenticata ma manca di un'autorizzazione necessaria all'azione. Create una nuova chiave con le autorizzazioni elencate in precedenza, quindi disconnettete la vecchia connessione e collegate la nuova chiave.
Disconnessione
Aprite Integrations, individuate l'account e premete Disconnect. Questa operazione elimina immediatamente la chiave memorizzata. Qualsiasi elemento che la stesse utilizzando si interrompe all'azione successiva e le schermate che dipendevano da essa lo segnalano anziché fallire silenziosamente.
La disconnessione non annulla le operazioni già eseguite: i record, le distribuzioni o le impostazioni modificati sul vostro account rimangono inalterati. Se ritenete che la chiave stessa possa essere stata compromessa, revocatela anche presso il fornitore; la disconnessione rimuove la nostra copia, non la loro.