Criar Chave SSH ou Token Bitbucket

Este guia descreve o processo para configurar a autenticação no Bitbucket, incluindo a criação de chaves SSH para autenticação segura ou a configuração do Git Credential Manager para guardar seu token de autenticação.

Autenticação no Bitbucket

Existem duas formas principais de autenticar no Bitbucket: chaves SSH e Git Credential Manager.

1. Chaves SSH

As chaves SSH permitem autenticar sem precisar digitar sua senha a cada vez.

1.1. Verificação de Chaves Existentes

Verifique se você já possui chaves SSH existentes:

ls -al ~/.ssh

Se você vir arquivos como id_rsa e id_rsa.pub, você já tem chaves SSH. Caso contrário, siga para o próximo passo.

1.2. Geração de Chaves SSH

Gere uma nova chave SSH com o seguinte comando:

ssh-keygen -t rsa -b 4096 -C "seu_email@exemplo.com"

Substitua seu_email@exemplo.com pelo seu endereço de e-mail. Pressione Enter para aceitar o local padrão para salvar a chave (geralmente ~/.ssh/id_rsa). Defina uma passphrase (senha) para sua chave SSH, ou deixe em branco para não usar uma passphrase.

1.3. Adição da Chave ao Bitbucket

Copiar a Chave Pública:
- No Windows: clip < ~/.ssh/id_rsa.pub
- No macOS: pbcopy < ~/.ssh/id_rsa.pub
- No Linux: cat ~/.ssh/id_rsa.pub e copie manualmente
Adicionar a Chave ao Bitbucket:
- Acesse o Bitbucket e faça login
- Clique no seu avatar no canto superior direito
- Selecione "Settings" (Configurações)
- No menu lateral, clique em "SSH keys" (Chaves SSH)
- Clique em "Add key" (Adicionar chave)
- Cole a chave pública no campo "Key" (Chave)
- Dê um nome descritivo à chave (ex: "Laptop Trabalho")
- Clique em "Add key" (Adicionar chave)

1.4. Teste da Conexão SSH

Teste a conexão SSH com o Bitbucket:

ssh -T git@bitbucket.org

Você deverá ver uma mensagem de sucesso.

2. Git Credential Manager

O Git Credential Manager armazena seu token de autenticação para que você não precise digitá-lo repetidamente.

2.1. Windows

No Windows, o Git Credential Manager é instalado automaticamente com o Git for Windows. Ele guarda suas credenciais de forma segura.

2.2. macOS

brew install git-credential-manager-core

Em seguida, configure o Git para usar o Credential Manager:

git config --global credential.credentialStore osxkeychain

2.3. Ubuntu/Linux

sudo apt-get update
sudo apt-get install git-credential-manager

Em seguida, configure o Git para usar o Credential Manager:

git config --global credential.credentialStore secrets

3. Criação de Token de Acesso Pessoal (Alternativa às Chaves SSH)

Se preferir usar um token de acesso pessoal em vez de chaves SSH:

Acesse o Bitbucket e faça login
Clique no seu avatar no canto superior direito
Selecione "Settings" (Configurações)
No menu lateral, clique em "App passwords" (Senhas de aplicativo)
Clique em "Create app password" (Criar senha de aplicativo)
Dê um nome à senha (ex: "Desenvolvimento Local")
Selecione as permissões necessárias (geralmente "Repository read" e "Repository write")
Clique em "Create" (Criar)
Copie o token gerado (você não poderá vê-lo novamente)

Ao clonar um repositório ou fazer push, use seu nome de usuário e o token como senha:

git clone https://seu_usuario@bitbucket.org/equipe/repositorio.git
# Quando solicitado, use o token como senha

Configuração do Repositório

Após configurar a autenticação, você pode clonar o repositório do projeto:

Usando SSH

git clone git@bitbucket.org:equipe/repositorio.git

Usando HTTPS com Token

git clone https://seu_usuario@bitbucket.org/equipe/repositorio.git
# Quando solicitado, use o token como senha

Próximos Passos

Após configurar a autenticação no Bitbucket, você está pronto para começar a trabalhar com o repositório do projeto. O próximo passo é instalar o ambiente de desenvolvimento necessário para o bootcamp.