Instalação

AMBIENTE DE DESENVOLVIMENTO

É 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.

UTILIZANDO O COCOAPODS

O CocoaPods é um gerenciador de dependências para projetos Cocoa, para instruções de uso e instalação visite a documentação do oficial do Cocoapods. Para integrar o SDK iOS em seu projeto Xcode usando CocoaPods, siga as orientações abaixo:

Inclua o unicocheck-ios em seu Podfile:

pod ‘unicocheck-ios’

Em seguida, basta utilizar o comando em seu terminal para instalar as dependências:

pod install

Atenção

Se estiver executando o projeto em .xcodeproj é necessário abrir o projeto em .xcworkspace.

UTILIZANDO O SWIFT PACKAGE MANAGER (SPM)

O Swift Package Manager é um gerenciador de dependências para projetos Swift. Ele é integrado ao sistema de compilação Swift para automatizar o processo de download, compilação e vinculação de dependências. Para integrar o SDK iOS em seu projeto usando o SPM, siga as orientações abaixo:

Inclua a dependência em seu arquivo Package.swift:

Package.swift
dependencies: [
    .package(url: "https://github.com/acesso-io/unico-check-ios.git", .upToNextMajor(from: "2.12.0"))
]

PERMISSÕES PARA UTILIZAÇÃO DA CÂMERA

Para utilizar o método de abertura de câmera em seu projeto é necessário adicionar as permissões antes de compilar a sua aplicação:

Info.plist
<key>NSCameraUsageDescription</key>
<string>Camera usage description</string>

OBTENDO AS CREDENCIAIS

Para utilizar o SDK iOS é necessário obter a credencial SDK Key, uma chave única de identificação do cliente gerada pela equipe da Unico.

Entre em contato com o CSs e/ou time de Onboarding.
Solicite a SDK Key informando os identificadores de suas aplicações. Bundle Identifier para iOS, PackageID para Android e Host para WEB.
Os identificadores de suas aplicações serão vinculados a SDK Key pela equipe da Unico.
Você recebe a sua SDK Key para implementar o AcessoBioConfigDataSource

Credenciais (Client API Key) - Método Depreciado

Para importar as credenciais (Client API Key) em seu projeto, utilize o guia a seguir:

Acesse a sua instância com o login e senha;
Role a barra de menus para baixo e clique no menu Configurações, em seguida clique no menu Integração e por fim clique no menu API Key;
Para criar uma API Key clique em + Nova API Key ou para editar clique sob a API Key desejada;
Se desejar utilizar o modo câmera de selfie com Liveness, verifique se o campo Utiliza liveness com interação está preenchido com a opção SIM. Se estiver preenchido com NÃO, ou não estiver aparecendo, entre em contato com o suporte através da Central de ajuda e solicite a ativação; Para mais informações sobre LIVENESS COM INTERAÇÃO, clique aqui.
No campo Utiliza autenticação segura na SDK selecione a opção Sim;
Expanda a seção SDK iOS, adicione a identificação do projeto e o Bundle ID;
Por fim, clique em Salvar;
Volte para a seção APIKey;
Escolha a API Key configurada, na coluna Bundle, clique no botão de Download;
Uma nova seção é aberta, selecione a opção iOS;
NOTA
Se a aba não abrir, verifique se o seu navegador está bloqueando os pop-ups.
Clique em Gerar e automaticamente uma nova aba é aberta em seu navegador contendo informações do projeto em formato JSON;
Salve esse JSON.

Para embarcar a SDK Key ao projeto, implemente o protocolo AcessoBioConfigDataSource em sua classe.

Objective-c
Swift

.h:
#import <AcessoBio/AcessoBioManager.h>
#import <AcessoBio/AcessoBio-Swift.h>

@interface YourUnicoConfigClass: AcessoBioConfigDataSource {}
@end

.m:
@implementation YourUnicoConfigClass

- (NSString * _Nonnull)getBundleIdentifier {
    return @"<YOUR_MOBILE_BUNDLE_IDENTIFIER>";
}

- (NSString * _Nonnull)getHostKey {
    return @"<YOUR_SDK_KEY>";
}

@end

import AcessoBio

class YourUnicoConfigClass: AcessoBioConfigDataSource {
          
    func getBundleIdentifier() -> String {
        return "<YOUR_MOBILE_BUNDLE_IDENTIFIER>"
    }
        
    func getHostKey() -> String {
        return "<YOUR_SDK_KEY>"
    }
}

Credenciais (Client API Key) - Método Depreciado

Objective-c
Swift

.h:
#import <AcessoBio/AcessoBioManager.h>
#import <AcessoBio/AcessoBio-Swift.h>

@interface YourUnicoConfigClass: AcessoBioConfigDataSource {}
@end

.m:
@implementation YourUnicoConfigClass

- (NSString * _Nonnull)getBundleIdentifier {
    return @"<YOUR_MOBILE_BUNDLE_IDENTIFIER>";
}

- (NSString * _Nonnull)getHostInfo {
    return @"<YOUR_HOST_INFO>";
}

- (NSString * _Nonnull)getHostKey {
    return @"<YOUR_HOST_KEY>";
}

- (NSString * _Nonnull)getMobileSdkAppId {
    return @"<YOUR_MOBILE_SDK_APP_ID>";
}

- (NSString * _Nonnull)getProjectId {
    return @"<YOUR_PROJECT_ID>";
}

- (NSString * _Nonnull)getProjectNumber {
    return @"<YOUR_PROJECT_NUMBER>";
}

@end

import AcessoBio

class YourUnicoConfigClass: AcessoBioConfigDataSource {
        
    func getProjectNumber() -> String {
        return "<YOUR_PROJECT_NUMBER>"
    }
    
    func getProjectId() -> String {
        return "<YOUR_PROJECT_ID>"
    }
    
    func getMobileSdkAppId() -> String {
        return "<YOUR_MOBILE_SDK_APP_ID>"
    }
    
    func getBundleIdentifier() -> String {
        return "<YOUR_MOBILE_BUNDLE_IDENTIFIER>"
    }
    
    func getHostInfo() -> String {
        return "<YOUR_HOST_INFO>"
    }
    
    func getHostKey() -> String {
        return "<YOUR_HOST_KEY>"
    }
}

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.

AMBIENTE DE DESENVOLVIMENTO​

UTILIZANDO O COCOAPODS​

UTILIZANDO O SWIFT PACKAGE MANAGER (SPM)​

PERMISSÕES PARA UTILIZAÇÃO DA CÂMERA​

OBTENDO AS CREDENCIAIS​

Dúvidas?​