Como gerenciar várias contas

Se você usar uma estação de trabalho para contribuir com projetos para mais de uma conta, poderá modificar sua configuração do Git para simplificar o processo de contribuição.

Platform navigation

Neste artigo

Contribuir com diversas contas usando HTTPS e o personal access tokens

Como alternativa, se você quiser usar o protocolo HTTPS para ambas as contas, pode usar personal access token diferentes para cada conta, configurando o Git para armazenar credenciais diferentes para cada repositório.

  1. Abra o terminal.

  2. Para confirmar o uso de um gerenciador de credenciais, insira o comando a seguir e anote a saída.

    Shell
    git config --get credential.helper

  3. Se a saída confirmar que você está usando um gerenciador de credenciais, desmarque as credenciais armazenadas para o gerenciador de credenciais.

  • Se a saída não incluir o nome de um gerenciador de credenciais, não haverá nenhum gerenciador de credenciais configurado e você poderá prosseguir para a próxima etapa.

    • Se a saída for osxkeychain, você estará usando o conjunto de chaves macOS. Para limpar as credenciais, você pode usar o auxiliar de credenciais na linha de comando:

      $ git credential-osxkeychain erase
host=github.com
protocol=https
> [Press Return]
>

    • Se a saída for manager (ou manager-core nas versões anteriores) você está usando o Gerenciador de Credenciais do Git. Para limpar as credenciais, execute o comando a seguir.

      Shell
      echo "protocol=https\nhost=github.com" | git credential-manager erase

  1. Para configurar o Git a fim de armazenar credenciais em cache para a URL completa do repositório remoto de cada repositório que você acessar no GitHub, insira o comando a seguir.

    Shell
    git config --global credential.https://github.com.useHttpPath true

  2. Para cada conta, crie um personal access token (classic) dedicado com o escopo repo. Ou, para cada uma das contas e para cada organização da qual você é membro, crie um fine-grained personal access token que possa acessar os repositórios desejados e que tenha permissões de leitura e gravação no conteúdo do repositório. Para saber mais, confira Gerenciar seus tokens de acesso pessoal.

  3. Na primeira vez que você usar o Git para clonar um repositório ou acessar dados em um repositório que você já clonou, o Git solicitará credenciais. Forneça ao personal access token da conta acesso ao repositório.

    O Git armazenará em cache o personal access token baseado na URL completa do repositório remoto, e você poderá acessar e gravar dados do repositório no GitHub.com usando a conta correta.

  1. Abra o Git Bash.

  2. Para confirmar o uso de um gerenciador de credenciais, insira o comando a seguir e anote a saída.

    Shell
    git config --get credential.helper

  3. Se a saída confirmar que você está usando um gerenciador de credenciais, desmarque as credenciais armazenadas para o gerenciador de credenciais.

  • Se a saída não incluir o nome de um gerenciador de credenciais, não haverá nenhum gerenciador de credenciais configurado e você poderá prosseguir para a próxima etapa.

  • Se a saída for manager (ou manager-core nas versões anteriores) você está usando o Gerenciador de Credenciais do Git. Para limpar as credenciais, execute o comando a seguir.

    Shell
    echo "protocol=https`nhost=github.com" | git credential-manager erase

    • Se a saída for wincred, você estará usando o Gerenciador de Credenciais Windows. Para limpar as credenciais, insira o comando a seguir.

      Shell
      cmdkey /delete:LegacyGeneric:target=git:https://github.com

  1. Para configurar o Git a fim de armazenar credenciais em cache para a URL completa do repositório remoto de cada repositório que você acessar no GitHub, insira o comando a seguir.

    Shell
    git config --global credential.https://github.com.useHttpPath true

  2. Para cada conta, crie um personal access token (classic) dedicado com o escopo repo. Ou, para cada uma das contas e para cada organização da qual você é membro, crie um fine-grained personal access token que possa acessar os repositórios desejados e que tenha permissões de leitura e gravação no conteúdo do repositório. Para saber mais, confira Gerenciar seus tokens de acesso pessoal.

  3. Na primeira vez que você usar o Git para clonar um repositório ou acessar dados em um repositório que você já clonou, o Git solicitará credenciais. Forneça ao personal access token da conta acesso ao repositório.

    O Git armazenará em cache o personal access token baseado na URL completa do repositório remoto, e você poderá acessar e gravar dados do repositório no GitHub.com usando a conta correta.

  1. Abra o terminal.

  2. Para confirmar o uso de um gerenciador de credenciais, insira o comando a seguir e anote a saída.

    Shell
    git config --get credential.helper

  3. Se a saída confirmar que você está usando um gerenciador de credenciais, desmarque as credenciais armazenadas para o gerenciador de credenciais.

  • Se a saída não incluir o nome de um gerenciador de credenciais, não haverá nenhum gerenciador de credenciais configurado e você poderá prosseguir para a próxima etapa.

  • Se a saída for manager (ou manager-core nas versões anteriores) você está usando o Gerenciador de Credenciais do Git. Para limpar as credenciais, execute o comando a seguir.

    Shell
    echo "protocol=https\nhost=github.com" | git credential-manager erase

  1. Para configurar o Git a fim de armazenar credenciais em cache para a URL completa do repositório remoto de cada repositório que você acessar no GitHub, insira o comando a seguir.

    Shell
    git config --global credential.https://github.com.useHttpPath true

  2. Para cada conta, crie um personal access token (classic) dedicado com o escopo repo. Ou, para cada uma das contas e para cada organização da qual você é membro, crie um fine-grained personal access token que possa acessar os repositórios desejados e que tenha permissões de leitura e gravação no conteúdo do repositório. Para saber mais, confira Gerenciar seus tokens de acesso pessoal.

  3. Na primeira vez que você usar o Git para clonar um repositório ou acessar dados em um repositório que você já clonou, o Git solicitará credenciais. Forneça ao personal access token da conta acesso ao repositório.

    O Git armazenará em cache o personal access token baseado na URL completa do repositório remoto, e você poderá acessar e gravar dados do repositório no GitHub.com usando a conta correta.

Contribuindo para várias contas usando SSH e GIT_SSH_COMMAND

Se você quiser usar o protocolo SSH para ambas as contas, poderá usar chaves SSH diferentes em cada conta. Para saber mais sobre como usar o SSH, confira Conectando-se ao GitHub com o SSH.

Para usar uma chave SSH diferente para repositórios diferentes que você clona em sua estação de trabalho, você deve escrever uma função de wrapper de shell para operações do Git. A função deve executar as etapas a seguir.

  1. Determine o nome completo do repositório com o proprietário, usando um comando como git config --get remote.origin.url.
  2. Escolha a chave SSH correta para autenticação.
  3. Modifique GIT_SSH_COMMAND adequadamente. Para obter mais informações sobre GIT_SSH_COMMAND, confira Variáveis de ambiente na documentação do Git.

Por exemplo, o comando a seguir define a variável de ambiente GIT_SSH_COMMAND para especificar um comando SSH que usa o arquivo de chave privada em PATH/TO/KEY/FILE para autenticação a fim de clonar o repositório OWNER/REPOSITORY no GitHub.com.

Shell
GIT_SSH_COMMAND='ssh -i PATH/TO/KEY/FILE -o IdentitiesOnly=yes' git clone git@github.com:OWNER/REPOSITORY

Contribuindo para várias contas usando SSH e várias chaves

Se você for membro de uma empresa com usuários gerenciados, mas também quiser colaborar fora da sua empresa usando uma conta pessoal, você pode usar chaves SSH diferentes para cada conta. Para saber mais sobre como usar o SSH, confira Conectando-se ao GitHub com o SSH.

Aviso

Não é possível usar a mesma chave SSH para contribuir para ambos os repositórios dentro da sua organização com usuários gerenciados e fora da empresa.

  1. Gere uma chave SSH diferente para os repositórios na sua organização com usuários gerenciados. Confira Gerando uma nova chave SSH e adicionando-a ao agente SSH. Ao salvar a chave, dê a ela um nome de arquivo diferente da chave existente (por exemplo, adicione -emu ao nome sugerido do arquivo).

  2. Adicione a nova chave SSH ao seu conta de usuário gerenciada. Confira Adicionando uma nova chave SSH à sua conta de GitHub

  3. Configure o arquivo ~/.ssh/config de configuração SSH para usar as chaves diferentes. Por exemplo, se sua chave SSH pessoal for ~/.ssh/id_ed25519 e a chave SSH da empresa com usuários gerenciados for ~/.ssh/id_ed25519-emu

    Text
    Host github.com
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

Host github-emu.com
    Hostname github.com
    IdentityFile ~/.ssh/id_ed25519-emu
    IdentitiesOnly yes

    Observação

    A IdentitiesOnly linha garante que, se o ssh-agent tiver carregado várias chaves, o ssh usará a chave correta ao se conectar.

  4. Teste sua configuração de SSH executando o comando a seguir para se conectar usando a chave SSH associada à sua conta pessoal - consulte Testar a conexão SSH para obter mais detalhes

    Shell
    ssh -T git@github.com

    Teste se você consegue se conectar ao (GitHub) usando a sua chave SSH empresa com usuários gerenciados

    Shell
    ssh -T git@github-emu.com

  5. Indique git para utilizar a chave correta ao descarregar ou carregar um repositório em um organização com usuários gerenciados. Para listar as organizações em seu empresa com usuários gerenciados, 1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

    1. Para cada organização listada, diga git para usar o github-emu.com host.

    Por exemplo, se uma de suas organizações for chamada octocat-emu, para informar ao git que use o host github-emu.com para repositórios na organização octocat-emu, execute o comando a seguir.

    Shell
    git config --global url."git@github-emu.com:octocat-emu/".insteadOf "git@github.com:octocat-emu/"

Agora, ao clonar um repositório usando SSH, na organização octocat-emu, git usará a chave SSH associada ao seu empresa com usuários gerenciados em vez de sua chave pessoal.

Próximas etapas

Para obter informações de referência, confira Referência de conta pessoal.