SDKs e Ferramentas
Os SDKs da Unico se integram diretamente à sua aplicação para gerenciar a experiência de captura no lado do cliente. Após uma captura bem-sucedida, o SDK retorna um payload criptografado que o seu backend encaminha para o mecanismo biométrico do IDCloud para análise via API REST.
SDKs disponíveis
Biblioteca nativa para aplicações Java e Kotlin.
Biblioteca nativa para aplicações Swift e Objective-C.
Plugin construído sobre os SDKs nativos Android e iOS.
Biblioteca JavaScript para fluxos de captura baseados em navegador.
Apps de exemplo (PoCs)
Explore aplicativos oficiais de Proofs of Concept (PoCs) para cada SDK antes de iniciar sua integração — implementações validadas e atualizadas dos principais fluxos de captura.
SDKs Nativos
| Plataforma | Fluxo | Repositório |
|---|---|---|
| Android | Prova de Vida | GitHub — unico-sdk-poc-kotlin |
| Android | User Journeys | GitHub — unico-sdks-poc-kotlin |
| iOS | Prova de Vida | GitHub — unico-sdk-poc-ios-swift |
| iOS | User Journeys | GitHub — unico-sdks-poc-swift |
| Flutter | Prova de Vida | GitHub — unico-sdk-poc-flutter |
| Flutter | User Journeys | GitHub — unico-sdks-flutter |
Integração Web App (SDK de Jornadas)
| Linguagem / Framework | Repositório |
|---|---|
| Angular | GitHub — unico-cbu-poc-angular |
| JS Vanilla | GitHub — unico-cbu-poc-js |
| React | GitHub — unico-cbu-poc-react |
| Vue JS | GitHub — unico-cbu-poc-vuejs |
Web SDK
| Linguagem / Framework | Repositório |
|---|---|
| Angular | GitHub — unico-sdk-poc-angular |
| JS Vanilla | GitHub — unico-sdk-poc-js-vanilla |
| Next.js | GitHub — unico-sdk-poc-next-js |
| React JS with TypeScript | GitHub — unico-webframe-poc-react |
| React JS with JavaScript | GitHub — unico-sdk-poc-react-js |
| React JS with Webpack + Babel | SFTP — solicite ao seu Gerente de Projeto |
| Vue JS | GitHub — unico-sdk-poc-vuejs |
Recursos principais
Os SDKs se integram com a capacidade de Liveness para confirmar que o usuário está fisicamente presente no momento da captura. A sessão de captura só é concluída quando o liveness é verificado, bloqueando tentativas de spoofing como fotos, vídeos ou máscaras.
A UI de captura se adapta automaticamente à silhueta do usuário e às dimensões da tela. Isso melhora a validade biométrica e reduz capturas rejeitadas em comparação com implementações de câmera padrão, sem exigir nenhuma configuração por parte do desenvolvedor.
Camadas de segurança
Cada SDK vem com múltiplos controles de segurança aplicados em tempo de execução:
- Criptografia de payload entre cliente e backend
- Prevenção de injeção e adulteração
- Detecção de fraude em diferentes modos de câmera
- Ofuscação de código
- Bloqueio de emuladores
- Verificação de bundle da aplicação
Como funciona
O SDK (lado do cliente) é responsável por simplificar a sua integração com a plataforma Unico, tratando toda a complexidade de manipulação de câmera, captura de imagem e jornada do usuário.
Se a captura for bem-sucedida, o SDK retorna um payload criptografado que deve ser enviado para a API do mecanismo biométrico, completando assim a validação biométrica, conforme ilustrado no diagrama abaixo:
O SDK gerencia o fluxo completo de captura no cliente: acesso à câmera, validação de frame, verificação de liveness e criptografia. O seu backend recebe o payload criptografado e o encaminha para o mecanismo biométrico do IDCloud — nenhuma imagem bruta é transmitida.
Esses SDKs produzem saída para o contrato Web & SDK (POST /client/v1/process). Para o contrato de API, a captura é realizada na sua própria surface e o imageBase64 é enviado diretamente.
As versões dos SDKs seguem semantic versioning (MAJOR.MINOR.PATCH). A responsabilidade pela atualização do SDK depende do modelo de integração. Para integrações by-Client, manter o SDK atualizado é sua responsabilidade — versões desatualizadas podem perder cobertura de segurança ou acesso a novas capacidades. Para integrações by-Unico, a Unico envia as atualizações automaticamente.
- Versão Maior (MAJOR): Quando há alterações incompatíveis na API.
- Versão Menor (MINOR): Quando funcionalidades são adicionadas mantendo compatibilidade.
- Versão de Patch (PATCH): Quando bugs são corrigidos mantendo compatibilidade.
Suportados: Android nativo, iOS nativo e Flutter via nosso plugin. Não suportados: qualquer framework híbrido ou cross-platform, incluindo, mas não se limitando a, React Native e Ionic.