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

Wat het koppelen voor u doet

Door GitHub met een token te koppelen, kan een site vanuit een van uw repositories worden geïmplementeerd: pusht u naar de branch, dan wordt de site bijgewerkt. Het stelt ons ook in staat om te publiceren naar GitHub Pages op uw account wanneer u dat kiest als host voor een site.

Als uw repositories toebehoren aan een organisatie, geef dan de voorkeur aan de Zinn® GitHub app — zie De Zinn® GitHub app installeren. Een token is eigendom van één persoon en stopt met werken wanneer deze vertrekt.

Voordat u begint

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

1. Maak de sleutel aan op GitHub

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

Geef onder Repository permissions Read and write voor:

• Contents
• Pages
• Administration

Klik op Generate token en kopieer deze — GitHub toont deze slechts één keer.

2. Koppel het hier

Open Integraties in uw dashboard en kies Een account koppelen. Kies Code hosting als groep en GitHub als account, vul het API-token in en druk op Account koppelen.

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 werkt, wordt versleuteld bewaard in onze geheimenkluis — nooit in onze database — en wordt nooit meer getoond, zelfs niet aan u.

Wat er nu gebeurt

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

repositorykoppeling van de site, selecteer de repository en branch, en een push implementeert direct.

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

live site bereikt.

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

bron van de code van de site.

Als het niet koppelt

Een repository verschijnt niet. De repositorytoegang van het token bevat deze niet. Bewerk het token op GitHub en voeg de repository toe.

Het werkte en stopte vervolgens. Fine-grained tokens verlopen op de datum die u hebt gekozen. Genereer een nieuwe en koppel deze; GitHub stuurt u een e-mail voordat een token verloopt.

Er staat dat de sleutel is geweigerd. Bijna altijd een van de drie dingen: een spatie of een regeleinde meegekopieerd, 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.

Het koppelt, maar later mislukt er iets. De sleutel verifieert wel, 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.

Ontkoppelen

Open Integraties, zoek het account en druk op Ontkoppelen. 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.

Ontkoppelen 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 mogelijk is gelekt, trek deze dan ook in bij de leverancier; ontkoppelen verwijdert onze kopie, niet die van hen.