Skip to main content

About secret scanning

GitHub scans repositories for known types of secrets, to prevent fraudulent use of secrets that were committed accidentally.

Secret scanning for partner patterns is automatically run on public repositories in all products on GitHub.com. Secret scanning for advanced security is available for repositories owned by organizations that use GitHub Enterprise Cloud and have a license for GitHub Advanced Security. Para más información, consulte "Acerca de GitHub Advanced Security".

About secret scanning

If your project communicates with an external service, you might use a token or private key for authentication. Tokens and private keys are examples of secrets that a service provider can issue. If you check a secret into a repository, anyone who has read access to the repository can use the secret to access the external service with your privileges. We recommend that you store secrets in a dedicated, secure location outside of the repository for your project.

Secret scanning will scan your entire Git history on all branches present in your GitHub repository for secrets.

Secret scanning is available on GitHub.com in two forms:

  1. Secret scanning for partner patterns. Runs automatically on all public repositories. Any strings that match patterns that were provided by secret scanning partners are reported directly to the relevant partner.

  2. Secret scanning for advanced security. Organizations using GitHub Enterprise Cloud with a license for GitHub Advanced Security can enable and configure additional scanning for repositories owned by the organization. Any strings that match patterns provided by secret scanning partners, by other service providers, or defined by your organization, are reported as alerts in the "Security" tab of repositories. If a string in a public repository matches a partner pattern, it is also reported to the partner. For more information, see the GitHub Enterprise Cloud documentation.

Service providers can partner with GitHub to provide their secret formats for scanning. Para obtener información sobre nuestro programa de partners, vea "Programa de partners de Secret scanning".

About secret scanning for partner patterns

When you make a repository public, or push changes to a public repository, GitHub always scans the code for secrets that match partner patterns. If secret scanning detects a potential secret, we notify the service provider who issued the secret. The service provider validates the string and then decides whether they should revoke the secret, issue a new secret, or contact you directly. Their action will depend on the associated risks to you or them. For more information, see "Supported secrets for partner patterns."

You cannot change the configuration of secret scanning on public repositories.

Nota: Las organizaciones que utilizan GitHub Enterprise Cloud con la GitHub Advanced Security pueden habilitar el secret scanning for advanced security en cualquier repositorio de su propiedad, incluidos los privados. Para obtener más información, vea la documentación de GitHub Enterprise Cloud.

Further reading