Stille Authentifizierungs-Updates in Verify API

Wir führen wichtige Erweiterungen ein für Stille Authentifizierung in der Verify API. Diese Aktualisierungen sollen die Entwickler- und Testerfahrung verbessern und Ihnen mehr Kontrolle über die Authentifizierungsabläufe geben.

Hier erfahren Sie alles, was Sie wissen müssen, und welche Maßnahmen Sie ergreifen sollten, bevor 1. Mai 2026.

Neuer Parameter coverage_check

Eine der häufigsten Herausforderungen bei der stillen Authentifizierung ist der effiziente Umgang mit nicht unterstützten Netzwerken. Bisher erfolgte die Überprüfung der Netzabdeckung oft erst später im Datenfluss, was zu unnötigen Umleitungen führen konnte.

Wir haben uns Ihr Feedback zu Herzen genommen und verbessern es. Wir fügen einen neuen coverage_check booleschen Parameter für die Verify API.

Wie es funktioniert

coverage_check=true (Standard)

• Synchrone Validierung

• Wenn das Netzwerk unterstützt wird, prüft die API, ob die Vonage Application korrekt konfiguriert ist und die stille Authentifizierung aktiviert ist.

• Wenn alle Prüfungen erfolgreich sind, wird die check_url zurückgegeben

• Gibt sofort einen Fehler zurück, wenn das Netzwerk nicht unterstützt wird.

• Verhindert unnötige Umleitungsströme

coverage_check=false

• Asynchrones Verhalten

• Gibt immer eine check_url

• Ermöglicht Ihnen die Verwaltung der Netzwerkvalidierung auf Ihrer Seite

Wichtige Hinweise

• Wenn silent_auth der einzige Kanal ist, gibt ein nicht unterstütztes Netzwerk einen Fehler zurück.

• Wenn ein Failover-Kanal konfiguriert ist, fällt die Anfrage automatisch auf den nächsten Kanal zurück.

Netzwerkregistrierung für die Produktion erforderlich

Zur Verbesserung der Integration von Netzbetreibern und zur Verringerung fehlgeschlagener Authentifizierungsversuche, Netzwerk-Registrierung für Live-Anfragen zur stummen Authentifizierung obligatorisch werden.

So konfigurieren Sie es

Sie müssen den Netzwerk-Registrierungsprozess.

Der Assistent hilft Ihnen bei der Erstellung von Geschäfts- und Anwendungsprofilen. Ihr Anwendungsprofil muss ein Netzwerk-Anwendungsprofil in "Angenommen" Status haben (von den Mobilfunkbetreibern genehmigt) und mit Ihrer Vonage Application im Developer Dashboard verknüpft sein.

Sie können diese Schritte in Ihrem Vonage Entwickler Dashboard:

1. Öffnen Sie das Dashboard

2. Weiter zu Netzwerk-Register aus dem linken Menü

3. Schließen Sie die Registrierung ab

4. Aktivieren Sie die Netzwerkregistrierungsfunktion in Ihrem Vonage Applications Einstellungen

Nach der Fertigstellung ist Ihre Anwendung ordnungsgemäß für den Live-Datenverkehr mit Silent Authentication konfiguriert.

Was passiert dann nach dem 1. Mai?

Wenn eine Anfrage gestellt wird und das Netzanwendungsprofil noch nicht von den Mobilfunkbetreibern genehmigt wurde, wird ein Fehler zurückgegeben:

• Wenn coverage_check=truewird die Anfrage synchron mit einem 412-Fehler abgelehnt.

• Wenn coverage_check=falsewird der Fehler asynchron über einen Callback zurückgegeben.

Abschaffung des Sandbox-Parameters

Wir modernisieren auch die Art und Weise, wie Sie Silent Authentication testen.

Der sandbox Parameter wird nicht mehr verwendet. Künftig sollten Tests über den Netzwerk-Registrierungsspielplatz, durchgeführt werden, der Live-Verkehr in einer sicheren und kontrollierten Umgebung bietet.

The Playground bietet eine deutlich verbesserte Erfahrung für Entwickler:

• Live-Verkehr für unterstützte APIs und Länder mit bis zu 5 registrierten Telefonnummern.

• Unterstützung für virtuelle Betreiber zum Testen der API in Ländern, in denen noch keine API verfügbar ist.

Anstatt sich auf ein Anforderungskennzeichen zu verlassen, haben Sie jetzt eine realistischere und leistungsfähigere Testumgebung.

Die Umstellung auf den neuen Playground war noch nie so einfach:

• Entfernen Sie den sandbox Parameter aus Ihrer Verify API-Integration.

• Folgen Sie den Schritten, die in der Handbuch Network Registry Playground beschriebenen Schritte, um die Testumgebung in Ihrer Vonage Application zu aktivieren. Vergessen Sie nicht, eine neue dedizierte Applikation für die Playground-Nutzung zu erstellen. Eine einzelne Vonage-Applikation kann nicht sowohl Playground- als auch Produktionsverkehr unterstützen.

Was passiert nach dem 1. Mai? Die API wird sich wie folgt verhalten:

• Abfragen mit sandbox=true geben einen 422 Fehler Ungültige Params.

• Anfragen mit sandbox=false (oder ohne sandbox Parameter) werden weiterhin normal funktionieren (Parameter ignoriert).

Aktions-Checkliste

Das müssen Sie tun, bevor 1. Mai 2026:

Fürcoverage_check

• Überprüfen Sie Ihre aktuelle Integration

• Entscheiden Sie zwischen synchron (wahr) oder asynchron (false) Verhalten

• Aktualisieren Sie Ihre API-Aufrufe entsprechend

Für die Netzwerkregistrierung

• Überprüfen Sie, ob Ihr Netzwerk-Anwendungsprofil richtig verknüpft ist

Für die Veraltung der Sandbox

• Nicht mehr verwenden sandbox=true

• Umstellung der Tests auf den Network Registry Playground

• Sicherstellen, dass die Produktionsabläufe nicht auf den Sandbox-Parameter angewiesen sind

Stichtag: 1. Mai 2026

Zu diesem Datum:

• coverage_check verfügbar wird (Standard: true)

• Netzregistrierung wird für Live-Verkehr obligatorisch

• sandbox=true gibt einen 422-Fehler zurück. Verwenden Sie stattdessen den Network Registry Playground

Schlussfolgerung

Silent Authentication wird ständig weiterentwickelt, um zuverlässiger und berechenbarer zu werden und den Betrieb im großen Maßstab zu erleichtern. Diese Aktualisierungen spiegeln drei Hauptziele wider:

• Verbessern Sie die Erfahrung der Entwickler. Der coverage_check Parameter reduziert unnötige Umleitungen und gibt sofortiges Feedback über nicht unterstützte Netzwerke.

• Bessere Verwaltung der Netzabdeckung. Die obligatorische Registrierung sorgt für eine bessere Integration der Netzbetreiber und weniger Authentifizierungsfehler.

• Besser testen. Das Ersetzen von sandbox durch den Network Registry Playground erhalten Sie eine realistischere, robustere Testumgebung.