FAQ SDK
Nesta FAQ, você encontrará as dúvidas mais comuns relacionadas ao componente SDK da plataforma IDCloud
Atualizado
Nesta FAQ, você encontrará as dúvidas mais comuns relacionadas ao componente SDK da plataforma IDCloud
Atualizado
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.
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.
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.
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 16.0 ou superior do Xcode instalado (IDE oficial de desenvolvimento da Apple);
Possuir a versão do SDK iOS na versão 12 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.
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 12.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.
iOS: Chrome, Firefox, Safari.
Android: Chrome, Samsung Internet.
MacOS (desktop): Chrome, Firefox, Safari.
Windows (desktop): Chrome, Firefox.
O SDK Android da Unico aumenta o tamanho do seu aplicativo em 30MB.
O SDK iOS da Unico aumenta o tamanho do seu aplicativo em 31MB.
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.
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.
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.
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.
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.
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 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 12.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.
Não, atualmente não é possível customizar os textos da SDK, somente seu idioma.
É 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. 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.
É 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().
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.
Atualmente a SDK da Unico não é compatível com câmeras traseiras.
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.
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.
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.
É 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.
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.
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.