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 · 14 de março de 2026

Desenvolvendo um SDK KYC Reutilizável para eIDAS2 e Credenciais Verificáveis (PT-BR)

Explore considerações arquitetônicas e estratégias de implementação para construir um SDK KYC Reutilizável robusto. Este post aprofunda-se na conformidade com eIDAS2, credenciais verificáveis e APIs de carteira de identidade.

Por DiditAtualizado
reusable-kyc-sdk-design-eidas2-verifiable-credentials.png

Foco em Identidade DescentralizadaSDKs KYC reutilizáveis devem priorizar credenciais verificáveis (VCs) e identificadores descentralizados (DIDs) para maior privacidade e controle do usuário, alinhando-se aos princípios do eIDAS2.

Design API-FirstUma API bem estruturada é crucial para uma integração perfeita, suportando implementações hospedadas e sem interface (headless), e permitindo orquestração de identidade flexível.

Segurança e Privacidade por DesignImplemente fortes medidas criptográficas, tratamento seguro de dados e mecanismos de consentimento do usuário desde o início para proteger dados de identidade sensíveis.

Experiência do Usuário é FundamentalSimplifique a jornada do usuário para emissão, apresentação e reautenticação de credenciais para impulsionar a adoção e reduzir o atrito.

O cenário da identidade digital está em rápida evolução, impulsionado por novas estruturas regulatórias como o eIDAS2 e a crescente adoção de credenciais verificáveis (VCs). Para os desenvolvedores, isso apresenta uma oportunidade de construir soluções de identidade mais seguras, privadas e centradas no usuário. Um componente chave desse futuro é o SDK KYC reutilizável, projetado para permitir que os usuários verifiquem sua identidade uma vez e compartilhem esses atributos verificados sem permissão em vários serviços.

Este post explora os princípios de design e as considerações técnicas para a criação de um SDK KYC reutilizável poderoso e compatível, focando em sua integração com o eIDAS2 e o desenvolvimento de credenciais verificáveis. Examinaremos como uma API de carteira de identidade pode facilitar essa mudança de paradigma, oferecendo insights práticos para desenvolvedores.

Entendendo o KYC Reutilizável e a Conformidade com o eIDAS2

Os processos tradicionais de KYC são frequentemente repetitivos e complicados. Cada provedor de serviço exige que os usuários passem por um processo completo de verificação de identidade (IDV), levando a uma experiência de usuário ruim, altos custos operacionais e dados fragmentados. O KYC reutilizável aborda isso, permitindo que um usuário obtenha uma identidade digital verificada (muitas vezes como uma credencial verificável) de um emissor confiável e, em seguida, a apresente a outras partes confiáveis sem ter que verificar novamente do zero.

O regulamento eIDAS2 da União Europeia é um impulsionador significativo para este modelo, exigindo a criação de Carteiras de Identidade Digital Europeia (EUDI). Essas carteiras armazenarão e gerenciarão credenciais verificáveis, permitindo que os cidadãos provem sua identidade e atributos digitalmente em todos os estados membros. Um SDK eIDAS2 eficaz deve, portanto, ser projetado com interoperabilidade, forte segurança criptográfica e controle do usuário em sua essência.

Os principais componentes da conformidade com o eIDAS2 para um SDK incluem:

  • Suporte para Credenciais Verificáveis (VCs): O SDK deve ser capaz de emitir, armazenar e apresentar VCs em conformidade com os padrões W3C.
  • Identificadores Descentralizados (DIDs): A integração com métodos DID permite que os usuários gerenciem seus identificadores independentemente de uma autoridade central.
  • Gerenciamento de Consentimento: O consentimento explícito do usuário é necessário para compartilhar qualquer atributo, com mecanismos claros para revogação.
  • Autenticação Forte: A reautenticação biométrica (por exemplo, correspondência facial com prova de vida) é frequentemente exigida para desbloquear e apresentar credenciais, garantindo que o proprietário legítimo esteja presente.

Arquitetando um SDK KYC Reutilizável: Componentes Essenciais

Um SDK KYC reutilizável abrangente precisa gerenciar várias interações complexas, desde a verificação inicial da identidade até a apresentação segura da credencial. Aqui está um detalhamento dos componentes arquitetônicos essenciais:

1. Módulo de Emissão de Credenciais

Este módulo lida com o processo inicial de integração e verificação. Ele se integra a serviços de verificação de identidade de backend (como os módulos de IDV, prova de vida e AML da Didit) para estabelecer confiança. Uma vez verificado, ele orquestra a criação e emissão de uma credencial verificável para a carteira digital do usuário.


// Exemplo: Função SDK para emissão de credencial
async function issueVerifiableCredential(userId, verificationData) {
    const response = await api.post('/v1/credentials/issue', {
        userId: userId,
        data: verificationData,
        type: 'KYCProfileCredential'
    });
    return response.data; // Retorna uma VC ou uma referência a ela
}

2. Integração com a API da Carteira de Identidade

O SDK atua como um intermediário entre as partes confiáveis e a carteira de identidade do usuário (por exemplo, um aplicativo móvel ou extensão de navegador). Ele fornece uma API de carteira de identidade para solicitar credenciais, receber apresentações e gerenciar as interações do usuário. Esta API deve suportar vários padrões de carteira e protocolos de comunicação (por exemplo, OpenID para Emissão/Apresentação de Credenciais Verificáveis).


// Exemplo: Função SDK para solicitar uma credencial da carteira do usuário
async function requestCredentialPresentation(credentialType, requiredAttributes) {
    const challenge = await api.get('/v1/presentations/challenge');
    // Redirecionar ou abrir link direto para a carteira do usuário com o desafio
    const presentation = await waitForPresentationResponse(challenge.data.id);
    return presentation; // Retorna uma Apresentação Verificável
}

3. Módulo de Apresentação e Verificação Verificável

Quando uma parte confiável precisa verificar um usuário, este módulo facilita a solicitação de uma apresentação verificável da carteira do usuário. Em seguida, ele verifica a autenticidade e a integridade da credencial apresentada, verificando as assinaturas do emissor, o status de revogação e garantindo que os atributos apresentados atendam aos requisitos da parte confiável. O backend da Didit pode lidar automaticamente com a verificação dessas apresentações.

4. Reautenticação Biométrica

Para maior segurança, especialmente para transações de alto valor ou acesso a dados sensíveis, o SDK integra a reautenticação biométrica. Isso garante que a pessoa que apresenta a credencial é de fato o proprietário legítimo. O módulo de Autenticação Biométrica da Didit (Face Match 1:1, Prova de Vida) é crítico aqui, configurado para uma experiência de reautenticação sem senha.

Principais Considerações de Design para Desenvolvedores

Ao desenvolver ou integrar um SDK KYC reutilizável, vários fatores são primordiais:

  • Modularidade: Projete o SDK com componentes modulares para que os desenvolvedores possam escolher as funcionalidades (por exemplo, apenas verificação de credenciais ou fluxo completo de emissão e apresentação).
  • Segurança e Criptografia: Todas as comunicações devem ser criptografadas. As VCs devem ser assinadas criptograficamente por emissores confiáveis. O SDK precisa de recursos robustos de gerenciamento de chaves.
  • Privacidade por Design: Implemente a divulgação seletiva, permitindo que os usuários compartilhem apenas os atributos necessários. Evite a coleta excessiva de dados.
  • Experiência do Desenvolvedor (DX): Forneça documentação clara, exemplos abrangentes e APIs intuitivas. O suporte para vários idiomas e plataformas (Web, iOS, Android) é essencial.
  • Tratamento de Erros e Fallbacks: Lide graciosamente com problemas de rede, cancelamentos de usuários e credenciais inválidas. Forneça feedback claro tanto para o usuário quanto para a parte confiável.
  • Interoperabilidade: Cumpra os padrões abertos (W3C VCs, DIDs, OpenID para VC) para garantir a compatibilidade com várias carteiras de identidade e ecossistemas.

Como a Didit Ajuda na Integração do SDK KYC Reutilizável

A plataforma de identidade tudo-em-um da Didit está perfeitamente posicionada para impulsionar o desenvolvimento do seu SDK KYC reutilizável. Com a Didit, você pode:

  • Emitir Credenciais Verificáveis: Aproveite a verificação de identidade, biometria e triagem AML da Didit para estabelecer confiança e emitir credenciais verificáveis de alta garantia.
  • Reautenticação Biométrica: Integre o módulo de Autenticação Biométrica da Didit para acesso seguro e sem senha a credenciais, em conformidade com os requisitos do eIDAS2 para autenticação forte.
  • Orquestração de Identidade: Use o construtor de fluxo de trabalho da Didit para definir a lógica de emissão e verificação de credenciais, adaptando-se a vários casos de uso e necessidades de conformidade.
  • Abordagem API-First: A Didit fornece uma API RESTful robusta e SDKs (Web, iOS, Android) que podem ser perfeitamente integrados ao seu próprio SDK KYC reutilizável, seja você construindo uma solução hospedada ou um backend sem interface.
  • Conformidade e Segurança: Beneficie-se da conformidade da Didit com SOC 2 Tipo II, ISO 27001 e GDPR, garantindo que suas soluções de identidade atendam a rigorosos padrões regulatórios e de segurança. A abordagem de privacidade por padrão da Didit (por exemplo, processar selfies na memória e excluí-las) alinha-se perfeitamente com o ethos de identidade reutilizável e que preserva a privacidade.

Pronto para Começar?

Construir um SDK KYC reutilizável robusto que adote o eIDAS2 e as credenciais verificáveis é um empreendimento complexo, mas recompensador. Ao aproveitar plataformas como a Didit, os desenvolvedores podem acelerar o desenvolvimento de suas credenciais verificáveis, focando na experiência do usuário e na lógica de negócios, em vez de reinventar as primitivas de identidade subjacentes.

Explore a documentação técnica abrangente da Didit para ver como nossas APIs e SDKs podem ser integrados em sua solução de identidade de próxima geração. Para uma análise mais aprofundada de nossos recursos, considere uma demonstração do produto ou entre em contato com nossa equipe em hello@didit.me.

FAQ

O que é um SDK KYC Reutilizável?

Um SDK KYC Reutilizável é um kit de desenvolvimento de software que permite aos usuários verificar sua identidade uma vez com um emissor confiável e, em seguida, reutilizar de forma segura e sem permissão esses atributos verificados em vários provedores de serviços, muitas vezes por meio de credenciais verificáveis armazenadas em uma carteira digital.

Como o eIDAS2 impacta os SDKs KYC Reutilizáveis?

O eIDAS2 exige a criação de Carteiras de Identidade Digital Europeia (EUDI), que armazenarão credenciais verificáveis. Os SDKs KYC Reutilizáveis devem ser projetados para serem compatíveis com os padrões eIDAS2, suportando a emissão, armazenamento e apresentação dessas credenciais, ao mesmo tempo em que aderem a fortes requisitos de autenticação e privacidade.

O que são Credenciais Verificáveis (VCs) e como elas funcionam com uma API de Carteira de Identidade?

Credenciais Verificáveis (VCs) são provas digitais invioláveis de declarações (por exemplo, idade, nacionalidade, endereço) assinadas criptograficamente por um emissor. Uma API de Carteira de Identidade permite que um aplicativo interaja com a carteira digital de um usuário para solicitar, receber e verificar essas VCs, permitindo o compartilhamento seguro e privado de dados com base no consentimento do usuário.

O que torna a plataforma da Didit adequada para construir um SDK KYC Reutilizável?

A Didit oferece primitivas de identidade essenciais (IDV, biometria, AML) para emitir credenciais verificáveis, APIs e SDKs robustos para integração e um motor de fluxo de trabalho para orquestração. Sua compatibilidade com o eIDAS2 e o foco em segurança e privacidade fornecem uma base sólida para o desenvolvimento de soluções KYC reutilizáveis compatíveis e centradas no usuário.

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
SDK KYC Reutilizável: eIDAS2 e Credenciais Verificáveis.