Install the Zinn® GitHub app so we can deploy without a long-lived token

Wat de koppeling voor u doet

Door de Zinn® GitHub app te installeren kan een website worden geïmplementeerd vanuit uw repositories, en blijft een projectboard synchroon met GitHub, zonder dat u ons een persoonlijk token hoeft te overhandigen. Wij bewaren enkel het installatienummer van de app, dat op zichzelf nutteloos is, en genereren een token dat een uur geldig is telkens wanneer wij er een nodig hebben. Dit 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 op de organisatie waar u de app wilt installeren. Organisaties die apps van derden verbieden, vereisen dat een eigenaar toestemming geeft; als dat niet mogelijk is, gebruikt u in plaats daarvan een fijnmazig token (Verbind uw GitHub-account).

1. Maak de sleutel aan op GitHub

Er hoeft geen sleutel te worden aangemaakt. Installeer de Zinn® GitHub app op uw persoonlijke account of uw organisatie, en kies ofwel alle repositories of alleen degene 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 getal aan het einde van de adresbalk op die pagina — bijvoorbeeld github.com/settings/installations/12345678 — is het installatienummer.

2. Koppel het hier

De app wordt gekozen op de plaats waar deze wordt gebruikt in plaats van op het scherm Integraties:

• Bij de repository-koppeling van een site, kiest u GitHub (app install).
• Bij de GitHub-koppeling van een projectboard, kiest u The Zinn® GitHub app.

Plak het Installation number en ga verder. Wij controleren de installatie voordat er iets wordt opgeslagen; een getal dat wij niet kunnen bereiken, wordt nooit opgeslagen.

Wat er hierna gebeurt

• De repositories waarvoor u de app toestemming hebt verleend, verschijnen zodat de site hiervandaan kan worden geïmplementeerd, en een push zorgt voor de implementatie.
• Elke actie die wij uitvoeren, verschijnt in het auditlogboek van de installatie op GitHub onder de naam van de app, niet die van u.
• Om ons meer repositories te geven, wijzigt u de repositorytoegang van de app op dezelfde Configure-pagina — er hoeft niets opnieuw te worden gekoppeld.

Als de koppeling mislukt

Een repository ontbreekt. De installatie omvat alleen de repositories die u hebt gekozen. Open Configure en voeg deze toe.

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

Er wordt gemeld dat de sleutel is geweigerd. Dit wordt bijna altijd veroorzaakt door een van de volgende drie zaken: een meegekopieerde spatie of regeleinde, een verlopen sleutel, of een sleutel die is ingetrokken of opnieuw is gegenereerd nadat u deze hebt gekopieerd. Maak een nieuwe aan en plak deze opnieuw.

De koppeling slaagt, maar er treedt later een fout op. De sleutel verifieert succesvol, maar mist een machtiging die de actie vereist. Maak een nieuwe sleutel aan met de hierboven vermelde machtigingen, verbreek vervolgens de oude koppeling en koppel de nieuwe sleutel.

Loskoppelen

Open Integraties, zoek het account op en klik op Disconnect. Hiermee wordt de opgeslagen sleutel direct verwijderd. Alles wat hiervan gebruik maakte, stopt bij de volgende actie, en de schermen die hiervhankelijk waren, geven dit duidelijk weer in plaats van stilletjes te falen.

Loskoppelen maakt niet ongedaan wat al is gedaan — records, implementaties of instellingen die wij op uw account hebben gewijzigd, blijven zoals ze zijn. Als u vermoedt dat de sleutel zelf is uitgelekt, trek deze dan ook in bij de leverancier; door los te koppelen wordt onze kopie verwijderd, niet die van hen.