Verwalten von Warnungen aus der Geheimnisüberprüfung

Verwalten von Warnungen zur Geheimnisüberprüfung

1. Navigiere auf GitHub.com zur Hauptseite des Repositorys.

2. Wähle unter dem Repositorynamen die Option Sicherheit aus. Wenn die Registerkarte „Sicherheit“ nicht angezeigt wird, wähle im Dropdownmenü die Option Sicherheit aus.

3. Klicke auf der linken Randleiste unter „Sicherheitsrisikowarnungen“ auf Secret scanning .

4. Klicke unter „Secret scanning“ auf die Warnung, die du anzeigen möchtest.

5. Wenn es sich bei dem kompromittierten Geheimnis um ein GitHub-Token handelt, überprüfe optional die Gültigkeit des Geheimnisses, und führe die Korrekturschritte aus. Wenn das GitHub-Token derzeit aktiv ist, kannst du auch die Tokenmetadaten überprüfen. Weitere Informationen zum Überprüfen von Tokenmetadaten findest du unter Überprüfen von GitHub-Tokenmetadaten.

   

   Note: Die Gültigkeitsüberprüfung für GitHub-Token befindet sich derzeit in der öffentlichen Betaversion und kann noch geändert werden.

   GitHub stellt nur für GitHub-Token Informationen zur Gültigkeit des Geheimnisses bereit.

   Gültigkeitsdauer	Ergebnis
   Aktives Geheimnis	GitHub hat bestätigt, dass dieses Geheimnis aktiv ist.
   Aktives Geheimnis	GitHub hat beim Anbieter dieses Geheimnisses nachgefragt und ermittelt, dass dieses Geheimnis aktiv ist.
   Möglicherweise aktives Geheimnis	GitHub bietet noch keine Gültigkeitsüberprüfungen für diesen Tokentyp.
   Möglicherweise aktives Geheimnis	GitHub konnte dieses Geheimnis nicht überprüfen.
   Geheimnis wird als inaktiv angezeigt	Du solltest sicherstellen, dass noch kein unautorisierter Zugriff erfolgt ist.

6. Um eine Warnung zu schließen, wähle das Dropdownmenü „Schließen als“ aus, und klicke auf einen Grund zum Beheben einer Warnung.

   

7. Füge optional im Feld „Kommentar“ einen Kommentar zum Schließen der Warnung hinzu. Der Kommentar zum Schließen wird der Zeitleiste der Warnung hinzugefügt und kann bei Prüfungen und Berichterstellungen als Begründung verwendet werden. Du kannst den Verlauf aller geschlossenen Warnungen und zugehörigen Kommentare in der Zeitachse der Warnungen einsehen. Du kannst auch mithilfe der Secret scanning-API einen Kommentar abrufen oder festlegen. Der Kommentar ist im Feld resolution_comment enthalten. Weitere Informationen findest du in der REST-API-Dokumentation unter Geheime Überprüfung.

8. Klicke auf Warnung schließen.

Überprüfen von GitHub-Tokenmetadaten

In der Ansicht für eine aktive GitHub-Tokenwarnung kannst du bestimmte Metadaten zum Token überprüfen. Diese Metadaten können dir helfen, das Token zu identifizieren und zu entscheiden, welche Korrekturschritte ausgeführt werden sollen. Weitere Informationen zum Anzeigen einzelner Warnungen findest du unter Verwalten von Warnungen aus der secret scanning.

Token wie personal access token und andere Anmeldeinformationen werden als personenbezogene Daten betrachtet. Weitere Informationen zur Verwendung von GitHub-Token findest du unter GitHub-Datenschutzerklärung und Richtlinien zur akzeptablen Nutzung von GitHub.

Metadaten für GitHub-Token sind für aktive Token in jedem Repository mit aktivierter Geheimnisüberprüfung verfügbar. Wenn ein Token widerrufen wurde oder sein Status nicht überprüft werden kann, sind keine Metadaten verfügbar. GitHub widerruft GitHub-Token in öffentlichen Repositorys automatisch. Daher ist es unwahrscheinlich, dass Metadaten für GitHub-Token in öffentlichen Repositorys verfügbar sind. Die folgenden Metadaten sind für aktive GitHub-Token verfügbar:

Metadaten	Beschreibung
Geheimnisname	Der Name, der dem GitHub-Token vom Ersteller/der Erstellerin zugewiesen wurde
Geheimnisbesitzer*in	Das GitHub-Handle des Tokenbesitzers/der Tokenbesitzerin
Erstellt am	Erstellungsdatum des Tokens
Abgelaufen am	Ablaufdatum des Tokens
Zuletzt verwendet am	Datum der letzten Verwendung des Tokens
Access	Gibt an, ob das Token über Organisationszugriff verfügt

Kompromittierte Geheimnisse sichern

Sobald ein Geheimnis an ein Repository übergeben wurde, solltest du das Geheimnis als kompromittiert betrachten. GitHub empfiehlt die folgenden Aktionen für kompromittierte Geheimnisse:

• Lösche bei einem kompromittierten persönlichen Zugriffstoken für GitHub personal access token das kompromittierte Token, erstelle ein neues Token und aktualisiere alle Dienste, die das alte Token verwenden. Weitere Informationen findest du unter Verwalten deiner persönlichen Zugriffstoken.
  • Wenn sich deine Organisation im Besitz eines Unternehmenskontos befindet, identifiziere alle Aktionen, die durch das kompromittierte Token für die Ressourcen deines Unternehmens ausgeführt wurden. Weitere Informationen findest du unter Identifizieren von Überwachungsprotokollereignissen, die von einem Zugriffstoken ausgeführt werden.
• Für alle anderen Geheimnisse überprüfe zuerst, dass das per Commit an GitHub Enterprise Cloud übergebene Geheimnis gültig ist. Wenn dies der Fall ist, erstelle ein neues Geheimnis, aktualisiere alle Dienste, die das alte Geheimnis verwenden, und lösche dann das alte Geheimnis.

Konfigurieren von Benachrichtigungen für Warnungen zur Geheimnisüberprüfung

Benachrichtigungen unterscheiden sich für inkrementelle Überprüfungen und verlaufsbezogene Überprüfungen.

Inkrementelle Überprüfung

Wenn ein neues Geheimnis erkannt wird, benachrichtigt GitHub Enterprise Cloud alle Benutzer mit Zugriff auf Sicherheitswarnungen für das Repository entsprechend ihren Benachrichtigungseinstellungen. Zu diesen Benutzer gehören Folgenden:

• Repositoryadministratoren
• Sicherheitsmanager
• Benutzer*innen mit benutzerdefinierten Rollen mit Lese-/Schreibzugriff
• Organisationsbesitzerinnen und Unternehmensbesitzerinnen, wenn sie Administrator*innen von Repositorys sind, in denen Geheimnisse geleakt wurden

Du erhältst in folgenden Fällen eine E-Mail-Benachrichtigung:

• Du überwachst das Repository.
• Du hast Benachrichtigungen für „Jede Aktivität“ oder für benutzerdefinierte „Sicherheitswarnungen“ für das Repository aktiviert.
• Du hast in deinen Benachrichtigungseinstellungen unter „Abonnements“ und dann unter „Überwachung“ ausgewählt, dass du Benachrichtigungen per E-Mail erhalten möchtest.

1. Navigiere auf GitHub.com zur Hauptseite des Repositorys.

2. Um mit der Überwachung des Repositorys zu beginnen, wähle Überwachen aus.

   

3. Klicke im Dropdownmenü auf Jede Aktivität. Um nur Sicherheitswarnungen zu abonnieren, klicke alternativ auf Benutzerdefiniert und dann auf Sicherheitswarnungen.

4. Navigiere zu den Benachrichtigungseinstellungen für dein persönliches Konto. Diese sind unter https://github.com/settings/notifications verfügbar.

5. Wähle auf der Seite mit den Benachrichtigungseinstellungen unter „Abonnements“ und dann unter „Beobachten“ die Dropdownliste Mich benachrichtigen aus.

6. Wähle „E-Mail“ als Benachrichtigungsoption aus, und klicke dann auf Speichern.

   

Weitere Informationen zum Einrichten der Benachrichtigungseinstellungen findest du unter Verwalten von Sicherheits- und Analyseeinstellungen für dein Repository und unter Konfigurieren von Überwachungseinstellungen für ein einzelnes Repository.

Verlaufsbezogene Überprüfungen

Bei verlaufsbezogenen Überprüfungen benachrichtigt GitHub Enterprise Cloud die folgenden Benutzer*innen:

• Organisationsbesitzerinnen, Unternehmensbesitzerinnen und Sicherheitsmanager – immer dann, wenn eine verlaufsbezogene Überprüfen abgeschlossen ist, auch wenn keine Geheimnisse gefunden werden
• Repositoryadministratorinnen, Sicherheitsmanager und Benutzerinnen mit benutzerdefinierten Rollen mit Lese-/Schreibzugriff – immer dann, wenn bei einer verlaufsbezogenen Überprüfung ein Geheimnis erkannt wird, und entsprechend ihren Benachrichtigungseinstellungen

Commitautoren werden nicht benachrichtigt.

Weitere Informationen zum Einrichten der Benachrichtigungseinstellungen findest du unter Verwalten von Sicherheits- und Analyseeinstellungen für dein Repository und unter Konfigurieren von Überwachungseinstellungen für ein einzelnes Repository.

Überwachungsantworten auf Warnungen zur Geheimnisüberprüfung

Du kannst die Aktionen, die als Reaktion auf secret scanning-Warnungen ergriffen wurden, mit GitHub-Tools überprüfen. Weitere Informationen findest du unter Prüfen von Sicherheitswarnungen.