FAQ SDK
Nesta FAQ, você encontrará as dúvidas mais comuns relacionadas ao componente SDK da plataforma IDCloud
Qual a importância de implementar o SDK no seu projeto?
Os SDKs contam com recursos de criptografia e segurança contra injection de imagens, 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. Além disso, é o pré-requisito para a utilização da capacidade de Prova de vida.
Qual é o diferencial do SDK da Unico?
Os SDKs da unico possuem funcionalidades de segurança anti fraude e usabilidade adaptados a diferentes fluxos, tais como: Liveness com interação, câmera inteligente, câmera normal e captura de documentos.
Quais as camadas de segurança dos SDKs da Unico?
Os SDKs possuem diversas camadas de segurança que funcionam de forma complementar, tanto no nivel da aplicação quanto em relação aos dados trafegados entre os SDKs e o backend. O SDK possui ofuscação de código, bloqueio de emulador e checagem de bundle do aplicativo que a está executando.
Quais os pré-requisitos para começar o desenvolvimento da SDK?
Android: É necessário que seu ambiente de desenvolvimento esteja de acordo com os seguintes pré-requisitos:
Possuir a versão 9 ou superior do Android Studio instalado (IDE oficial de desenvolvimento do Google);
Possuir a versão do SDK Android na versão 21 ou superior;
Possuir o repositório Maven da Unico configurado.
iOS: É necessário que seu ambiente de desenvolvimento esteja de acordo com os seguintes pré-requisitos:
Possuir a versão 15.0.1 ou superior do Xcode instalado (IDE oficial de desenvolvimento da Apple);
Possuir a versão do SDK iOS na versão 11 ou superior;
Possuir o gerenciador de dependências Cocoapods ou Swift Package Manager já configurado.
Flutter: É necessário que seu ambiente de desenvolvimento esteja de acordo com os seguintes pré-requisitos:
Possuir o Developer SDK do Flutter instalado.
Web: É necessário ter realizado a implantação do SDK Web em uma aplicação que contenha um domínio seguro com protocolo https.
Quais as versões mínimas de sistemas operacionais que a Unico suporta para Android, iOS e Web?
A SDK da Unico suporta as seguintes versões mínimas de sistemas operacionais:
Android: A partir da versão 5.1 (Lollipop).
iOS: A partir da versão 11.0.
Web: Não há nenhuma versão mínima de sistema operacional para Web, mas a SDK é compatível com os principais navegadores modernos.
Quais são os browsers compatíveis com a SDK?
iOS: Chrome, Firefox, Safari.
Android: Chrome, Samsung Internet.
MacOS (desktop): Chrome, Firefox, Safari.
Windows (desktop): Chrome, Firefox.
Qual é o tamanho do SDK Android?
O SDK Android da Unico aumenta o tamanho do seu aplicativo em 30MB.
Qual é o tamanho do SDK iOS?
O SDK iOS da Unico aumenta o tamanho do seu aplicativo em 23.7MB.
A SDK pode ser usada em ambientes híbridos, como Flutter ou React Native?
Possuímos o plugin de Flutter, portanto a implementação será mais simples. Em relação a outros frameworks híbridos, como React Native ou Ionic, você precisará implementar a SDK da Unico em uma camada nativa e criar uma “bridge” para compatibilizar o framework com a SDK.
É importante mencionar que o 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.
Como obtenho as credenciais para implementar SDK?
Para obter as credenciais de utilização da SDK, fale com o CSM responsável pela sua conta ou no contate via suporte através da central de ajuda: https://empresas.unico.io/hc/pt-br/p/atendimentoparaempresas.
Qual objeto retornado pela SDK eu devo enviar na API?
O objeto que deve ser enviado na API após a utilização do SDK da Unico é o objeto encrypted. Este objeto contém as informações necessárias, de forma segura e criptografada, para a validação de identidade e autenticação.
Qual é o tamanho JWT gerado pelo SDK?
Não garantimos um tamanho exato do JWT porque a Unico constantemente evolui suas tecnologias e pode realizar modificações que alterem para mais ou para menos o tamanho médio de um JWT. Por conta dessas condições, garanta que sua aplicação não restrinja o tamanho do JWT a um valor fixo durante a integração com o SDK.
Qual a rigidez da segurança do JWT? Qual o nível de criptografia?
Os arquivos trafegam em um canal seguro usando criptografia TLS na versão 1.3. Cada arquivo também é criptografado usando o formato JWS (Json Web Signature), que contém as informações da criptografia, os dados a serem enviados e uma assinatura para o token gerado. A principal ferramenta de segurança do JWS é a assinatura, que é invalidada caso o conteúdo seja alterado. Além disso, os prazos de expiração dos tokens são curtos, então a janela para qualquer ataque é pequena.
Posso abrir o objeto encrypted para obter o base64 da foto do usuário?
O encrypted, que é um objeto JWT que deve ser deve ser enviado na chamada das APIs REST. O JWT (Encrypted) deve ser utilizado estritamente durante o envio da imagem através das APIs da Unico. Não se deve abrir e/ou serializar esse atributo, pois suas características podem ser alteradas sem aviso prévio. Seu uso deve ser exclusivo nas interações com as APIs para garantir a integridade e segurança dos dados. A Unico não se responsabiliza por quaisquer danos decorrentes dessa prática, uma vez que as modificações podem ocorrer de maneira imprevista. Como dito, a SDK já fornece o atributo Base64 para obter a imagem em questão.
A SDK oferece suporte para dispositivos mais antigos?
A SDK da Unico oferece suporte para sistemas operacionais que existem há muito tempo no mercado, como Android: A partir da versão 5.1 (Lollipop) e iOS: A partir da versão 11.0. Portanto, de forma indireta damos suporte para dispositivos antigos que contenham versões iguais ou superiores às versões de sistemas operacionais mencionados anteriormente.
É possível alterar os textos da SDK?
Não, atualmente não é possível customizar os textos da SDK, somente seu idioma.
É possível personalizar o idioma da SDK?
É possível configurar a experiência das mensagens informativas dos frames de captura alterando seu idioma. Utilize o enumerado LocaleTypes que contém os seguintes valores:
LocaleTypes.PT_BR: para Português(Brasil);
LocaleTypes.ES_MX: para Espanhol(México);
LocaleTypes.ES_ES: para Espanhol(Espanha);
LocaleTypes.EN_US: para Inglês(EUA).
OBS: Pode ser necessário uma ativação remota para ser utilizado, caso deseje usar, por favor acionar o CSM da conta. Caso não seja configurado, por padrão o SDK utiliza o Português como idioma principal.
É possível customizar o Layout da câmera?
É possível. Tanto para Android, iOS e JS, são disponibilizados métodos para a customização. Para saber mais basta clicar na documentação respectiva. Exemplo: ao clicar no ícone do Android, as funcionalidades são apresentadas. Selecionar “customizações” Android e iOS. Em implementação, todos os itens que podem ser customizados e as demais especificações são apresentados.
A SDK da Unico funciona com iFrames?
É possível utilizar o SDK Web com Liveness Interativo embarcado em um iFrame, para isso é preciso realizar uma implementação semelhante a seção anterior na preparação da câmera. A preparação da câmera será efetuada através do método prepareSelfieCameraForIFrame(), também disponibilizado a partir do builder. Este método recebe os mesmos parâmetros do prepareSelfieCamera().
A SDK da Unico funciona em webviews?
Sim, a SDK da Unico pode funcionar em webviews. Isso permite que você integre as funcionalidades de autenticação de identidade e captura de documentos em aplicativos que utilizam webviews para exibir conteúdo web. Para garantir uma implementação correta e verificar quaisquer limitações ou considerações específicas ao usar a SDK em webviews, recomendo consultar a documentação oficial da Unico.
A SDK funciona em câmera traseira?
Atualmente a SDK da Unico não é compatível com câmeras traseiras.
Quais documentos consigo capturar com a SDK da Unico?
A captura dos seguintes tipos de documentos está disponível:
CNH: Captura da CNH aberta;
CNH frente: Captura da frente da CNH;
CNH verso: Captura do verso da CNH;
CPF: Captura do documento de CPF;
RG frente: Captura da frente do RG;
RG verso: Captura do verso do RG;
Novo RG frente: Captura a frente do novo tipo de RG;
Novo RG verso: Captura o verso do novo tipo de RG;
Outros: Captura documento genérico.
Como faço para saber sobre novas atualizações do SDK?
Existem duas formas de saber sobre as atualizações do SDK:
Consulte o CSM da sua conta para que ele possa inseri-lo no nosso mailing de comunicação;
Acesse a nossa documentação regularmente para consultar o release notes.
Como faço para baixar as novas atualizações do SDK?
Para baixar as novas atualizações, primeiro confira o descritivo da versão no Release Notes - que se encontra na documentação - e posteriormente incremente a tag de implementação dentro do seu projeto.
Quando saber que o SDK possui versões mais atualizadas do que a que estou usando?
É possível se inscrever, junto ao gerente de contas, no newsletter da Unico. Assim as novidades são recebidas através do email. Também é possível saber através da documentação, na aba de Release Notes, onde se encontram as informações sobre as últimas atualizações do SDK.
Conflitos entre arquivos AndroidManifest envolvendo o meta-data com.google.mlkit.vision.DEPENDENCIES. O que fazer?
com.google.mlkit.vision.DEPENDENCIES. O que fazer?Em cenários onde ocorrem conflitos entre os arquivos de AndroidManifest envolvendo dependências com.google.mlkit.vision, basta adicionar a tag tools:replace="android:value" dentro do meta-data, como mostrado a seguir:
Dúvidas?
Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.
Atualizado