README.md

   1 # Crear Cuenta de Usuario en `repo.or.cz`
   2
   3 Primero hay que crear las claves (pública y privada) para usar con [**ssh**](https://es.wikipedia.org/wiki/Secure_Shell).
   4
   5 ```bash
   6 $ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
   7 ```
   8
   9 A continuación se puede ver un ejemplo de cómo se crean las claves y el contenido de la clave pública.
  10
  11 ![ejemplo_ssh-keygen](images/20230907_001.png)
  12
  13 ![ejemplo_clave](images/20230907_002.png)
  14
  15 Una vez que se disponga de las claves, hay que crear una cuenta en [`repo.or.cz`](https://repo.or.cz/reguser.cgi).
  16
  17 ![crear_usuario](images/20230907_003.png)
  18
  19 Se necesita ingresar:
  20
  21 1. Nombre de Usuario (inventarlo)
  22 2. Correo Electrónico
  23 3. Contenido de la Clave Pública
  24
  25 ![datos_usuario](images/20230907_004.png)
  26
  27 Aunque no se utiliza para la conexión `ssh`, por las dudas, descargar el certificado de autenticación para **http push**.
  28
  29 ![http_push](images/20230907_005.png)
  30
  31 Una vez creada la cuenta de usuario, definir la configuración de **ssh** (para `repo.or.cz`).
  32
  33 ```
  34 # ~/.ssh/config
  35 Host repo.or.cz
  36   Hostname repo.or.cz
  37   User foredi2
  38   IdentityFile ~/.ssh/repo.or.cz
  39   # Don't try multiple keys
  40   IdentitiesOnly yes
  41 ```
  42
  43 Controlar que se pueda establecer la conexión **ssh**.
  44
  45 ```bash
  46 $ ssh -v repo.or.cz 2>&1 | grep -i -e 'authenticat' -e 'permission' -e 'denied'
  47 debug1: Authentications that can continue: publickey
  48 debug1: Authentication succeeded (publickey).
  49 ```
  50
  51 Si no se obtienen resultados, omitir el filtro (`grep`) y analizar la información generada por `ssh`.
  52
  53 ```bash
  54 $ ssh -v repo.or.cz
  55 ```
  56
  57 A continuación se puede ver un ejemplo.
  58
  59 ![authentication_succeeded](images/20230907_006.png)
  60
  61 Enviar el nombre de usuario creado, para que sea agregado como colaborador del proyecto. En [la página de configuración proyecto](https://repo.or.cz/editproj.cgi?name=todo-rest-api_edi2-2023.git) se puede controlar si el usuario es colaborador.
  62
  63 ![users](images/20230907_007.png)
  64
  65 Una vez que el usuario esté en el listado de colaboradores, copiar el enlace **ssh** desde la página del proyecto.
  66
  67 ![proyecto](images/20230907_008.png)
  68
  69 Ya con el enlace **ssh**, clonar el repositorio para poder trabajar en él.
  70
  71 ![git_clone](images/20230907_009.png)