Agente SSH
Bitwarden Password Manager aplicación de escritorio puede actuar como un agente SSH para cifrar de forma segura y almacenar sus claves SSH (Secure Shell) para su uso con:
Autenticarse en servidores
Firmar commits de Git
Interactuar con servicios basados en SSH
El Agente SSH de Bitwarden organizará y protegerá sus claves en una ubicación segura. Se puede acceder a las claves SSH con la aplicación de escritorio, la aplicación web, la extensión del navegador y la aplicación móvil. Las claves SSH se pueden generar utilizando la aplicación de escritorio, la aplicación web y la extensión del navegador.
note
The SSH Agent requires release version 2025.1.2 or newer.
Almacenamiento de una clave SSH
Se pueden crear y guardar nuevas claves SSH en la aplicación de escritorio de Bitwarden. Las claves SSH de Bitwarden se almacenarán:
Campo | Descripción |
|---|---|
Nombre de la clave | El nombre de su clave SSH. |
Clave privada | La clave privada son datos sensibles que serán utilizados por el servidor para facilitar una conexión segura. Los datos de la clave privada deben tratarse con cuidado y mantenerse seguros. Los usuarios pueden utilizar Bitwarden para generar una clave privada segura y única. |
Clave pública | Parte de la clave compartida con el servidor al que se conectará. |
Huella digital | Cadena corta y única generada a partir de la clave pública para su identificación. Por ejemplo, los commits git firmados por SSH pueden ser verificados usando la huella digital. |
Las claves SSH almacenadas en el Gestor de Contraseñas de Bitwarden tendrán acceso a las características de Bitwarden tales como carpetas, favoritos, reintento de contraseña maestra, notas, clonación de elementos, archivos adjuntos y campos personalizados.
Crear nueva clave SSH
Cree una nueva clave SSH utilizando la aplicación de escritorio, la aplicación web o la extensión de navegador de Bitwarden. Una vez creadas, se puede acceder a las claves SSH almacenadas en Bitwarden desde la aplicación de escritorio, la aplicación web, la extensión del navegador y las aplicaciones móviles.
Seleccione el botón Nuevo y elija Clave SSH como tipo de elemento:
Crear nueva clave SSH en el escritorio note
At this time, Bitwarden can only generate
ED25519type SSH keys.Rellene los datos restantes, como el nombre, y seleccione el icono Guardar cuando haya terminado.
Claves SSH de organización
Las claves SSH pueden crearse y almacenarse en una colección de organización. Los miembros de la organización con los permisos adecuados pueden crear, gestionar y acceder a las claves SSH propiedad de una organización. Obtenga más información sobre los permisos de colección aquí.
Para añadir una nueva clave SSH compartida al almacén de la organización:
En la vista Bóveda de la aplicación de escritorio o web, seleccione el botón Nuevo y seleccione Clave SSH.
tip
Los propietarios de la organización, los administradores y algunos usuarios personalizados también pueden realizar este paso directamente desde Admin Console para omitir algunos de los pasos de este proceso.
En el menú desplegable Propietario, seleccione la organización a la que desea que pertenezca este elemento.
En la lista desplegable Colecciones, seleccione la colección o colecciones con las que desea compartir este elemento.
Compartir una clave SSH
note
In general, resources that use SSH keys can support per-user keys. We recommend reviewing SSH key best practices before sharing SSH keys to an organization.
Editar claves existentes
Una vez guardada una clave SSH en su almacén de Bitwarden, puede editar algunos de los campos de la clave, como el nombre, el propietario, la carpeta y los campos personalizados:
Para editar claves SSH en la aplicación de escritorio Bitwarden:
Abra la aplicación de escritorio de Bitwarden y navegue hasta Claves SSH.
Localice la clave SSH que desea editar y seleccione Editar.
Una vez que haya completado los cambios deseados, seleccione Guardar.
Importar clave a Bitwarden
La función de importación de claves SSH está disponible en la app de escritorio de Bitwarden. Usando la aplicación de escritorio de Bitwarden:
Seleccione el botón Nuevo y elija Clave SSH como tipo de elemento.
Copie la clave SSH existente que desea importar a Bitwarden.
Utilice el icono Importar clave desde el portapapeles. Esto pegará automáticamente la clave SSH en Bitwarden.
En este momento, las claves importadas deben estar en formato OpenSSH o PKCS#8.
Importar una clave SSH
note
At this time, imported SSH keys from Putty are not compatible.
Configurar el agente SSH de Bitwarden
Con el fin de utilizar Bitwarden como su Agente SSH primario, se le pedirá que configure su cliente SSH para comunicarse con Bitwarden para la autenticación.
To enable the Bitwarden SSH Agent on Windows, you must disable the OpenSSH service on your Windows machine. To disable OpenSSH:
On your Windows machine, navigate to Services → OpenSSH Authentication Agent. Services can be located with the Windows search bar.
Windows Services panel Once you have opened the OpenSSH Authentication Agent Properties window, set the Startup type setting to Disabled.
Disable OpenSSH Windows Once the settings have been adjusted, select Apply and then OK.
Habilitar agente SSH
Para habilitar el agente SSH en su aplicación de escritorio Bitwarden, vaya a Configuración y Habilitar agente SSH.
Después de habilitar el agente SSH, también puede ajustar la configuración Pedir autorización cuando se utiliza el agente SSH. Este ajuste determinará cuándo Bitwarden le pedirá que autorice el acceso a una clave SSH:
Siempre
Nunca
Recordar hasta que la bóveda esté bloqueada
Siempre estará seleccionado por defecto.
Probando claves SSH
Una vez que el Agente SSH ha sido configurado para Bitwarden, podemos probar la configuración solicitando una lista SSH:
Plain Textssh-add -L
Esto devolverá una lista de claves SSH guardadas en su cliente de escritorio Bitwarden.
note
When accessing an SSH key, the behavior of Bitwarden will differ depending on the locked or unlocked status of the client.
Locked vault: If your Bitwarden vault is locked, Bitwarden will automatically prompt you to unlock your vault in order to gain access to the SSH key.
Unlocked vault: If the desktop vault is unlocked, you will be prompted to confirm the SSH key usage.
Usar clave SSH para autenticarse con Git
SSH puede usarse para autenticarse con Git. El agente SSH de Bitwarden puede añadir seguridad y facilidad de uso a sus flujos de trabajo Git. En este ejemplo, el Agente SSH Bitwarden autenticará a GitHub.
En su cuenta de GitHub, configure una clave SSH navegando a Configuración, Claves SSH y GPG, luego seleccione Nueva Clave SSH.
En la pantalla de añadir nueva clave SSH, añada un Nombre, seleccione un Tipo de clave. Seleccione Clave
de autenticación. Copie y pegue la clave pública de su bóveda Bitwarden en el campo Clave en GitHub.Create new GitHub key Cuando haya rellenado todos los campos, seleccione Añadir clave SSH para guardar la clave. GitHub le pedirá que verifique su cuenta de GitHub antes de guardar la clave.
Prueba la clave SSH de GitHub en tu terminal, por ejemplo si utilizas macOS:
Plain Textssh -T git@github.comSi tiene éxito, Bitwarden le pedirá que verifique la solicitud de acceso. Seleccione Autorizar para confirmar. Si tiene éxito, recibirá un mensaje verificando el intento de autenticación:
Plain TextHi <USER>! You've successfully authenticated, but GitHub does not provide shell access.
Autenticarse con repositorios git
Utilizar el Agente SSH de Bitwarden para firmar commits SSH de Git. Antes de utilizar el Agente SSH de Bitwarden para firmar los commits de Git, su sistema requerirá:
Git versión 2.34 o superior. Compruebe su versión de Git con:
Plain Textgit --versionOpenSSH versión 8.8 o posterior. Compruebe la versión con:
Plain Textssh -VCliente de escritorio Bitwarden con Agente SSH habilitado.
Configurar Git para la firma SSH
Configure su entorno Git para que apunte a su clave SSH para la firma. Para completar esto puedes establecer variables globales o establecer las instrucciones en tu archivo .gitconfig.
Establecer variables globales
Para configurar los ajustes de Git utilizando variables --global:
Establece que Git use SSH para firmar:
Plain Textgit config --global gpg.format sshEspecificar la clave SSH a utilizar como clave de firma. Para utilizar el agente SSH de Bitwarden, sustituya
<YOUR_PUBLIC_KEY>por la clave pública copiada de la clave SSH guardada en su bóveda de Bitwarden.Plain Textgit config --global user.signingkey "<YOUR_PUBLIC_KEY>"Habilitar la firma automática de commits.
Plain Textgit config --global commit.gpgsign true
Establecer archivo .gitconfig
Para configurar Git mediante un archivo .gitconfig:
Accede a
.gitconfigcon tu editor de texto preferido:Plain Textnano ~/.gitconfigAñade las siguientes configuraciones:
Bash[gpg] format = ssh [user] signingkey = "<YOUR_PUBLIC_KEY>" name = <USER_NAME> email = <USER_EMAIL> [commit] gpgsign = true
note
For Windows users:
Add the
core.sshCommandvariable to your Git config to use Microsoft OpenSSH:Plain Textgit config --global core.sshCommand "C:/Windows/System32/OpenSSH/ssh.exe"Alternatively, set variable in your
.gitconfigfile:Plain Text[core] sshCommand = C:/Windows/System32/OpenSSH/ssh.exeNext, you may be required to set the
gpg.ssh.programparameter:Plain Textgit config --global gpg.ssh.program "C:/Windows/System32/OpenSSH/ssh-keygen.exe"
Firmar commits de Git
Utilizar SSH para autenticarse con Git puede añadir seguridad y facilidad de uso a tu flujo de trabajo. Del mismo modo, las claves SSH almacenadas en Bitwarden pueden utilizarse para firmar y verificar los commits de Git utilizando el protocolo SSH. En este ejemplo, el agente SSH de Bitwarden se utilizará para firmar los commits de Git en GitHub.
En tu cuenta de GitHub, configura una clave de firma SSH accediendo a Configuración, Claves SSH y GPG y, a continuación, selecciona Nueva clave SSH.
En la pantalla de añadir nueva clave SSH, añada un Nombre y seleccione un Tipo de clave, Elija Clave
de firma. Copie y pegue la clave pública de su bóveda Bitwarden en el campo Clave en GitHub.Configure git para utilizar el
allowedSignersFilecon el siguiente comando:Plain Textgit config --global gpg.ssh.allowedSignersFile "$HOME/.ssh/allowed_signers"Añade tu clave pública al allowedSignersFile:
Bash# Create allowed_signers file touch ~/.ssh/allowed_signers # Edit the allowed_signers file and add a line for your public key pair you wish to trust, for example: User1@Bitwarden.com ssh-ed25519 <Your_Public_Key>Utiliza la clave SSH para clonar tu repositorio con el método SSH:
SSH clone Plain Textgit clone git@github.com:<USER>/<repository>.gitCree el commit de Git usando la terminal o su editor de texto preferido:
Plain Textgit commit -m "This commit is signed using SSH"Bitwarden le pedirá que autorice el uso de la clave:
Una vez autorizado, la clave SSH se iniciará para aprobar el commit. Ahora puedes enviar el commit:
Plain Textgit pushPuedes verificar tu commit en Github navegando a GitHub commits:
Verify your commit in GitHub
SSH Agent forwarding
SSH agent forwarding permite que un servidor remoto al que está accediendo se autentique en otros servidores utilizando sus claves, sin exponer sus claves privadas fuera de su bóveda. El servidor en el que ha iniciado sesión puede solicitar a su instancia local de Bitwarden que se autentique en el servidor remoto. En este ejemplo, vamos a demostrar la transferencia de archivos entre servidores:
Para empezar, asegúrese de que el agente SSH se ha habilitado en su aplicación de escritorio Bitwarden navegando a Configuración y Habilitar agente SSH:
Enable SSH storage on desktop client Cree una nueva clave SSH o importe una clave SSH existente a su aplicación de escritorio Bitwarden.
Active el reenvío de agentes abriendo una conexión con el servidor al que desea enviar archivos:
Plain Textssh -A <HostnameA>Enviar un archivo al servidor:
Plain Textrsync -avzP ./TEST.txt <USER>@<HostnameB>:/home/<USER>/test.txtBitwarden le pedirá que apruebe el acceso a la clave SSH. Esto mostrará que la clave SSH ha sido solicitada y utilizada para completar la transferencia de archivos.
Confirm SSH Agent Forwarding