Base di conoscenza

Colleghi il Suo account GitHub con un token affinché i Suoi siti vengano distribuiti da un repository

Crea un token GitHub granulare per i repository che distribuisci e collegalo, in modo che un push distribuisca il tuo sito e i branch ricevano le anteprime.

Vantaggi del collegamento

Il collegamento di GitHub tramite un token consente a un sito di essere distribuito da uno dei vostri repository: eseguite il push sul branch e il sito si aggiorna. Consente inoltre la pubblicazione su GitHub Pages sul vostro account nei casi in cui scegliete tale opzione come host del sito.

Se i vostri repository appartengono a un'organizzazione, preferite invece l'applicazione Zinn® per GitHub — consultate Installare l'applicazione Zinn® per GitHub. Un token appartiene a una singola persona e smette di funzionare quando questa lascia l'organizzazione.

Prima di iniziare

Un account GitHub con accesso ai repository che desiderate distribuire. Se appartengono a un'organizzazione, un proprietario potrebbe dover approvare i token granulari per essa.

1. Creare la chiave su GitHub

Su GitHub, fate clic sulla vostra immagine del profilo, quindi su Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Assegnate un nome e scegliete una data di scadenza. Sotto Repository access scegliete Only select repositories e selezionate quelli che desiderate distribuire, applicando il livello di accesso minimo necessario.

Sotto Repository permissions impostate Read and write su:

  • Contents
  • Pages
  • Administration

Fate clic su Generate token e copiatelo: GitHub lo mostra una sola volta.

2. Effettuare il collegamento qui

Aprite Integrations nella vostra dashboard e scegliete Connect an account. Selezionate Code hosting come gruppo e GitHub come account, inserite il API token e fate clic su Connect account.

Verifichiamo il testo incollato prima di salvare qualsiasi elemento. Una chiave non funzionante non viene mai memorizzata e il messaggio di errore indica il problema riscontrato. Una chiave funzionante viene conservata in modo crittografato nel nostro caveau dei dati riservati (mai nel nostro database) e non viene più mostrata, nemmeno a voi.

Cosa succede dopo

  • Un sito può essere distribuito direttamente da un repository su questo account: selezionatelo nella connessione del repository del sito, scegliete il repository e il branch e un push eseguirà la distribuzione.
  • Ciascuno degli altri branch può ottenere un'anteprima dedicata, consentendovi di verificare una modifica prima che venga applicata al sito attivo.
  • Gli host statici basati su Git, come Render e Azure Static Web Apps, utilizzano questa connessione come origine del codice del sito.

In caso di mancata connessione

Un repository non viene visualizzato. L'accesso ai repository associato al token non lo include. Modificate il token su GitHub e aggiungete il repository.

Ha funzionato ma poi ha smesso. I token granulari scadono nella data stabilita. Generatene uno nuovo e collegatelo; GitHub invia un'email di avviso prima della scadenza di un token.

Viene indicato che la chiave è stata rifiutata. Quasi sempre si tratta di uno di questi tre problemi: la copia accidentale di uno spazio o di un'interruzione di riga, una chiave scaduta o una chiave revocata o rigenerata dopo essere stata copiata. Create una nuova chiave e incollatela nuovamente.

La connessione riesce, ma un'operazione successiva fallisce. La chiave effettua l'autenticazione ma non dispone di un'autorizzazione necessaria per l'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 fate clic su Disconnect. Questa operazione elimina immediatamente la chiave memorizzata. Qualsiasi elemento che la stesse utilizzando si interrompe alla successiva operazione e le schermate dipendenti da essa lo segnalano chiaramente anziché fallire silenziosamente.

La disconnessione non annulla le operazioni già eseguite: registri, distribuzioni o impostazioni modificate 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.

Ultimi articoli del blog

Di cosa abbiamo scritto riguardo a hosting, SEO e gestione di siti su larga scala.

SEO e Link Building dal Layer di Hosting: La Visione di un Operatore nel 2026

In che modo l'hosting influenza l'indicizzazione e la link equity nel 2026: mantenere le pagine indicizzate, valutare i domini anziani prima di svilupparli, la creazione di link senza lasciare tracce e una visione onesta di ciò che l'infrastruttura può e non può fare per la SEO.

Leggi il post

Rendere WordPress Veloce e Sicuro: Una Checklist per Prestazioni e Plugin

Una checklist pratica per WordPress veloce e sicuro: caching a livello di server, una object cache per singolo sito, la manciata di plugin che vale la pena usare, il mantenimento dello stack aggiornato e le pagine di WooCommerce che non devi mai mettere in cache.

Leggi il post

Come scegliere l'hosting web gestito nel 2026: Guida all'acquisto

Ciò che distingue realmente un buon hosting gestito da un server economico con pannello di controllo — migrazioni, backup, isolamento, caching reale e scalabilità onesta — e come valutarlo prima di impegnarsi.

Leggi il post

Leggi il blog

Ancora bloccato?

Il supporto è incluso in ogni piano, il servizio è attivo 24 ore al giorno e potete scriverci in una qualsiasi delle nostre 58 lingue: vi risponderemo nella vostra.

Contatta il supporto Tutti gli articoli