Installeer de Zinn® GitHub-app zodat we kunnen implementeren zonder een langlevend token

Wat koppelen voor u doet

Door de Zinn® GitHub-app te installeren, kan een site vanuit uw repositories worden geïmplementeerd — en blijft een projectbord synchroon met GitHub — zonder dat u ons een persoonlijk token hoeft te overhandigen. We bewaren alleen het installatienummer van de app, dat op zichzelf nutteloos is, en genereren telkens wanneer we er een nodig hebben een token dat een uur geldig is. Het is de betere keuze voor een organisatie, omdat het niet aan één persoon toebehoort en niet stopt met werken wanneer iemand vertrekt.

Voordat u begint

Een GitHub-account, of eigenaarsrechten voor de organisatie waar u de app wilt installeren. Organisaties die apps van derden verbieden, hebben een eigenaar nodig om dit toe te staan; als dat niet mogelijk is, gebruik dan in plaats daarvan een 'fine-grained' token (Uw GitHub-account koppelen).

1. De sleutel aanmaken op GitHub

Er hoeft geen sleutel te worden aangemaakt. Installeer de Zinn® GitHub-app op uw persoonlijke account of uw organisatie, en kies alle repositories of alleen de repositories die u door ons wilt laten implementeren.

Zoek vervolgens het installatienummer op:

• Persoonlijk account — Settings → Applications → Installed GitHub Apps, en Configure naast de Zinn®-app.
• Organisatie — Your organizations → Settings → GitHub Apps, en Configure naast de Zinn®-app.

Het nummer aan het einde van de adresbalk op die pagina — bijvoorbeeld github.com/settings/installations/12345678 — is het installatienummer.

2. Hier koppelen

De app wordt gekozen waar deze wordt gebruikt, en niet op het scherm Integraties:

• Bij de repository-koppeling van een site, kies GitHub (app install).
• Bij de GitHub-koppeling van een projectbord, kies The Zinn® GitHub app.

Plak het Installatienummer en ga verder. We controleren de installatie voordat we iets opslaan; een nummer dat we niet kunnen bereiken, wordt nooit opgeslagen.

Wat er nu gebeurt

• De repositories waartoe u de app toegang hebt verleend, verschijnen zodat de site hieruit kan implementeren, en een push implementeert deze.
• Elke actie die we uitvoeren, verschijnt in het auditlogboek van de installatie op GitHub onder de naam van de app, niet die van u.
• Om ons toegang te geven tot meer repositories, wijzigt u de repositorytoegang van de app op dezelfde Configure-pagina — er hoeft niets opnieuw te worden gekoppeld.

Als er geen verbinding wordt gemaakt

Er ontbreekt een repository. De installatie dekt alleen de repositories die u hebt gekozen. Open Configure en voeg deze toe.

Het nummer wordt geweigerd. Controleer of het het installatienummer uit de adresbalk is, niet de eigen ID van de app, en of de app nog steeds is geïnstalleerd — een verwijderde app heeft geen installatie.

Er staat dat de sleutel is geweigerd. Bijna altijd een van deze drie zaken: een spatie of regeleinde die mee is gekopieerd, een sleutel die is verlopen, of een sleutel die is ingetrokken of opnieuw gegenereerd nadat u deze hebt gekopieerd. Maak een nieuwe aan en plak deze opnieuw.

Er is verbinding, maar later mislukt er iets. De sleutel verifieert wel, maar mist een machtiging die de actie nodig heeft. Maak een nieuwe sleutel aan met de hierboven vermelde machtigingen, verbreek vervolgens de oude verbinding en koppel de nieuwe sleutel.

Loskoppelen

Open Integraties, zoek het account en druk op Loskoppelen. Daarmee wordt de opgeslagen sleutel direct verwijderd. Alles wat er gebruik van maakte, stopt bij de volgende actie, en de schermen die ervan afhankelijk waren geven dit aan in plaats van geruisloos te mislukken.

Loskoppelen maakt niet ongedaan wat al is gedaan — records, implementaties of instellingen die we op uw account hebben gewijzigd, blijven zoals ze zijn. Als u denkt dat de sleutel zelf is gelekt, trek deze dan ook in bij de leverancier; loskoppelen verwijdert ons exemplaar, niet dat van hen.