Skip to main content

Enterprise Server 3.20 is currently available as a release candidate.

Viewing and filtering alerts from secret scanning

Learn how to find and filter secret scanning alerts for your repository.

Who can use this feature?

Repository owners, organization owners, security managers, and users with the admin role

In this article

You can find and filter secret scanning through your repository's Security tab. To learn more about alerts and the different types you may encounter, see About secret scanning alerts.

Viewing alerts

Alerts for secret scanning are displayed under the Security tab of the repository.

  1. On GitHub, navigate to the main page of the repository.

  2. Under the repository name, click Security. If you cannot see the "Security" tab, select the dropdown menu, and then click Security.

    Screenshot of a repository header showing the tabs. The "Security" tab is highlighted by a dark orange outline.

  3. In the left sidebar, under "Vulnerability alerts", click Secret scanning.

  4. Optionally, toggle to "Generic" to see alerts for non-provider patterns.

  5. Under "Secret scanning", click the alert you want to view.

    Note

    Only people with admin permissions to the repository containing a leaked secret can view security alert details and token metadata for an alert. Enterprise owners can request temporary access to the repository for this purpose.

  6. Optionally, assign the alert to someone to fix using the Assignees control shown on the right, see Assigning alerts.

Filtering alerts

You can apply various filters to the alerts list to help you find the alerts you're interested in. You can use the dropdown menus above the alerts list, or input the qualifiers listed in the table into the search bar.

QualifierDescription
bypassedDisplay alerts for secrets where push protection has been bypassed (true). For more information, see About push protection.
isDisplay alerts that are open (open), closed (closed), found in a public repository (publicly-leaked), or found in more than one repository within the same organization or enterprise (multi-repository).
propsDisplay alerts for repositories with a specific custom property (CUSTOM_PROPERTY_NAME) set. For example, props:data_sensitivity:high display results for repositories with the data_sensitivity property set to the value high.
providerDisplay alerts for a specific provider (PROVIDER-NAME), for example, provider:github. For a list of supported partners, see Supported secret scanning patterns.
repoDisplay alerts detected in a specified repository (REPOSITORY-NAME), for example: repo:octo-repository.
resolutionDisplay alerts closed as "false positive" (false-positive), "hidden by config" (hidden-by-config), "pattern deleted" (pattern-deleted), "pattern edited" (pattern-edited), "revoked" (revoked), "used in tests" (used-in-tests), or "won't fix" (wont-fix).
resultsDisplay alerts for supported secrets and custom patterns (default), or non-provider patterns such as private keys (generic). See Supported secret scanning patterns.
secret-typeDisplay alerts for a specific secret type (SECRET-NAME), for example, secret-type:github_personal_access_token. For a list of supported secret types, see Supported secret scanning patterns.
sortDisplay alerts from newest to oldest (created-desc), oldest to newest (created-asc), most recently updated (updated-desc), or least recently updated (updated-asc).
teamDisplay alerts owned by members of the specified team, for example: team:octocat-dependabot-team.
topicDisplay alerts with the matching repository topic, for example: topic:asdf.
validityDisplay alerts for secrets with a specific validity (active, inactive, or unknown). For more information about validity statuses, see Evaluating alerts from secret scanning.

Next steps