Node.js

Probar la aplicación

La autenticación silenciosa se valida mejor en un dispositivo real con una SIM + datos móviles. Tenga en cuenta las siguientes consideraciones:

  • A menudo, el emulador no puede proporcionar el contexto de operador/red que necesita la Autenticación Silenciosa.
  • Si realizas las pruebas en un emulador, es probable que tengas que recurrir a SMS con frecuencia.
  • La autenticación silenciosa suele requerir datos móviles. Si solo dispones de Wi-Fi, puede fallar (precisamente por eso implementamos una ruta alternativa inmediata).
  • Incluso en dispositivos reales, la autenticación silenciosa puede no estar disponible para todos los números/operadores. Tu aplicación debe tratar el retorno a SMS como algo normal, no excepcional.

Qué verificar al probar el proyecto

En la aplicación, comprueba que el mensaje de estado lo indica:

  • Verificado mediante autenticación silenciosa
  • O Verified via SMS

Comprueba los registros de backend:

  • Confirme que el /verification y /check-code se llama a los puntos finales.
  • Desactiva los datos de tu dispositivo y comprueba si /next se está llamando (fallback forzado).
  • Compruebe el /callback eventos.

Al final de la prueba, debería poder confirmarlo:

  • El backend puede crear solicitudes de verificación
  • La aplicación para Android puede:
    • verificación de inicio
    • gestionar la autenticación silenciosa cuando esté disponible
    • retroceder limpiamente a SMS cuando sea necesario
  • Los usuarios pueden completar la verificación sin entender qué es la Autenticación Silenciosa

Problemas comunes y cómo depurarlos

App Stuck Loading

  • Backend inaccesible
  • URL de backend incorrecta
  • Falta android.permission.INTERNET

La autenticación silenciosa nunca funciona

  • Pruebas en un emulador. Asegúrese de utilizar un dispositivo real
  • Dispositivo sólo con Wi-Fi
  • El operador no admite la autenticación silenciosa

Los SMS nunca llegan

  • Formato de teléfono incorrecto (debe ser E.164)
  • Fallback forzado no llamado
  • Límites de tarifa o intentos anteriores aún activos

/next Fracasa

  • Esto no es fatal. En el peor de los casos, la aplicación espera a que se agote el tiempo de espera (por defecto es de 20 segundos).
  • Verify continúa y finalmente retrocederá automáticamente
  • La aplicación debería seguir mostrando la entrada de SMS

¿Y ahora qué?

Ahora tienes un flujo 2FA completo y comprobable con Autenticación Silenciosa y fallback a SMS. Podemos elevar nuestro diseño al siguiente nivel:

  • almacenamiento persistente (Redis/Postgres)
  • limitación de tarifas y prevención de abusos
  • sondeo o actualizaciones de estado en tiempo real
  • despliegue de producción