Skip to main content

About security overview

You can gain insights into the overall security landscape of your organization or enterprise and identify repositories that require intervention using security overview.

Who can use this feature?

Enterprises and their organizations

Security overview contains focused views where you can explore trends in detection, remediation, and prevention of security alerts and dig deep into the current state of your codebases.

  • Information about Dependabot features and alerts is shown for all repositories.
  • Information for GitHub Advanced Security features, such as code scanning and secret scanning, is shown for enterprises that use GitHub Advanced Security and for public repositories.

For more information, see About Dependabot alerts and About GitHub Advanced Security.

About the views

Note

All views show information and metrics for the default branches of the repositories you have permission to view in an organization or enterprise.

The views are interactive with filters that allow you to look at the aggregated data in detail and identify sources of high risk, see security trends, and see the impact of pull request analysis on blocking security vulnerabilities entering your code. As you apply multiple filters to focus on narrower areas of interest, all data and metrics across the view change to reflect your current selection. For more information, see Filtering alerts in security overview.

From security overview, you can download comma-separated values (CSV) files containing data from the "Overview", "Risk", "Coverage" and "CodeQL pull request alerts" pages of your organization or enterprise's security overview. These files can be used for efforts like security research and in-depth data analysis, and can integrate easily with external datasets. For more information, see Exporting data from security overview.

There are dedicated views for each type of security alert. You can limit your analysis to a specific type of alert, and then narrow the results further with a range of filters specific to each view. For example, in the secret scanning alert view, you can use the "Secret type" filter to view only secret scanning alerts for a specific secret, like a GitHub personal access token.

Note

Security overview displays active alerts raised by security features. If there are no alerts shown in security overview for a repository, undetected security vulnerabilities or code errors may still exist or the feature may not be enabled for that repository.

About security overview for organizations

The application security team at your company can use the different views for both broad and specific analyses of your organization's security status. For example, the team can use the "Overview" dashboard view to track your organization's security landscape and progression.

You can find security overview on the Security tab for any organization. Each view shows a summary of the data that you have access to. As you add filters, all data and metrics across the view change to reflect the repositories or alerts that you've selected. For information about permissions, see Permission to view data in security overview.

Security overview has multiple views that provide different ways to explore enablement and alert data.

You also create and manage security campaigns to remediate alerts from security overview, see Creating and tracking security campaigns and Best practices for fixing security alerts at scale.

About security overview for enterprises

You can find security overview on the Code Security tab for your enterprise. Each page displays aggregated and repository-specific security information for your enterprise.

As with security overview for organizations, security overview for enterprises has multiple views that provide different ways to explore data.

For information about permissions, see Permission to view data in security overview.

Permission to view data in security overview

Organization-level overview

If you are an owner or security manager for an organization, you can see data for all the repositories in the organization in all views.

If you are an organization or team member, you can view security overview for the organization and see data for repositories where you have an appropriate level of access.

Organization or team member withOverview dashboard viewRisk and alerts viewsCoverage view
admin access for one or more repositoriesView data for those repositoriesView data for those repositoriesView data for those repositories
write access for one or more repositoriesView code scanning and Dependabot data for those repositoriesView code scanning and Dependabot data for those repositoriesNo access
read or triage access for one or more repositoriesNo accessNo accessNo access
Security alert access for one or more repositoriesView all security alert data for those repositoriesView all security alert data for those repositoriesNo access
Custom organization role with permission to view one or more types of security alertView allowed alert data for all repositoriesView allowed alert data for all repositories in all viewsNo access

Note

To ensure a consistent and responsive experience, for organization members, the organization-level security overview pages will only display results from the most recently updated 3,000 repositories. If your results have been restricted, a notification will appear at the top of the page. Organization owners and security managers will see results from all repositories.

For more information about access to security alerts and related views, see Managing security and analysis settings for your repository and About custom repository roles.

Enterprise-level overview

Note

If you are an enterprise owner, you will need to join an organization as an organization owner to view data for the organization's repositories in both the organization-level and enterprise-level overview. 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. For more information, see Managing your role in an organization owned by your enterprise.

In the enterprise-level security overview, you can see data for all organizations where you are an organization owner or security manager. For more information, see Managing GitHub Advanced Security features for your enterprise.

If you're an owner of an enterprise with managed users, you can view data from user-owned repositories in security overview and filter by repository owner type. For more information on managed user accounts, see About Enterprise Managed Users.

Further reading