Ce face conectarea pentru dumneavoastră
Conectarea GitHub cu un token permite implementarea unui site dintr-unul dintre depozitele dumneavoastră: trimiteți prin push în ramură, iar site-ul se actualizează. De asemenea, ne permite să publicăm pe GitHub Pages în contul dumneavoastră, atunci când alegeți această opțiune ca gazdă a unui site.
Dacă depozitele dumneavoastră aparțin unei organizații, alegeți de preferință aplicația Zinn® GitHub — consultați Instalați aplicația Zinn® GitHub. Un token aparține unei singure persoane și încetează să funcționeze atunci când aceasta pleacă.
Înainte de a începe
Un cont GitHub cu acces la depozitele pe care doriți să le implementați. Dacă acestea aparțin unei organizații, este posibil ca un proprietar să trebuiască să aprobe tokenurile granulare (fine-grained) pentru aceasta.
1. Creați cheia pe GitHub
Pe GitHub, faceți clic pe fotografia de profil, apoi pe Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Dați-i un nume și alegeți o dată de expirare. La Repository access, alegeți Only select repositories și selectați-le pe cele pe care le implementați — cel mai restrâns acces posibil.
La Repository permissions, acordați Read and write pentru:
- Contents
- Pages
- Administration
Apăsați Generate token și copiați-l — GitHub îl afișează o singură dată.
2. Conectați-o aici
Deschideți Integrări în panoul de control și alegeți Conectați un cont. Selectați Găzduire cod ca grup și GitHub ca cont, completați Token API și apăsați Conectați contul.
Testăm ceea ce lipiți înainte de a salva ceva. O cheie care nu funcționează nu este stocată niciodată, iar răspunsul menționează ce a fost în neregulă cu ea. O cheie funcțională este păstrată criptată în seiful nostru de secrete — niciodată în baza noastră de date — și nu este afișată niciodată din nou, nici măcar dumneavoastră.
Ce urmează
- Un site se poate implementa direct dintr-un depozit de pe acest cont: alegeți-l în conexiunea de depozit a site-ului, selectați depozitul și ramura, iar o operațiune de push va realiza implementarea.
- Fiecare altă ramură poate avea propria previzualizare, astfel încât să puteți verifica o modificare înainte ca aceasta să ajungă pe site-ul live.
- Gazdele statice bazate pe Git, cum ar fi Render și Azure Static Web Apps, folosesc această conexiune ca sursă a codului site-ului.
Dacă nu se conectează
Un depozit nu apare. Accesul la depozite al tokenului nu îl include. Editați tokenul pe GitHub și adăugați depozitul.
A funcționat și apoi s-a oprit. Tokenurile granulare expiră la data pe care ați ales-o. Generați unul nou și conectați-l; GitHub vă trimite un e-mail înainte ca un token să expire.
Indică faptul că cheia a fost respinsă. Aproape întotdeauna este vorba despre unul dintre aceste trei lucruri: un spațiu sau o întrerupere de rând copiată odată cu ea, o cheie care a expirat sau o cheie care a fost revocată sau regenerată după ce ați copiat-o. Creați una nouă și lipiți-o din nou.
Se conectează, dar ceva eșuează ulterior. Cheia se autentifică, dar îi lipsește o permisiune de care acțiunea are nevoie. Creați o nouă cheie cu permisiunile enumerate mai sus, apoi deconectați vechea conexiune și conectați noua cheie.
Deconectarea
Deschideți Integrări, găsiți contul și apăsați Deconectați. Aceasta șterge imediat cheia stocată. Orice element care o utiliza se va opri la următoarea sa acțiune, iar ecranele care depindeau de ea vor indica acest lucru în loc să eșueze silențios.
Deconectarea nu anulează ceea ce a fost deja făcut — înregistrările, implementările sau setările pe care le-am modificat în contul dumneavoastră rămân neschimbate. Dacă suspectați că însăși cheia s-ar fi putut scurge, revocați-o și la furnizor; deconectarea elimină copia noastră, nu și pe a lor.