Guia do Desenvolvedor para Integrar Didit com Stacks de Observabilidade Modernas (PT-BR)

Integração PerfeitaAs APIs claras e o design focado no desenvolvedor da Didit permitem uma integração direta com ferramentas de observabilidade líderes como Grafana, Loki e Tempo.

Monitoramento AprimoradoAo instrumentar os processos de verificação de identidade da Didit, os desenvolvedores podem obter visibilidade em tempo real sobre o status das sessões, taxas de sucesso e possíveis gargalos.

Depuração ProativaUtilize o rastreamento distribuído com o Tempo para identificar problemas em fluxos de trabalho de identidade complexos, garantindo resolução rápida e impacto mínimo no usuário.

Desempenho OtimizadoA arquitetura modular e nativa de IA da Didit, combinada com uma observabilidade robusta, ajuda a otimizar o desempenho e a confiabilidade dos seus serviços de verificação de identidade, tudo isso com KYC Essencial Gratuito.

A Criticalidade da Observabilidade na Verificação de Identidade

No cenário digital atual, a verificação de identidade não é mais uma mera formalidade; é um pilar fundamental de confiança e segurança. À medida que as empresas crescem e as interações do usuário se tornam mais complexas, os processos subjacentes de verificação de identidade devem ser robustos, confiáveis e transparentes. É aqui que entram as stacks de observabilidade modernas. Ferramentas como Grafana para visualização, Loki para logs e Tempo para traces fornecem uma visão abrangente da saúde e desempenho de suas aplicações. Integrar estas ferramentas com sua plataforma de verificação de identidade, como a Didit, é fundamental para o monitoramento proativo, depuração rápida e garantia de uma experiência de usuário perfeita.

Sem a observabilidade adequada, problemas como falhas de verificação, desafios na detecção de vivacidade ou processos lentos de Verificação de ID podem passar despercebidos, levando a usuários frustrados, riscos de conformidade e potencial fraude. Ao instrumentar as APIs da Didit, os desenvolvedores podem transformar dados brutos de verificação em insights acionáveis, tornando mais fácil identificar tendências, diagnosticar problemas e melhorar continuamente seus fluxos de trabalho de identidade.

Instrumentando Sessões Didit com Logs (Loki) e Métricas (Grafana)

A abordagem API-first da Didit torna incrivelmente simples integrar a coleta de logs e métricas em seus fluxos de trabalho de verificação de identidade. Ao criar uma sessão de verificação usando a API da Didit, você recebe um session_id e um status. Estes são pontos de dados cruciais para a observabilidade.

Logando com Loki

Para cada chamada à API da Didit, especialmente ao criar uma sessão ou receber um webhook, você deve registrar detalhes relevantes. Loki é uma excelente escolha para isso devido à sua indexação baseada em rótulos, o que o torna eficiente para consultas. Veja como você pode abordá-lo:

// Pseudocódigo para logar a criação de uma sessão
const diditResponse = await didit.createSession({
  workflow_id: 'your-workflow-id',
  callback: 'https://yourapp.com/verification-complete',
  vendor_data: 'user-123'
});

logger.info('Sessão Didit criada', {
  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'
});

Quando a Didit envia webhooks notificando sobre atualizações de sessão (por exemplo, mudanças de status, verificação bem-sucedida ou falhas), registre esses eventos com detalhes semelhantes. Isso permite que você pesquise no Loki por todos os logs relacionados a um session_id ou vendor_data específico para entender o ciclo de vida completo de uma tentativa de verificação. Por exemplo, se um usuário tiver um problema com a Verificação de ID da Didit falhando, você pode filtrar rapidamente os logs para ver as mudanças exatas de status e quaisquer mensagens de erro.

Métricas com Grafana

Para análise quantitativa, exponha métricas de sua aplicação que interagem com a Didit. Métricas comuns incluem:

• didit_session_created_total: Contador para o total de sessões iniciadas.
• didit_session_status_total{status="success"}: Contador para verificações bem-sucedidas.
• didit_session_status_total{status="failed"}: Contador para verificações falhas.
• didit_session_duration_seconds: Histograma ou sumário para o tempo desde a criação da sessão até a conclusão.
• didit_api_request_duration_seconds: Histograma para os tempos de resposta da API.

Essas métricas, expostas via Prometheus e visualizadas no Grafana, fornecem dashboards que mostram a saúde e o desempenho geral do seu sistema de verificação de identidade. Você pode configurar alertas para quedas repentinas nas taxas de sucesso ou aumentos na latência, indicando possíveis problemas com a Detecção de Vivacidade da Didit ou outros componentes.

Rastreamento Distribuído para Fluxos de Trabalho Complexos (Tempo)

Aplicações modernas frequentemente envolvem múltiplos microsserviços se comunicando para completar uma única solicitação do usuário. A verificação de identidade não é exceção, especialmente ao orquestrar várias verificações como Análise AML, Comprovação de Endereço e Verificação de Telefone e E-mail. O rastreamento distribuído, alimentado por ferramentas como o Tempo, torna-se indispensável aqui.

Quando um usuário inicia um fluxo de verificação de identidade, você pode iniciar um novo trace. À medida que sua aplicação faz chamadas para a API da Didit, e à medida que os webhooks da Didit acionam ações subsequentes em seu sistema, você deve propagar contextos de trace (por exemplo, IDs de trace OpenTelemetry). Isso permite que você veja toda a jornada de uma solicitação de verificação em todos os serviços envolvidos, desde a iniciação no frontend até a decisão final de verificação.

// Pseudocódigo para usar OpenTelemetry com chamada à API Didit
import { trace } from '@opentelemetry/api';

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

async function verifyUser(userData) {
  const span = tracer.startSpan('didit.createSession');
  try {
    // Adicionar atributos relevantes ao span
    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();
  }
}

Se um usuário relatar um problema com seu processo de Estimativa de Idade ou Verificação NFC, você pode usar o ID do usuário ou o ID da sessão para pesquisar no Tempo. O trace mostrará exatamente qual serviço ou chamada de API externa (como a API Didit) introduziu latência ou falhou, fornecendo insights inestimáveis para depuração e otimização de desempenho.

Como a Didit Ajuda

A Didit é projetada desde o início para ser "developer-first", tornando a integração com stacks de observabilidade modernas não apenas possível, mas perfeita. Nossa arquitetura modular permite que você "plug-and-play" verificações de identidade, cada uma das quais pode ser instrumentada individualmente para um monitoramento superior. A plataforma nativa de IA da Didit garante que processos essenciais como Verificação de ID, Vivacidade Passiva e Ativa, e Correspondência Facial 1:1 e Busca Facial sejam altamente performáticos e confiáveis, e nosso design robusto de API fornece pontos de entrada e saída claros para seus dados de observabilidade.

Oferecemos KYC Essencial Gratuito, removendo barreiras financeiras para começar com a verificação de identidade essencial. Nossa plataforma gera dados de identidade estruturados, o que é ideal para alimentar seus sistemas de log e métricas. Seja você rastreando a taxa de sucesso da Estimativa de Idade da Didit para conformidade ou monitorando o desempenho de nossa Verificação NFC para aplicações de alta segurança, a Didit fornece a transparência que você precisa. Não há taxas de configuração, e nosso modelo de pagamento por verificação bem-sucedida garante que você pague apenas pelo que usa, facilitando a escalabilidade de seus esforços de observabilidade junto com o crescimento de seus negócios.

Pronto para Começar?

Pronto para ver a Didit em ação? Obtenha uma demonstração gratuita hoje.

Comece a verificar identidades gratuitamente com o nível gratuito da Didit.