# Inicio de sesión en dos pasos a través de YubiKey

El inicio de sesión en dos pasos utilizando [YubiKey](https://www.yubico.com) está disponible para usuarios Premium, incluyendo miembros de organizaciones pagas (familias, Equipos o empresas). Cualquier [YubiKey que soporte OTP](https://www.yubico.com/products/yubikey-hardware/compare-yubikeys/) puede ser utilizado. Esto incluye todos los dispositivos de la serie YubiKey 4 y 5, así como YubiKey NEO y YubiKey NFC. Puedes agregar hasta cinco YubiKeys a tu cuenta.

> [!TIP] YubiKey with FIDO2 WebAuthn
> La mayoría de los YubiKeys modernos, incluyendo las llaves de la serie 5, soportan el protocolo FIDO2 WebAuthn. Si tu llave lo admite, lo cual puedes determinar utilizando la aplicación [Gestor de YubiKey](https://www.yubico.com/support/download/yubikey-manager/), recomendamos configurar tu llave como un dispositivo WebAuthn FIDO2 siguiendo [estas instrucciones](https://bitwarden.com/es-la/help/setup-two-step-login-fido/).

## Configuración de YubiKey

Para habilitar el inicio de sesión en dos pasos usando YubiKey:

> [!WARNING] Losing 2FA Device (Generic)
> **Perder el acceso a su dispositivo de inicio de sesión de dos pasos puede bloquearlo permanentemente de su caja fuerte** a menos que escriba y guarde su código de recuperación de inicio de sesión de dos pasos en un lugar seguro o tenga habilitado y disponible un método alternativo de inicio de sesión de dos pasos.
> 
> [Obtén tu código de recuperación](https://bitwarden.com/es-la/help/two-step-recovery-code/) desde la pantalla de **inicio de sesión en dos pasos** inmediatamente después de habilitar cualquier método.

1. Inicia sesión en la aplicación web de Bitwarden.
2. Seleccione **Ajustes** → **Seguridad**→**Inicio de sesión en dos pasos** desde la navegación:

![Two-step login](https://bitwarden.com/assets/2BsKs83g4cmiCUwxf2ad83/b2a90e85355f3d937aeb46139203737e/2024-12-02_10-54-31.png)
3. Ubique la opción **Clave de Seguridad OTP YubiKey** y seleccione el botón **Gestionar**.

![Selecciona el botón Gestionar ](https://bitwarden.com/assets/3mrpxcGY18F1lmrCKykQ9e/e3b8aedb374e61635b55117cbcc3d9c8/yubikey.png)

Se le pedirá que ingrese su contraseña maestra para continuar.
4. Conecta la YubiKey (NEO o serie 4) al puerto USB de tu ordenador.
5. Seleccione el primer campo de entrada YubiKey vacío en el diálogo en su caja fuerte web.
6. Toca el botón de YubiKey.

Si va a utilizar el YubiKey para un dispositivo móvil habilitado para NFC, marque la casilla **Una de mis llaves soporta NFC**.
7. Seleccione **Guardar**. Un mensaje verde `Habilitado` indicará que el inicio de sesión en dos pasos usando YubiKey ha sido habilitado.
8. Seleccione el botón **Cerrar** y confirme que la opción **Clave de Seguridad OTP YubiKey** ahora está habilitada, como lo indica una casilla de verificación verde ( ✓ ).

Repite este proceso para agregar hasta 5 YubiKeys a tu cuenta.

> [!NOTE] After activating 2FA, logout of sessions.
> Recomendamos mantener abierta la pestaña de la caja fuerte web activa antes de proceder a probar el inicio de sesión de dos pasos en caso de que algo se haya configurado incorrectamente. Una vez que hayas confirmado que funciona, cierra la sesión de todas tus aplicaciones Bitwarden para requerir el inicio de sesión en dos pasos para cada una. Eventualmente serás cerrado sesión automáticamente.

## Configuración autoalojada

Si eres un administrador de una organización, necesitarás configurar un par de variables de entorno en `global.override.env` para permitir que se realicen llamadas a la API de OTP de YubiKey:

| **Variable** | **Descripción** |
|------|------|
| configuraciones-globales__yubico__id-de-cliente | Reemplace el valor con la ID recibida de su Yubico Key. Regístrate para la llave Yubico [aquí](https://upgrade.yubico.com/getapikey/). |
| configuraciones-globales__yubico__clave | Ingrese el valor de la clave recibido de Yubico. |

## Usa YubiKey

Se asume que **YubiKey** es tu [método-habilitado-de-mayor-prioridad](https://bitwarden.com/es-la/help/setup-two-step-login/#using-multiple-methods/). Para acceder a tu caja fuerte usando un YubiKey:

1. Inicia sesión en tu caja fuerte de Bitwarden en cualquier aplicación e ingresa tu correo electrónico y contraseña maestra.

Se le pedirá que inserte su YubiKey en el puerto USB de su computadora o que sostenga su YubiKey contra la parte posterior de su dispositivo habilitado para NFC:

![Solicitud de YubiKey](https://bitwarden.com/assets/7jikprFVd3XRhOGRCLrEYT/82b0a7332797a1c6ee6add081ea40ab9/2025-03-25_10-15-37.png)

> [!TIP] Remember Me for 2FA
> Marca la casilla **Recuérdame** para recordar tu dispositivo durante 30 días. Recordar tu dispositivo significará que no se te requerirá completar tu paso de inicio de sesión de dos pasos.

**Si estás utilizando un YubiKey no-NFC en un dispositivo móvil:**

 1. Conecta tu YubiKey al dispositivo.
 2. Toca **Cancelar** para terminar el aviso NFC.

![Cancelar NFC](https://bitwarden.com/assets/0SakpfPW6yFdTU34AHxNu/7b9167ccdccd05cdaa87f748041be031/nonfc.webp)
 3. Toca el campo de entrada de texto, denotado por un subrayado gris.
 4. Toca o presiona el botón de tu YubiKey para insertar tu código.
2. Selecciona o toca **Continuar** para terminar de iniciar sesión.

No se le requerirá completar su segundo paso de inicio de sesión de dos pasos para **desbloquear** su caja fuerte una vez que haya iniciado sesión. Para ayuda configurando el comportamiento de cerrar sesión vs. bloquear, vea [opciones de tiempo de espera de la caja fuerte](https://bitwarden.com/es-la/help/vault-timeout/).

## Solución de problemas de NFC

Si la funcionalidad NFC de tu YubiKey no está funcionando correctamente:

##### Verifique que NFC esté habilitado:

1. Descarga [Gestor de YubiKey](https://www.yubico.com/products/services-software/download/yubikey-manager/).
2. Conecta el YubiKey a tu dispositivo.
3. Seleccione la pestaña **Interfaces**, y verifique que todas las casillas en la sección NFC estén marcadas.

##### Verifique que NFC esté configurado correctamente:

1. Descarga la [herramienta de personalización YubiKey](https://www.yubico.com/products/services-software/download/yubikey-personalization-tools/).
2. Conecta el YubiKey a tu dispositivo.
3. Seleccione la pestaña **Herramientas**.
4. Seleccione el botón **Programación NDEF**.
5. Seleccione la ranura de configuración que le gustaría que el YubiKey use a través de NFC.
6. Selecciona el botón **Programa**.

##### (Solo-Android) Verifica lo siguiente:

- Que marcaste la casilla **Una de mis llaves soporta NFC** durante la configuración.
- Que su dispositivo Android soporte [NFC](https://en.wikipedia.org/wiki/List_of_NFC-enabled_mobile_devices) y se [sabe que funciona correctamente](https://forum.yubico.com/viewtopic1c5f.html?f=26&t=1302) con YubiKey NEO o YubiKey 5 NFC.
- Que tengas NFC habilitado en tu dispositivo Android (**Ajustes** → **Más**).
- Que el formato/modo de tu teclado esté configurado en QWERTY.