Filtern von Warnungen in der Sicherheitsübersicht

Informationen zum Filtern der Sicherheitsübersicht

Sie können in einer Sicherheitsübersicht Filter verwenden, um sich auf eine Reihe von Faktoren zu konzentrieren, z. B. auf die Warnungsrisikostufe, den Warnungstyp und die Featureaktivierung. Je nach Ansicht und abhängig davon, ob Sie die Daten auf Unternehmens- oder Organisationsebene betrachten, stehen unterschiedliche Filter zur Verfügung.

Die Informationen, die über die Sicherheitsübersicht angezeigt werden, variieren je nach Ihrem Zugriff auf Repositorys und Organisationen und je nachdem, ob GitHub Advanced Security von diesen Repositorys und Organisationen verwendet werden. Weitere Informationen findest du unter Informationen zur Sicherheitsübersicht.

Filterlogik für die Sicherheitsübersicht

Sie können Filter anwenden und logische Operatoren verwenden, um Ergebnisse anzuzeigen, die bestimmte Kriterien für die Sicherheitsübersicht erfüllen. Wenn Sie mehrere verschiedene Filter anwenden, kommt standardmäßig die AND-Logik zum Einsatz, was bedeutet, dass nur Ergebnisse angezeigt werden, die mit jedem von Ihnen angewendeten Filter übereinstimmen. Wenn Sie beispielsweise den Filter is:public dependabot:enabled hinzufügen, werden nur Ergebnisse aus Repositorys angezeigt, die öffentlich sind und für die Dependabot aktiviert sind.

Derzeit sind zwei logische Operatoren verfügbar, die Sie auf Ihre Filter zur Sicherheitsübersicht anwenden können:

Der Operator - verwendet NOT-Logik, wobei alle Ergebnisse angezeigt werden, mit Ausnahme derjenigen, die dem angegebenen Filter entsprechen. Um den Operator - zu verwenden, fügen Sie ihn am Anfang eines Filters hinzu. Beispielsweise werden beim Filtern nach -repo:REPOSITORY-NAME Daten aus allen Repositorys mit mit Ausnahme von REPOSITORY-NAME angezeigt.
Der Operator , wendet OR-Logik an und zeigt Ergebnisse an, die mit einem der angegebenen Werte für einen einzelnen Filter übereinstimmen. Um den Operator , zu verwenden, fügen Sie ihn zwischen jedem aufgelisteten Wert für einen Filter hinzu. Beispielsweise werden beim Filtern nach is:public,private Daten aus allen Repositorys angezeigt, die öffentlich oder privat sind. Wenn Sie denselben Filter mehrmals mit unterschiedlichen Werten anwenden, kommt die OR-Logik zum Einsatz. is:public is:private entspricht beispielsweise is:public,private.

Filtermethoden

Alle Sicherheitsansichten verfügen über Features, mit deren Hilfe Sie Filter definieren können. Sie bieten eine einfache Möglichkeit zur Einrichtung von Filtern und zum Verständnis der verfügbaren Optionen.

Interaktives Suchtextfeld. Wenn Sie im Suchfeld klicken und die LEERTASTE drücken, werden in einem Popup-Textfeld die in der jeweiligen Ansicht verfügbaren Filteroptionen angezeigt. Über die Maus oder die Pfeiltasten der Tastatur können Sie die gewünschten Optionen im Textfeld auswählen, bevor Sie die EINGABETASTE drücken, um den Filter hinzuzufügen. Wird für alle Ansichten unterstützt.
Optionen in Dropdownlisten und Umschaltflächen. Werden am Ende des Suchtextfelds oder in der Kopfzeile der Datentabelle angezeigt. Während Sie die anzuzeigenden Daten auswählen, werden die im Suchtextfeld angezeigten Filter entsprechend aktualisiert. Wird in den Warnungsansichten unterstützt.
Dialogfeld „Erweiterte Filter“. Wenn Sie auf die Schaltfläche Filter klicken, können Sie über die Dropdownlisten den „Qualifizierer“, den „Operator“ und die „Werte“ für die einzelnen Filter auswählen. Wird in der „Übersicht“ und in Metrikansichten unterstützt.

Filter für Repositoryname, Sichtbarkeit und Status

In allen Ansichten gibt es zwei Methoden zum Filtern von Ergebnissen nach Repositoryname.

Freitext- oder Schlüsselwortsuche. Zeigen Sie Daten für alle Repositorys mit einem Namen an, der das Schlüsselwort enthält. Suchen Sie beispielsweise nach test, um Daten für die Repositorys „test-repository“ und „octocat-testing“ anzuzeigen.
Qualifizierer repo. Zeigen Sie Daten ausschließlich für das Repository an, das exakt mit dem Wert des Qualifizierers übereinstimmt. Suchen Sie beispielsweise nach repo:octocat-testing, um Daten ausschließlich für das Repository „octocat-testing“ anzuzeigen.

Außerdem können Sie nach Repositorysichtbarkeit (intern, privat oder öffentlich) und Archivstatus filtern.

Qualifizierer	Beschreibung	Ansichten
`visibility`	Zeigen Sie Daten für alle Repositories an, die `public`, `private` oder `internal` sind.	"Übersicht" und Metriken
`is`	Zeigen Sie Daten für alle Repositories an, die `public`, `private` oder `internal` sind.	"Risiko" und "Abdeckung"
`archived`	Zeigen Sie nur Daten für archivierte (`true`) oder aktive (`false`) Repositories an.	Alle außer Ansichten vom Typ „Warnungen“

Filter für Team und Thema

Diese Qualifizierer sind in allen Ansichten verfügbar.

Qualifizierer	Beschreibung
`team`	Zeigen Sie Daten für alle Repositorys an, für die das angegebene Team über -Schreibzugriff oder -Admin-Zugriff verfügt. Weitere Informationen zu Repository-Rollen finden Sie unter „Repositoryrollen für eine Organisation“.
`topic`	Zeigen Sie Daten für alle Repositorys an, die mit einem bestimmten Thema klassifiziert sind. Weitere Informationen zu Repositorythemen finden Sie unter Dein Repository mit Themen klassifizieren.

Filter für benutzerdefinierte Repositoryeigenschaften

Hinweis: Repository-Eigenschaften befinden sich in beta und können geändert werden.

Benutzerdefinierte Repositoryeigenschaften sind Metadaten, die Organisationsbesitzer zu Repositorys in einer Organisation hinzufügen können. So lassen sich Repositorys nach den Informationen gruppieren, an denen Sie interessiert sind. Sie können z. B. benutzerdefinierte Repositoryeigenschaften für Compliance-Frameworks oder Datenvertraulichkeit hinzufügen. Weitere Informationen zum Hinzufügen benutzerdefinierter Repositoryeigenschaften finden Sie unter „Verwalten von benutzerdefinierten Eigenschaften für Repositorys in Ihrer Organisation“.

Wenn Sie Ihrer Organisation benutzerdefinierte Eigenschaften hinzufügen und Werte für Repositorys festlegen, können Sie die „Übersicht“ mithilfe dieser benutzerdefinierten Eigenschaften als Qualifizierer filtern. Diese Qualifizierer sind in den Ansichten auf Organisations- und auf Unternehmensebene verfügbar.

Qualifizierer props.CUSTOM_PROPERTY_NAME. Der Qualifizierer besteht aus einem props.-Präfix, gefolgt vom Namen der benutzerdefinierten Eigenschaft. props.data_sensitivity:high zum Beispiel zeigt Ergebnisse für Repositorys an, deren Eigenschaft data_sensitivity auf den Wert high eingestellt ist. |

Filter für Name und Typ des Repositorybesitzers

In Ansichten auf Unternehmensebene können Sie die Daten auf Repositorys einer einzelnen Organisation im Unternehmen filtern.

Qualifizierer	Beschreibung	Ansichten
`owner`	Zeigen Sie Daten für alle Repositorys eines einzelnen Kontobesitzers an.	Mehrzahl der Ansichten
`org`	Zeigen Sie Daten für Repositorys einer einzelnen Organisation an.	Warnungen Dependabot alerts und code scanning

Filter für Aktivierung von Sicherheitsfeatures

In den Ansichten „Risiko“ und „Abdeckung“ können Sie Daten ausschließlich für Repositorys anzeigen, in denen Sicherheitsfeatures aktiviert (enabled) oder deaktiviert (not-enabled) sind.

Qualifizierer	BESCHREIBUNG
`code-scanning-alerts`	Zeigt Repositorys an, für die die code scanning konfiguriert wurde.
`dependabot-alerts`	Zeigt Repositorys an, für die Dependabot alerts aktiviert wurden.
`secret-scanning-alerts`	Anzeigen von Repositorys, für die Warnungen zur Geheimnisüberprüfung aktiviert sind
`any-feature`	Zeigt Repositorys an, bei denen mindestens eine Sicherheitsfunktion aktiviert ist.

Zusätzliche Filter für die Ansicht „Abdeckung“

Qualifizierer	Beschreibung
`advanced-security`	Zeigen Sie Daten für Repositorys an, in denen GitHub Advanced Security aktiviert oder deaktiviert ist.
`code-scanning-default-setup`	Zeigen Sie Daten für Repositorys an, in denen code scanning mit dem Standard-Setup CodeQL aktiviert oder deaktiviert ist.
`code-scanning-pull-request-alerts`	Zeigen Sie Daten für Repositorys an, in denen code scanning zur Ausführung von Pull Requests aktiviert oder deaktiviert ist.
`dependabot-security-updates`	Zeigen Sie Daten für Repositorys an, in denen Dependabot security updates aktiviert oder deaktiviert ist.
`secret-scanning-push-protection`	Zeigen Sie Daten für Repositorys an, in denen der Push-Schutz für secret scanning aktiviert oder deaktiviert ist.

Filter für Anzahl von Warnungen

In der Ansicht „Risiko“ können Sie Repositorys nach der Anzahl vorliegender Warnungen eines bestimmten Typs filtern.

Qualifizierer	Beschreibung
`code-scanning-alerts`	Zeigen Sie Daten für Repositorys an, die eine genaue Anzahl (`=`) bzw. mehr (`>`) oder weniger als (`<`) eine bestimmte Anzahl von code scanning-Warnungen aufweisen. Beispiel: `code-scanning-alerts:>100` für Repositorys mit mehr als 100 Warnungen.
`dependabot-alerts`	Zeigen Sie Daten für Repositorys an, die eine bestimmte Anzahl (`=`) bzw. mehr (`>`) oder weniger als (`<`) eine bestimmte Anzahl von Dependabot alerts aufweisen. Beispiel: `dependabot-alerts:<=10` für Repositorys mit 10 Warnungen oder weniger.
`secret-scanning-alerts`	Zeigen Sie Daten für Repositorys an, die eine bestimmte Anzahl (`=`) bzw. mehr (`>`) oder weniger als (`<`) eine bestimmte Anzahl von Warnungen zur Geheimnisüberprüfung aufweisen. Beispiel: `secret-scanning-alerts:=10` für Repositorys mit genau 10 Warnungen.

Filter für Warnungstyp und -eigenschaft

Sie können die „Übersicht“ nach dem Typ und der Eigenschaft von Warnungen filtern. Mit dem Qualifizierer tool können Sie Daten ausschließlich für Warnungen anzeigen, die von einem bestimmten Tool oder Tooltyp generiert wurden.

tool:codeql zum Anzeigen von Daten ausschließlich für code scanning-Warnungen, die mit CodeQL generiert wurden.
tool:dependabot zum Anzeigen von Daten ausschließlich für Dependabot alerts.
tool:secret-scanning zum Anzeigen von Daten ausschließlich für Warnungen zur Geheimnisüberprüfung.
tool:github oder tool:third-party zum Anzeigen von Daten für alle Typen von Warnungen, die von GitHub-Tools oder von Tools von Drittanbietern generiert werden.
tool:TOOL-NAME zum Anzeigen von Daten für alle Warnungen, die vom Tool eines Drittanbieters für code scanning generiert wurden.

Außerdem können Sie die „Übersicht“ nach den Eigenschaften von Warnungen filtern.

Qualifizierer	Beschreibung
`codeql.rule`	Zeigen Sie Daten ausschließlich für code scanning an, die durch eine bestimmte Regel für CodeQL identifiziert wurden.
`dependabot.ecosystem`	Zeigen Sie Daten ausschließlich für Dependabot alerts für ein bestimmtes Ökosystem an, z. B.: `npm`.
`dependabot.package`	Zeigen Sie Daten ausschließlich für Dependabot alerts für ein bestimmtes Paket an, z. B.: `tensorflow`.
`dependabot.scope`	Zeigen Sie Daten ausschließlich für Dependabot alerts mit dem Bereich `runtime` oder `development` an.
`secret-scanning.bypassed`	Zeigen Sie Daten ausschließlich für Warnungen zur Geheimnisüberprüfung an, bei denen der Push-Schutz umgangen (`true`) oder nicht umgangen (`false`) wurde.
`secret-scanning.provider`	Zeigen Sie Daten ausschließlich für Warnungen zur Geheimnisüberprüfung an, die von einem bestimmten Anbieter ausgegeben wurden, z. B.: `secret-scanning.provider:adafruit`.
`secret-scanning.secret-type`	Zeigen Sie Daten ausschließlich für Warnungen zur Geheimnisüberprüfung für einen bestimmten Geheimnistyp an, z. B.: `secret-scanning.secret-type:adafruit_io_key`.
`secret-scanning.validity`	Zeigen Sie Daten ausschließlich für Warnungen zur Geheimnisüberprüfung für eine bestimmte Gültigkeit an (`active`, `inactive` oder `unknown`).
`severity`	Zeigen Sie Daten ausschließlich für Warnungen eines bestimmten Schweregrads an (`critical`, `high`, `medium` oder `low`).
`third-party.rule`	Zeigen Sie Daten ausschließlich für code scanning an, die von einer bestimmten Regel für ein von einem Drittanbieter entwickeltes Tool identifiziert wurden. `third-party.rule:CVE-2021-26291-maven-artifact` zum Beispiel zeigt nur Ergebnisse für die Regel `CVE-2021-26291-maven-artifact` des code scanning-Tools eines Drittanbieters an.

Ansichtsfilter für Dependabot-Warnungen

Sie können die Ansicht filtern, um Dependabot alerts anzuzeigen, die behoben werden können oder für die Informationen zur Offenlegung verfügbar sind. Sie können auf ein beliebiges Ergebnis klicken, um vollständige Details der Warnung anzuzeigen.

Qualifizierer	Beschreibung
`ecosystem`	Zeigen Sie Dependabot alerts an, die in einem angegebenen Ökosystem erkannt wurden, z. B.: `ecosystem:Maven`.
`has`	Zeigen Sie Dependabot für Sicherheitsrisiken an, bei denen entweder bereits eine sichere Version verfügbar ist (`patch`) oder bei denen mindestens ein Aufruf des Repositorys an eine anfällige Funktion erkannt wurde (`vulnerable-calls`). Weitere Informationen findest du unter Anzeigen und Aktualisieren von Dependabot-Warnungen.
`is`	Zeigen Sie Dependabot alerts an, die geöffnet (`open`) oder geschlossen (`closed`) sind.
`package`	Zeigen Sie Dependabot alerts an, die im angegebenen Paket erkannt wurden, z. B.: `package:semver`.
`resolution`	Zeigen Sie Dependabot alerts an, die als „automatisch geschlossen“ (`auto-dismissed`), „eine Behebung wurde bereits gestartet“ (`fix-started`), „behoben“ (`fixed`), „diese Warnung ist ungenau oder falsch“ (`inaccurate`), „keine Bandbreite zur Behebung dieses Problems“ (`no-bandwidth`), „anfälliger Code wird nicht wirklich verwendet“ (`not-used`) oder „Risiko ist für dieses Projekt erträglich“ (`tolerable-risk`) geschlossen wurden.
`scope`	Zeigen Sie Dependabot alerts aus der Entwicklungsabhängigkeit (`development`) oder aus der Runtime-Abhängigkeit (`runtime`) an.
`sort`	Gruppiert Dependabot alerts nach dem Pfad der Manifestdatei, auf den die Warnungen verweisen (`manifest-path`), oder nach dem Namen des Pakets, in dem die Warnung erkannt wurde (`package-name`). Zeigt alternativ Warnungen von der wichtigsten zur unwichtigsten an, wie durch die CVSS-Bewertung, die Folgen der Sicherheitsrisiken, die Relevanz und die Verwertbarkeit festgelegt (`most-important`), von der neuesten zur ältesten (`newest`), von der ältesten zur neuesten (`oldest`) oder von der schwerwiegendsten zur am wenigsten schwerwiegenden (`severity`).

Ansichtsfilter für Code scanning-Warnungen

Alle code scanning Warnungen weisen eine der unten aufgeführten Kategorien auf. Sie können auf ein beliebiges Ergebnis klicken, um alle Details zur entsprechenden Abfrage sowie die Codezeile anzuzeigen, die die Warnmeldung ausgelöst hat.

Qualifizierer	Beschreibung
`is`	Zeigen Sie code scanning an, die geöffnet (`open`) oder geschlossen (`closed`) sind.
`resolution`	Zeigen Sie code scanning-Warnungen an, die als „falsch positives Ergebnis“ (`false-postive`), „behoben“ (`fixed`), „in Tests verwendet“ (`used-in-tests`) oder „nicht behebbar“ (`wont-fix`) geschlossen wurden.
`rule`	Zeigen Sie code scanning-Warnungen an, die von der angegebenen Regel identifiziert wurden.
`severity`	Zeigen Sie code scanning-Warnungen an, die als Sicherheitswarnungen vom Typ `critical`, `high`, `medium` oder `low` kategorisiert sind. Zeigt alternativ code scanning-Warnungen an, die als Probleme vom Typ `error`, `warning` oder `note` kategorisiert sind.
`sort`	Zeigen Sie Warnungen von der neuesten zur ältesten an (`created-desc`), von der ältesten zur neuesten (`created-asc`), nach der jüngsten Aktualisierung (`updated-desc`) oder nach der am weitesten zurückliegenden Aktualisierung (`updated-asc`).
`tool`	Zeigen Sie code scanning-Warnungen an, die vom angegebenen Tool erkannt wurden, z. B. `tool:CodeQL` für Warnungen, die mithilfe der Anwendung CodeQL in GitHub erstellt wurden.

Ansichtsfilter für Secret scanning-Warnungen

Qualifizierer	Beschreibung
`bypassed`	Zeigen Sie Warnungen zur Geheimnisüberprüfung an, bei denen der Push-Schutz umgangen (`true`) oder nicht umgangen (`false`) wurde.
`confidence`	Zeigen Sie Warnungen zur Geheimnisüberprüfung von hoher (`high`) oder sonstiger (`other`) Konfidenz an.
`is`	Zeigen Sie Warnungen zur Geheimnisüberprüfung an, die geöffnet (`open`) oder geschlossen (`closed`) sind.
`provider`	Zeigen Sie Warnungen für alle Geheimnisse an, die von einem angegebenen Anbieter ausgegeben wurden, z. B.: `adafruit`.
`resolution`	Zeigen Sie Warnungen zur Geheimnisüberprüfung an, die als „falsch positives Ergebnis“ (`false-positive`), „Muster gelöscht“ (`pattern-deleted`), „Muster bearbeitet“ (`pattern-edited`), „widerrufen“ (`revoked`), „in Tests verwendet“ (`used-in-tests`) oder „nicht behebbar“ (`wont-fix`) geschlossen wurden.
`sort`	Zeigen Sie Warnungen von der neuesten zur ältesten an (`created-desc`), von der ältesten zur neuesten (`created-asc`), nach der jüngsten Aktualisierung (`updated-desc`) oder nach der am weitesten zurückliegenden Aktualisierung (`updated-asc`).
`secret-type`	Zeigen Sie Warnungen für das angegebene Geheimnis und den angegebenen Anbieter (`provider-pattern`) oder für ein benutzerdefiniertes Muster (`custom-pattern`) an.