Pular para o conteúdo principal
Didit levanta US$ 7,5 milhões para construir a infraestrutura para identidade e fraude
Didit
Voltar para o blog
Blog · 7 de março de 2026

Construindo um Sandbox de Identidade para Desenvolvedores com Didit e Docker Compose (PT-BR)

Criar um ambiente de desenvolvimento robusto e isolado para verificação de identidade é crucial para iterações rápidas e testes seguros. Este guia explora como usar a plataforma Didit com Docker Compose para construir esse.

Por DiditAtualizado
developer-friendly-identity-sandbox-didit-docker-compose.png

Desenvolvimento SimplificadoO Docker Compose simplifica a configuração de infraestruturas complexas de verificação de identidade, permitindo que os desenvolvedores criem ambientes isolados de forma rápida e consistente.

Segurança e Isolamento AprimoradosAmbientes de sandbox evitam a exposição de dados sensíveis e garantem que os testes não afetem os sistemas de produção, promovendo um ciclo de vida de desenvolvimento seguro.

Integração AceleradaAs APIs limpas e a abordagem developer-first da Didit, combinadas com o Docker Compose, permitem a integração e o teste rápidos de fluxos de trabalho de verificação de identidade sem atritos.

A Vantagem DiditA Didit oferece uma plataforma modular e nativa de IA com um nível KYC principal gratuito, tornando-a a escolha ideal para construir sandboxes de verificação de identidade flexíveis, econômicos e poderosos.

No cenário digital atual, a verificação robusta de identidade não é apenas um recurso; é uma necessidade. Desde a prevenção de fraudes até a garantia de conformidade, as empresas dependem de soluções de identidade sofisticadas. Para os desenvolvedores, integrar e testar essas soluções pode ser complexo, muitas vezes exigindo ambientes seguros e isolados que simulem a produção sem os riscos associados. É aqui que o poder de um sandbox de identidade amigável ao desenvolvedor, construído com ferramentas como Didit e Docker Compose, se torna indispensável.

O Desafio do Desenvolvimento de Verificação de Identidade

Desenvolver com serviços de verificação de identidade apresenta vários desafios únicos:

  1. Sensibilidade dos Dados: O tratamento de Informações de Identificação Pessoal (PII) exige extremo cuidado, tornando os ambientes de teste isolados críticos para prevenir violações.
  2. Integrações Complexas: As plataformas de identidade frequentemente envolvem múltiplos componentes, desde a digitalização de IDs e detecção de vivacidade até verificações AML e validações de banco de dados. Integrá-los perfeitamente em uma aplicação requer uma abordagem estruturada.
  3. Conformidade Regulatória: As regulamentações KYC (Know Your Customer) e AML (Anti-Money Laundering) são rigorosas. Os desenvolvedores precisam de ambientes onde possam testar com confiança os fluxos de trabalho de conformidade sem repercussões legais.
  4. Iteração Rápida: O ritmo do desenvolvimento exige ciclos de feedback rápidos. Configurações de teste lentas e complicadas dificultam a inovação e a velocidade de implantação.

As configurações de desenvolvimento tradicionais muitas vezes ficam aquém, levando a atrasos, vulnerabilidades de segurança e frustração. Um ambiente de sandbox bem projetado aborda esses problemas de frente, fornecendo um espaço seguro e eficiente para os desenvolvedores inovarem.

Por Que o Docker Compose para Seu Sandbox de Identidade?

O Docker Compose é uma ferramenta poderosa para definir e executar aplicações Docker multi-contêiner. Ele permite configurar os serviços, redes e volumes da sua aplicação em um único arquivo docker-compose.yml, tornando incrivelmente fácil levantar e derrubar ambientes complexos. Para um sandbox de verificação de identidade, o Docker Compose oferece vários benefícios chave:

  • Consistência: Garante que todos na equipe, de desenvolvedores a QA, trabalhem com exatamente o mesmo ambiente, eliminando problemas de “funciona na minha máquina”.
  • Isolamento: Cada serviço é executado em seu próprio contêiner, prevenindo conflitos e garantindo que o sandbox esteja completamente separado da produção ou de outras instâncias de desenvolvimento.
  • Portabilidade: Um arquivo docker-compose.yml pode ser facilmente compartilhado e executado em qualquer sistema com Docker instalado, simplificando a integração e a implantação.
  • Escalabilidade: Embora seja um sandbox, os princípios de design do Docker Compose permitem fácil escalonamento de serviços, se necessário, para cenários de teste mais intensivos.
  • Reprodutibilidade: Você pode recriar todo o seu ambiente de verificação de identidade com um único comando, o que é inestimável para depuração e teste de diferentes configurações.

Ao definir seus serviços de backend, servidores mock para dependências externas e até mesmo um banco de dados local dentro do Docker Compose, você cria um ecossistema autocontido para o desenvolvimento de verificação de identidade.

Integrando Didit em Seu Sandbox Docker Compose

Didit, com sua abordagem nativa de IA e developer-first, é perfeitamente adequado para integração em um sandbox Docker Compose. Suas APIs limpas e arquitetura modular significam que você pode facilmente conectar os componentes específicos de verificação de identidade de que precisa. Veja como você pode estruturar seu docker-compose.yml e integrar Didit:

Primeiro, certifique-se de ter sua Chave de API Didit e o Segredo do Webhook do Console Didit. Você também precisará de um ID de Fluxo de Trabalho, que pode ser criado no console, escolhendo entre modelos como KYC, Verificação Adaptativa de Idade (aproveitando a Estimativa de Idade da Didit), Autenticação Biométrica (usando a Correspondência Facial 1:1 da Didit) ou Verificação de Endereço (usando o Comprovante de Endereço da Didit).

Seu docker-compose.yml pode se parecer com isto:

version: '3.8'
services:
  app:
    build: .
    ports:
      - "8080:8080"
    environment:
      DIDIT_API_KEY: ${DIDIT_API_KEY}
      DIDIT_WEBHOOK_SECRET: ${DIDIT_WEBHOOK_SECRET}
      DIDIT_WORKFLOW_ID: ${DIDIT_WORKFLOW_ID}
      # Outras variáveis de ambiente específicas da aplicação
    depends_on:
      - db
      - mockserver
  db:
    image: postgres:13
    environment:
      POSTGRES_DB: mydatabase
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
    volumes:
      - db_data:/var/lib/postgresql/data
  mockserver:
    image: wiremock/wiremock:2.35.0 # Ou qualquer outro servidor mock
    ports:
      - "8081:8080"
    volumes:
      - ./wiremock:/home/wiremock
volumes:
  db_data:

Nesta configuração:

  • O serviço app representa sua aplicação, configurado com credenciais Didit como variáveis de ambiente. Esta aplicação fará chamadas de API para Didit para Verificação de ID (OCR, MRZ, códigos de barras), Vivacidade Passiva e Ativa, Triagem e Monitoramento AML e outras verificações.
  • O serviço db fornece uma instância PostgreSQL local para os dados da sua aplicação.
  • O mockserver pode simular serviços externos ou até mesmo respostas de webhook da Didit para cenários de teste específicos, permitindo que você teste casos extremos sem fazer chamadas de API ao vivo.

Para executar isso, você simplesmente executaria docker-compose up -d, e seu ambiente completo de desenvolvimento de verificação de identidade estaria pronto. Você pode então usar a API da Didit para criar sessões:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_DIDIT_API_KEY" \
  -d '{
    "workflow_id": "YOUR_DIDIT_WORKFLOW_ID",
    "callback": "https://yourapp.com/verification-complete",
    "vendor_data": "user-123",
    "contact_details": {
      "email": "test@example.com"
    }
  }'

Este comando inicia uma sessão de verificação, e a Didit lida com as complexas verificações de identidade, enviando os resultados de volta para o URL de callback especificado. Isso permite que você teste o ciclo de vida completo da verificação de identidade dentro do seu sandbox isolado.

Melhores Práticas para Seu Sandbox de Identidade

Para maximizar a eficácia do seu sandbox de identidade baseado em Docker Compose:

  1. Use Variáveis de Ambiente: Nunca codifique chaves de API ou informações sensíveis diretamente em seu docker-compose.yml. Use arquivos .env e o suporte integrado do Docker para variáveis de ambiente.
  2. Simule Serviços Externos: Para serviços que você não controla ou que incorrem em custos, use um servidor mock dentro de sua configuração Compose. Isso permite testes consistentes e gratuitos.
  3. Dados de Teste Dedicados: Popule seu banco de dados sandbox com dados de teste realistas e não sensíveis. Nunca use dados de produção em um ambiente de desenvolvimento.
  4. Automatize Testes: Integre seu sandbox com suítes de teste automatizadas (unidade, integração, ponta a ponta) para garantir que as alterações não quebrem os fluxos de trabalho de identidade existentes.
  5. Controle de Versão: Mantenha seu docker-compose.yml e quaisquer arquivos de configuração relacionados (como definições de servidor mock) sob controle de versão.
  6. Atualizações Regulares: Mantenha suas imagens Docker e SDKs Didit (por exemplo, SDK Android, SDK iOS) atualizados para se beneficiar dos recursos e patches de segurança mais recentes.

Como a Didit Ajuda

A Didit é projetada desde o início para ser amigável ao desenvolvedor, tornando-a a parceira perfeita para o seu sandbox de identidade Docker Compose. Nossa plataforma oferece:

  • KYC Core Gratuito: Comece com recursos essenciais de verificação de identidade sem custos iniciais, ideal para desenvolvimento e testes.
  • Arquitetura Modular: Nossas primitivas de identidade componíveis significam que você usa apenas o que precisa. Seja Verificação de ID, Vivacidade Passiva e Ativa, Correspondência Facial 1:1, Triagem AML, Comprovante de Endereço, Estimativa de Idade ou Verificação NFC, você pode integrar facilmente componentes específicos em seu sandbox.
  • Tecnologia Nativa de IA: As soluções da Didit, alimentadas por IA, fornecem precisão superior e detecção de fraudes, dando-lhe confiança em seus resultados de teste.
  • Experiência Developer-First: Com um sandbox instantâneo disponível, documentação abrangente e APIs limpas, os desenvolvedores podem integrar e testar rapidamente. Nosso guia de fluxo completo da API fornece instruções passo a passo para criar sessões e lidar com webhooks, que são críticos para um sandbox eficiente.
  • Sem Taxas de Configuração: Concentre-se na construção e teste sem se preocupar com compromissos financeiros iniciais.
  • Fluxos de Trabalho Orquestrados: Defina etapas de verificação complexas com nosso motor sem código no Console, e então as referencie pelo ID do Fluxo de Trabalho em suas chamadas de API, simplificando a configuração do sandbox.

Ao combinar a plataforma de identidade poderosa e flexível da Didit com o isolamento e a consistência do Docker Compose, os desenvolvedores podem criar um ambiente de sandbox incomparável. Essa configuração não apenas acelera o desenvolvimento, mas também aprimora a segurança e a confiabilidade de seus processos de verificação de identidade, garantindo que você construa confiança em escala.

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.

Infraestrutura para identidade e fraude.

Uma API para KYC, KYB, Monitoramento de Transações e Análise de Carteiras. Integre em 5 minutos.

Peça para uma IA resumir esta página
Sandbox de Identidade para Desenvolvedores com Didit e.