LogoLogo
  • Git e GitHub para Humanos
  • Sumário
  • 1. Antes de Começar
    • 1.1 Este livro é para você?
    • 1.2 A razão por trás deste livro
    • 1.3 Visão geral
    • 1.4 Sobre o GitHub
    • 1.5 Sobre a Cumbuca Dev
    • 1.6 O maravilhoso mundo do open source
    • 1.7 Mapa do livro
    • 1.8 Glossário: capítulo 1
  • 2. Fundamentos de Controle de Versão e Git
    • 2.1 Introdução a sistemas de controle de versão
      • 2.1.1 Sistemas de controle de versão centralizados
      • 2.1.2 Sistemas de controle de versão distribuídos
    • 2.2 Introdução ao Git
    • 2.3 Conceitos Fundamentais do Git
      • 2.3.1 Repositório
      • 2.3.2 Commit
      • 2.3.3 Branch
      • 2.3.4 Merge
    • 2.4 Instalando o Git
      • 2.4.1 Instalando no Linux
      • 2.4.2 Instalando no macOS
      • 2.4.3 Instalando no Windows
    • 2.5 Interagindo com o Git
    • 2.6 O Comando Git
    • 2.7 Inicializando de um Repositório Local
    • 2.8 Configurando de um Repositório Local
    • 2.9 Links Úteis: Capítulo 2
    • 2.10 Glossário: Capítulo 2
  • 3. Operações Locais Básicas no Git
    • 3.1 Explorando Operações Locais do Git
    • 3.2 Salvando Alterações Localmente
      • 3.2.1 Adicionando Arquivos ao Controle de Versão via `git add`
      • 3.2.2 Verificando o Estado do Repositório via `git status`
      • 3.2.3 Criando Commits via `git commit`
      • 3.2.4 Visualizando o Histórico do Repositório via `git log`
      • 3.2.5 Comparando Alterações via `git diff`
      • 3.2.6 Unindo os Pontos
      • 3.2.7 Exemplo Prático
    • 3.3 Trabalhando com Branches Localmente
      • 3.3.1 Gerenciando Branches via `git branch`
      • 3.3.2 Alternando Entre Branches via `git switch`
      • 3.3.3 Mesclando Branches via `git merge`
        • 3.3.3.1 Resolvendo Conflitos de Merge
      • 3.3.4 Unindo os Pontos
      • 3.3.5 Exemplo Prático
    • 3.4 Links Úteis: Capítulo 3
    • 3.5 Glossário: Capítulo 3
  • 4. Ajuste de Mudanças Locais no Git
    • 4.1 Desfazendo Alterações Localmente
      • 4.1.1 Desfazendo Alterações Antes do Commit
      • 4.1.2 Desfazendo Commits
      • 4.1.3 Alterando o Último Commit via `git commit --amend`
      • 4.1.4 Unindo os Pontos
      • 4.1.5 Exemplos Práticos
    • 4.2 Ignorando e Removendo Arquivos do Rastreamento Local
      • 4.2.1 Ignorando Arquivos do Rastreamento Utilizando o arquivo .gitignore
      • 4.2.2 Removendo Arquivos do Rastreamento via `git rm`
    • 4.3 Links Úteis: Capítulo 4
    • 4.4 Glossário: Capítulo 4
  • 5. Introdução ao GitHub
    • 5.1 Qual a diferença entre Git e GitHub?
    • 5.2 Grandes Projetos Abertos no GitHub
    • 5.3 Recursos do GitHub
    • 5.4 Idioma Suportado no GitHub
    • 5.5 Contas no GitHub
      • 5.5.1 Conta Pessoal
      • 5.5.2 Conta de Organização
      • 5.5.3 Conta Corporativa
      • 5.5.4 Unindo os Pontos
    • 5.6 Planos do GitHub
    • 5.7 Criando uma Conta Pessoal no GitHub
    • 5.8 Explorando a Interface do GitHub
      • 5.8.1 Página Principal (Home)
      • 5.8.2 Página de Notificações (Notifications)
      • 5.8.3 Página de Configurações (Settings)
    • 5.9 Links Úteis: Capítulo 5
    • 5.10 Glossário: Capítulo 5
  • 6. Repositórios no GitHub
    • 6.1 O quê é um Repositório no GitHub?
    • 6.2 Criando um Repositório no GitHub
    • 6.3 Página Principal de um Repositório: Aba Code
      • 6.3.1 Editando um Arquivo em um Repositório no GitHub
      • 6.3.2 Explorando o Histórico de Commits de um Repositório no GitHub
      • 6.3.3 Editando Detalhes de um Repositório no GitHub
      • 6.3.4 Explorando um Repositório Ativo em Uso
    • 6.4 Página de Configurações de um Repositório: Aba Settings
      • 6.4.1 Gerenciando Configurações Gerais de um Repositório no GitHub: Menu General
      • 6.4.2 Gerenciando Configurações de Colaboração de um Repositório no GitHub: Menu Collaborators
      • 6.4.3 Explorando Configurações de um Repositório no GitHub na Prática
    • 6.5 Links Úteis: Capítulo 6
    • 6.6 Glossário: Capítulo 6
  • 7. Documentação de Projetos
    • 7.1 O quê é Documentação de Projeto?
    • 7.2 Explorando a Linguagem de Marcação Markdown
    • 7.3 Criando uma Página de Apresentação no GitHub
    • 7.4 Links Úteis: Capítulo 7
    • 7.5 Glossário: Capítulo 7
  • 8. Issues no GitHub
    • 8.1 O quê é GitHub Issues?
    • 8.2 Criando uma Issue no GitHub
    • 8.3 Explorando a Página de uma Issue no GitHub
    • 8.4 Atribuindo uma Issue no GitHub
    • 8.5 Categorizando Issues de um Repositório através de Labels no GitHub
      • 8.5.1 Gerenciando Labels de um Repositório no GitHub
    • 8.6 Página de Issues de um Repositório no GitHub: Aba Issues
    • 8.7 Explorando Issues no Mundo Real
    • 8.8 Links Úteis: Capítulo 8
    • 8.9 Glossário: Capítulo 8
  • 9. Git Remoto
    • 9.1 Explorando Operações Remotas do Git
    • 9.2 Interagindo com o Repositório Remoto Central no Git
      • 9.2.1 Clonando um Repositório Remoto via `git clone`
      • 9.2.2 Buscar Atualizações de um Repositório Remoto via `git fetch`
      • 9.2.3 Enviando Mudanças Locais para o Repositório Remoto via `git push`
      • 9.2.4 Sincronizando o Repositório Local com o Remoto via `git pull`
      • 9.2.5 Unindo os Pontos
      • 9.2.6 Exemplo
    • 9.3 Interagindo com o Repositório Remoto hello-world
      • 9.3.1 Conectando-se ao GitHub via SSH
      • 9.3.2 Clonando o Repositório hello-world
      • 9.3.3 Alterando hello-world Localmente
        • 9.3.3.1 Editor de Código
        • 9.3.3.2 Editando README.md
        • 9.3.3.3 Salvando Alterações no Controle de Versão Local
      • 9.3.4 Enviando Alterações para o Repositório Remoto
    • 9.4 Links Úteis: Capítulo 9
    • 9.5 Glossário: Capítulo 9
  • 10. Pull Requests no GitHub
    • 10.1 O quê é um Pull Requests no GitHub?
    • 10.2 Entendendo as Propriedades de um Pull Request no GitHub
      • 10.2.1 Branches de Origem e de Destino de um Pull Request
      • 10.2.2 Título de um Pull Request
      • 10.2.3 Descrição de um Pull Request
      • 10.2.4 Modificações de um Pull Request
      • 10.2.5 Pessoas Revisoras de um Pull Request
      • 10.2.6 Labels de um Pull Request
    • 10.3 Criando um Pull Request no GitHub
    • 10.4 Página de um Pull Request no GitHub
      • 10.4.1 Aba Conversation
      • 10.4.2 Aba Commits
      • 10.4.3 Aba Checks
      • 10.4.4 Aba Files Changed
    • 10.5 Página de Pull Requests de um Repositório no GitHub: Aba Pull Requests
    • 10.6 Recebendo Revisões em um Pull Request no GitHub
      • 10.6.1 Boas Práticas
      • 10.6.2 Exemplo Prático
        • 10.6.2.1 Adicionando Conta Colaboradora
        • 10.6.2.2 Solicitando Revisão de Pull Request
        • 10.6.2.3 Lidando com o Feedback
    • 10.7 Mesclando um Pull Request no GitHub
      • 10.7.1 Exemplo Prático
    • 10.8 Atualizando um Repositório Local Após Mesclagem
    • 10.9 Explorando Pull Requests no Mundo Real
    • 10.10 Links Úteis: Capítulo 10
    • 10.11 Glossário: Capítulo 10
  • 11. Fluxo de Trabalho
    • 11.1 Fork no GitHub
      • Fork
    • 11.2 Forks e Pull Requests
      • 11.2.1 Criando um Fork no GitHub
      • 11.2.2 Clonando um Fork
      • 11.2.3 Realizando Alterações Localmente
      • 11.2.4 Enviando Alterações Locais para o Fork Remoto
      • 11.2.5 Criando um Pull Request a partir de um Fork no GitHub
      • 11.2.6 Sincronizando um Fork no GitHub
      • 11.2.7 Revisão, Mesclagem e Atualizações Pós-mesclagem
    • 11.3 Fluxo de Trabalho
  • 11.4 Links Úteis - Capítulo 11
  • 11.5 Glossário - Capítulo 11
  • 12. O Caminho Continua
    • 12.1 Conhecendo Ferramentas Adicionais
      • 12.1.1 Indicação: Jogo Oh My Git
    • 12.2 Explorando Projetos Open Source
    • 12.3 Crescendo e Colaborando em Comunidades
    • 12.4 Desafio: GitCaos 🔥
    • 12.5 Links Úteis - Capítulo 12
    • 12.6 Glossário Completo: Git e GitHub para Humanos
Fornecido por GitBook
Nesta página
  • O que é uma conexão SSH?
  • O que são as chaves SSH?
  • Configurando uma conexão SSH com o GitHub
  • Gerando uma nova chave SSH e adicionando-a ao agente SSH
  • Adicionar uma nova chave SSH à sua conta do GitHub
  • Testar a conexão SSH

Isto foi útil?

Editar no GitHub
Exportar como PDF
  1. 9. Git Remoto
  2. 9.3 Interagindo com o Repositório Remoto hello-world

9.3.1 Conectando-se ao GitHub via SSH

Quando trabalhamos com o GitHub, muitas vezes precisamos provar que somos nós mesmos antes de realizar ações como enviar código ou clonar repositórios. Isso se chama autenticação. Em vez de digitar usuário e senha toda vez, podemos usar uma conexão SSH para facilitar esse processo.

O que é uma conexão SSH?

SSH (Secure Shell) é um sistema que permite a comunicação segura entre dois computadores. Imagine que é como um túnel protegido entre sua máquina e um servidor, garantindo que ninguém mais possa ver ou modificar os dados que estão sendo trocados.

No contexto do GitHub, uma conexão SSH permite que seu computador fale com o servidor do GitHub de forma segura, sem precisar digitar credenciais toda vez. Isso é feito através de um par de chaves.

O que são as chaves SSH?

As chaves SSH funcionam como o registro de um crachá de acesso digital para sua máquina. Pense em um prédio com segurança na entrada: para entrar sem precisar se identificar a cada vez, você recebe um crachá. Esse crachá tem duas partes:

  • Parte que fica com você (chave privada): Assim como um crachá físico que você carrega no bolso, a chave privada fica armazenada no seu computador e nunca deve ser compartilhada.

  • Parte registrada na portaria (chave pública): Para que você possa entrar no prédio sem problemas, seu crachá precisa estar registrado na recepção. No caso do GitHub, isso significa adicionar sua chave pública à sua conta.

Quando você tenta se conectar ao GitHub via SSH, ele verifica se a "portaria" (o GitHub) tem o registro da sua chave pública e se ela corresponde à chave privada que está com você. Se tudo estiver certo, você entra sem precisar digitar senha.

As chaves SSH são, na verdade, apenas arquivos de texto com um conteúdo aparentemente embaralhado. A chave privada geralmente fica salva no seu computador em um arquivo chamado id_rsa (ou similar), enquanto a chave pública fica em outro arquivo chamado id_rsa.pub. O conteúdo da chave pública começa com ssh-rsa e continua com uma longa sequência de caracteres aleatórios.

Configurando uma conexão SSH com o GitHub

Gerando uma nova chave SSH e adicionando-a ao agente SSH

A primeira parte para fazer a conexão com o GitHub é gerar o seu crachá (chave privada) e o seu registro que futuramente será adicionado à portaria (chave pública).

Além disso, é necessário adicionar a chave ao agente SSH, que é um programa que guarda sua chave privada em memória para que você não precise digitá-la toda vez que for se conectar ao GitHub. É como se fosse um chaveiro que mantém seu crachá sempre pronto para ser usado.

Para completar essas duas etapas, siga os passos da documentação oficial, se atentando para selecionar o sistema operacional correto.

Adicionar uma nova chave SSH à sua conta do GitHub

Agora iremos cadastrar o registro do crachá criado à portaria do GitHub.

Para isso, siga os passos da documentação oficial, se atentando para selecionar o sistema operacional correto.

Testar a conexão SSH

Agora é hora de verificar se seu crachá está funcionando e se você passa na portaria.

Para isso, siga os passos da documentação oficial, se atentando para selecionar o sistema operacional correto.


Agora que você configurou sua chave SSH e testou a conexão, seu ambiente está pronto para interagir com o GitHub de forma segura e prática. O próximo passo é clonar um repositório, e agora você pode fazer isso sem precisar digitar usuário e senha. Caso troque de máquina ou precise configurar outro dispositivo, basta repetir o processo para gerar uma nova chave e adicioná-la ao GitHub.

Anterior9.3 Interagindo com o Repositório Remoto hello-worldPróximo9.3.2 Clonando o Repositório hello-world

Atualizado há 3 meses

Isto foi útil?

Gerando uma nova chave SSH e adicionando-a ao agente SSH - GitHub DocsGitHub Docs
Adicionar uma nova chave SSH à sua conta do GitHub - GitHub DocsGitHub Docs
Testar a conexão SSH - GitHub DocsGitHub Docs
Logo
Logo
Logo