Verbind uw GitHub account met een token zodat uw sites worden geïmplementeerd vanuit een repository

Wat de koppeling voor u doet

Door GitHub te koppelen met een token kan een site worden geïmplementeerd vanuit een van uw repositories: push naar de branch en de site wordt bijgewerkt. Hiermee kunnen we ook publiceren naar GitHub Pages op uw account wanneer u daarvoor kiest als de host van een site.

Als uw repositories tot een organisatie behoren, geef dan de voorkeur aan de Zinn® GitHub-app — zie Installeer de Zinn® GitHub-app. Een token hoort bij één persoon en werkt niet meer wanneer deze vertrekt.

Voordat u begint

Een GitHub-account met toegang tot de repositories die u wilt implementeren. Als deze behoren tot een organisatie, moet een eigenaar mogelijk fijnmazige tokens hiervoor goedkeuren.

1. Maak de sleutel aan op GitHub

Klik op GitHub op uw profielfoto en vervolgens op Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Geef het een naam en kies een vervaldatum. Kies onder Repository access voor Only select repositories en selecteer degene die u implementeert — de meest beperkte toegang die werkt.

Geef onder Repository permissions de machtiging Read and write voor:

• Contents
• Pages
• Administration

Druk op Generate token en kopieer deze — GitHub toont deze slechts eenmalig.

2. Koppel deze hier

Open Integrations in uw dashboard en kies Connect an account. Kies Code hosting als de groep en GitHub als het account, vul API token in en druk op Connect account.

We testen wat u plakt voordat er iets wordt opgeslagen. Een sleutel die niet werkt, wordt nooit opgeslagen en het antwoord geeft aan wat er mis mee was. Een sleutel die wel werkt, wordt versleuteld bewaard in onze geheimenkluis — nooit in onze database — en wordt nooit meer getoond, zelfs niet aan u.

Wat er hierna gebeurt

• Een site kan rechtstreeks worden geïmplementeerd vanuit een repository op dit account: kies deze in de

repository-koppeling van de site, selecteer de repository en branch, en een push zorgt voor de implementatie.

• Elke andere branch kan een eigen voorbeeldweergave krijgen, zodat u een wijziging kunt controleren voordat deze de

live site bereikt.

• Op Git gebouwde statische hosts zoals Render en Azure Static Web Apps gebruiken deze koppeling als de

bron van de code van de site.

Als de koppeling niet tot stand komt

Een repository verschijnt niet. De repository-toegang van het token omvat deze niet. Bewerk het token op GitHub en voeg de repository toe.

Het werkte en stopte toen. Fijnmazige tokens verlopen op de door u gekozen datum. Genereer een nieuwe en koppel deze; GitHub stuurt u een e-mail voordat een token verloopt.

Er wordt gezegd dat de sleutel is geweigerd. Vrijwel altijd een van drie dingen: een spatie of regelteken dat is meegekopieerd, een sleutel die is verlopen, 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 iets later treedt er een fout op. De sleutel wordt geverifieerd, maar mist een machtiging die de actie nodig heeft. Maak een nieuwe sleutel aan met de hierboven vermelde machtigingen, verbreek vervolgens de oude koppeling en koppel de nieuwe sleutel.

Loskoppelen

Open Integrations, zoek het account op en druk op Disconnect. Daardoor wordt de opgeslagen sleutel onmiddellijk verwijderd. Alles wat hiervan gebruik maakte, stopt bij de volgende actie, en de schermen die hiervan afhankelijk waren, geven dit aan in plaats van stilletjes te falen.

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 vermoedt dat de sleutel zelf is gelekt, trek deze dan ook in bij de leverancier; bij loskoppelen wordt ons exemplaar verwijderd, niet het hare.