Guia do Programador para Integrar o Didit com Plataformas de Observabilidade Modernas (PT-PT)

Integração Sem ComplicaçõesAs APIs limpas do Didit e o design focado no programador permitem uma integração direta com ferramentas de observabilidade líderes, como Grafana, Loki e Tempo.

Monitorização MelhoradaAo instrumentar os processos de verificação de identidade do Didit, os programadores podem obter visibilidade em tempo real sobre os estados das sessões, taxas de sucesso e potenciais gargalos.

Depuração ProativaAproveite o rastreio distribuído com o Tempo para identificar problemas em fluxos de trabalho de identidade complexos, garantindo uma resolução rápida e um impacto mínimo no utilizador.

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

A Criticidade da Observabilidade na Verificação de Identidade

No panorama digital atual, a verificação de identidade já não é um mero item de verificação; é um pilar fundamental de confiança e segurança. À medida que as empresas crescem e as interações dos utilizadores se tornam mais complexas, os processos subjacentes de verificação de identidade devem ser robustos, fiáveis e transparentes. É aqui que entram as plataformas de observabilidade modernas. Ferramentas como o Grafana para visualização, o Loki para registos e o Tempo para rastreios fornecem uma visão abrangente da saúde e desempenho das suas aplicações. Integrar estas ferramentas com a sua plataforma de verificação de identidade, como o Didit, é fundamental para a monitorização proativa, depuração rápida e para garantir uma experiência de utilizador fluida.

Sem uma observabilidade adequada, problemas como falhas de verificação, desafios na deteção de vivacidade ou processos lentos de Verificação de Identidade podem passar despercebidos, levando a utilizadores frustrados, riscos de conformidade e potencial fraude. Ao instrumentar as APIs do Didit, os programadores podem transformar dados brutos de verificação em informações acionáveis, tornando mais fácil identificar tendências, diagnosticar problemas e melhorar continuamente os seus fluxos de trabalho de identidade.

Instrumentação de Sessões Didit com Registos (Loki) e Métricas (Grafana)

A abordagem API-first do Didit torna incrivelmente simples a integração da recolha de registos e métricas nos seus fluxos de trabalho de verificação de identidade. Quando cria uma sessão de verificação usando a API do Didit, recebe um session_id e um status. Estes são pontos de dados cruciais para a observabilidade.

Registo com Loki

Para cada chamada à API do Didit, especialmente ao criar uma sessão ou receber um webhook, deve registar os detalhes relevantes. O Loki é uma excelente escolha para isso devido à sua indexação baseada em etiquetas, o que o torna eficiente para consultas. Veja como pode abordá-lo:

// Pseudocódigo para registar 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('Didit session created', {
  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 o Didit envia webhooks a notificá-lo sobre atualizações de sessão (por exemplo, alterações de estado, verificação bem-sucedida ou falhas), registe estes eventos com detalhes semelhantes. Isto permite-lhe procurar no Loki todos os registos relacionados com um session_id ou vendor_data específico para compreender o ciclo de vida completo de uma tentativa de verificação. Por exemplo, se um utilizador tiver um problema com a Verificação de Identidade do Didit a falhar, pode filtrar rapidamente os registos para ver as alterações exatas de estado e quaisquer mensagens de erro.

Métricas com Grafana

Para análise quantitativa, exponha métricas da sua aplicação que interagem com o Didit. As 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 falhadas.
• didit_session_duration_seconds: Histograma ou resumo para o tempo decorrido desde a criação da sessão até à conclusão.
• didit_api_request_duration_seconds: Histograma para os tempos de resposta da API.

Estas métricas, expostas via Prometheus e visualizadas no Grafana, fornecem painéis que mostram a saúde e o desempenho geral do seu sistema de verificação de identidade. Pode configurar alertas para quedas súbitas nas taxas de sucesso ou aumentos na latência, indicando potenciais problemas com a Deteção de Vivacidade do Didit ou outros componentes.

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

As aplicações modernas envolvem frequentemente múltiplos microsserviços a comunicar para completar um único pedido de utilizador. A verificação de identidade não é exceção, especialmente ao orquestrar várias verificações como Análise AML, Prova de Morada e Verificação de Telefone e E-mail. O rastreio distribuído, impulsionado por ferramentas como o Tempo, torna-se indispensável aqui.

Quando um utilizador inicia um fluxo de verificação de identidade, pode iniciar um novo rastreio. À medida que a sua aplicação faz chamadas à API do Didit, e à medida que os webhooks do Didit desencadeiam ações subsequentes no seu sistema, deve propagar os contextos de rastreio (por exemplo, IDs de rastreio OpenTelemetry). Isto permite-lhe ver toda a jornada de um pedido de verificação em todos os serviços envolvidos, desde a iniciação no frontend até à 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 utilizador reportar um problema com o processo de Estimativa de Idade ou Verificação NFC, pode usar o ID do utilizador ou o ID da sessão para pesquisar no Tempo. O rastreio mostrará exatamente qual serviço ou chamada de API externa (como a API do Didit) introduziu latência ou falhou, fornecendo informações inestimáveis para depuração e otimização de desempenho.

Como o Didit Ajuda

O Didit foi concebido desde o início para ser focado no programador, tornando a integração com plataformas de observabilidade modernas não só possível, mas fluida. A nossa arquitetura modular permite-lhe "ligar e usar" verificações de identidade, cada uma das quais pode ser individualmente instrumentada para uma monitorização superior. A plataforma nativa de IA do Didit garante que os processos centrais como Verificação de Identidade, Vivacidade Passiva e Ativa, e Correspondência Facial 1:1 e Pesquisa Facial são altamente performantes e fiáveis, e o nosso design robusto de API fornece pontos claros de entrada e saída para os seus dados de observabilidade.

Oferecemos KYC Essencial Gratuito, removendo barreiras financeiras para começar com a verificação de identidade essencial. A nossa plataforma gera dados de identidade estruturados, o que é ideal para alimentar os seus sistemas de registo e métricas. Quer esteja a monitorizar a taxa de sucesso da Estimativa de Idade do Didit para conformidade ou a monitorizar o desempenho da nossa Verificação NFC para aplicações de alta segurança, o Didit fornece a transparência de que necessita. Não há taxas de configuração, e o nosso modelo de pagamento por verificação bem-sucedida garante que paga apenas pelo que usa, tornando mais fácil escalar os seus esforços de observabilidade em conjunto com o crescimento do seu negócio.

Pronto para Começar?

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

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