generating-ssh-key.asc

[[r_generate_ssh_key]]
=== Generando tu clave pública SSH

(((SSH keys)))
Tal y como se ha comentado, muchos servidores Git utilizan la autentificación
a través de claves públicas SSH. Y, para ello, cada usuario del sistema ha de
generarse una, si es que ya no la tiene. El proceso para hacerlo es similar
en casi cualquier sistema operativo.
Ante todo,  asegúrate que no tengas ya una clave. Por defecto, las claves
de cualquier usuario SSH se guardan en la carpeta `~/.ssh` de dicho usuario.
Puedes verificar si ya tienes unas claves, simplemente situándote sobre dicha
carpeta y viendo su contenido:

[source,console]
----
$ cd ~/.ssh
$ ls
authorized_keys2  id_dsa       known_hosts
config            id_dsa.pub
----

Has de buscar un par de archivos con nombres tales como 'algo' y 'algo.pub';
siendo ese "algo" normalmente 'id_dsa' o 'id_rsa'. El archivo terminado en
'.pub' es tu clave pública, y el otro archivo es tu clave privada. Si no tienes
esos archivos (o no tienes ni siquiera la carpeta '.ssh'), has de crearlos;
utilizando un programa llamado 'ssh-keygen', que viene incluido en el paquete
SSH de los sistemas Linux/Mac o en el paquete MSysGit en los sistemas Windows:

[source,console]
----
$ ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/home/schacon/.ssh/id_rsa):
Created directory '/home/schacon/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/schacon/.ssh/id_rsa.
Your public key has been saved in /home/schacon/.ssh/id_rsa.pub.
The key fingerprint is:
d0:82:24:8e:d7:f1:bb:9b:33:53:96:93:49:da:9b:e3 schacon@mylaptop.local
----

Como se ve, este comando primero solicita confirmación de dónde van a a guardarse
las claves ('.ssh/id_rsa'), y luego solicita, dos veces, una contraseña
(passphrase), contraseña que puedes dejar en blanco si no deseas tener que
teclearla cada vez que uses la clave.

Tras generarla, cada usuario ha de encargarse de enviar su clave pública
a quienquiera que administre el servidor Git (en el caso de que éste
esté configurado con SSH y así lo requiera). Esto se puede realizar
simplemente copiando los contenidos del archivo terminado en '.pub' y enviándoselos
por correo electrónico. La clave pública será una serie de números, letras y
signos, algo así como esto:

[source,console]
----
$ cat ~/.ssh/id_rsa.pub
ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAklOUpkDHrfHY17SbrmTIpNLTGK9Tjom/BWDSU
GPl+nafzlHDTYW7hdI4yZ5ew18JH4JW9jbhUFrviQzM7xlELEVf4h9lFX5QVkbPppSwg0cda3
Pbv7kOdJ/MTyBlWXFCR+HAo3FXRitBqxiX1nKhXpHAZsMciLq8V6RjsNAQwdsdMFvSlVK/7XA
t3FaoJoAsncM1Q9x5+3V0Ww68/eIFmb1zuUFljQJKprrX88XypNDvjYNby6vw/Pb0rwert/En
mZ+AW4OZPnTPI89ZPmVMLuayrD2cE86Z/il8b+gw3r3+1nKatmIkjn2so1d01QraTlMqVSsbx
NrRFi9wrf+M7Q== schacon@mylaptop.local
----

Para más detalles sobre cómo crear unas claves SSH en variados sistemas operativos,
consultar la correspondiente guía en GitHub: https://help.github.com/articles/generating-ssh-keys[].