About secrets
Secrets are encrypted environment variables that you create in an organization or repository. The secrets that you create are available to use in GitHub Codespaces. GitHub uses a libsodium sealed box to encrypt secrets before they reach GitHub and only decrypts them when you use them in a codespace.
Organization-level secrets let you share secrets between multiple repositories, which reduces the need to create duplicate secrets. You can use access policies to control which repositories can use organization secrets.
Once you have created a secret, it will be available when you create a new codespace or restart the codespace. To use a secret that you've just created in a current codespace, you will need to stop the codespace and resume it. For information about stopping the codespace, see "Using the Visual Studio Code Command Palette in GitHub Codespaces."
Naming secrets
As regras a seguir aplicam-se aos nomes dos segredos:
-
Os nomes secretos só podem conter caracteres alfanuméricos (
[a-z],[A-Z],[0-9]) ou sublinhados (_). Espaços não são permitidos. -
Os nomes secretos não devem começar com o prefixo
GITHUB_. -
Os nomes dos segredos não devem começar com um número.
-
Nomes dos segredos não diferenciam maiúsculas de minúsculas.
-
Os nomes dos segredos devem ser únicos no nível em que são criados. For example, a secret created at the repository level must have a unique name in that repository, and a secret created at the organization level must have a unique name at that level.
Se houver um segredo com o mesmo nome em vários níveis, o segredo no nível mais baixo terá precedência. Por exemplo, se um segredo a nível de organização tiver o mesmo nome que um segredo a nível de repositório, o segredo a nível de repositório terá prioridade.
Limits for secrets
You can store up to 100 secrets per organization and 100 secrets per repository.
Secrets are limited to 64 KB in size.
Adding secrets for a repository
To create secrets for an organization repository, you must have administrator access.
-
No GitHub.com, navegue até a página principal do repositório.
-
Abaixo do nome do repositório, clique em Configurações.
-
In the "Security" section of the sidebar, select Secrets, then click Codespaces.
-
At the top of the page, click New repository secret.
-
Type a name for your secret in the Name input box.
-
Enter the value for your secret.
-
Click Add secret.
Adding secrets for an organization
When creating a secret in an organization, you can use a policy to limit which repositories can access that secret. For example, you can grant access to all repositories, or limit access to only private repositories or a specified list of repositories.
Para criar segredos no nível da organização, você precisa ter acesso de admin.
-
No GitHub.com, navegue até a página principal da organização.
-
No nome da sua organização, clique em Configurações.
-
In the "Security" section of the sidebar, select Secrets, then click Codespaces.
-
At the top of the page, click New organization secret.
-
Type a name for your secret in the Name input box.
-
Enter the Value for your secret.
-
From the Repository access dropdown list, choose an access policy.
-
Click Add secret.
Reviewing access to organization-level secrets
You can check which access policies are applied to a secret in your organization.
-
No GitHub.com, navegue até a página principal da organização.
-
No nome da sua organização, clique em Configurações.
-
In the "Security" section of the sidebar, select Secrets, then click Codespaces.
-
The list of secrets includes any configured permissions and policies. For example:
-
For more details on the configured permissions for each secret, click Update.