Actualizaciones de autenticación silenciosa en Verify API

Estamos introduciendo importantes mejoras en Autenticación silenciosa en la Verify API. Estas actualizaciones están diseñadas para mejorar la experiencia de los desarrolladores y de las pruebas y ofrecerle un mayor control sobre los flujos de autenticación.

Esto es todo lo que necesita saber y qué medidas tomar antes de que se produzca la crisis. 1 de mayo de 2026.

Nuevo parámetro coverage_check

Uno de los retos más comunes de la autenticación silenciosa es la gestión eficaz de las redes no compatibles. Antes, la validación de la cobertura solía producirse más adelante en el flujo, lo que podía provocar redireccionamientos innecesarios.

Hemos escuchado sus comentarios y los estamos mejorando. Vamos a añadir un nuevo parámetro coverage_check booleano a la Verify API.

Cómo funciona

coverage_check=true (por defecto)

• Validación sincrónica

• Si la red es compatible, la API verifica que la aplicación de Vonage esté configurada correctamente con la autenticación silenciosa habilitada.

• Si se superan todas las comprobaciones, la URL_comprobación se devuelve

• Devuelve un error inmediato si la red no es compatible

• Evita redireccionamientos innecesarios

coverage_check=false

• Comportamiento asíncrono

• Devuelve siempre un check_url

• Le permite gestionar la validación de la red por su cuenta

Notas importantes

• Si silent_auth es el único canal, una red no soportada devuelve un error.

• Si se configura un canal de conmutación por error, la solicitud pasa automáticamente al canal siguiente.

Registro de red necesario para la producción

Para mejorar las integraciones de las operadoras y reducir los intentos fallidos de autenticación, registro en red se está convirtiendo en obligatorio para las solicitudes de autenticación silenciosa en directo.

Cómo configurarlo

Debe completar el Registro de red.

El asistente le ayudará a crear los Perfiles de Empresa y de Aplicaciones. Su Perfil de Aplicación debe tener un Perfil de Aplicación de Red en "Aceptado" (aprobado por los operadores móviles) y estar vinculado a tu aplicación de Vonage en el panel del desarrollador.

Puedes completar estos pasos en tu panel de desarrollador de Vonage:

1. Abrir el cuadro de mandos

2. Ir a Registro de red en el menú de la izquierda

3. Completar el proceso de registro

4. Habilita la función de registro de red en tu Vonage Aplicaciones de Vonage

Una vez completado, su aplicación estará correctamente configurada para el tráfico de Autenticación Silenciosa en tiempo real.

Entonces, ¿qué pasará después del 1 de mayo?

Si se realiza una solicitud y el perfil de aplicación de red aún no ha sido aprobado por los operadores móviles, se devolverá un error:

• Cuando coverage_check=truela solicitud se rechaza de forma sincrónica con un error 412.

• Cuando coverage_check=falseel error se devuelve de forma asíncrona mediante una llamada de retorno.

Supresión de la caja de arena Parámetro

También estamos modernizando la forma de probar la autenticación silenciosa.

El parámetro sandbox se retira. A partir de ahora, las pruebas deberán realizarse a través del Área de juegos del registro de red, que proporciona tráfico en directo en un entorno seguro y controlado.

Playground ofrece una experiencia de desarrollo significativamente mejorada:

• Tráfico en directo para APIs y países compatibles hasta 5 números de teléfono registrados.

• Soporte de operador virtual para probar la API en aquellos países en los que aún no está disponible.

En lugar de depender de un indicador de solicitud, ahora dispone de un entorno de pruebas más realista y potente.

Migrar al nuevo Playground nunca ha sido tan fácil:

• Elimine el parámetro sandbox de su integración Verify API.

• Siga los pasos descritos en la Guía de Network Registry Playground para habilitar el entorno de prueba en tu aplicación de Vonage. No olvides crear una nueva aplicación dedicada para el uso de Playground. Una sola aplicación de Vonage no puede admitir tráfico de Playground y de producción.

¿Qué ocurrirá después del 1 de mayo? La API se comportará de la siguiente manera:

• Las solicitudes con sandbox=true devolverán un error error 422 Parámetros no válidos.

• Solicitudes con sandbox=false (o sin parámetro sandbox parámetro) seguirán funcionando normalmente (parámetro ignorado).

Lista de control

Esto es lo que debe hacer antes 1 de mayo de 2026:

Paracoverage_check

• Revise su integración actual

• Decidir entre síncrono (verdadero) o asíncrono (falso)

• Actualice sus llamadas a la API en consecuencia

Para el registro en la red

• Confirme que su perfil de aplicación de red está correctamente vinculado

Para Sandbox Deprecation

• Deje de utilizar sandbox=true

• Migración de las pruebas a Network Registry Playground

• Asegúrese de que los flujos de trabajo de producción no dependan del parámetro de sandbox

Fecha clave: 1 de mayo de 2026

En esta fecha:

• coverage_check esté disponible (por defecto: true)

• El registro en la red pasa a ser obligatorio para el tráfico en directo

• sandbox=true devolverá un error 422. Utilice en su lugar Network Registry Playground

Conclusión

La autenticación silenciosa sigue evolucionando, haciéndose más fiable, más predecible y más fácil de utilizar a gran escala. Estas actualizaciones reflejan tres objetivos clave:

• Mejorar la experiencia de los desarrolladores. El parámetro coverage_check reduce las redirecciones innecesarias y proporciona información inmediata sobre las redes no compatibles.

• Mejor gestión de la cobertura de red. El registro obligatorio garantiza una mejor integración con los operadores y menos fallos de autenticación.

• Mejores pruebas. La sustitución de sandbox por Network Registry Playground le proporciona un entorno de pruebas más realista y robusto.