Advisor [Entwickler-Vorschau]

Die Funktion „Advisor“ analysiert die in einer Identity Insights-Anfrage angeforderten und/oder verfügbaren Insights und gibt darauf basierend Empfehlungen und Bewertungen aus.

Advisor basiert auf vier statischen Modellen, die für verschiedene Anwendungsfälle und Branchen gelten:

  • Synthetische Identität: Modell zur Bewertung des Risikos einer synthetischen Identität im Rahmen der Customer Journey.
  • Identitätsmissbrauch: Modell zur Bewertung des Risikos von Identitätsmissbrauch innerhalb einer Customer Journey.
  • Account-Übernahme: Modell zur Bewertung des Risikos einer Account-Übernahme im Rahmen der Customer Journey.
  • Kundenerlebnis: Ein Modell zur Bewertung von Signalen zum Kundenerlebnis im Rahmen der Customer Journey.

Diese Modelle zeichnen sich durch einen Grad an Komplexität und eine Vielfalt an Anwendungsfällen aus, die kurz- bis mittelfristig gut zu den derzeit in Identity Insights verfügbaren Signalen passen. Jedes Modell enthält eine Reihe empfohlener Insights, Signaldefinitionen auf der Grundlage von Attributwerten sowie Attributbereiche.

Wenn Sie die „Advisor Insight“-Informationen in die Anfrage aufnehmen, enthält die Antwort zusätzlich für jedes Modell folgende Angaben:

  • Empfohlene Insights: Array mit den für das Modell empfohlenen Insights.
  • Signale: Spezifische Attribute und die dazugehörigen Werte oder Wertebereiche, die zur Bewertung relevanter Aspekte einer Customer Journey herangezogen werden. Signale helfen bei der Einschätzung von Risiken, der Benutzererfahrung oder der Compliance, indem sie aussagekräftige Muster oder Anomalien in den von Identity Insights abgerufenen Daten hervorheben.
  • Kennzahlen:
    • completeness_ratio: Das Verhältnis der verfügbaren (nicht fehlenden) Insights zur Gesamtzahl der empfohlenen Insights, ausgedrückt als Wert zwischen 0 und 1.
    • positive_ratio: Anteil pro Beratungsart (ausgenommen MISSED_INSIGHT)
    • warning_ratio: Anteil pro Beratungsart (ausgenommen MISSED_INSIGHT)
    • negative_ratio: Anteil pro Beratungsart (ausgenommen MISSED_INSIGHT)
    • weighted_ratio: Gewichtete Quote für jede Beratungsart (ausgenommen MISSED_INSIGHT)
  • Tipps für Models:
    • completeness: Empfehlungen auf der Grundlage der completeness_ratio metrisch.
    • worst_case: Dieser Ratschlag ist der schlechteste aller verfügbaren Ratschläge
    • weighted: Bewerten Sie die relevanten Signale und geben Sie eine Gesamtempfehlung ab, wobei Sie positive, negative und fehlende Signale berücksichtigen.

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 dieser Anleitung wird erläutert, wie Sie das Advisor Insight-Programm programmgesteuert mit cURL nutzen können.

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 den „Advisor“- und den „SIM Swap“-Einblick, um zu überprüfen, ob in den letzten 240 Stunden ein SIM-Swap stattgefunden hat, und um die Analyse aus diesem Einblick abzurufen:

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "sim_swap": {
        "period": 240
      },
      "advisor": {}
    }
  }'

Die API analysiert anschließend die Antwort aus dem SIM-Swap-Insight, nimmt eine Bewertung vor und gibt auf dieser Grundlage Empfehlungen:

{
  "request_id":"c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights":{
    "sim_swap":{
      "latest_sim_swap_at":"2024-07-08T09:30:27.504Z",
      "is_swapped":true,
      "status":{
        "code":"OK",
        "message":"Success"
      }
    },
    "advisor":{
      "synthetic_identity":{
        "recommended_insights":[
          "format",
          "original_carrier"
        ],
        "signals":[
          {
            "attribute":"format",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor synthetic_identity model."
          },
          {
            "attribute":"original_carrier",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor synthetic_identity model."
          }
        ],
        "metrics":{
          "completeness_ratio":0,
          "positive_ratio":0,
          "warning_ratio":0,
          "negative_ratio":0,
          "weighted_ratio":0
        },
        "model_advice":{
          "completeness":"LOW",
          "worst_case":"WARNING",
          "weighted":"WARNING"
        }
      },
      "impersonation":{
        "recommended_insights":[
          "format",
          "original_carrier",
          "current_carrier",
          "subscriber_match"
        ],
        "signals":[
          {
            "attribute":"format",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor impersonation model."
          },
          {
            "attribute":"original_carrier",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor impersonation model."
          },
          {
            "attribute":"current_carrier",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor impersonation model."
          },
          {
            "attribute":"subscriber_match",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor impersonation model."
          }
        ],
        "metrics":{
          "completeness_ratio":0,
          "positive_ratio":0,
          "warning_ratio":0,
          "negative_ratio":0,
          "weighted_ratio":0
        },
        "model_advice":{
          "completeness":"LOW",
          "worst_case":"WARNING",
          "weighted":"WARNING"
        }
      },
      "account_take_over":{
        "recommended_insights":[
          "format",
          "sim_swap"
        ],
        "signals":[
          {
            "attribute":"format",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor account_take_over model."
          },
          {
            "attribute":"sim_swap",
            "advice":"NEGATIVE",
            "assessment":"A SIM swap represents a high risk of account takeover."
          }
        ],
        "metrics":{
          "completeness_ratio":0.5,
          "positive_ratio":0,
          "warning_ratio":0,
          "negative_ratio":1,
          "weighted_ratio":0
        },
        "model_advice":{
          "completeness":"MEDIUM",
          "worst_case":"NEGATIVE",
          "weighted":"NEGATIVE"
        }
      },
      "customer_experience":{
        "recommended_insights":[
          "format",
          "current_carrier"
        ],
        "signals":[
          {
            "attribute":"format",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor customer_experience model."
          },
          {
            "attribute":"current_carrier",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor customer_experience model."
          }
        ],
        "metrics":{
          "completeness_ratio":0,
          "positive_ratio":0,
          "warning_ratio":0,
          "negative_ratio":0,
          "weighted_ratio":0
        },
        "model_advice":{
          "completeness":"LOW",
          "worst_case":"WARNING",
          "weighted":"WARNING"
        }
      },
      "status":{
        "code":"OK",
        "message":"Success."
      }
    }
  }
}

Weitere Lektüre