Conectando o SDK à API

Para conectar o SDK ao Oz API, especifique a URL da API, token de acesso, e SSL pins como mostrado abaixo.

Kotlin

OzLivenessSDK.setApiConnection(OzConnection.fromServiceToken(host, token, sslPins))

Java

OzLivenessSDK.INSTANCE.setApiConnection(
        OzConnection.Companion.fromServiceToken(host, token, sslPins), 
        null
);

Observe:

• No aplicativo host, recomenda-se definir o endereço da API na tela que precede a verificação de Liveness. Definir a URL da API inicia uma chamada de serviço para a API, o que pode causar carga excessiva no servidor quando isso for feito na inicialização ou no startup do aplicativo. Recomendamos chamar o setApiConnection método uma vez, por exemplo, na Application classe.

• A ordem de inicialização do SDK e da conexão com a API não importa, mas ambos os métodos devem ser concluídos com sucesso antes de invocar o createStartIntent método.

Como alternativa, é possível usar o login e a senha fornecidos pelo gerente de conta da Oz Forensics:

Kotlin

OzLivenessSDK.setApiConnection(
    OzConnection.fromCredentials(host, username, password, sslPins),
    statusListener(
        { token -> /* token */ },
        { ex -> /* error */ }
    )
)

Java

OzLivenessSDK.INSTANCE.setApiConnection(
        OzConnection.Companion.fromCredentials(host, username, password, sslPins),
        new StatusListener<String>() {
            @Override
            public void onStatusChanged(@Nullable String s) {}
            @Override
            public void onSuccess(String token) { /* token */ }
            @Override
            public void onError(@NonNull OzException e) { /* error */ }
        }
);

Embora a opção preferida seja a autenticação via token de acesso – por motivos de segurança.

Por padrão, os logs são salvos junto com os dados das análises. Se for necessário manter os logs distintos dos dados de análise, configure a conexão separada para telemetria como mostrado abaixo:

Kotlin

OzLivenessSDK.setEventsConnection(
    OzConnection.fromCredentials(
        "https://echo.cdn.ozforensics.com/",
        "<[e-mail]>",
        "your_telemetry_password"
    )
)

Java

OzLivenessSDK.setEventsConnection(
        OzConnection.fromCredentials(
                "https://tm.ozforensics.com/",
                "<[e-mail]>",
                "your_telemetry_password"
        )
);

Remoção da autorização:

Kotlin

OzLivenessSDK.setApiConnection(null)

Java

OzLivenessSDK.INSTANCE.setApiConnection(null, null);

Outros métodos

Verifique a presença do token de acesso salvo da Oz API:

Kotlin

val isLoggedIn = OzLivenessSDK.isLoggedIn

Java

boolean isLoggedIn = OzLivenessSDK.INSTANCE.isLoggedIn();

Encerrar sessão:

Kotlin

OzLivenessSDK.logout()

Java

OzLivenessSDK.INSTANCE.logout();