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
/verificationy/check-codese llama a los puntos finales. - Desactiva los datos de tu dispositivo y comprueba si
/nextse está llamando (fallback forzado). - Compruebe el
/callbackeventos.
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
Primeros pasos con la autenticación silenciosa
La Autenticación Silenciosa requiere un poco de comprensión. Este tutorial te muestra cómo construir una integración desde cero con Nodejs y Kotlin
Disponible en:
Pasos
1
Introducción2
Requisitos previos del backend3
Configurar el entorno4
Configura tus credenciales de Vonage5
Agrega la API Vonage Verify al backend6
Probar el backend7
Requisitos previos de la aplicación móvil8
Configurar el entorno9
Crear una aplicación Android básica10
Conectar con el backend11
Utiliza el Vonage Client SDK12
Configurar el entorno de pruebas13
Probar la aplicación