SDKs y Herramientas
Los SDKs de Unico se integran directamente en tu aplicación para gestionar la experiencia de captura en el lado del cliente. Tras una captura exitosa, el SDK devuelve un payload cifrado que tu backend reenvía al motor biométrico de IDCloud para su análisis a través de la API REST.
SDKs disponibles
Biblioteca nativa para aplicaciones Java y Kotlin.
Biblioteca nativa para aplicaciones Swift y Objective-C.
Plugin desarrollado sobre los SDKs nativos de Android e iOS.
Aplicaciones de referencia
Unico ofrece una aplicación de referencia para cada SDK en el repositorio reference-apps. Cada aplicación implementa la jornada completa del usuario.
SDKs nativos
| Plataforma | Repositorio |
|---|---|
| Android | GitHub — reference-apps/android |
| iOS | GitHub — reference-apps/ios |
| Flutter | GitHub — reference-apps/flutter |
Integración de Aplicación Web (SDK de Jornadas)
| Lenguaje / Framework | Repositorio |
|---|---|
| Node.js (Express) | GitHub — reference-apps/web |
Funcionalidades principales
Los SDKs se integran con la capacidad de Liveness para confirmar que el usuario está físicamente presente en el momento de la captura. La sesión de captura solo se completa cuando se verifica el liveness, bloqueando intentos de suplantación como fotos, videos o máscaras.
La interfaz de captura se adapta automáticamente a la silueta del usuario y a las dimensiones de la pantalla. Esto mejora la validez biométrica y reduce las capturas rechazadas en comparación con las implementaciones de cámara estándar, sin requerir ninguna configuración por parte del desarrollador.
Capas de seguridad
Cada SDK incluye múltiples controles de seguridad aplicados en tiempo de ejecución:
- Cifrado del payload entre cliente y backend
- Prevención de inyección y manipulación
- Detección de fraude en todos los modos de cámara
- Ofuscación de código
- Bloqueo de emuladores
- Verificación del bundle de la aplicación
Cómo funciona
El SDK (lado del cliente) es responsable de simplificar tu integración con la plataforma Unico, gestionando toda la complejidad de la manipulación de la cámara, la captura de imágenes y el recorrido del usuario.
Si la captura es exitosa, el SDK devuelve un payload cifrado que debe enviarse a la API del motor biométrico, completando así la validación biométrica, tal como se ilustra en el diagrama a continuación:
El SDK gestiona el flujo de captura completo en el cliente: acceso a la cámara, validación de fotogramas, verificación de liveness y cifrado. Tu backend recibe el payload cifrado y lo reenvía al motor biométrico de IDCloud — ninguna imagen en bruto es transmitida.
Estos SDKs producen la salida para el contrato Web & SDK (POST /client/v1/process). Para el contrato API, la captura se gestiona en tu propia superficie y imageBase64 se envía directamente.
Las versiones del SDK siguen el versionamiento semántico (MAJOR.MINOR.PATCH). La responsabilidad de actualizar el SDK depende de tu modelo de integración. En integraciones by-Client, mantener el SDK actualizado es tu responsabilidad — las versiones desactualizadas pueden perder cobertura de seguridad o acceso a nuevas capacidades. En integraciones by-Unico, Unico aplica las actualizaciones automáticamente.
- Versión Mayor (MAJOR): Al realizar cambios incompatibles con la API.
- Versión Menor (MINOR): Al agregar funcionalidades manteniendo la compatibilidad.
- Versión de Parche (PATCH): Al corregir errores manteniendo la compatibilidad.
Compatible: Android nativo, iOS nativo y Flutter mediante nuestro plugin. No compatible: ningún framework híbrido o multiplataforma, incluidos, entre otros, React Native e Ionic.