Verbinden Sie Ihr GitHub-Konto mit einem Token, damit Ihre Websites über ein Repository bereitgestellt werden

Welche Vorteile Ihnen die Verknüpfung bringt

Durch das Verknüpfen von GitHub mittels eines Tokens kann eine Website direkt aus einem Ihrer Repositories bereitgestellt werden: Nach einem Push in den Branch wird die Website aktualisiert. Zudem können wir so auf GitHub Pages unter Ihrem Konto veröffentlichen, sofern Sie dies als Host für eine Website auswählen.

Falls Ihre Repositories zu einer Organisation gehören, verwenden Sie stattdessen vorzugsweise die Zinn® GitHub-App – siehe Zinn® GitHub-App installieren. Ein Token ist einer einzelnen Person zugeordnet und funktioniert nicht mehr, sobald diese Person die Organisation verlässt.

Bevor Sie beginnen

Ein GitHub-Konto mit Zugriff auf die Repositories, die Sie bereitstellen möchten. Falls diese zu einer Organisation gehören, muss ein Eigentümer möglicherweise feingranulare Tokens (Fine-grained tokens) dafür genehmigen.

1. Den Schlüssel bei GitHub erstellen

Klicken Sie auf GitHub auf Ihr Profilbild und wählen Sie dann Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Vergeben Sie einen Namen und wählen Sie ein Ablaufdatum. Wählen Sie unter Repository access die Option Only select repositories und wählen Sie genau die Repositories aus, die Sie bereitstellen möchten – die restriktivste Zugriffsberechtigung, die funktioniert.

Wählen Sie unter Repository permissions die Berechtigung Read and write für:

• Contents
• Pages
• Administration

Klicken Sie auf Generate token und kopieren Sie ihn – GitHub zeigt ihn nur ein einziges Mal an.

2. Hier verknüpfen

Öffnen Sie Integrations in Ihrem Dashboard und wählen Sie Connect an account. Wählen Sie Code hosting als Gruppe und GitHub als Konto, tragen Sie den API token ein und klicken Sie auf Connect account.

Wir überprüfen Ihre Eingabe, bevor etwas gespeichert wird. Ein Schlüssel, der nicht funktioniert, wird niemals gespeichert, und die Rückmeldung gibt an, was daran fehlerhaft war. Ein funktionierender Schlüssel wird verschlüsselt in unserem Secrets-Vault aufbewahrt – niemals in unserer Datenbank – und wird danach nie wieder angezeigt, auch Ihnen nicht.

Was als Nächstes geschieht

• Eine Website kann direkt aus einem Repository dieses Kontos bereitgestellt werden: Wählen Sie dieses bei der Repository-Verknüpfung der Website aus, wählen Sie Repository und Branch, und ein Push löst das Deployment aus.
• Jeder andere Branch kann eine eigene Vorschau erhalten, sodass Sie Änderungen prüfen können, bevor sie auf die Live-Website gelangen.
• Git-basierte statische Hosts wie Render und Azure Static Web Apps nutzen diese Verbindung als Quelle für den Quellcode der Website.

Falls keine Verbindung zustande kommt

Ein Repository wird nicht angezeigt. Der Repository-Zugriff des Tokens umfasst dieses Repository nicht. Bearbeiten Sie das Token auf GitHub und fügen Sie das Repository hinzu.

Es hat funktioniert und wurde dann unterbrochen. Feingranulare Tokens laufen am ausgewählten Datum ab. Erstellen Sie ein neues Token und verknüpfen Sie es; GitHub benachrichtigt Sie per E-Mail, bevor ein Token abläuft.

Die Meldung besagt, dass der Schlüssel abgelehnt wurde. Dies liegt fast immer an einem von drei Gründen: Ein Leerzeichen oder Zeilenumbruch wurde mitkopiert, der Schlüssel ist abgelaufen oder der Schlüssel wurde widerrufen bzw. neu generiert, nachdem Sie ihn kopiert haben. Erstellen Sie einen neuen Schlüssel und fügen Sie ihn erneut ein.

Die Verbindung klappt, aber später schlägt ein Vorgang fehl. Der Schlüssel authentifiziert sich zwar, verfügt jedoch nicht über eine Berechtigung, die für diese Aktion erforderlich ist. Erstellen Sie einen neuen Schlüssel mit den oben aufgeführten Berechtigungen, trennen Sie dann die alte Verbindung und verknüpfen Sie den neuen Schlüssel.

Verbindung trennen

Öffnen Sie Integrations, suchen Sie das Konto und klicken Sie auf Disconnect. Dadurch wird der gespeicherte Schlüssel umgehend gelöscht. Jeder Prozess, der ihn verwendet hat, stoppt bei der nächsten Aktion, und die davon abhängigen Ansichten weisen darauf hin, anstatt stillschweigend fehlzuschlagen.

Das Trennen der Verbindung macht bereits erfolgte Aktionen nicht rückgängig – Einträge, Deployments oder Einstellungen, die wir auf Ihrem Konto geändert haben, bleiben unverändert bestehen. Falls Sie befürchten, dass der Schlüssel selbst kompromittiert wurde, widerrufen Sie ihn zusätzlich beim Anbieter; durch das Trennen wird lediglich unsere Kopie entfernt, nicht deren.