Entwicklerleitfaden zur Integration von Didit in moderne Beobachtbarkeits-Stacks (DE)

Nahtlose IntegrationDidits klare APIs und das entwicklerorientierte Design ermöglichen eine unkomplizierte Integration mit führenden Observability-Tools wie Grafana, Loki und Tempo.

Verbesserte ÜberwachungDurch die Instrumentierung der Identitätsverifizierungsprozesse von Didit erhalten Entwickler Echtzeit-Einblicke in den Sitzungsstatus, Erfolgsquoten und potenzielle Engpässe.

Proaktives DebuggingNutzen Sie Distributed Tracing mit Tempo, um Probleme in komplexen Identitäts-Workflows zu lokalisieren und eine schnelle Lösung mit minimalen Auswirkungen auf den Benutzer zu gewährleisten.

Optimierte LeistungDidits modulare und KI-native Architektur, kombiniert mit robuster Observability, hilft, die Leistung und Zuverlässigkeit Ihrer Identitätsverifizierungsdienste zu optimieren, und bietet dabei kostenloses Core KYC.

Die Bedeutung der Beobachtbarkeit bei der Identitätsprüfung

In der heutigen digitalen Landschaft ist die Identitätsprüfung nicht mehr nur ein Kontrollkästchen; sie ist eine grundlegende Säule des Vertrauens und der Sicherheit. Wenn Unternehmen wachsen und Benutzerinteraktionen komplexer werden, müssen die zugrunde liegenden Identitätsverifizierungsprozesse robust, zuverlässig und transparent sein. Hier kommen moderne Beobachtbarkeits-Stacks ins Spiel. Tools wie Grafana für die Visualisierung, Loki für Logs und Tempo für Traces bieten einen umfassenden Überblick über den Zustand und die Leistung Ihrer Anwendungen. Die Integration dieser Tools mit Ihrer Identitätsverifizierungsplattform, wie Didit, ist entscheidend für proaktive Überwachung, schnelle Fehlerbehebung und die Gewährleistung einer nahtlosen Benutzererfahrung.

Ohne eine angemessene Beobachtbarkeit können Probleme wie Verifizierungsfehler, Herausforderungen bei der Lebenderkennung oder langsame ID-Verifizierungsprozesse unbemerkt bleiben, was zu frustrierten Benutzern, Compliance-Risiken und potenziellem Betrug führen kann. Durch die Instrumentierung der Didit-APIs können Entwickler Rohdaten der Verifizierung in umsetzbare Erkenntnisse umwandeln, wodurch es einfacher wird, Trends zu erkennen, Probleme zu diagnostizieren und ihre Identitäts-Workflows kontinuierlich zu verbessern.

Instrumentierung von Didit-Sitzungen mit Logs (Loki) und Metriken (Grafana)

Didits API-First-Ansatz macht die Integration von Logging und Metrikenerfassung in Ihre Identitätsverifizierungs-Workflows unglaublich einfach. Wenn Sie eine Verifizierungssitzung mit Didits API erstellen, erhalten Sie eine session_id und einen status. Dies sind entscheidende Datenpunkte für die Beobachtbarkeit.

Logging mit Loki

Für jeden Aufruf der Didit-API, insbesondere beim Erstellen einer Sitzung oder beim Empfangen eines Webhooks, sollten Sie relevante Details protokollieren. Loki ist aufgrund seiner labelbasierten Indizierung, die eine effiziente Abfrage ermöglicht, eine ausgezeichnete Wahl dafür. So könnten Sie vorgehen:

// Pseudocode für das Logging einer Sitzungserstellung
const diditResponse = await didit.createSession({
  workflow_id: 'your-workflow-id',
  callback: 'https://yourapp.com/verification-complete',
  vendor_data: 'user-123'
});

logger.info('Didit-Sitzung erstellt', {
  session_id: diditResponse.session_id,
  workflow_id: diditResponse.workflow_id,
  status: diditResponse.status,
  vendor_data: diditResponse.vendor_data,
  service: 'identity-verification-service',
  component: 'didit-api-integration'
});

Wenn Didit Webhooks sendet, die Sie über Sitzungsaktualisierungen (z. B. Statusänderungen, erfolgreiche Verifizierung oder Fehler) informieren, protokollieren Sie diese Ereignisse mit ähnlichen Details. Dies ermöglicht Ihnen, Loki nach allen Logs zu durchsuchen, die sich auf eine bestimmte session_id oder vendor_data beziehen, um den gesamten Lebenszyklus eines Verifizierungsversuchs zu verstehen. Wenn beispielsweise ein Benutzer ein Problem mit der fehlgeschlagenen Didit-ID-Verifizierung hat, können Sie schnell Logs filtern, um die genauen Statusänderungen und Fehlermeldungen zu sehen.

Metriken mit Grafana

Für die quantitative Analyse stellen Sie Metriken aus Ihrer Anwendung bereit, die mit Didit interagieren. Häufige Metriken umfassen:

• didit_session_created_total: Zähler für die insgesamt initiierten Sitzungen.
• didit_session_status_total{status="success"}: Zähler für erfolgreiche Verifizierungen.
• didit_session_status_total{status="failed"}: Zähler für fehlgeschlagene Verifizierungen.
• didit_session_duration_seconds: Histogramm oder Zusammenfassung für die Zeit von der Sitzungserstellung bis zum Abschluss.
• didit_api_request_duration_seconds: Histogramm für API-Antwortzeiten.

Diese Metriken, die über Prometheus bereitgestellt und in Grafana visualisiert werden, bieten Dashboards, die den allgemeinen Zustand und die Leistung Ihres Identitätsverifizierungssystems anzeigen. Sie können Warnungen für plötzliche Rückgänge der Erfolgsquoten oder Anstiege der Latenz einrichten, die auf potenzielle Probleme mit Didits Lebenderkennung oder anderen Komponenten hinweisen.

Verteiltes Tracing für komplexe Workflows (Tempo)

Moderne Anwendungen umfassen oft mehrere Microservices, die kommunizieren, um eine einzelne Benutzeranfrage abzuschließen. Die Identitätsprüfung ist keine Ausnahme, insbesondere wenn verschiedene Prüfungen wie AML-Screening, Adressnachweis und Telefon- & E-Mail-Verifizierung orchestriert werden. Verteiltes Tracing, unterstützt durch Tools wie Tempo, wird hier unverzichtbar.

Wenn ein Benutzer einen Identitätsverifizierungs-Workflow initiiert, können Sie einen neuen Trace starten. Während Ihre Anwendung Aufrufe an Didits API tätigt und Didits Webhooks nachfolgende Aktionen in Ihrem System auslösen, sollten Sie Trace-Kontexte (z. B. OpenTelemetry Trace IDs) weitergeben. Dies ermöglicht es Ihnen, den gesamten Weg einer Verifizierungsanfrage über alle beteiligten Dienste hinweg zu sehen, von der Frontend-Initiierung bis zur endgültigen Verifizierungsentscheidung.

// Pseudocode für die Verwendung von OpenTelemetry mit Didit API-Aufruf
import { trace } from '@opentelemetry/api';

const tracer = trace.getTracer('my-app-didit-integration');

async function verifyUser(userData) {
  const span = tracer.startSpan('didit.createSession');
  try {
    // Relevante Attribute zum Span hinzufügen
    span.setAttribute('user.id', userData.id);
    span.setAttribute('workflow.id', 'your-workflow-id');

    const diditResponse = await didit.createSession({
      workflow_id: 'your-workflow-id',
      callback: 'https://yourapp.com/verification-complete',
      vendor_data: userData.id
    });

    span.setAttribute('didit.session_id', diditResponse.session_id);
    span.setAttribute('didit.status', diditResponse.status);
    span.setStatus({ code: SpanStatusCode.OK });
    return diditResponse;
  } catch (error) {
    span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
    span.recordException(error);
    throw error;
  } finally {
    span.end();
  }
}

Wenn ein Benutzer ein Problem mit seiner Alterschätzung oder dem NFC-Verifizierungsprozess meldet, können Sie die Benutzer-ID oder Sitzungs-ID verwenden, um Tempo zu durchsuchen. Der Trace zeigt Ihnen genau, welcher Dienst oder externe API-Aufruf (wie die Didit-API) Latenz verursacht oder fehlgeschlagen ist, und liefert unschätzbare Einblicke für Debugging und Leistungsoptimierung.

Wie Didit hilft

Didit wurde von Grund auf als entwicklerorientierte Lösung konzipiert, was die Integration in moderne Beobachtbarkeits-Stacks nicht nur möglich, sondern nahtlos macht. Unsere modulare Architektur ermöglicht es Ihnen, Identitätsprüfungen "plug-and-play" zu verwenden, wobei jede einzeln für eine überlegene Überwachung instrumentiert werden kann. Didits KI-native Plattform stellt sicher, dass Kernprozesse wie ID-Verifizierung, passive & aktive Lebenderkennung und 1:1 Gesichtsabgleich & Gesichtssuche hochperformant und zuverlässig sind, und unser robustes API-Design bietet klare Ein- und Ausgangspunkte für Ihre Observability-Daten.

Wir bieten kostenloses Core KYC an, wodurch finanzielle Barrieren für den Einstieg in die wesentliche Identitätsprüfung beseitigt werden. Unsere Plattform generiert strukturierte Identitätsdaten, die sich ideal für die Einspeisung in Ihre Logging- und Metrikensysteme eignen. Ob Sie die Erfolgsquote von Didits Alterschätzung für die Compliance verfolgen oder die Leistung unserer NFC-Verifizierung für Hochsicherheitsanwendungen überwachen, Didit bietet die Transparenz, die Sie benötigen. Es gibt keine Einrichtungsgebühren, und unser Pay-per-erfolgreiche-Prüfung-Modell stellt sicher, dass Sie nur für das bezahlen, was Sie nutzen, was es einfach macht, Ihre Beobachtbarkeitsbemühungen mit Ihrem Geschäftswachstum zu skalieren.

Bereit zum Start?

Möchten Sie Didit in Aktion sehen? Fordern Sie noch heute eine kostenlose Demo an.

Beginnen Sie kostenlos mit der Identitätsprüfung mit Didits kostenlosem Tarif.