Guia de Instalação

Instale e configure o Certta para Android. Saiba mais sobre os requisitos do SDK, permissões, repositórios, dependências, configuração de sessão, atualizações de token em tempo de execução e temas de cores.

Este guia abrange a versão 7.14.0 e superior. Para versões anteriores à 7.14.0, consulte a documentação legada.

Instalando o SDK para Android

Este guia vai orientá-lo em todo o processo de configuração necessário para baixar, configurar e instalar com sucesso o SDK em sua máquina

Requisitos

Antes de integrar, verifique se seu ambiente atende aos requisitos mínimos para o SDK da Certta:

Requisito

Versão

Versão mínima do SDK (minSdk)

Versão de compilação do Android (compileSDK)

Versão mínima do Kotlin

1.9.10

Versão do Gradle

8.4

Android Gradle Plugin (AGP)

8.3.2

Permissões

Para habilitar a funcionalidade de rede e câmera necessária para o SDK da Certta, você deve declarar as permissões e os recursos de hardware apropriados no arquivo AndroidManifest.xml do seu projeto.

Adicione as seguintes linhas dentro da tag <manifest> tag:

AndroidManifest.xml

<uses-feature android:name="android.hardware.camera" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />

AndroidManifest.xml

<uses-feature android:name="android.hardware.camera" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

O Detector de Documentos requer READ_EXTERNAL_STORAGE permissão quando o envio de documentos estiver habilitado.

Adicionando repositórios

Para baixar o SDK da Certta, você deve informar ao seu projeto Android onde encontrar suas dependências. Isso é feito configurando o bloco dependencyResolutionManagement localizado no settings.gradle.kts do seu projeto.

raiz do seu projeto. Adicione os URLs de repositório necessários à sua configuração:

Para projetos baseados em Groovy, inclua os seguintes repositórios no settings.gradle do seu projeto.

settings.gradle.kts

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url = uri("https://repo.combateafraude.com/android/release") }        
    }
}

settings.gradle

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url "https://repo.combateafraude.com/android/release" }
    }
}

Adicionando dependências

Para integrar o SDK da Certta ao seu app, adicione as dependências necessárias ao nível do módulo (nível do app) build.gradle.kts do seu projeto.

Coloque a seguinte linha dentro do bloco dependencies depêndencias:

build.gradle.kts

dependencies {
    // Gerencia as versões de todas as dependências
    implementation(platform("io.caf.sdk:caf-sdk-bom:7.13.0"))
    
    // --- Detector de Documentos (Escolha uma) ---
    implementation("io.caf.sdk:document-detector-ui") // Adiciona telas de UI personalizáveis
    // implementation("io.caf.sdk:document-detector") // Apenas núcleo (crie sua própria UI)

    // --- Vivacidade Facial (Escolha uma) ---
    implementation("io.caf.sdk:caffaceliveness-ui") // Adiciona telas de UI personalizáveis
    // implementation("io.caf.sdk:caffaceliveness") // Apenas núcleo (crie sua própria UI)

    // --- Provedores de Vivacidade ---
    implementation("io.caf.sdk:caffaceliveness-providers-iproov-lite")
    implementation("io.caf.sdk:caffaceliveness-providers-payface")
    implementation("io.caf.sdk:caffaceliveness-providers-facetec")
    
    // --- Impressão digital ---
    implementation("io.caf.sdk:fingerprint")
}

build.gradle

dependencies {
    // Gerencia as versões de todas as dependências
    implementation platform("io.caf.sdk:caf-sdk-bom:7.13.0")
    
    // --- Detector de Documentos (Escolha uma) ---
    implementation "io.caf.sdk:document-detector-ui" // Adiciona telas de UI personalizáveis
    // implementation "io.caf.sdk:document-detector" // Apenas núcleo (crie sua própria UI)

    // --- Vivacidade Facial (Escolha uma) ---
    implementation "io.caf.sdk:caffaceliveness-ui" // Adiciona telas de UI personalizáveis
    // implementation "io.caf.sdk:caffaceliveness" // Apenas núcleo (crie sua própria UI)

    // --- Provedores de Vivacidade ---
    implementation "io.caf.sdk:caffaceliveness-providers-iproov-lite"
    implementation "io.caf.sdk:caffaceliveness-providers-payface"
    implementation "io.caf.sdk:caffaceliveness-providers-facetec"
    
     // --- Impressão digital ---
    implementation "io.caf.sdk:fingerprint"
}

Ao usar o caffaceliveness módulo, você deve incluir pelo menos uma dependência de provedor de vivacidade (como iproov-lite, payface, ou facetec), em seu build.gradle do seu projeto.

Configuração e personalizações

Obtendo o Token Móvel

Para gerar seu token móvel, siga este guia:

Autenticação

Configurando a sessão

Depois de obter seu token móvel, inicialize o SDK da Certta dentro da sua classe personalizada Application . Isso deve ser feito dentro do método onCreate() usando o contexto da aplicação e seu objeto de configuração.

Aqui está um exemplo de como sua Application classe pode se parecer:

Tanto o userId quanto o mobileToken são opcionais durante a configuração inicial. Além disso, esses valores não são permanentes; você pode atualizá-los ou alterá-los a qualquer momento durante o ciclo de vida do aplicativo, conforme seus requisitos evoluem.

MyApplication.kt

val config = CerttaConfiguration(
    userId = "user-id",
    mobileToken = "your-jwt",
    environment = CerttaEnvironment.PROD,
    securityEnabled = true,
)

Certta.instance.configure(
    context = this,
    config = config
)

MyApplication.java

CerttaConfiguration config = new CerttaConfiguration(
   "your-jwt",     // mobileToken
   "user-id",      // userId
   CerttaEnvironment.PROD, //environment
   true,            // securityEnabled
);

Certta.getInstance().configure(this, config);

Parâmetros de CerttaConfiguration

Parâmetro

Tipo

Descrição

mobileToken

String

Seu JSON Web Token (JWT) gerado.

userId

String

Um identificador exclusivo para o usuário.

securityEnabled

Boolean

Ativa ou desativa validações de segurança.

environment

CerttaEnvironment

Define o ambiente de execução.

Atualizações de configuração em tempo de execução

Os userId quanto o mobileToken não estão restritos à configuração inicial; eles podem ser atualizados dinamicamente em tempo de execução para se adaptar a mudanças nas sessões de usuário ou nos requisitos de segurança.

Esses métodos podem ser chamados de qualquer Activity ou Fragment após a configuração inicial ter sido estabelecida em sua Application classe.

Para atualizar esses valores, use os métodos específicos fornecidos pela instância Certta da instância:

MyActivity.kt

Certta.instance.updateUserId("new-user-id")
Certta.instance.updateMobileToken("new-jwt-token")

MyActivity.java

Certta.getInstance().updateUserId("new-user-id");
Certta.getInstance().updateMobileToken("new-jwt-token");

Use esses métodos sempre que seu app fizer logout/login ou quando seu backend emitir um JWT atualizado para garantir que o SDK da Certta permaneça sincronizado com sua sessão ativa.

Temas de cores

Tanto os módulos Liveness quanto Document Detector oferecem suporte a temas de cores personalizados, permitindo que você combine perfeitamente a interface do SDK com as diretrizes de marca do seu aplicativo. Você pode personalizar a UI fornecendo valores de cor em um formato padrão de string hexadecimal (por exemplo, "#RRGGBB").

Depois de configurar o SDK, crie um CerttaColorConfiguration objeto com as cores que você deseja alterar e passe-o para Certta.instance.setColorConfiguration().

val colorConfig = CerttaColorConfiguration(
    primaryColor = "#FF0000",
    secondaryColor = "#00FF00",
    backgroundColor = "#FFFFFF",
    contentColor = "#000000",
    mediumColor = "#D1D1D1",
    dialogBackgroundColor = "#FFFFFF",
    dialogBorderColor = "#0C395E",
)
Certta.instance.setColorConfiguration(colorConfig)

CafColorConfiguration colorConfig = new CafColorConfiguration(
      "#FF0000", //primaryColor
      "#00FF00", //secondaryColor
      "#FFFFFF", //backgroundColor
      "#000000", //contentColor
      "#D1D1D1", //mediumColor,
      "#FFFFFF", //dialogBackgroundColor
      "#0C395E" //dialogBorderColor
);
Certta.getInstance().setColorConfiguration(colorConfig);

Parâmetros de ColorConfiguration

Todos os parâmetros no objeto de configuração são opcionais. Você só precisa definir as cores específicas que deseja sobrescrever para seu tema personalizado.

Propriedade de cor

Descrição

primaryColor

Cor principal para botões e destaques.

secondaryColor

Cor secundária para elementos complementares.

backgroundColor

Cor de fundo da tela.

contentColor

Cor usada para textos e ícones.

mediumColor

Cor neutra para elementos como barras de progresso.

dialogBackgroundColor

Cor de fundo de diálogos e pop-ups.

dialogBorderColor

Cor da borda de diálogos e pop-ups.

Ofuscação de Código

Confira o bloco de código com as regras ProGuard/R8 necessárias para que o SDK e suas dependências funcionem corretamente mesmo após a ofuscação e otimização do código. Essas regras preservam informações essenciais (como assinaturas, anotações e classes internas) e impedem que classes críticas sejam removidas ou alteradas.

proguard_rules.txt

# O tratador predefinido do Android para exceções é carregado por reflexão (via ServiceLoader).
-keep class kotlinx.coroutines.experimental.android.AndroidExceptionPreHandler { *; }

### GSON ##################################################################
# O Gson usa informações de tipo genérico armazenadas em um arquivo de classe ao trabalhar com campos.
# O ProGuard remove essas informações por padrão, então configure-o para mantê-las todas.
-keepattributes Signature
# Para usar a anotação @Expose do GSON
-keepattributes *Annotation*
### FIM GSON ##################################################################

### Retrofit ##################################################################
# Preserve assinaturas genéricas, classes internas e métodos envolventes para a reflexão do Retrofit.
-keepattributes Signature, InnerClasses, EnclosingMethod
# Retém anotações visíveis em tempo de execução em métodos e parâmetros.
-keepattributes RuntimeVisibleAnnotations, RuntimeVisibleParameterAnnotations
# Mantém valores padrão de anotações.
-keepattributes AnnotationDefault
# Retém parâmetros de métodos de serviço para interfaces com anotações do Retrofit.
-keepclassmembers,allowshrinking,allowobfuscation interface * {
    @retrofit2.http.* <methods>;
}
# Suprime avisos para ferramentas de build e certas anotações JSR 305.
-dontwarn org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement
-dontwarn javax.annotation.**
-dontwarn kotlin.Unit
-dontwarn retrofit2.KotlinExtensions
-dontwarn retrofit2.KotlinExtensions$*
# Mantém explicitamente as interfaces Retrofit para evitar a nulificação pelo R8.
-if interface * { @retrofit2.http.* <methods>; }
-keep,allowobfuscation interface <1>
-if interface * { @retrofit2.http.* <methods>; }
-keep,allowobfuscation interface * extends <1>
# Preserva as continuations usadas pelas funções suspend do Kotlin.
-keep,allowobfuscation,allowshrinking class kotlin.coroutines.Continuation
# Para o modo full do R8: mantém os tipos de retorno genéricos para métodos do Retrofit.
-if interface * { @retrofit2.http.* public *** *(...); }
-keep,allowoptimization,allowshrinking,allowobfuscation class <3>
# Preserva a classe Response do Retrofit.
-keep,allowobfuscation,allowshrinking class retrofit2.Response
### FIM Retrofit ##############################################################

### OkHttp ####################################################################
# Suprime avisos para anotações JSR 305.
-dontwarn javax.annotation.**
# Adapta nomes de arquivos de recursos para o banco de dados interno de sufixos públicos.
-adaptresourcefilenames okhttp3/internal/publicsuffix/PublicSuffixDatabase.gz
# Suprime avisos para o Animal Sniffer e classes específicas da plataforma.
-dontwarn org.codehaus.mojo.animal_sniffer.*
-dontwarn okhttp3.internal.platform.**
-dontwarn org.conscrypt.**
-dontwarn org.bouncycastle.**
-dontwarn org.openjsse.**
# Mantém todas as classes do OkHttp e do Okio.
-keep class okhttp3.** { *; }
-dontwarn okhttp3.**
-keep class okio.** { *; }
-dontwarn okio.**
-dontwarn javax.annotation.Nullable
-dontwarn javax.annotation.ParametersAreNonnullByDefault
### FIM OkHttp ################################################################

### Serialização Kotlin ######################################################
# Mantém os objetos Companion para classes serializáveis.
-if @kotlinx.serialization.Serializable class **
-keepclassmembers class <1> {
    static <1>$Companion Companion;
}
# Mantém funções serializer nos objetos companion.
-if @kotlinx.serialization.Serializable class ** {
    static **$* *;
}
-keepclassmembers class <2>$<3> {
    kotlinx.serialization.KSerializer serializer(...);
}
# Retém INSTANCE e serializer para objetos serializáveis.
-if @kotlinx.serialization.Serializable class ** {
    public static ** INSTANCE;
}
-keepclassmembers class <1> {
    public static <1> INSTANCE;
    kotlinx.serialization.KSerializer serializer(...);
}
# Preserva os objetos Companion em kotlinx.serialization.json.
-keepclassmembers class kotlinx.serialization.json.** {
    *** Companion;
}
-keepclasseswithmembers class kotlinx.serialization.json.** {
    kotlinx.serialization.KSerializer serializer(...);
}
# Preserva a busca de serializer para classes serializáveis (ajuste o nome do pacote conforme necessário).
-keepclassmembers @kotlinx.serialization.Serializable class packeage.** {
    *** Companion;
    *** INSTANCE;
    kotlinx.serialization.KSerializer serializer(...);
}
### FIM Serialização Kotlin #################################################

### AutoValue ################################################################
-dontwarn com.google.auto.**
-dontwarn autovalue.shaded.com.**
-dontwarn sun.misc.Unsafe
-dontwarn javax.lang.model.element.Modifier
### FIM AutoValue ############################################################

### CAF - Combate a Fraude ######################################################
# Mantém os atributos de exceções.
-keepattributes Exceptions
# Preserva todas as classes, interfaces e membros de classe para os módulos CAF.
-keep class com.caf.facelivenessiproov.** { *; }
-keep class com.combateafraude.documentdetector.** { *; }
-keep class com.combateafraude.** { *; }
-keep interface com.combateafraude.** { *; }
-keep class io.caf.** { *; }
-keep interface io.caf.** { *; }
-keepclassmembers class com.combateafraude.** { *; }
# Suprime avisos para java.nio.file e certas classes internas do OkHttp.
-dontwarn java.nio.file.*
-dontwarn com.squareup.okhttp.internal.Platform
# Mantém campos em classes que estendem GeneratedMessageLite (para uso com Tink).
-keepclassmembers class * extends com.google.crypto.tink.shaded.protobuf.GeneratedMessageLite {
  <fields>;
}
# Preserva classes do TensorFlow.
-keep class org.tensorflow.** { *; }
-keep class org.tensorflow.**$* { *; }
-dontwarn org.tensorflow.**
# Preserva classes do IProov e classes protobuf.
-keep public class com.iproov.sdk.IProov { public *; }
-keep class com.iproov.** { *; }
-keep class com.iproov.**$* { *; }
-keep class com.google.protobuf.** { *; }
-keep class com.google.protobuf.**$* { *; }
-dontwarn com.google.protobuf.**
# Suprime avisos para classes Flow concorrentes.
-dontwarn java.util.concurrent.Flow*
# Preservar as classes Kotlin e kotlinx.
-keep class kotlin.** { *; }
-keep class kotlinx.** { *; }
-dontwarn com.android.tools.lint.**
-dontwarn io.caf.sdk.common.jvmshared.lint.**
### FIM CAF - Combate a Fraude ##################################################

Atualizado há 1 mês