Visão Geral

Os SDK's da plataforma Unico IDCloud tem como objetivo potencializar a segurança do seu negócio e dos seus clientes, permitindo inclusive personalizar a experiência de uso aplicando a identidade visual da sua marca. Os SDKs abstraem a complexidade de manipulação da câmera do dispositivo dos usuários e a captura de imagens (Selfie e documento), facilitando a vida do desenvolvedor e reduzindo o tempo de entrega do produto final. Outras vantagens:

• Prova de vida: Os SDK's são utilizados em conjunto com a capacidade de Prova de vida para garantir que o usuário esteja ao vivo no momento de captura da selfie;

• Precisão na captura de imagens: Os SDKs possuem recursos que auxiliam o usuário a obter fotos biometricamente válidas, reduzindo o drop das imagens quando comparados a captura realizada pelas câmeras padrões dos dispositivos. São adicionados SmartFrames, “elementos chave“ que se ajustam automaticamente à silhueta e proporção da tela do usuário permitindo uma melhor captura da imagem;

• Segurança reforçada: Recursos de criptografia e segurança contra injection de imagens, possuindo também funcionalidades que previnem fraudes adaptadas a diferentes modos de câmera. Camadas de segurança que funcionam de forma complementar, tanto a nível da aplicação quanto em relação aos dados que são trafegados entre os SDKs e o backend. O SDK também inclui ofuscação de código, bloqueio de emulador e checagem de bundle do aplicativo que a está executando.

A captura das imagens por meio dos SDKs é apenas a primeira parte de sua jornada. Sendo assim, é de extrema importância que entenda os conceitos básicos e o funcionamento das APIs do motor biométrico. Para mais informações, veja sobre a API REST do by Client.

Atualizações dos SDKs

É importante ressaltar que para o bom funcionamento das nossas soluções, com o máximo de segurança e estabilidade, é imprescindível que o SDK esteja devidamente atualizado. É responsabilidade do cliente acompanhar e garantir que está utilizando a versão mais recente do SDK disponível em nossos servidores.

A Unico não se responsabiliza por problemas decorrentes de falta de atualização do SDK na operação do cliente. [Saiba mais sobre nossa Política de Atualização da SDK aqui]

Diagrama de Funcionamento

O SDK (Client-side) é responsável por simplificar sua integração com a plataforma Unico IDCloud, absorvendo toda a complexidade da manipulação da câmera e captura de imagens.

Se a captura for feita com sucesso, o SDK retorna um objeto que deve ser enviado para a API do motor biométrico, completando assim a validação biométrica, conforme diagrama exemplificado abaixo:

1

O usuário acessa sua aplicação

2

Através do SDK, sua aplicação solicita o frame para captura (de acordo como foi configurada a sua aplicação)

3

Sua aplicação renderiza o frame para captura em um placeholder pré estabelecido

4

O SDK captura a imagem, gerando um token JWT que será retornado para a sua aplicação

5

Sua aplicação repassa o JWT para seu servidor

6

Seu servidor interage com as APIs do motor biométrico para analisar a imagem (através das APIs REST do by Client)

7

Os servidores retornam a resposta do motor biométrico, que deve ser enviada para sua aplicação

8

Sua aplicação disponibiliza uma resposta ao usuário

Requisitos suportados por cada Client SDK

A seguir, informações e requisitos necessários, oficialmente suportados por cada Client SDK da Unico:

SDK Android	SDK iOS	SDK Web
Plugins: Flutter Linguagens: Java/Kotlin Android​: 5.0 (API 21) Kotlin​: 1.6	Xcode: >= 15.0 Plugins: Flutter Linguagens: swift/objective-c iOS: >= 11 Gerenciador de dependência: Cocoapods ou Swift Package Manager	Frameworks: React JS, Angular, Next JS, Vue JS e JS Vanilla. Versão Javascript: ECMAScript 5 ou superiores.

Nosso suporte é restrito a aplicativos desenvolvidos diretamente nas plataformas nativas Android e iOS, utilizando seus respectivos módulos nativos, além do framework Flutter (se a implementação for utilizando nosso plugin). No momento, não oferecemos suporte para aplicativos desenvolvidos em frameworks híbridos, como React Native, Ionic ou outras tecnologias de desenvolvimento multiplataforma.

Versionamento dos SDKs

Os SDKs da plataforma Unico IDCloud possuem um versionamento semântico, sendo assim, há numeração de versão "MAJOR.MINOR.PATCH", descrita da seguinte forma:

• Versão Maior(MAJOR): Quando fizer mudanças incompatíveis na API;

• Versão Menor(MINOR): Quando adicionar funcionalidades mantendo compatibilidade;

• Versão de Correção (PATCH): Quando corrigir falhas mantendo compatibilidade.