Installieren Sie die Zinn®-GitHub-App, damit wir ohne ein langlebiges Token bereitstellen können

Was Ihnen die Verbindung bringt

Durch die Installation der Zinn® GitHub-App kann eine Website aus Ihren Repositories bereitgestellt werden – und ein Projektboard bleibt mit GitHub synchronisiert –, ohne dass Sie uns ein persönliches Token übergeben müssen. Wir speichern lediglich die Installationsnummer der App, die für sich allein unbrauchbar ist, und erstellen jedes Mal, wenn wir eines benötigen, ein Token mit einer Gültigkeitsdauer von einer Stunde. Für eine Organisation ist dies die bessere Wahl, da sie keiner einzelnen Person gehört und nicht aufhört zu funktionieren, wenn jemand das Unternehmen verlässt.

Bevor Sie beginnen

Ein GitHub-Konto oder Inhaberrechte für die Organisation, in der Sie die App installieren möchten. Organisationen, die Drittanbieter-Apps untersagen, erfordern die Genehmigung durch einen Inhaber; falls dies nicht möglich ist, verwenden Sie stattdessen ein feingranulares Token (GitHub-Konto verbinden).

1. Den Schlüssel bei GitHub erstellen

Es muss kein Schlüssel erstellt werden. Installieren Sie die Zinn® GitHub-App in Ihrem persönlichen Konto oder Ihrer Organisation und wählen Sie entweder alle Repositories oder nur diejenigen aus, die wir bereitstellen sollen.

Ermitteln Sie anschließend die Installationsnummer:

• Persönliches Konto – Settings → Applications → Installed GitHub Apps und Configure neben der Zinn®-App.
• Organisation – Your organizations → Settings → GitHub Apps und Configure neben der Zinn®-App.

Die Nummer am Ende der Adressleiste auf dieser Seite – zum Beispiel github.com/settings/installations/12345678 – ist die Installationsnummer.

2. Hier verbinden

Die App wird dort ausgewählt, wo sie verwendet wird, und nicht auf dem Bildschirm „Integrationen“:

• Bei der Repository-Verbindung einer Website wählen Sie GitHub (App-Installation).
• Bei der GitHub-Verknüpfung eines Projektboards wählen Sie Die Zinn® GitHub-App.

Fügen Sie die Installationsnummer ein und fahren Sie fort. Wir überprüfen die Installation, bevor wir etwas speichern; eine Nummer, die wir nicht erreichen können, wird niemals gespeichert.

Was als Nächstes geschieht

• Die Repositories, für die Sie der App Zugriff gewährt haben, stehen der Website für die Bereitstellung zur Verfügung, und ein Push stellt sie bereit.
• Jede von uns durchgeführte Aktion wird im Audit-Protokoll der Installation auf GitHub unter dem Namen der App und nicht unter Ihrem Namen aufgeführt.
• Um uns Zugriff auf weitere Repositories zu gewähren, ändern Sie den Repository-Zugriff der App auf derselben Seite Configure – es muss nichts neu verbunden werden.

Wenn keine Verbindung hergestellt werden kann

Ein Repository fehlt. Die Installation umfasst nur die von Ihnen ausgewählten Repositories. Öffnen Sie Configure und fügen Sie es hinzu.

Die Nummer wird abgelehnt. Überprüfen Sie, ob es sich um die Installationsnummer aus der Adressleiste und nicht um die eigene ID der App handelt, und stellen Sie sicher, dass die App noch installiert ist – eine deinstallierte App besitzt keine Installation.

Es wird gemeldet, dass der Schlüssel abgelehnt wurde. Fast immer liegt es an einem von drei Gründen: Ein Leerzeichen oder ein Zeilenumbruch wurde mitkopiert, ein Schlüssel ist abgelaufen, oder ein 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 gelingt, aber später schlägt etwas fehl. Der Schlüssel authentifiziert sich, verfügt jedoch nicht über eine Berechtigung, die für die Aktion erforderlich ist. Erstellen Sie einen neuen Schlüssel mit den oben aufgeführten Berechtigungen, trennen Sie dann die alte Verbindung und verbinden Sie den neuen Schlüssel.

Verbindung trennen

Öffnen Sie Integrationen, suchen Sie das Konto und drücken Sie Trennen. Dadurch wird der gespeicherte Schlüssel sofort gelöscht. Alles, was ihn verwendet hat, stoppt bei der nächsten Aktion, und die Bildschirme, die davon abhingen, weisen darauf hin, anstatt stillschweigend fehlzuschlagen.

Das Trennen der Verbindung macht das, was bereits getan wurde, nicht rückgängig – Datensätze, Bereitstellungen oder Einstellungen, die wir in Ihrem Konto geändert haben, bleiben unverändert. Wenn Sie vermuten, dass der Schlüssel selbst kompromittiert wurde, widerrufen Sie ihn zusätzlich beim Anbieter; durch das Trennen der Verbindung wird unsere Kopie entfernt, nicht deren.