Mises à jour de l'authentification silencieuse dans Verify API

Nous apportons d'importantes améliorations à Authentification silencieuse dans l Verify API. Ces mises à jour sont conçues pour améliorer l'expérience des développeurs et des tests et pour vous donner plus de contrôle sur les flux d'authentification.

Voici tout ce qu'il faut savoir et les mesures à prendre avant de se lancer dans l'aventure 1er mai 2026.

Nouveau paramètre coverage_check

L'un des défis les plus courants de l'authentification silencieuse est la gestion efficace des réseaux non pris en charge. Auparavant, la validation de la couverture intervenait souvent à un stade ultérieur du flux, ce qui pouvait entraîner des redirections inutiles.

Nous avons écouté vos commentaires et nous les améliorons. Nous ajoutons un nouveau paramètre coverage_check à l'API Verify API.

Comment ça marche

coverage_check=true (par défaut)

• Validation synchrone

• Si le réseau est pris en charge, l'API vérifie que l'application Vonage est correctement configurée avec l'authentification silencieuse activée

• Si tous les contrôles sont réussis, l'adresse check_url est renvoyée

• Renvoie une erreur immédiate si le réseau n'est pas pris en charge.

• Empêche les flux de redirection inutiles

coverage_check=false

• Comportement asynchrone

• Renvoie toujours un check_url

• Vous permet de gérer la validation du réseau de votre côté

Remarques importantes

• Si silent_auth est le seul canal, un réseau non pris en charge renvoie une erreur.

• Si un canal de basculement est configuré, la demande passe automatiquement au canal suivant.

Enregistrement du réseau requis pour la production

Pour améliorer l'intégration des opérateurs et réduire les tentatives d'authentification infructueuses, l'enregistrement du réseau devient obligatoire pour les demandes d'authentification silencieuse en direct.

Comment le configurer

Vous devez compléter le processus de processus d'enregistrement du réseau.

L'assistant vous aidera à créer les profils d'entreprise et d'application. Votre profil d'application doit avoir un profil d'application réseau en "accepté (approuvé par les opérateurs mobiles) et être lié à votre Applications Vonage dans le tableau de bord du développeur.

Vous pouvez effectuer ces étapes dans votre tableau de bord du développeur Vonage:

1. Ouvrir le tableau de bord

2. Aller à Registre du réseau dans le menu de gauche

3. Compléter la procédure d'inscription

4. Activez la capacité du Registre du réseau dans votre Vonage Applications de Vonage

Une fois cette opération terminée, votre application sera correctement configurée pour le trafic d'authentification silencieuse en direct.

Que se passera-t-il après le 1er mai ?

Si une demande est faite et que le profil d'application réseau n'a pas encore été approuvé par les opérateurs mobiles, une erreur sera renvoyée :

• Lorsque la demande est rejetée, la demande est rejetée de manière synchrone avec une erreur 412. coverage_check=truela demande est rejetée de manière synchrone avec une erreur 412.

• Lorsque coverage_check=falsel'erreur est renvoyée de manière asynchrone par le biais d'un rappel.

Dépréciation du paramètre "bac à sable" (sandbox)

Nous modernisons également la façon dont vous testez l'authentification silencieuse.

Le paramètre sandbox est supprimé. À l'avenir, les tests devront être effectués via le aire de jeu du registre du réseau, qui fournit du trafic en direct dans un environnement sûr et contrôlé.

Le terrain de jeu offre aux développeurs une expérience nettement améliorée :

• Trafic en direct pour les API et les pays pris en charge jusqu'à 5 numéros de téléphone enregistrés.

• Aide aux opérateurs virtuels pour tester l'API dans les pays où elle n'est pas encore disponible.

Plutôt que de vous fier à un indicateur de demande, vous disposez désormais d'un environnement de test plus réaliste et plus puissant.

La migration vers le nouveau terrain de jeux n'a jamais été aussi simple :

• Supprimez le paramètre sandbox de votre intégration à l'API Verify.

• Suivez les étapes décrites dans le guide Guide de l'aire de jeu du registre du réseau pour activer l'environnement de test dans votre Applications Vonage. N'oubliez pas de créer une nouvelle Application dédiée à l'utilisation de l'aire de jeu. Une seule Application Vonage ne peut pas prendre en charge à la fois le trafic de l'aire de jeu et le trafic de production.

Que se passera-t-il après le 1er mai ? L'API se comportera comme suit :

• Les demandes avec sandbox=true renverront une erreur 422 Paramètres non valides.

• Demandes avec sandbox=false (ou sans sandbox continueront à fonctionner normalement (paramètre ignoré).

Liste de contrôle des actions

Voici ce que vous devez faire avant le 1er mai 2026:

Pourcoverage_check

• Examinez votre intégration actuelle

• Décider entre le mode synchrone (vrai) ou asynchrone (faux)

• Mettez à jour vos appels API en conséquence

Pour l'enregistrement du réseau

• Confirmez que votre profil d'application du réseau est correctement lié.

Pour la déchéance de l'écrin de sable

• Cessez d'utiliser sandbox=true

• Migrer les tests vers le terrain de jeu du registre du réseau

• Veiller à ce que les flux de production ne reposent pas sur le paramètre "bac à sable".

Date clé : 1er mai 2026

A cette date :

• coverage_check devient disponible (par défaut : true)

• L'enregistrement du réseau devient obligatoire pour le trafic en direct

• sandbox=true renverra une erreur 422. Utilisez plutôt le Network Registry Playground

Conclusion

Silent Authentication continue d'évoluer, devenant plus fiable, plus prévisible et plus facile à mettre en œuvre à grande échelle. Ces mises à jour reflètent trois objectifs clés :

• Améliorer l'expérience des développeurs. Le paramètre coverage_check réduit les redirections inutiles et fournit un retour d'information immédiat sur les réseaux non pris en charge.

• Meilleure gestion de la couverture du réseau. L'enregistrement obligatoire garantit une meilleure intégration des opérateurs et une réduction des échecs d'authentification.

• De meilleurs tests. En remplaçant sandbox par le Network Registry Playground, vous disposez d'un environnement de test plus réaliste et plus robuste.