Exigencia de 2FA

Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.

La implementación de la autenticación de dos factores (2FA) permite a los administradores exigir que todos los miembros tengan el 2FA activado en sus cuentas para acceder a los recursos de la organización. Esto garantiza un mayor nivel de seguridad para tus apps y datos.

Resumen

Cuando la implementación de 2FA está activada para una organización:

Todos los miembros deben tener el 2FA activado en su cuenta de Capgo
Se denegará el acceso a las apps de la organización a los miembros sin 2FA
Tanto el dashboard web como CLI aplicarán este requisito
Los nuevos miembros deben activar 2FA antes de acceder a los recursos de la organización

Cómo funciona

Panel de control web

Si intentas acceder a una organización que requiere 2FA y no lo tienes activado:

Verás un mensaje de acceso denegado
Se te redirigirá para activar el 2FA en la configuración de tu cuenta
Una vez activado, podrás acceder a la organización normalmente

Acceso CLI

Al usar el Capgo CLI para interactuar con apps en una organización que requiere 2FA:

🔐 Access Denied: Two-Factor Authentication Required
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

This organization requires all members to have 2FA enabled.

To regain access:
  1. Go to https://web.capgo.app/settings/account
  2. Enable Two-Factor Authentication on your account
  3. Try your command again

Activar la obligatoriedad de 2FA

Desde el Web Dashboard

Ve a la configuración de tu organización
Ve a la pestaña Seguridad sección
Interruptor Requerir 2FA para todos los miembros
Confirmar acción

Vía CLI

Puedes activar la obligatoriedad de 2FA usando el Capgo CLI:

# Enable 2FA enforcement for an organization
npx @capgo/cli organization set YOUR_ORG_ID --enforce-2fa

# Disable 2FA enforcement
npx @capgo/cli organization set YOUR_ORG_ID --no-enforce-2fa

Al activarlo vía CLI, verás:

Qué miembros no tienen 2FA activado
Un aviso si tú no tienes 2FA activado
Un prompt de confirmación antes de aplicar el cambio

Comprobando el estado de 2FA del miembro

Vía CLI

Puedes listar todos los miembros de la organización y su estado de 2FA:

npx @capgo/cli organization members YOUR_ORG_ID

Esto mostrará:

Email y rol del miembro
Si tienen el 2FA habilitado
Un resumen de cuántos miembros deben habilitar el 2FA

Vía Web Dashboard

En la configuración de tu organización, puedes ver si cada miembro tiene el 2FA habilitado.

Configuración de 2FA en tu cuenta

Si necesitas habilitar 2FA en tu cuenta, consulta nuestra guía de configuración de Two-Factor Authentication.

Buenas prácticas

Antes de habilitar la obligatoriedad

Comunica los cambios con antelación: Avisa a los miembros con al menos una semana de antelación
Brinda soporte: Comparte el Guía de configuración de 2FA con tu equipo
Verificar preparación: Usa npx @capgo/cli organization members para ver quién aún debe activar el 2FA

Tras activar la obligatoriedad

Monitorear problemas de acceso: Estar disponible para ayudar a miembros bloqueados
Guardar códigos de respaldo: Recordar a los miembros que guarden sus códigos de respaldo 2FA
Revisar regularmente: Verifica periódicamente que todos los miembros tengan 2FA activo

Para CI/CD Pipelines

Usa llaves API: Los sistemas de CI/CD deben usar llaves API, no cuentas de usuario
Dueños de llaves API: Asegúrate de que el usuario que creó las llaves API de CI/CD tenga 2FA habilitado
Rotar llaves: Rota regularmente las llaves API usadas en sistemas automatizados

Solución de problemas

“Acceso denegado: se requiere autenticación de dos factores”

Problema: Estás viendo este error al intentar acceder a una organización.

Solución:

Ve a Configuración de la cuenta
Activa la 2FA en tu cuenta
Intenta acceder a la organización de nuevo

“No se puede activar la obligatoriedad de 2FA”

Problema: No puedes activar la obligatoriedad de 2FA para tu organización.

Solución:

Asegúrate de tener super_admin permisos en la organización
Primero activa 2FA en tu propia cuenta
Contacta a soporte si el problema persiste

Fallo en los comandos de CLI

Problema: los comandos de CLI fallan con errores de 2FA.

Solución:

Verifica que tu clave de API sea válida: npx @capgo/cli doctor
Asegúrate de que el dueño de la clave API tenga 2FA activado
Vuelve a autenticarte si usas auth basada en login: npx @capgo/cli login

Cumplimiento

La implementación de 2FA ayuda a tu organización a cumplir con diversos requisitos de cumplimiento:

Estándar	Requisito	Cómo ayuda el 2FA
SOC 2	Controles de acceso	Garantiza una autenticación sólida para todos los usuarios
ISO 27001	Seguridad de la información	Añade una capa de verificación de identidad
HIPAA	Gestión de accesos	Protege contra accesos no autorizados
RGPD	Protección de datos	Reduce el riesgo de compromiso de cuentas
PCI DSS	Controles de autenticación	Cumple con requisitos de autenticación multifactor

Próximos pasos

Continuar desde 2FA Enforcement

Si estás usando Exigencia de 2FA para planificar la seguridad y el cumplimiento, conéctalo con Cifrado para los detalles de implementación en Cifrado, Cumplimiento para los detalles de implementación en Cumplimiento, Escáner de seguridad de Capgo para el flujo de trabajo del producto en Capgo Security Scanner, Seguridad de Capgo para el flujo de trabajo del producto en Capgo Security, y Centro de confianza de Capgo para el flujo de trabajo del producto en Capgo Trust Center.