Saltar para o conteúdo principal
Didit angaria 7,5 milhões de dólares para construir a infraestrutura para identidade e fraude
Didit
Voltar ao blog
Blog · 14 de março de 2026

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

Explore considerações arquitetónicas e estratégias de implementação para construir um SDK KYC Reutilizável robusto. Este artigo aborda a conformidade com eIDAS2, credenciais verificáveis e APIs de carteiras de identidade.

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

Foco na Identidade DescentralizadaOs SDKs KYC reutilizáveis devem priorizar credenciais verificáveis (VCs) e identificadores descentralizados (DIDs) para maior privacidade e controlo do utilizador, alinhando-se com os princípios do eIDAS2.

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

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

A Experiência do Utilizador é FundamentalSimplifique o percurso do utilizador para a emissão, apresentação e reautenticação de credenciais para impulsionar a adoção e reduzir o atrito.

O panorama da identidade digital está a evoluir rapidamente, impulsionado por novos quadros regulamentares como o eIDAS2 e a crescente adoção de credenciais verificáveis (VCs). Para os programadores, isto representa uma oportunidade para construir soluções de identidade mais seguras, privadas e centradas no utilizador. Um componente chave deste futuro é o SDK KYC reutilizável, concebido para permitir que os utilizadores verifiquem a sua identidade uma vez e partilhem esses atributos verificados sem permissão entre vários serviços.

Este artigo explora os princípios de design e as considerações técnicas para a criação de um SDK KYC reutilizável poderoso e conforme, focando-se na sua integração com o eIDAS2 e no desenvolvimento de credenciais verificáveis. Analisaremos como uma API de carteira de identidade pode facilitar esta mudança de paradigma, oferecendo insights práticos para os programadores.

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

Os processos KYC tradicionais são frequentemente repetitivos e morosos. Cada fornecedor de serviços exige que os utilizadores passem por um processo completo de verificação de identidade (IDV), o que leva a uma má experiência do utilizador, altos custos operacionais e dados fragmentados. O KYC reutilizável aborda isso, permitindo que um utilizador 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 dependentes sem ter de 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 Europeias (EUDI). Estas carteiras armazenarão e gerirão credenciais verificáveis, permitindo que os cidadãos provem a sua identidade e atributos digitalmente em todos os estados-membros. Um SDK eIDAS2 eficaz deve, portanto, ser concebido com interoperabilidade, forte segurança criptográfica e controlo do utilizador no seu cerne.

Os componentes chave 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 as normas do W3C.
  • Identificadores Descentralizados (DIDs): A integração com métodos DID permite que os utilizadores gerenciem os seus identificadores independentemente de uma autoridade central.
  • Gestão de Consentimento: É exigido o consentimento explícito do utilizador para partilhar 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 está presente.

Arquitetar um SDK KYC Reutilizável: Componentes Essenciais

Um SDK KYC reutilizável abrangente precisa de gerir várias interações complexas, desde a verificação inicial de identidade até à apresentação segura de credenciais. Aqui está uma descrição 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. Integra-se com serviços de verificação de identidade de backend (como os módulos IDV, prova de vida e AML da Didit) para estabelecer confiança. Uma vez verificado, orquestra a criação e emissão de uma credencial verificável para a carteira digital do utilizador.


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

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

O SDK atua como um intermediário entre as partes dependentes e a carteira de identidade do utilizador (por exemplo, uma aplicação móvel ou extensão de navegador). Fornece uma API de carteira de identidade para solicitar credenciais, receber apresentações e gerir interações do utilizador. 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 utilizador
async function requestCredentialPresentation(credentialType, requiredAttributes) {
    const challenge = await api.get('/v1/presentations/challenge');
    // Redirecionar ou abrir link profundo para a carteira do utilizador com o desafio
    const presentation = await waitForPresentationResponse(challenge.data.id);
    return presentation; // Devolve uma Apresentação Verificável
}

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

Quando uma parte dependente precisa de verificar um utilizador, este módulo facilita o pedido de uma apresentação verificável da carteira do utilizador. Em seguida, verifica a autenticidade e integridade da credencial apresentada, verificando as assinaturas do emissor, o estado de revogação e garantindo que os atributos apresentados cumprem os requisitos da parte dependente. O backend da Didit pode lidar automaticamente com a verificação destas 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 facto o proprietário legítimo. O módulo de Autenticação Biométrica da Didit (Correspondência Facial 1:1, Prova de Vida) é crítico aqui, configurado para uma experiência de reautenticação sem palavra-passe.

Considerações Cruciais de Design para Programadores

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

  • Modularidade: Conceba o SDK com componentes modulares para que os programadores 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 encriptadas. Os VCs devem ser criptograficamente assinados por emissores confiáveis. O SDK precisa de capacidades robustas de gestão de chaves.
  • Privacidade por Design: Implemente a divulgação seletiva, permitindo que os utilizadores partilhem apenas os atributos necessários. Evite a recolha excessiva de dados.
  • Experiência do Programador (DX): Forneça documentação clara, exemplos abrangentes e APIs intuitivas. O suporte para várias linguagens e plataformas (Web, iOS, Android) é essencial.
  • Tratamento de Erros e Contingências: Lide graciosamente com problemas de rede, cancelamentos de utilizadores e credenciais inválidas. Forneça feedback claro tanto ao utilizador quanto à parte dependente.
  • Interoperabilidade: Adira a 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 de 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, pode:

  • Emitir Credenciais Verificáveis: Aproveite a Verificação de ID, biometria e triagem AML da Didit para estabelecer confiança e emitir credenciais verificáveis de alta segurança.
  • Reautenticação Biométrica: Integre o módulo de Autenticação Biométrica da Didit para acesso seguro e sem palavra-passe às 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 integrados perfeitamente no seu próprio SDK KYC reutilizável, quer esteja a construir uma solução alojada ou um backend sem interface.
  • Conformidade e Segurança: Beneficie da conformidade da Didit com SOC 2 Tipo II, ISO 27001 e GDPR, garantindo que as suas soluções de identidade cumprem os rigorosos padrões regulamentares e de segurança. A abordagem de privacidade por omissão da Didit (por exemplo, processar selfies em memória e eliminá-las) alinha-se perfeitamente com o ethos de identidade reutilizável e preservadora da privacidade.

Pronto para Começar?

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

Explore a abrangente documentação técnica da Didit para ver como as nossas APIs e SDKs podem ser integrados na sua solução de identidade de próxima geração. Para um aprofundamento nas nossas capacidades, considere uma demonstração do produto ou contacte a nossa equipa 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 utilizadores verificar a 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 fornecedores de serviços, muitas vezes através de credenciais verificáveis armazenadas numa carteira digital.

Como o eIDAS2 impacta os SDKs KYC Reutilizáveis?

O eIDAS2 exige a criação de Carteiras de Identidade Digital Europeias (EUDI), que armazenarão credenciais verificáveis. Os SDKs KYC Reutilizáveis devem ser concebidos para serem compatíveis com as normas do eIDAS2, suportando a emissão, armazenamento e apresentação dessas credenciais, ao mesmo tempo que aderem a requisitos de autenticação forte e privacidade.

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

Credenciais Verificáveis (VCs) são provas digitais invioláveis de afirmações (por exemplo, idade, nacionalidade, endereço) criptograficamente assinadas por um emissor. Uma API de Carteira de Identidade permite que uma aplicação interaja com a carteira digital de um utilizador para solicitar, receber e verificar esses VCs, permitindo a partilha segura e privada de dados com base no consentimento do utilizador.

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. A sua compatibilidade com o eIDAS2 e o foco na segurança e privacidade fornecem uma base sólida para o desenvolvimento de soluções KYC reutilizáveis, conformes e centradas no utilizador.

Infraestrutura para identidade e fraude.

Uma API para KYC, KYB, Monitorização de Transações e Rastreio de Carteiras. Integre em 5 minutos.

Peça a uma IA para resumir esta página
Design de SDK KYC Reutilizável: eIDAS2 e Credenciais.