Saltar a contenido

Crear Llave SSH o Token de Bitbucket

Esta guía describe el proceso para configurar la autenticación en Bitbucket, incluyendo la creación de llaves SSH para una autenticación segura o la configuración del Git Credential Manager para guardar su token de autenticación.

Autenticación en Bitbucket

Existen dos formas principales de autenticarse en Bitbucket: llaves SSH y Git Credential Manager.

1. Llaves SSH

Las llaves SSH le permiten autenticarse sin necesidad de escribir su contraseña cada vez.

1.1. Verificación de Llaves Existentes

Verifique si ya tiene llaves SSH existentes:

ls -al ~/.ssh

Si ve archivos como id_rsa e id_rsa.pub, ya tiene llaves SSH. De lo contrario, continúe con el siguiente paso.

1.2. Generación de Llaves SSH

Genere una nueva llave SSH con el siguiente comando:

ssh-keygen -t rsa -b 4096 -C "tu_email@ejemplo.com"

Reemplace tu_email@ejemplo.com con su dirección de correo electrónico. Presione Enter para aceptar la ubicación predeterminada para guardar la llave (generalmente ~/.ssh/id_rsa). Defina una passphrase (contraseña) para su llave SSH, o déjela en blanco para no usar una.

1.3. Agregar la Llave a Bitbucket

  1. Copiar la Llave Pública:

    • En Windows: clip < ~/.ssh/id_rsa.pub
    • En macOS: pbcopy < ~/.ssh/id_rsa.pub
    • En Linux: cat ~/.ssh/id_rsa.pub y cópiela manualmente

  2. Agregar la Llave a Bitbucket:

    • Acceda a Bitbucket e inicie sesión
    • Haga clic en su avatar en la esquina superior derecha
    • Seleccione "Settings" (Configuraciones)
    • En el menú lateral, haga clic en "SSH keys" (Llaves SSH)
    • Haga clic en "Add key" (Agregar llave)
    • Pegue la llave pública en el campo "Key" (Llave)
    • Déle un nombre descriptivo a la llave (ej: "Portátil Trabajo")
    • Haga clic en "Add key" (Agregar llave)

1.4. Probar la Conexión SSH

Pruebe la conexión SSH con Bitbucket:

ssh -T git@bitbucket.org

Debería ver un mensaje de éxito.

2. Git Credential Manager

El Git Credential Manager almacena su token de autenticación para que no tenga que escribirlo repetidamente.

2.1. Windows

En Windows, el Git Credential Manager se instala automáticamente con Git for Windows. Guarda sus credenciales de forma segura.

2.2. macOS

brew install git-credential-manager-core

Luego, configure Git para usar el Credential Manager:

git config --global credential.credentialStore osxkeychain

2.3. Ubuntu/Linux

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

Luego, configure Git para usar el Credential Manager:

git config --global credential.credentialStore secrets

3. Creación de una Contraseña de Aplicación (Alternativa a las Llaves SSH)

Si prefiere usar una contraseña de aplicación en lugar de llaves SSH:

  1. Acceda a Bitbucket e inicie sesión
  2. Haga clic en su avatar en la esquina superior derecha
  3. Seleccione "Settings" (Configuraciones)
  4. En el menú lateral, haga clic en "App passwords" (Contraseñas de aplicación)
  5. Haga clic en "Create app password" (Crear contraseña de aplicación)
  6. Déle un nombre a la contraseña (ej: "Desarrollo Local")
  7. Seleccione los permisos necesarios (generalmente "Repository read" y "Repository write")
  8. Haga clic en "Create" (Crear)
  9. Copie el token generado (no podrá verlo de nuevo)

Al clonar un repositorio o hacer push, use su nombre de usuario y el token como contraseña:

git clone https://su_usuario@bitbucket.org/equipo/repositorio.git
# Cuando se le solicite, use el token como contraseña

Configuración del Repositorio

Después de configurar la autenticación, puede clonar el repositorio del proyecto:

Usando SSH

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

Usando HTTPS con Token

git clone https://su_usuario@bitbucket.org/equipo/repositorio.git
# Cuando se le solicite, use el token como contraseña

Próximos Pasos

Después de configurar la autenticación en Bitbucket, está listo para comenzar a trabajar con el repositorio del proyecto. El siguiente paso es instalar el entorno de desarrollo necesario para el bootcamp.