Inicialização

O que é IDV Mobile

IDV (Verificação de Identidade) é o fluxo que permite verificar e autenticar a identidade de uma pessoa por meio da captura e validação de traços biométricos.

O fluxo é configurado previamente na plataforma da Facephi e é executado na aplicação por meio de seu identificador (flowId).

Dependências necessárias

A seguir, detalha-se a lista de dependências dos componentes disponíveis para integrar um Fluxo de IDV no iOS. Instale somente os componentes de captura que tenham sido licenciados.

CocoaPods

// CORE
pod 'FPHISDKMainComponent', '~> $VERSION'
pod 'FPHISDKTrackingComponent', '~> $VERSION'
pod 'FPHISDKStatusComponent', '~> $VERSION'
pod 'FPHISDKTokenizeComponent', '~> $VERSION'
// COMPONENTES DE CAPTURA
pod 'FPHISDKSelphIDComponent', '~> $VERSION'
pod 'FPHISDKSelphiComponent', '~> $VERSION'
pod 'FPHISDKNFCComponent', '~> $VERSION'
pod 'FPHISDKCaptureComponent', '~> $VERSION'
pod 'FPHISDKVideoRecordingComponent', '~> $VERSION'

Para facilitar o processo de integração, é apresentada uma tabela que faz referência à dependência de cada componente:

Componente	Dependência	Controlador
Selfie	FPHISDKSelphiComponent	SelphiController
Selfie (com funcionalidade IAD)	FPHISDKSelphiIADComponent	SelphiController
Documento	FPHISDKSelphIDComponent	SelphIDController
Videogravação	FPHISDKVideoRecordingComponent	VideoRecordingController / StopVideoRecordingController
NFC	FPHISDKNFCComponent	NFCController

Swift Package Manager (SPM)

// CORE (OBRIGATÓRIOS)
[email protected]:facephi-clienters/SDK-SdkPackage-SPM.git
[email protected]:facephi-clienters/SDK-TrackingPackage-SPM.git
[email protected]:facephi-clienters/SDK-StatusPackage-SPM.git
[email protected]:facephi-clienters/SDK-TokenizePackage-SPM.git
// COMPONENTES DE CAPTURA
[email protected]:facephi-clienters/SDK-SelphidMBSDRComponent-SPM.git
[email protected]:facephi-clienters/SDK-Selphi_component-SPM.git
[email protected]:facephi-clienters/SDK-NFC_component-SPM.git
[email protected]:facephi-clienters/SDK-VideoRecording-SPM.git

Para facilitar o processo de integração, é apresentada uma tabela que faz referência à dependência de cada componente:

Componente	Dependência	Controlador
Selfie	[email protected]:facephi-clienters/SDK-Selphi_component-SPM.git	SelphiController
Selfie (com funcionalidade IAD)	[email protected]:facephi-clienters/SDK-Selphi_IAD_component-SPM.git	SelphiController
Documento	[email protected]:facephi-clienters/SDK-SelphidMBSDRComponent-SPM.git	SelphIDController
Videogravação	[email protected]:facephi-clienters/SDK-VideoRecording-SPM.git	VideoRecordingController / StopVideoRecordingController
NFC	[email protected]:facephi-clienters/SDK-NFC_component-SPM.git	NFCController

O SDK conta com várias bibliotecas que adicionam funcionalidade.

• Status -> Permite que o SDK mostre telas de tutorial e diagnóstico para cada componente, melhorando a experiência do usuário.

• Tokenize -> Alguns serviços requerem o envio dos assets tokenizados. Esta biblioteca adiciona os valores tokenizados à resposta do componente.

Inicializar o SDK

O SDK funciona por meio de um controlador principal (SDKController), que deve ser inicializado corretamente antes de poder iniciar qualquer Fluxo.

Facephi fornecerá o apiKey da Licença necessária para a Inicialização.

Após uma Inicialização correta, o aplicativo terá acesso a todos os Fluxos configurados para esse projeto.

let trackingController = TrackingController(trackingError: { trackingError in
    print(\"TRACKING ERROR: \\(trackingError)\")
}, enableLocation: enableLocation, debug: debugFlag)

SDKController.shared.initSdk(
        licensingUrl: SdkConfigurationManager.LICENSING_URL,
        apiKey: SdkConfigurationManager.APIKEY_LICENSING_IDV,
        output: { sdkResult in
            if sdkResult.finishStatus == .STATUS_OK {
                self.log("Licença automática configurada corretamente")
            } else {
                self.log("Ocorreu um erro ao tentar obter a licença: \(sdkResult.errorType)")
            }
        },
        trackingController: trackingController,
        tokenizeController: tokenizeController,
        statusController: statusController,
        analyticsOutput: { time, component, type, info  in
            self.log("Analytics: \(Date()) \(component) - \(type) - \(info)")
        })

Lançar um fluxo de IDV

O fluxo de IDV é lançado por meio de um FlowController, indicando:

• O ID do fluxo configurado na plataforma (flowId).

• O ID do cliente (customerId).

• O ID de autenticação (authenticationId). Apenas necessário se estivermos diante de um Fluxo de autenticação.

• A lista de controladores que podem participar no processo.

Exemplos de controladores comuns:

• SelphiController → Captura Facial.

• SelphIDController → Captura de documentos.

• StartVideoRecordingController / StopVideoRecordingController → Gravação do processo.

public func launchFlow(viewController: UIViewController, output: @escaping (SdkFlowResult) -> Void) {
        let selphidController = SelphIDController(data: nil, output: {
            print("SelphidController output: \($0.errorType)")
        }, viewController: viewController)
        
        let selphiController = SelphiController(data: nil, output: {
            print("SelphiController output: \($0.errorType)")
        }, viewController: viewController)
        
        let startVideoRecordingController = VideoRecordingController(viewController: viewController, output: {
            print("videoRecordingController output: \($0.errorType)")
        })
        
        let stopVideoRecordingController = StopVideoRecordingController(videoRecordingController: startVideoRecordingController, output: {
            print("stopVideoRecordingController output: \($0.errorType)")
        })
        
        let controllers: [IFlowableController] =
        [selphidController, selphiController, startVideoRecordingController, stopVideoRecordingController]
        
        let flowConfigurationData = FlowConfigurationData(
            id: 340260c3-0428-41d7-91c7-13c2a122cfc3,
            controllers: controllers,
            customerId: SdkConfigurationManager.customerId,
            authenticationId: authenticationId) // Parámetro opcional
        
        let flowController = SdkConfigurationManager.offlineFlow ? FlowOfflineController(flowConfigurationData: flowConfigurationData, output: output): FlowController(flowConfigurationData: flowConfigurationData, output: output)
        self.flowController = flowController
        SDKController.shared.launch(controller: flowController)
}

Consultar fluxos disponíveis

Se você precisar obter os fluxos disponíveis antes de lançar um deles, use:

SDKController.shared.getFlowIds()

A função retorna uma lista com o identificador do Fluxo e sua tipo de operação.