Guía para Desarrolladores: Integrando Didit con Pila de Observabilidad Modernas (ES)

Integración sin Esfuerzo Las API limpias y el diseño enfocado en el desarrollador de Didit permiten una integración sencilla con herramientas de observabilidad líderes como Grafana, Loki y Tempo.

Monitoreo Mejorado Al instrumentar los procesos de verificación de identidad de Didit, los desarrolladores pueden obtener visibilidad en tiempo real del estado de las sesiones, tasas de éxito y posibles cuellos de botella.

Depuración Proactiva Aprovecha el rastreo distribuido con Tempo para identificar problemas dentro de flujos de trabajo de identidad complejos, asegurando una resolución rápida y un impacto mínimo para el usuario.

Rendimiento Optimizado La arquitectura modular y nativa de IA de Didit, combinada con una observabilidad robusta, ayuda a optimizar el rendimiento y la fiabilidad de tus servicios de verificación de identidad, todo mientras ofrece KYC Básico Gratuito.

La Criticidad de la Observabilidad en la Verificación de Identidad

En el panorama digital actual, la verificación de identidad ya no es una simple casilla de verificación; es un pilar fundamental de confianza y seguridad. A medida que las empresas escalan y las interacciones de los usuarios se vuelven más complejas, los procesos subyacentes de verificación de identidad deben ser robustos, fiables y transparentes. Aquí es donde entran en juego las pilas de observabilidad modernas. Herramientas como Grafana para visualización, Loki para registros y Tempo para rastreos proporcionan una visión integral de la salud y el rendimiento de tus aplicaciones. Integrar estas con tu plataforma de verificación de identidad, como Didit, es primordial para el monitoreo proactivo, la depuración rápida y la garantía de una experiencia de usuario fluida.

Sin una observabilidad adecuada, problemas como fallas en la verificación, desafíos en la detección de vida o procesos lentos de verificación de identidad pueden pasar desapercibidos, lo que lleva a usuarios frustrados, riesgos de cumplimiento y posible fraude. Al instrumentar las API de Didit, los desarrolladores pueden transformar datos de verificación brutos en información procesable, facilitando la identificación de tendencias, el diagnóstico de problemas y la mejora continua de sus flujos de trabajo de identidad.

Instrumentación de Sesiones Didit con Registros (Loki) y Métricas (Grafana)

El enfoque API-first de Didit hace que sea increíblemente sencillo integrar la recopilación de registros y métricas en tus flujos de trabajo de verificación de identidad. Cuando creas una sesión de verificación utilizando la API de Didit, recibes un session_id y un status. Estos son puntos de datos cruciales para la observabilidad.

Registros con Loki

Para cada llamada a la API de Didit, especialmente al crear una sesión o recibir un webhook, debes registrar los detalles relevantes. Loki es una excelente opción para esto debido a su indexación basada en etiquetas, lo que lo hace eficiente para consultas. Así es como podrías abordarlo:

// Pseudocódigo para registrar la creación de una sesión
const diditResponse = await didit.createSession({
  workflow_id: 'tu-id-de-flujo-de-trabajo',
  callback: 'https://tuapp.com/verificacion-completa',
  vendor_data: 'usuario-123'
});

logger.info('Sesión Didit creada', {
  session_id: diditResponse.session_id,
  workflow_id: diditResponse.workflow_id,
  status: diditResponse.status,
  vendor_data: diditResponse.vendor_data,
  service: 'servicio-de-verificacion-de-identidad',
  component: 'integracion-api-didit'
});

Cuando Didit envía webhooks notificándote sobre actualizaciones de sesión (por ejemplo, cambios de estado, verificación exitosa o fallas), registra estos eventos con detalles similares. Esto te permite buscar en Loki todos los registros relacionados con un session_id o vendor_data específico para comprender el ciclo de vida completo de un intento de verificación. Por ejemplo, si un usuario experimenta un problema con la Verificación de Identidad de Didit que falla, puedes filtrar rápidamente los registros para ver los cambios de estado exactos y cualquier mensaje de error.

Métricas con Grafana

Para un análisis cuantitativo, exponga métricas de su aplicación que interactúen con Didit. Las métricas comunes incluyen:

• didit_session_created_total: Contador para el total de sesiones iniciadas.
• didit_session_status_total{status="success"}: Contador para verificaciones exitosas.
• didit_session_status_total{status="failed"}: Contador para verificaciones fallidas.
• didit_session_duration_seconds: Histograma o resumen del tiempo transcurrido desde la creación hasta la finalización de la sesión.
• didit_api_request_duration_seconds: Histograma para los tiempos de respuesta de la API.

Estas métricas, expuestas a través de Prometheus y visualizadas en Grafana, proporcionan paneles que muestran la salud y el rendimiento general de tu sistema de verificación de identidad. Puedes configurar alertas para caídas repentinas en las tasas de éxito o aumentos en la latencia, lo que indica posibles problemas con la Detección de Vida de Didit u otros componentes.

Rastreo Distribuido para Flujos de Trabajo Complejos (Tempo)

Las aplicaciones modernas a menudo involucran múltiples microservicios que se comunican para completar una única solicitud de usuario. La verificación de identidad no es una excepción, especialmente al orquestar varias comprobaciones como la Detección de AML, la Prueba de Dirección y la Verificación de Teléfono y Correo Electrónico. El rastreo distribuido, impulsado por herramientas como Tempo, se vuelve indispensable aquí.

Cuando un usuario inicia un flujo de verificación de identidad, puedes iniciar un nuevo rastreo. A medida que tu aplicación realiza llamadas a la API de Didit, y a medida que los webhooks de Didit activan acciones subsiguientes en tu sistema, debes propagar los contextos de rastreo (por ejemplo, IDs de rastreo de OpenTelemetry). Esto te permite ver el viaje completo de una solicitud de verificación a través de todos los servicios involucrados, desde la iniciación del frontend hasta la decisión final de verificación.

// Pseudocódigo para usar OpenTelemetry con la llamada a la API de Didit
import { trace } from '@opentelemetry/api';

const tracer = trace.getTracer('mi-app-integracion-didit');

async function verifyUser(userData) {
  const span = tracer.startSpan('didit.createSession');
  try {
    // Añadir atributos relevantes al span
    span.setAttribute('user.id', userData.id);
    span.setAttribute('workflow.id', 'tu-id-de-flujo-de-trabajo');

    const diditResponse = await didit.createSession({
      workflow_id: 'tu-id-de-flujo-de-trabajo',
      callback: 'https://tuapp.com/verificacion-completa',
      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();
  }
}

Si un usuario informa un problema con su proceso de Estimación de Edad o Verificación NFC, puedes usar el ID de usuario o el ID de sesión para buscar en Tempo. El rastreo te mostrará exactamente qué servicio o llamada a la API externa (como la API de Didit) introdujo latencia o falló, proporcionando información invaluable para la depuración y la optimización del rendimiento.

Cómo Ayuda Didit

Didit está diseñado desde cero para ser primero para desarrolladores, haciendo que la integración con pilas de observabilidad modernas no solo sea posible, sino perfecta. Nuestra arquitectura modular te permite conectar y usar verificaciones de identidad, cada una de las cuales puede ser instrumentada individualmente para un monitoreo superior. La plataforma nativa de IA de Didit asegura que los procesos centrales como la Verificación de Identidad, la Detección de Vida Pasiva y Activa, y la Coincidencia Facial 1:1 y la Búsqueda Facial sean de alto rendimiento y fiables, y nuestro robusto diseño de API proporciona puntos de entrada y salida claros para tus datos de observabilidad.

Ofrecemos KYC Básico Gratuito, eliminando las barreras financieras para comenzar con la verificación de identidad esencial. Nuestra plataforma genera datos de identidad estructurados, lo cual es ideal para alimentar tus sistemas de registro y métricas. Ya sea que estés rastreando la tasa de éxito de la Estimación de Edad de Didit para cumplimiento o monitoreando el rendimiento de nuestra Verificación NFC para aplicaciones de alta seguridad, Didit proporciona la transparencia que necesitas. No hay tarifas de configuración, y nuestro modelo de pago por verificación exitosa asegura que solo pagues por lo que usas, lo que facilita escalar tus esfuerzos de observabilidad junto con el crecimiento de tu negocio.

¿Listo para empezar?

¿Listo para ver Didit en acción? Obtén una demostración gratuita hoy.

Comienza a verificar identidades gratis con el plan gratuito de Didit.