Installa l'app GitHub di Zinn® per consentirci di effettuare il deployment senza un token di lunga durata

Che cosa comporta la connessione

L'installazione dell'applicazione GitHub di Zinn® consente a un sito di effettuare il deployment dai vostri repository e a una bacheca di progetto di rimanere sincronizzata con GitHub, senza doverci affidare un token personale. Conserviamo esclusivamente il numero di installazione dell'applicazione, che di per sé è inutile, e generiamo un token della durata di un'ora ogni volta che ne abbiamo bisogno. È la scelta migliore per un'organizzazione, poiché non appartiene a una singola persona e non smette di funzionare quando qualcuno lascia l'azienda.

Prima di iniziare

Un account GitHub o i diritti di proprietario sull'organizzazione in cui si desidera installare l'applicazione. Le organizzazioni che vietano le applicazioni di terze parti richiedono l'autorizzazione di un proprietario; se ciò non fosse possibile, utilizzare invece un token con granularità fine (Collega il vostro account GitHub).

1. Creare la chiave su GitHub

Non vi è alcuna chiave da creare. Installate l'applicazione GitHub di Zinn® sul vostro account personale o sulla vostra organizzazione e scegliete tutti i repository o solo quelli da cui desiderate che venga effettuato il deployment.

Quindi trovate il numero di installazione:

• Account personale — Impostazioni → Applicazioni → Applicazioni GitHub installate e Configura accanto all'applicazione Zinn®.
• Organizzazione — Le vostre organizzazioni → Impostazioni → Applicazioni GitHub e Configura accanto all'applicazione Zinn®.

Il numero alla fine della barra degli indirizzi in quella pagina, ad esempio github.com/settings/installations/12345678, è il numero di installazione.

2. Effettuare la connessione qui

L'applicazione viene selezionata nel punto in cui viene utilizzata anziché nella schermata delle Integrazioni:

• Sulla connessione del repository di un sito, scegliete GitHub (installazione app).
• Sul collegamento GitHub di una bacheca di progetto, scegliete L'applicazione GitHub di Zinn®.

Incololate il Numero di installazione e continuate. Verifichiamo l'installazione prima di salvare qualsiasi dato; un numero che non siamo in grado di raggiungere non viene mai memorizzato.

Cosa succede in seguito

• I repository a cui avete concesso l'accesso all'applicazione compaiono affinché il sito possa effettuare il deployment da essi, e un push avvia il deployment.
• Ogni azione che compiamo appare nel registro di controllo (audit log) dell'installazione su GitHub sotto il nome dell'applicazione, non il vostro.
• Per fornirci ulteriori repository, modificate l'accesso ai repository dell'applicazione nella stessa pagina Configura; non è necessario ricollegare nulla.

In caso di mancata connessione

Manca un repository. L'installazione copre unicamente i repository selezionati. Aprite Configura e aggiungetelo.

Il numero viene rifiutato. Verificate che si tratti del numero di installazione presente nella barra degli indirizzi e non dell'ID dell'applicazione, e che l'applicazione sia ancora installata (un'applicazione disinstallata non possiede alcuna installazione).

Viene indicato che la chiave è stata rifiutata. Quasi sempre si tratta di una di queste tre eventualità: uno spazio o un'interruzione di riga copiati insieme ad essa, una chiave scaduta o una chiave revocata o rigenerata dopo essere stata copiata. Create una nuova chiave e incollatela nuovamente.

La connessione avviene, ma successivamente si verifica un errore. La chiave effettua l'autenticazione ma risulta sprovvista 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 Integrazioni, individuate l'account e premete Disconnetti. Questa operazione elimina immediatamente la chiave memorizzata. Qualsiasi elemento che la stesse utilizzando si interrompe alla successiva azione, e le schermate che ne dipendevano lo segnalano anziché fallire silenziosamente.

La disconnessione non annulla quanto è già stato eseguito: i record, i deployment o le impostazioni che abbiamo modificato 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.