DEV Community: Junio Santos

Como criar e registrar uma chave SSH para o GitHub

Junio Santos — Thu, 28 Sep 2023 17:26:40 +0000

Autor: Junio Santos

Índice

O que é
- Pré-requisitos
Instalando OpenSSH no seu computador
Criando a chave SSH
Adicionando no GitHub
Registrando no dispositivo

O que é

OpenSSH é uma ferramenta que auxilia em conexões remotas utilizando o protocolo SSH, servindo como um meio de autenticação prático onde não é necessário senhas e usernames. Aplique esse conceito ao Github (ou GitLab) e voce poderá clonar seus projetos e eles automaticamente autenticar com a sua conta, podendo manter o repositório sincronizado com maior segurança e sem necessidade de senha.

Se voce utiliza o Github Desktop não é necessário configurar alguma chave SSH, mas é bom ter configurado caso em algum momento precise utilizar Git fora da GUI

Pré-requisitos:

openSSH
Git

Instalando OpenSSH no seu computador

Caso ja openssh instalado em seu pc, pode pular para Criando a Chave
SSH

MacOS

MacOS:

MacOS já vem com o git instalando por padrão, e openssh já vem embutido sem a necessidade de fazer qlqer download extra.

Caso queira confirmar que realmente está tudo certo basta executar:

brew install git

Linux
Para conferir se já está disponível no seu computador utilize o comando:

if command -v /usr/bin/ssh-agent &> /dev/null; then echo "ta tudo certo"; fi

Se de fato apareceu ta tudo certo no teu terminal significa que ta tudo certo e pode pular essa parte.

# -- ubuntu/mint/debian
sudo apt install openssh-client

# -- fedora
sudo dnf install openssh

# -- openSUSE
sudo zypper install openssh

# -- arch
sudo pacman -S openssh

Windows
Uma das mais maneiras mais fáceis para conseguir gerenciar sua chave SSH no Windows é utilizando o Git Bash

Caso não tenha instalado basta baixar direto do site do Git acessando: https://git-scm.com/download/win

Clique no primeiro link para baixar
Durante a instalação selecione a opção padrão Use bundled OpenSSH

Criando a chave SSH

Daqui em diante o processo será o mesmo tanto para Linux quanto para Windows

OBS: Usuários de Windows devem prosseguir utilizando Git Bash

Para gerar uma nova chave usaremos o ssh-keygen e passaremos alguns parametros para reforçar a segurança como:

Parâmetro	Descrição
-f	Indica onde a chave será armazenada e qual nome ela terá. Gera dois arquivos, um privado e um público (com extensão .pub).
-t	Escolhe o algoritmo de criptografia a ser usado. O mais seguro atualmente é ed25519. Mais informações sobre outros algoritmos e comparações podem ser encontradas aqui.
-b	Define o tamanho em bits da chave. Quanto maior, mais seguro. Por precaução, utilizaremos o maior disponível.
-E	Especifica o tipo de hash no qual a chave será armazenada. O mais seguro disponível é sha512, e é isso que usaremos.
-C	Define o comentário que será o identificador da chave. Neste caso, será o mesmo e-mail usado no GitHub, desde que não seja o e-mail privado. Se o seu e-mail principal for privado, o GitHub gera um e-mail para você. Basta clicar aqui e copiar o e-mail que fica abaixo da opção "Keep my email addresses private" (deve ser algo como: 541234+@users.noreply.github.com).

Com isso esclarecido, basta inserir todo o comando abaixo para prosseguirmos.

ssh-keygen \
    -b 4096    \
    -E sha512  \
    -t ed25519 \
    -f ~/.ssh/gitKey \
    -C "seu@email.com"

lembre-se, o email não pode ficar entre < e >, deve ser identico ao utilizado no GitHub

Ao entrar com o comando irá aparecer uma tela pedindo uma senha. Como essa chave será utilizada apenas para validar o acesso ao github não é necessário, então aperte Enter para prosseguir.

Se formos ver a pasta ssh usando ls ~/.ssh/ irá notar que foram gerados dois arquivos: gitKey e gitKey.pub

A gitKey é a que contem os dados sensíveis e nunca deve ser compartilhada em hipotese alguma, pois é somente com ela permanecendo desconhecida que a gitKey.pub terá alguma validade e deverá gerar outra.
Por outro lado, a gitKey.pub pode ser mostrada sem problema algum e será ela que iremos mandar para o GitHub para autenticar com o nosso computador.

Para ler o arquivo gitKey.pub basta executar:

cat ~/.ssh/gitKey.pub

esse arquivo terá que começar com: ssh-ed25519 e terminar com o email utilizado no Git.

e apenas copie essa linha pois será necessária para a próxima etapa.

Adicionando no GitHub

Após copiar nossa chave pública do SSH, abra a página de chaves no site do Github (ou clicando aqui) e aperte o botão New SSH Key

E basta dar um nome que seja fácil para voce identificar de qual computador está configurado, em Key type usar Authentication key e por fim inserir a chave pública inteira no campo Key

Registrando no dispositivo

Quanto ao GitHub já está tudo certinho, *PORÉMMM... ainda temos que registrar a nossa chave no nosso próprio computador

Ué, mas nós criamos a chave e até registrei no Github, não é só usar?

Por padrão as chaves geradas não são registradas pois não são em todos os casos que SSH é utilizado apenas localmente, por ser um arquivo ela pode ser exportada para outro sistema e só lá ser adicionada, por conta disso é de nossa responsabilidade fazermos esse registro
Um meio de verificar se a chave SSH está funcionado é mandando uma requisição para o GitHub, vamos testar:

Vish... Permission Denied não é nada bom...
Para resolver isso temos que invocar o ssh-agent e ssh-add que vieram junto com a instalação do openssh que fizemos no começo do post.

Antes, vamos instanciar o ssh-agent utilizando o comando:

# bash/zsh:
eval "$(ssh-agent -s)"

# fish
eval $(ssh-agent -c)

e voce provavelmente deve ver uma mensagem parecida com Agent pid 16916
Agora sim, só nos resta registramos nossa chave privada:

ssh-add ~/.ssh/githubKey

e novamente uma mensagem de confirmação deve ser exibida:

Identity added: /home/ManoelGomes/.ssh/gitKey (<your git email>)

# ou a mensagem abaixo se for um usuário da maçã
Identity added: /Users/ManoelGomes/.ssh/gitKey (<your git email>)

E chegamos ao momento final ~~
Vamos tentar conectar no server do GitHub para ver se nossa máquina está ou não autenticada:

Agora está funcionando!!
Caso continue dando o erro de acesso negado, repita as etapas de adicionar a chave que funcionará.

E a partir de agora toda vez que voce for clonar algum repositório, esqueça o modo HTTP e use apenas SSH e nunca mais terá que inserir seu login e senha quando for trabalhar em algum outro projeto

E é isso! também não se esqueça de configurar a chave GPG para assinar cada commit que você fez!
E qualquer dúvida é só mandar aqui nos comentarios ;)

Como mudar o idioma padrão do LinkedIn

Junio Santos — Fri, 02 Dec 2022 00:58:46 +0000

Introdução

O LinkedIn é um aplicativo bem completo, porém ainda falta algumas features no idioma PT-BR e que já estão disponíveis em inglês, sendo a mais requisitada a função de construir seu currículo para áreas específicas. Atualmente em português o currículo é construído automaticamente APENAS com as informações do seu perfil

OBS:: Caso também tenha o seu perfil em Inglês e queira mudar para algum outro, é só seguir os passos abaixo mas trocando inglês pelo idioma desejado.

OBS2:: Esse método foi testado apenas na versão desktop, não há garantias de funcionar no mobile.

Antes de iniciar

Se o seu LinkedIn tiver em apenas um idioma configurado, diferente da imagem abaixo, pode ir direto para o capítulo Invertendo os idiomas, caso tenha já um idioma secundário (inglês ou qualquer outro) é necessário antes deleta-lo para inserir o novo padrão.

Deletando o idioma secundário

É bem intuitivo e simples, basta clicar no seu perfil para ser redirecionado a ele e no canto direito superior você verá a opção para trocar de idioma.

Clique no ícone do globo

logo após, clique no ícone do X

Se der algum erro, basta remover seu nome adicional(ou additional name) ao editar o perfil, deixando-o vazio.

E ao realizar a operação acima e tentar deletar novamente, agora vai tranquilo, pronto para a próxima etapa.

Invertendo os idiomas

Novamente na página do seu perfil agora estará disponível a opção Adicionar perfil em outro idioma, clique nela.

E agora ATENÇÃO, antes de seguir a intuição e adicionar inglês, você tem que clicar na opção PORTUGUÊS

E só então disponibilizará a opção para colocar um novo idioma padrão, e agora sim seleciona o inglês.

Por fim realize a tradução para o idioma "não padrão", que nesse caso é português.

E pronto, já está disponível os novos atributos para o seu LinkedIn, só resta o trabalho de realizar a tradução de todos os outros campos como Sobre, Experiências, etc.

Esse artigo foi útil? Deixe um comentário e um like para que alcance mais pessoas e possa ajudar mais gente.

Minhas redes:

Twitter: @juniokoi
LinkedIn: in/juniokoi
Github: @JunioKoi

O problema do React para quem é iniciante

Junio Santos — Fri, 18 Nov 2022 21:48:39 +0000

[TL;DR]: React por ser uma biblioteca permite que novos desenvolvedores desenvolvam hábitos ruins e terceirizem soluções que seriam evitados caso utilizassem outras frameworks que definissem padrões no desenvolvimento.

Disclaimer: Entrei recentemente na área de desenvolvimento então ainda estou aprendendo muita coisa e a opinião expressa não tem o intuito de condenar ou julgar, mas refletir e melhorar.

Nesses últimos anos vem surgindo uma onda de pessoas interessadas em entrar na área de programação muito por conta de um marketing abusivo já conhecido, mas também pela grande disponibilidade de tutoriais e cursos gratuitos ou com valores acessíveis que estimulam o aprendizado. E quem decide ir para o desenvolvimento web, mais especificamente na área frontend, recebem indicações para iniciar com React por três motivos:

É fácil aprender já que necessita de um conhecimento básico em Javascript
Tem uma grande comunidade, então caso o aluno tenha algum problema geralmente encontra-se uma resposta fácil
Por ser uma biblioteca, a estrutura do código é simples e fácil compreensão

E é nesse terceiro ponto que quero pegar pois toda essa facilidade no começo faz com que o aluno deixe de aprender assuntos essenciais que ao lidar com projetos reais começam a criar códigos sujos ou com uma organização mal estruturada.

Eu mesmo iniciei em React e mesmo concluindo vários cursos e bootcamps e no primeiro projeto com desafios reais decorri com vários problemas referentes a Design de sistema(System design) [não confundir com Sistema de design(Design system)] como nomenclaturas e estruturação e que nunca foi ensinado ou discutido sobre esses tópicos. No final do desenvolvimento por conta dessas questões me fez pensar que frontend não era para mim e explorei o outras áreas no backend.

A imagem abaixo é uma pequena ilustração de como é um projeto feito apenas em React (sem Next), nele estão inclusas chamadas de API, interfaces (também chamado de props), objetos em JSON além de vários componentes, porém é difícil saber o escopo (para onde que é aplicado) destes componentes, e mesmo levando em consideração que é um projeto pequeno será difícil dar manutenção e escalar, caso alguém decida contribuir no código também não será intuitivo compreender

Meses depois surgiu a oportunidade de aprender Angular e minha impressão foi que o fato de ser uma framework e ter que seguir regras fez com que fosse necessário compreender mais afundo algumas questões como:

Gerenciamento de rotas
Entender WebPack
Separação de arquivos para cada funcionalidade (e não um arquivo que: mostra um texto, controla o estilo, lida com comunicação com o servidor, tudo isso junto)

A imagem abaixo seria de um projeto em Angular e calma! Só quero destacar a questão de como estão organizadas as pastas e o projeto em si. Temos a pasta onde encontra-se todos os componentes, o app/, e dentro temos a pasta modules que é responsável por agrupar componentes essenciais (core), componentes utilizados em várias partes (shared) e um módulo para cada página, que seria a home(site.com/home) e timer(site.com/timer)
Assim se vejo que tem um erro no roteamento do Timer, sei exatamente onde que se encontra. Se eu quiser adicionar um outro módulo como por exemplo o Contato(site.com/contact), basta criar uma nova pasta e não afetará em nada o restante do site, então a chance do chamado efeito colateral é quase 0

E sinto que caso eu ficasse apenas no React iria demorar para aprender e entender esses conceitos, claro que muito disso seria resolvido com o NextJS, já que a framework define regras e segue padrões por conta da sua estrutura de diretórios e páginas tornando o projeto até mais fácil de ser escalável, contudo, estaria apenas terceirizando essas decisões já que quem lida com tudo isso no final das contas é a própria framework e deixando ao desenvolvedor somente criar componentes sem entender o que está por trás disso tudo. O que não seja algo necessariamente ruim já que permite ao desenvolvedor passar mais tempo programando, ainda assim problemas de otimização podem surgir se mal explorado.

E por conta dessa cultura imediatista que veio a surgir, novos devs procuram obter conhecimento de maneira rápida passando por cima de conceitos básicos, e por conta da simplicidade do React é criação hábitos considerados ruins, não porque querem, mas sim por conta de orientação e estímulos (ou falta deles) a apenas criar mas não entender.

Assim acredito que uma melhor alternativa seria após aprender Javascript manusear o DOM e entender como manipular os elementos da página e sua estilização, para depois então aprofundar esses conhecimentos testando e explorando frameworks e se possível estudar junto conceitos que são necessários para o mercado como: SOLID, Unit Test, TDD, System Design e tantos outros.

Lembrando que não é em relação de se obter expertise sobre todos os assuntos mas ter uma noção geral e explorar aos poucos e revisar os conceitos já aprendidos, buscando aprender mais conforme for surgindo a necessidade e curiosidade.

-- Fontes:

Configurando SSH key no WSL / Linux

Junio Santos — Thu, 28 Apr 2022 05:45:48 +0000

Introdução

Primeiramente gostaria de dedicar este artigo ao @rocketseat que me apresentou esse conteúdo através do incrível programa #discover no módulo GitHub. Obrigado por disponibilizar uma plataforma com excelentes conteúdos e de forma totalmente gratuita!

O artigo foi dividido em duas partes, sendo a primeira os processos realizados em nosso terminal, e a segunda feita no próprio site do GitHub.

Há não muito tempo atrás costumava manipular meus repositórios através do HTTPS e por mais que seja uma forma fácil ao instalar programas ou simples clones, quando começamos a realmente utilizar as funções do git e necessitamos de git pull, push entre outros, lidar com esse repositório com o HTTPS não é a melhor e nem a mais segura durante esse processo, ainda mais quando se trata de um repositório privado.

E como recentemente o GitHub deixou de utilizar a senha como fator de autenticação nos repositórios, gerar um Token de Acesso para cada vez que for trabalhar com um repositório final é de alto risco já que estes liberam total acesso para a sua conta, logo uma melhor solução seria criar chaves SSH e através de um processo simples poder futuramente manipular estes repositórios com bem mais segurança e privacidade.

Terminal

Bem, antes de tudo tenha certeza de que você possui instalado em seu computador alguns programas necessários, como o gerador de SSH (openssh-client para **Debian/ **Ubuntu* ou plan9port para Aarch). Caso não possua (ou queira atualizar) é só digitar os comandos:

Debian/ Ubuntu /Kali:



apt-get install openssh-client

Arch:



yay -S openssh



$ pacman -S openssh

para outros OS conferir aqui:
OpenSSH | Docs (crp.to)

Após isso, o que temos que fazer é usar as ferramentas listadas acima para criar uma chave SSH para que torne possível conectar nossos repositórios com o dispositivo que estamos agora configurando.

Para então gerar esta chave, precisamos rodar o seguinte comando:

ssh-keygen -t ed25519 -C "seu_email_do_github*@exemplo.com*"

-t indica que será criado um arquivo.
ed25519 - é o padrão de segurança utilizado
-C mostra que o email colocado a seguir será usado como identificador.

Mais informações sobre o comando utilizado está no site oficial do OpenSSH

https://www.openssh.com/txt/release-8.2

E então apenas confirme sem digitar nada as solicitações que o keygen irá fazer, e então você deverá obter uma tela parecida com esta:

e então verá que foram criado dois novos arquivos na pasta .ssh, com o comando abaixo é possível confirmar isso:

Agora iremos adicionar esta nova chave gerada ao nosso gerenciador de chaves (ssh-agent), portanto recomendo sair do shell que você está utilizando (zsh, fish, ...) e volte para bash, simplesmente digitando o comando



bash

Esta etapa é necessária pois nem toda interface shell suporta comandos de bash (como eval ), agora temos que ter certeza de que o ssh-agent (Gerenciador de chaves) esteja rodando certinho. Para conferir, digitamos:



eval "$(ssh-agent -s)"

(sem Super Usuário a.k.a **sudo)
e deverá mostrar algo semelhante como: Agent pid 5956
*O número acima não é importante e é gerado um novo a cada vez que você realiza este comando.

e para finalmente adicionarmos à SSH gerada o nosso gerenciador basta digitar:



ssh-add ~/.ssh/id_ed25519

note que o id_ed25519 poderá ser diferente caso tenha gerado sua chave com outro sistema de segurança (como ecdsa), então para não ter erro é só ver o resultado do ls que fizemos acima e inserir o nome do arquivo gerado pelo ssh-keygen

Com isso feito, você deverá ver uma mensagem mostrando que a identidade foi adicionada.

Ótimo!! Na parte do terminal terminamos (desculpe o trocadilho) e o que nos resta agora é partir para o site do GitHub adicionar uma outra chave SSH no sistema deles (e assim identificar nosso computador).

GitHub

Após fazer o login e estar na página principal, clicamos no nosso ícone no canto superior direito (1)
e depois ir na aba Settings (Configuração) (2)

Com isso feito, é só seguir para a barra lateral e clicar em SSH and GPG Keys
(Chaves SSH e GPG)

E terá um botão indicando para adicionar uma nova Chave SSH

Agora basta dar título (1) para identificar o seu dispositivo e na parte Key, deverá inserir o texto que está dentro do segundo arquivo gerado pelo ssh-keygen, que terá uma extensão .pub (que no nosso caso é id_ed25519.pub)

No terminal para acessar basta digitar cat ~/.ssh/id_ed25519.pub e irá mostrar ali mesmo o texto contigo, copie tudo isso e coloque onde está indicado como KEY na página do GitHub * (2) e por fim clicar em Add SSH Key (Adicionar Chave SSH)* (3).

e voilà!🎉 Sua chave SSH já está configurada no GitHub e poderá trazer repositórios para sua máquina sem nenhum problema!

Caso tenha sido útil este artigo por favor dê um like e compartilhe para quem não sabia deste processo tão fundamental e simples ao mesmo tempo.

Muito obrigado pela sua atenção e te vejo na próxima!

Fontes:

GitHub usará Access Token como autenticação: https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/
O que são Chaves SSH? : https://jumpcloud.com/blog/what-are-ssh-keys
Checando Chaves SSH existentes | GitHub: https://docs.github.com/en/authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys
Gerando uma nova chave SSH e adicionando ao ssh-agent | GitHub: https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent
Alternativas caso SSH-agent não funcione | Command not found :: https://command-not-found.com/ssh-agent
Instalando OpenSSH nos Sistemas Operacionais | OpenSSH :: https://docs.crp.to/openssh.html#prerequisites
Notas da última atualização do OpenSSH | OpenSSH: (https://www.openssh.com/txt/release-8.2)