Skip to content

Commit

Permalink
Merge pull request #115 from arsaccol/master
Browse files Browse the repository at this point in the history
Tradução da parte 4.3 (geração de chaves SSH) para português brasileiro
  • Loading branch information
carlosschults authored May 8, 2024
2 parents fdb4a52 + 8e46ebd commit 5d4de43
Showing 1 changed file with 18 additions and 17 deletions.
35 changes: 18 additions & 17 deletions book/04-git-server/sections/generating-ssh-key.asc
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
[[r_generate_ssh_key]]
=== Generating Your SSH Public Key
=== Gerando Sua Chave Pública SSH

(((SSH keys)))
That being said, many Git servers authenticate using SSH public keys.
In order to provide a public key, each user in your system must generate one if they don't already have one.
This process is similar across all operating systems.
First, you should check to make sure you don't already have a key.
By default, a user's SSH keys are stored in that user's `~/.ssh` directory.
You can easily check to see if you have a key already by going to that directory and listing the contents:
(((Chaves SSH)))
Dito isto, muitos servidores de Git efetuam autenticação utilizando chaves públicas SSH.
Para prover uma chave pública, cada usuário do seu sistema deve gerar uma chave se ainda não possui uma.
Este processo é similar em todos os sistemas operacionais.
Primeiro, você deve verificar e se certificar de que ainda não tem uma chave.
Por padrão, as chaves de SSH de um determinado usuário são armazenadas no diretório `~/.ssh` daquele usuário.
Você pode facilmente verificar se não já possui uma chave indo neste diretório e listando seu conteúdo:

[source,console]
----
Expand All @@ -17,9 +17,9 @@ authorized_keys2 id_dsa known_hosts
config id_dsa.pub
----

You're looking for a pair of files named something like `id_dsa` or `id_rsa` and a matching file with a `.pub` extension.
The `.pub` file is your public key, and the other file is your private key.
If you don't have these files (or you don't even have a `.ssh` directory), you can create them by running a program called `ssh-keygen`, which is provided with the SSH package on Linux/Mac systems and comes with Git for Windows:
O que você precisa encontrar é um par de arquivos, um com o nome parecido com `id_dsa` ou `id_rsa`, e o outro de nome correspondente, porém com a extensão `.pub` no final.
O arquivo de extensão `.pub` é sua chave pública, e o outro arquivo é sua chave privada.
Caso você não tenha estes arquivos (ou sequer um diretório `.ssh`), você pode criá-los rodando um programa chamado `ssh-keygen`, que vem incluído no pacote SSH em sistemas Linux/Mac, e também no Git para Windows:

[source,console]
----
Expand All @@ -35,11 +35,12 @@ The key fingerprint is:
d0:82:24:8e:d7:f1:bb:9b:33:53:96:93:49:da:9b:e3 [email protected]
----

First it confirms where you want to save the key (`.ssh/id_rsa`), and then it asks twice for a passphrase, which you can leave empty if you don't want to type a password when you use the key.

Now, each user that does this has to send their public key to you or whoever is administrating the Git server (assuming you're using an SSH server setup that requires public keys).
All they have to do is copy the contents of the `.pub` file and email it.
The public keys look something like this:
Primeiro, o programa confirma onde você deseja salvar a chave (`.ssh/id_rsa`), e então pede duas vezes por uma frase secreta, a qual você pode deixar vazia se não deseja digitar uma senha quando utiliza as chaves.
Entretanto, se você utilizar uma senha, lembre-se de adicionar a opção `-o`; ela salva a chave privada em um formato que é mais resistente a ataques de força bruta do que o formato padrão.
Você também pode utilizar a ferramenta `ssh-agent` para não ter de entrar com sua senha toda vez.
Agora, cada usuário que tenha feito os passos acima deve enviar sua chave pública a você ou a quem estiver administrando o servidor de Git (assumindo que um servidor SSH que requeira chaves públicas esteja sendo utilizado).
Tudo que o administrador precisa fazer é copiar o conteúdo do arquivo `.pub` e enviá-lo por e-mail.
A chave tem mais ou menos esta aparência:

[source,console]
----
Expand All @@ -52,4 +53,4 @@ mZ+AW4OZPnTPI89ZPmVMLuayrD2cE86Z/il8b+gw3r3+1nKatmIkjn2so1d01QraTlMqVSsbx
NrRFi9wrf+M7Q== [email protected]
----

For a more in-depth tutorial on creating an SSH key on multiple operating systems, see the GitHub guide on SSH keys at https://help.github.com/articles/generating-ssh-keys[].
Para ver um tutorial mais detalhado sobre a criação de chaves SSH em diversos sistemas operacionais, veja o guia do GitHub sobre chaves SSH em https://docs.github.com/pt/authentication/connecting-to-github-with-ssh[].

0 comments on commit 5d4de43

Please sign in to comment.