Skip to main content

Gerenciando segredos do ambiente de desenvolvimento para seu repositório ou organização

Os segredos de ambiente de desenvolvimento permitem que você armazene informações confidenciais na sua organização ou no seu repositório para uso com o GitHub Codespaces.

Quem pode usar esse recurso?

To manage development environment secrets for GitHub Codespaces for an organization, you must be an organization owner.

Development environment secrets are available in all public repositories, in private repositories owned by personal accounts, and in private repositories owned by organizations on GitHub Team or GitHub Enterprise plans. For more information, see "Planos do GitHub."

Sobre segredos

Os segredos do ambiente de desenvolvimento são variáveis de ambiente criptografadas que você cria nas configurações do GitHub Codespaces para uma organização, um repositório ou uma conta pessoal. Este artigo explica como gerenciar segredos da organização e segredos do repositório. Para obter mais informações sobre como criar segredos específicos do usuário, confira "Gerenciando segredos específicos da sua conta para o GitHub Codespaces".

Os segredos do ambiente de desenvolvimento que você criou estão disponíveis para uso no GitHub Codespaces. O GitHub usa uma caixa lacrada libsodium para ajudar a garantir que os segredos sejam criptografados antes de chegarem ao GitHub e permaneçam criptografados até você os usar em um fluxo de trabalho.

Os segredos da organização permitem que você compartilhe segredos entre vários repositórios, o que reduz a necessidade de criar segredos duplicados. Você pode usar políticas de acesso para controlar quais repositórios podem usar segredos da organização.

Após criar um segredo, ele estará disponível quando você criar um novo código ou reiniciar o codespace. Se você criou um segredo no GitHub.com e deseja usá-lo em um codespace em execução no momento, interrompa o codespace e reinicie-o. Para obter informações sobre como interromper o codespace, confira "Uso da paleta de comandos do Visual Studio Code no GitHub Codespaces".

Nomeando segredos

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. Por exemplo, um segredo criado no nível do repositório deve ter um nome exclusivo nesse repositório, e um segredo criado no nível da organização deve ter um nome exclusivo nesse nível.

    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.

Limites para segredos

Você pode armazenar até 100 segredos por organização e 100 segredos por repositório.

Os segredos são limitados a 48 KB.

Seu projeto pode exigir segredos de usuário específicos. Por exemplo, para executar o aplicativo em um codespace, talvez o usuário precise fornecer uma chave de API pessoal. Se esse for o caso, você poderá especificar os segredos recomendados na configuração do contêiner de desenvolvimento. Em seguida, o usuário precisará fornecer valores para esses segredos, se ainda não tiver criado esses segredos pessoais, quando usar a página de opções avançadas para criar um codespace. Se o usuário fornecer um valor secreto para uso no codespace, esse segredo será adicionado às configurações pessoais do Codespaces. Ele não precisará inserir um valor para esse segredo quando criar um codespace para esse repositório no futuro. Para obter mais informações, confira "Como especificar segredos recomendados para um repositório".

Adicionar segredos para um repositório

Para criar segredos do ambiente de desenvolvimento para um repositório da organização, você deve ter acesso de administrador.

  1. No GitHub.com, navegue até a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja-escuro.

  3. Na seção "Segurança" da barra lateral, selecione Segredos e variáveis, then click Codespaces .

  4. Na parte superior da página, clique em Novo segredo do repositório.

  5. Digite um nome para o segredo na caixa de entrada Nome.

  6. Insira o valor para o seu segredo.

  7. Clique em Adicionar segredo.

Adicionar segredos para uma organização

Ao criar um segredo de ambiente de desenvolvimento em uma organização, você pode usar uma política para limitar quais repositórios podem acessar esse segredo. Por exemplo, você pode conceder acesso a todos os repositórios ou limitar o acesso a apenas repositórios privados ou a uma lista específica de repositórios.

Para criar segredos no nível da organização, você precisa ter acesso de admin.

  1. No GitHub.com, navegue até a página principal da organização.

  2. No nome da sua organização, clique Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  3. Na seção "Segurança" da barra lateral, selecione Segredos e variáveis, then click Codespaces .

  4. Na parte superior da página, clique em Novo segredo.

  5. Digite um nome para o segredo na caixa de entrada Nome.

  6. Insira o Valor do segredo.

  7. Na lista suspensa Acesso do repositório, escolha uma política de acesso.

  8. Clique em Adicionar segredo.

Rever o acesso para os segredos do nível da organização

Você pode verificar quais políticas de acesso são aplicadas a um segredo do ambiente de desenvolvimento na sua organização.

  1. No GitHub.com, navegue até a página principal da organização.

  2. No nome da sua organização, clique Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  3. Na seção "Segurança" da barra lateral, selecione Segredos e variáveis, then click Codespaces .

  4. A lista de segredos inclui quaisquer permissões e políticas configuradas. Por exemplo:

    Captura de tela mostrando uma lista com dois segredos. À direita de cada um está um botão editar e um botão excluir.

  5. Para obter mais detalhes sobre as permissões configuradas para cada segredo, clique em Atualizar.

Leitura adicional