Standortüberprüfung

Der Einblick in die Standortverifizierung ermöglicht es Ihnen, den Standort eines Endgeräts innerhalb eines bestimmten Gebiets zu überprüfen. Es verwendet Techniken zur Positionierung im Mobilfunknetz, um das Gerät zu lokalisieren, was mehrere Vorteile gegenüber der GPS-Positionierung bietet, darunter:

  • Sicher und vertrauenswürdig: Die Positionierung über Mobilfunknetze verwendet Informationen direkt aus den Netzen der Mobilfunkbetreiber, wodurch das Risiko des GPS-Spoofing und der Umgehung über VPN ausgeschlossen wird.
  • Vereinfachte Integration: Identity Insights lässt sich problemlos in Ihre Applications integrieren, was die Komplexität und den Aufwand der Softwareentwicklung reduziert.

Einige Anwendungsfälle zur Betrugsprävention, bei denen die Standortüberprüfung nützlich ist:

  • Überprüfung der Benutzer im elektronischen Handel: E-Commerce- und Content-Plattformen stehen vor dem Problem, dass Nutzer Dienste, Inhalte und Lizenzen außerhalb der Region konsumieren, für die sie lizenziert wurden. Mit Location Verification können diese Plattformen überprüfen, ob sich der Standort eines Endnutzers innerhalb der für den Dienst, den Inhalt oder die Lizenz autorisierten Region befindet.
  • Überprüfung am Verkaufsort: Wenn ein Benutzer mit seiner Kredit-/Bankkarte einen Einkauf in einem Geschäft tätigt, möchte sein Finanzdienstleister manchmal überprüfen, ob diese Transaktion betrügerisch ist. Die Standortüberprüfung könnte mit der in der Bankanwendung eingegebenen Telefonnummer verwendet werden, um den Ort abzufragen, an dem die Transaktion eingeleitet wurde, um zu bestätigen, dass der Benutzer sich an diesem Ort befindet.
  • Standortbezogene Inhalte: Verifizieren Sie den Standort eines Nutzers bei Sportereignissen oder Konzerten, um das Erlebnis mit benutzerdefinierten Inhalten zu bereichern, z. B. mit Torwiederholungen, verschiedenen Blickwinkeln, nützlichen Informationen und vielem mehr.

Voraussetzungen

Um Identity Insights nutzen zu können, müssen Sie sicherstellen, dass Ihr Account korrekt konfiguriert ist; siehe die Erste Schritte Leitfaden für weitere Informationen über:

  • Erstellen Sie Ihren Account,
  • Erstellen einer Vonage-Anwendung zur Verwendung mit der Identity Insights API,
  • Die verschiedenen verfügbaren Umgebungen und wie Sie Ihren Account für deren Nutzung konfigurieren,
  • Und wie Sie die Dashboard-Einstiegs-UI verwenden, um die API zu nutzen, ohne Code zu schreiben.

In diesem Leitfaden wird erklärt, wie man den Location Verification Insight programmatisch mit cURL verwendet.

Die Identity Insights API ist über mehrere regionale Endpunkte verfügbar. Die Beispiele in diesem Leitfaden verwenden den EU-Endpunkt, aber Sie finden die vollständige Liste unter Technische Details.

Einen API-Aufruf tätigen

Die Authentifizierung für die Identity Insights API erfolgt über JWTs, ein kompaktes und in sich geschlossenes JSON-Token. Um ein JWT zu generieren, können Sie unser Online-Generatoroder verwenden Sie alternativ die Vonage CLI. Sie benötigen Ihre Anwendungs-ID und Ihren privaten Schlüssel, um das JWT zu erzeugen. Sobald Sie Ihr JWT haben, können Sie eine Anfrage an die API senden.

Dieses Beispiel zeigt eine cURL-Anfrage für die Standortüberprüfung, um zu prüfen, ob der Standort eines bestimmten Benutzergeräts innerhalb des angegebenen Gebiets liegt:

curl -X POST https://api-eu.vonage.com/v0.1/identity-insights \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "location_verification": {
         "location": {
            "type": "CIRCLE",
            "radius": 3000,
            "center": {
               "latitude": -90,
               "longitude": -180
                }
            }
          }
        }
    }'

Die API vergleicht dann die mit dem jeweiligen Mobiltelefonbenutzer verknüpften Informationen mit den gespeicherten (und überprüften) Informationen aus den Aufzeichnungen des Mobiltelefonbetreibers und gibt für jedes angegebene Attribut einen Übereinstimmungswert zurück:

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "location_verification": {
        "is_verified": "TRUE",
        "latest_location_at": "2024-07-08T09:30:27.504Z",
        "match_rate": 1,
        "status": {
          "code": "NO_COVERAGE",
          "message": "Success"
        }
    }
  }
}

Sie sehen die folgenden Felder im Fenster location_verification Array:

Feld Beschreibung
is_verified Ergebnis einer Überprüfungsanfrage:

TRUEWenn das Netz das Gerät innerhalb des angeforderten Bereichs lokalisiert.
FALSEwenn der angeforderte Bereich nicht mit dem Bereich übereinstimmt, in dem das Netz das Gerät lokalisiert.
UNKNOWN: wenn das Netz das Gerät nicht finden kann.
PARTIALwenn der angeforderte Bereich teilweise mit dem Bereich übereinstimmt, in dem das Netz das Gerät lokalisiert. A match_rate könnte in die Antwort aufgenommen werden.
latest_location_at Datum und Uhrzeit in UTC ISO 8601 des letzten Standortes.
match_rate Schätzung der Übereinstimmungsrate zwischen dem Bereich in der Anfrage (R) und dem Bereich, in dem das Netz das Gerät lokalisiert (N), berechnet als prozentualer Wert der Schnittmenge beider Bereiche geteilt durch den Netzbereich, d. h. (R ∩ N) / N * 100. Nur enthalten, wenn verifiziert ist PARTIAL.
status Gibt den Status der Informationen an, die für die angegebene Telefonnummer zurückgegeben werden.
code Code, der den Status der Anfrage angibt. Muss einer der folgenden sein:

NO_COVERAGE: Das Land oder das Mobilfunknetz wird von den verfügbaren Anbietern nicht unterstützt.
INVALID_PURPOSE: Der verwendete Zweck ist für diese Einsicht nicht gültig oder zulässig.
UNAUTHORIZED: Die Anfrage konnte für die Kombination aus Antrag, Lieferant und Telefonnummer nicht autorisiert werden.
INTERNAL_ERROR: Bei der Bearbeitung der Anfrage ist ein interner Fehler aufgetreten.
SUPPLIER_ERROR: Der Anbieter hat bei der Bearbeitung der Anfrage einen Fehler gemeldet.
NOT_FOUND: Die Rufnummer konnte für diese Einsicht nicht gefunden werden.
INVALID_NUMBER_FORMAT: Das Format der Telefonnummern ist für die Zuweisung durch die Netzbetreiber an die Benutzer nicht gültig.
PARTIAL_SUCCESS: Einige Antwortattribute wurden weggelassen, weil sie nicht anwendbar oder nicht verfügbar waren.
OK: Alle Insight-Attribute sind verfügbar und in der Antwort enthalten.
message Ausführlichere Statusbeschreibung.

Weitere Lektüre