Saltar al contenido principal

🚫 Desactivar 2FA y Verificación de Email en Clerk

⚠️ Problema​

Clerk está pidiendo verificación de dos factores (2FA) o verificación de email, lo cual interrumpe el flujo de desarrollo.

✅ Solución: Desactivar en el Dashboard de Clerk​

Esto DEBE hacerse manualmente en el Dashboard de Clerk. La API de Clerk no permite desactivar 2FA a nivel de aplicación programáticamente.

Pasos Detallados:​

  1. Ve al Dashboard de Clerk:

  2. Selecciona tu aplicación:

    • Haz clic en el nombre de tu aplicación

  3. Ve a Configuración de Autenticación:

    • En el menú lateral, ve a "Settings" (Configuración)
    • Luego haz clic en "User & Authentication" (Usuario y Autenticación)

  4. Desactiva Multi-Factor Authentication (2FA):

    • Busca la sección "Multi-factor authentication"
    • Cambia de "Required" a "Optional" o "Disabled"
    • O simplemente desactiva el toggle si está disponible

  5. Desactiva Verificación de Email:

    • Busca la sección "Email, Phone, Username"
    • Desactiva "Require email verification" (Requerir verificación de email)
    • O cambia a "Optional" si prefieres

  6. Guarda los cambios:

    • Haz clic en "Save" o "Apply" al final de la página
    • Espera unos segundos para que los cambios se propaguen

  7. Reinicia tu servidor de desarrollo:

    # Detén el servidor (Ctrl+C)
    rm -rf .next
    pnpm dev:webpack

  8. Prueba de nuevo:

    • Cierra sesión completamente
    • Abre una ventana de incógnito
    • Ve a http://localhost:3000/sign-in
    • Intenta iniciar sesión con un usuario de prueba

🔧 Script de Limpieza (Opcional)​

Puedes ejecutar este script para limpiar métodos de 2FA de usuarios individuales:

pnpm clerk:disable-2fa

Nota: Este script solo elimina métodos de 2FA de usuarios existentes, pero NO desactiva el requerimiento a nivel de aplicación. Debes hacerlo manualmente en el Dashboard.

📸 Ubicación en el Dashboard​

La configuración está en:

Dashboard → [Tu Aplicación] → Settings → User & Authentication

Secciones relevantes:​

  1. Multi-factor authentication

    • Opciones: Required / Optional / Disabled
    • Recomendado para desarrollo: Optional o Disabled

  2. Email, Phone, Username

    • Require email verification
    • Recomendado para desarrollo: Desactivado

⚠️ Importante para Producción​

NO desactives 2FA o verificación de email en producción. Estas son características de seguridad importantes. Solo desactívalas en tu instancia de desarrollo.

🐛 Si los Cambios No Funcionan​

  1. Espera 1-2 minutos: Los cambios pueden tardar en propagarse
  2. Limpia cookies del navegador: Las cookies antiguas pueden causar problemas
  3. Usa modo incógnito: Para evitar problemas con cache del navegador
  4. Verifica que estás en la aplicación correcta: Asegúrate de estar editando la aplicación de desarrollo, no producción

📝 Verificación​

Después de hacer los cambios, deberías poder:

  • ✅ Iniciar sesión sin código de verificación de email
  • ✅ Iniciar sesión sin código de 2FA
  • ✅ Acceder directamente al dashboard después de iniciar sesión