Ce beneficii vă aduce conectarea
Instalarea aplicației Zinn® GitHub permite implementarea unui site din depozitele dumneavoastră — și sincronizarea unui panou de proiect cu GitHub — fără a ne furniza un token personal. Păstrăm doar numărul de instalare al aplicației, care este inutil de unul singur, și generăm un token valabil o oră de fiecare dată când avem nevoie de unul. Este opțiunea optimă pentru o organizație, deoarece nu aparține unei singure persoane și nu încetează să funcționeze atunci când cineva pleacă.
Înainte de a începe
Un cont GitHub sau drepturi de proprietar asupra organizației în care doriți să instalați aplicația. Organizațiile care interzic aplicațiile terțe necesită permisiunea unui proprietar; dacă acest lucru nu este posibil, utilizați în schimb un token cu permisiuni specifice (Conectați-vă contul GitHub).
1. Creați cheia pe GitHub
Nu trebuie să creați nicio cheie. Instalați aplicația Zinn® GitHub pe contul dumneavoastră personal sau pe organizația dumneavoastră și alegeți fie toate depozitele, fie doar pe cele pe care doriți să le implementăm.
Apoi găsiți numărul de instalare:
- Cont personal — Settings → Applications → Installed GitHub Apps, apoi Configure lângă aplicația Zinn®.
- Organizație — Your organizations → Settings → GitHub Apps, apoi Configure lângă aplicația Zinn®.
Numărul de la sfârșitul barei de adrese din pagina respectivă — de exemplu github.com/settings/installations/12345678 — este numărul de instalare.
2. Conectați-o aici
Aplicația este aleasă în locul în care este utilizată, nu în ecranul Integrări:
- La conexiunea de depozit a unui site, alegeți GitHub (app install).
- La linkul GitHub al unui panou de proiect, alegeți The Zinn® GitHub app.
Lipiți Installation number și continuați. Verificăm instalarea înainte de a salva ceva; un număr pe care nu îl putem accesa nu este stocat niciodată.
Ce urmează
- Depozitele pe care le-ați acordat aplicației apar pentru implementarea site-ului, iar o operațiune de push inițiază implementarea.
- Fiecare acțiune pe care o întreprindem apare în jurnalul de audit al instalării de pe GitHub sub numele aplicației, nu al dumneavoastră.
- Pentru a ne oferi acces la mai multe depozite, modificați permisiunile aplicației pe aceeași pagină Configure — nu este necesară o reconectare.
Dacă nu se conectează
Lipsește un depozit. Instalarea acoperă doar depozitele selectate. Deschideți Configure și adăugați-l.
Numărul este refuzat. Verificați dacă este numărul de instalare din bara de adrese, nu ID-ul propriu al aplicației, și asigurați-vă că aplicația este încă instalată — o aplicație dezinstalată nu are o instalare.
Apare un mesaj care indică respingerea cheii. 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ă ori regenerată după ce ați copiat-o. Creați una nouă și lipiți-o din nou.
Se conectează, dar o operațiune ulterioară eșuează. Cheia se autentifică, dar îi lipsește o permisiune necesară acțiunii. Creați o cheie nouă cu permisiunile menționate mai sus, apoi deconectați vechea conexiune și conectați noua cheie.
Deconectare
Deschideți Integrations, găsiți contul și apăsați Disconnect. Această acțiune șterge imediat cheia stocată. Orice element care o utiliza se oprește la următoarea sa acțiune, iar ecranele care depindeau de ea vor afișa acest lucru, în loc să eșueze silențios.
Deconectarea nu anulează ceea ce s-a realizat deja — î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 a fost compromisă, revocați-o și la furnizor; deconectarea elimină copia noastră, nu și pe a lor.