Saltar al contenido principal
Didit recauda 7,5M $ para construir la infraestructura para identidad y fraude
Didit
Volver al blog
Blog · 14 de marzo de 2026

Diseño de un SDK KYC Reutilizable para eIDAS2 y Credenciales Verificables (ES)

Explore consideraciones arquitectónicas y estrategias de implementación para construir un SDK KYC reutilizable. Este post aborda la conformidad con eIDAS2, credenciales verificables y APIs de carteras de identidad, ofreciendo.

Por DiditActualizado el
reusable-kyc-sdk-design-eidas2-verifiable-credentials.png

Enfoque en la Identidad DescentralizadaLos SDK de KYC reutilizables deben priorizar las credenciales verificables (VCs) y los identificadores descentralizados (DIDs) para mejorar la privacidad y el control del usuario, alineándose con los principios de eIDAS2.

Diseño API-FirstUna API bien estructurada es crucial para una integración perfecta, soportando implementaciones tanto alojadas como sin cabeza, y permitiendo una orquestación de identidad flexible.

Seguridad y Privacidad por DiseñoImplemente medidas criptográficas sólidas, manejo seguro de datos y mecanismos de consentimiento del usuario desde el principio para proteger los datos de identidad sensibles.

La Experiencia del Usuario es ClaveSimplifique el recorrido del usuario para la emisión, presentación y reautenticación de credenciales para impulsar la adopción y reducir la fricción.

El panorama de la identidad digital está evolucionando rápidamente, impulsado por nuevos marcos regulatorios como eIDAS2 y la creciente adopción de credenciales verificables (VCs). Para los desarrolladores, esto presenta una oportunidad para construir soluciones de identidad más seguras, privadas y centradas en el usuario. Un componente clave de este futuro es el SDK KYC reutilizable, diseñado para permitir a los usuarios verificar su identidad una vez y compartir sin permiso esos atributos verificados a través de múltiples servicios.

Esta publicación explora los principios de diseño y las consideraciones técnicas para crear un SDK KYC reutilizable potente y conforme, centrándose en su integración con eIDAS2 y el desarrollo de credenciales verificables. Examinaremos cómo una API de cartera de identidad puede facilitar este cambio de paradigma, ofreciendo conocimientos prácticos para los desarrolladores.

Comprendiendo el KYC Reutilizable y la Conformidad con eIDAS2

Los procesos tradicionales de KYC suelen ser repetitivos y engorrosos. Cada proveedor de servicios requiere que los usuarios se sometan a un proceso completo de verificación de identidad (IDV), lo que conduce a una mala experiencia de usuario, altos costos operativos y datos fragmentados. El KYC reutilizable aborda esto permitiendo que un usuario obtenga una identidad digital verificada (a menudo como una credencial verificable) de un emisor confiable y luego la presente a otras partes confiables sin volver a verificar desde cero.

La regulación eIDAS2 de la Unión Europea es un motor significativo para este modelo, que exige la creación de Carteras Europeas de Identidad Digital (EUDI). Estas carteras almacenarán y gestionarán credenciales verificables, permitiendo a los ciudadanos probar su identidad y atributos digitalmente en todos los estados miembros. Un SDK eIDAS2 efectivo debe, por lo tanto, diseñarse con interoperabilidad, seguridad criptográfica sólida y control del usuario en su núcleo.

Los componentes clave de la conformidad con eIDAS2 para un SDK incluyen:

  • Soporte para Credenciales Verificables (VCs): El SDK debe ser capaz de emitir, almacenar y presentar VCs conformes con los estándares W3C.
  • Identificadores Descentralizados (DIDs): La integración con métodos DID permite a los usuarios gestionar sus identificadores independientemente de una autoridad central.
  • Gestión del Consentimiento: Se requiere el consentimiento explícito del usuario para compartir cualquier atributo, con mecanismos claros para la revocación.
  • Autenticación Fuerte: La reautenticación biométrica (p. ej., coincidencia facial con prueba de vida) a menudo es necesaria para desbloquear y presentar credenciales, asegurando que el propietario legítimo esté presente.

Arquitecturando un SDK KYC Reutilizable: Componentes Centrales

Un SDK KYC reutilizable completo necesita gestionar varias interacciones complejas, desde la verificación de identidad inicial hasta la presentación segura de credenciales. Aquí hay un desglose de los componentes arquitectónicos esenciales:

1. Módulo de Emisión de Credenciales

Este módulo gestiona el proceso inicial de incorporación y verificación. Se integra con los servicios de verificación de identidad de backend (como los módulos de IDV, prueba de vida y AML de Didit) para establecer confianza. Una vez verificado, orquesta la creación y emisión de una credencial verificable a la cartera digital del usuario.


// Ejemplo: Función SDK para la emisión de credenciales
async function issueVerifiableCredential(userId, verificationData) {
    const response = await api.post('/v1/credentials/issue', {
        userId: userId,
        data: verificationData,
        type: 'KYCProfileCredential'
    });
    return response.data; // Devuelve una VC o una referencia a ella
}

2. Integración de la API de la Cartera de Identidad

El SDK actúa como intermediario entre las partes confiables y la cartera de identidad del usuario (p. ej., una aplicación móvil o una extensión del navegador). Proporciona una API de cartera de identidad para solicitar credenciales, recibir presentaciones y gestionar las interacciones del usuario. Esta API debe admitir varios estándares de cartera y protocolos de comunicación (p. ej., OpenID para la Emisión/Presentación de Credenciales Verificables).


// Ejemplo: Función SDK para solicitar una credencial de la cartera del usuario
async function requestCredentialPresentation(credentialType, requiredAttributes) {
    const challenge = await api.get('/v1/presentations/challenge');
    // Redirigir o abrir un enlace profundo a la cartera del usuario con el desafío
    const presentation = await waitForPresentationResponse(challenge.data.id);
    return presentation; // Devuelve una Presentación Verificable
}

3. Módulo de Presentación y Verificación Verificable

Cuando una parte confiable necesita verificar a un usuario, este módulo facilita la solicitud de una presentación verificable desde la cartera del usuario. Luego verifica la autenticidad e integridad de la credencial presentada, comprobando las firmas del emisor, el estado de revocación y asegurando que los atributos presentados cumplan con los requisitos de la parte confiable. El backend de Didit puede manejar automáticamente la verificación de estas presentaciones.

4. Reautenticación Biométrica

Para una seguridad mejorada, especialmente para transacciones de alto valor o acceso a datos sensibles, el SDK integra la reautenticación biométrica. Esto asegura que la persona que presenta la credencial es de hecho el propietario legítimo. El módulo de Autenticación Biométrica de Didit (Coincidencia Facial 1:1, Prueba de Vida) es crítico aquí, configurado para una experiencia de reautenticación sin contraseña.

Consideraciones Clave de Diseño para Desarrolladores

Al desarrollar o integrar un SDK KYC reutilizable, varios factores son primordiales:

  • Modularidad: Diseñe el SDK con componentes modulares para que los desarrolladores puedan elegir funcionalidades (p. ej., solo verificación de credenciales, o flujo completo de emisión y presentación).
  • Seguridad y Criptografía: Todas las comunicaciones deben estar cifradas. Las VCs deben ser firmadas criptográficamente por emisores confiables. El SDK necesita capacidades robustas de gestión de claves.
  • Privacidad por Diseño: Implemente la divulgación selectiva, permitiendo a los usuarios compartir solo los atributos necesarios. Evite la sobre-recolección de datos.
  • Experiencia del Desarrollador (DX): Proporcione documentación clara, ejemplos completos y APIs intuitivas. El soporte para múltiples lenguajes y plataformas (Web, iOS, Android) es esencial.
  • Manejo de Errores y Alternativas: Maneje con gracia los problemas de red, las cancelaciones de usuario y las credenciales no válidas. Proporcione retroalimentación clara tanto al usuario como a la parte confiable.
  • Interoperabilidad: Adhiérase a estándares abiertos (W3C VCs, DIDs, OpenID para VC) para garantizar la compatibilidad con varias carteras de identidad y ecosistemas.

Cómo Didit Ayuda con la Integración del SDK KYC Reutilizable

La plataforma de identidad todo en uno de Didit está perfectamente posicionada para impulsar el desarrollo de su SDK KYC reutilizable. Con Didit, puede:

  • Emitir Credenciales Verificables: Aproveche la verificación de identidad, la biometría y el cribado AML de Didit para establecer confianza y emitir credenciales verificables de alta seguridad.
  • Reautenticación Biométrica: Integre el módulo de Autenticación Biométrica de Didit para un acceso seguro y sin contraseña a las credenciales, cumpliendo con los requisitos de eIDAS2 para una autenticación fuerte.
  • Orquestación de Identidad: Utilice el constructor de flujos de trabajo de Didit para definir la lógica de emisión y verificación de credenciales, adaptándose a varios casos de uso y necesidades de cumplimiento.
  • Enfoque API-First: Didit proporciona una robusta API RESTful y SDKs (Web, iOS, Android) que se pueden integrar sin problemas en su propio SDK KYC reutilizable, ya sea que esté construyendo una solución alojada o un backend sin cabeza.
  • Cumplimiento y Seguridad: Benefíciese del cumplimiento de Didit con SOC 2 Tipo II, ISO 27001 y GDPR, asegurando que sus soluciones de identidad cumplan con estrictos estándares regulatorios y de seguridad. El enfoque de Didit en la privacidad por defecto (p. ej., procesar selfies en memoria y eliminarlas) se alinea perfectamente con la ética de una identidad reutilizable y que preserva la privacidad.

¿Listo para empezar?

Construir un SDK KYC reutilizable robusto que adopte eIDAS2 y las credenciales verificables es un esfuerzo complejo pero gratificante. Al aprovechar plataformas como Didit, los desarrolladores pueden acelerar su desarrollo de credenciales verificables, centrándose en la experiencia del usuario y la lógica de negocio en lugar de reinventar las primitivas de identidad subyacentes.

Explore la completa documentación técnica de Didit para ver cómo nuestras APIs y SDKs pueden integrarse en su solución de identidad de próxima generación. Para una inmersión más profunda en nuestras capacidades, considere una demostración del producto o contacte a nuestro equipo en hello@didit.me.

Preguntas Frecuentes

¿Qué es un SDK KYC Reutilizable?

Un SDK KYC Reutilizable es un kit de desarrollo de software que permite a los usuarios verificar su identidad una vez con un emisor de confianza y luego reutilizar de forma segura y sin permiso esos atributos verificados en múltiples proveedores de servicios, a menudo a través de credenciales verificables almacenadas en una cartera digital.

¿Cómo impacta eIDAS2 a los SDKs KYC Reutilizables?

eIDAS2 exige la creación de Carteras Europeas de Identidad Digital (EUDI), que almacenarán credenciales verificables. Los SDKs KYC Reutilizables deben diseñarse para ser compatibles con los estándares eIDAS2, soportando la emisión, almacenamiento y presentación de estas credenciales, adhiriéndose a estrictos requisitos de autenticación y privacidad.

¿Qué son las Credenciales Verificables (VCs) y cómo funcionan con una API de Cartera de Identidad?

Las Credenciales Verificables (VCs) son pruebas digitales a prueba de manipulaciones de afirmaciones (p. ej., edad, nacionalidad, dirección) firmadas criptográficamente por un emisor. Una API de Cartera de Identidad permite a una aplicación interactuar con la cartera digital de un usuario para solicitar, recibir y verificar estas VCs, posibilitando el intercambio seguro y privado de datos basado en el consentimiento del usuario.

¿Qué hace que la plataforma de Didit sea adecuada para construir un SDK KYC Reutilizable?

Didit ofrece primitivas de identidad clave (IDV, biometría, AML) para emitir credenciales verificables, APIs y SDKs robustos para la integración, y un motor de flujo de trabajo para la orquestación. Su compatibilidad con eIDAS2 y su enfoque en la seguridad y la privacidad proporcionan una base sólida para desarrollar soluciones KYC reutilizables conformes y centradas en el usuario.

Infraestructura para identidad y fraude.

Una API para KYC, KYB, Monitoreo de Transacciones y Detección de Fraude en Wallets. Intégrala en 5 minutos.

Pide a una IA que resuma esta página
Diseño SDK KYC Reutilizable: eIDAS2 y Credenciales.