Tutorial de Verificação NFC de Documentos para o SDK Android da Didit (PT-PT)

Segurança ReforçadaA verificação NFC lê dados criptograficamente assinados diretamente de ePassaportes e eIDs, oferecendo um nível de garantia superior às verificações visuais.

Experiência do Utilizador OtimizadaA automatização da extração de dados via NFC reduz erros de entrada manual e acelera o processo de integração para os utilizadores.

Conformidade e Prevenção de FraudeA utilização da Verificação NFC ajuda as empresas a cumprir as rigorosas regulamentações KYC/AML e mitiga significativamente os riscos de fraude de identidade, validando a autenticidade dos documentos.

Integração Perfeita da DiditO SDK Android da Didit simplifica o complexo processo de verificação NFC, oferecendo uma solução modular e nativa de IA com deteção de prova de vida integrada e um nível KYC essencial gratuito.

O Poder do NFC na Verificação de Identidade

A Comunicação de Campo Próximo (NFC) revolucionou a verificação de identidade, particularmente para documentos como ePassaportes e eIDs. Ao contrário do reconhecimento ótico de caracteres (OCR) tradicional que depende de dados visuais, a verificação NFC lê diretamente o chip incorporado nestes documentos. Este chip contém dados biométricos do titular, informações pessoais e características de segurança cruciais, tudo criptograficamente protegido. Este método oferece segurança inigualável, tornando extremamente difícil para os fraudadores falsificar ou adulterar documentos de identidade.

Para as empresas, integrar a verificação NFC significa um salto significativo na prevenção de fraude e conformidade. Garante que a identidade apresentada não é apenas visualmente válida, mas também digitalmente autêntica, diretamente da autoridade emissora. Isto reduz o risco de fraude de identidade sintética, deepfakes e outros ataques sofisticados que poderiam contornar métodos de verificação menos rigorosos.

A experiência do utilizador também beneficia imensamente. Em vez de inserir detalhes manualmente ou depender de digitalizações OCR potencialmente propensas a erros, os utilizadores simplesmente encostam o seu documento ao seu smartphone com NFC. Este processo rápido e preciso minimiza o atrito durante a integração, levando a taxas de conversão mais altas e maior satisfação do cliente. O produto de Verificação NFC da Didit foi concebido para aproveitar estas vantagens, fornecendo uma solução robusta e fácil de usar.

Configurar o Seu Projeto Android para a Verificação NFC da Didit

Integrar a Verificação NFC da Didit na sua aplicação Android é um processo simples, graças ao seu SDK bem documentado e modular. Antes de mergulhar no código, certifique-se de que o seu ambiente de desenvolvimento cumpre os seguintes requisitos:

• Android API 23+ (Android 6.0 Marshmallow)
• Kotlin 1.9+, Gradle 8.0+
• Um dispositivo Android com NFC para testes.

Instalação Passo a Passo:

Primeiro, precisa de adicionar o SDK da Didit ao seu projeto. Isto envolve configurar os seus repositórios Maven e adicionar a dependência do SDK.

1. Adicionar Repositório Maven

No seu ficheiro settings.gradle.kts, certifique-se de que o repositório Maven da Didit está incluído:

dependencyResolutionManagement {
  repositories {
      google()
      mavenCentral()
      maven { url = uri("https://raw.githubusercontent.com/didit-protocol/sdk-android/main/repository") }
  }
}

2. Adicionar Dependência

Em seguida, no seu ficheiro app/build.gradle.kts, adicione a implementação do SDK da Didit:

dependencies {
  implementation("me.didit:didit-sdk:3.2.0")
}

3. Adicionar Exclusão de Empacotamento

Para evitar conflitos de compilação, adicione esta exclusão de empacotamento dentro do bloco android { } do seu app/build.gradle.kts:

android {
  packaging {
      resources {
          excludes += "META-INF/versions/9/OSGI-INF/MANIFEST.MF"
      }
  }
}

O SDK Android da Didit mescla automaticamente as permissões necessárias como INTERNET, ACCESS_NETWORK_STATE, CAMERA e NFC do seu manifesto, simplificando a sua configuração de manifesto.

Implementar a Verificação NFC com o SDK da Didit

Uma vez instalado o SDK, o próximo passo é iniciar uma sessão de verificação NFC. A abordagem da Didit é focada no programador, oferecendo APIs limpas para uma integração perfeita. O processo tipicamente envolve a criação de uma sessão de verificação no seu backend e, em seguida, a passagem do token da sessão para a sua aplicação Android.

Criação de Sessão no Backend (O Seu Servidor):

O seu backend iniciará uma sessão com a API da Didit. Isto garante comunicação segura e orquestração adequada do fluxo de trabalho.

POST https://verification.didit.me/v3/session/
Headers: { "x-api-key": DIDIT_API_KEY, "Content-Type": "application/json" }
Body: { "workflow_id": DIDIT_WORKFLOW_ID, "vendor_data": "user-id" }
Response: { "session_id": "uuid", "session_token": "jwt-token", "verification_url": "...", "status": "Not Started" }

O session_token recebido desta resposta é crucial; irá enviá-lo para a sua aplicação Android.

Integração da Aplicação Android:

Na sua aplicação Android, irá usar a classe DiditSdk para gerir o fluxo de verificação. O SDK suporta tanto uma experiência de UI completa quanto um modo sem interface gráfica para UIs personalizadas.

Opção A: Com Token de Sessão do Seu Backend

Esta é a abordagem recomendada para orquestrar fluxos de trabalho complexos e manter o controlo do backend.

import me.didit.DiditSdk

// ... dentro da sua Activity ou Fragment

val sessionToken = "YOUR_SESSION_TOKEN_FROM_BACKEND"
DiditSdk.start(this, sessionToken) { result ->
    when (result) {
        is DiditSdk.VerificationResult.Success -> {
            // Verificação bem-sucedida, trate o resultado
            Log.d("Didit", "Verification Success: ${result.sessionId}")
        }
        is DiditSdk.VerificationResult.Error -> {
            // Verificação falhou ou foi cancelada
            Log.e("Didit", "Verification Error: ${result.message}")
        }
    }
}

O SDK guiará o utilizador através do processo de digitalização NFC, incluindo pedidos para posicionar o documento contra o telemóvel. Integra perfeitamente a Verificação de Identidade (OCR, MRZ, códigos de barras), Prova de Vida Passiva e Ativa, e a crucial Verificação NFC (ePassaporte/eID) para garantir uma verificação de identidade abrangente e segura.

Melhores Práticas para uma Experiência de Utilizador Suave

Embora o SDK da Didit lide com grande parte da complexidade, otimizar a experiência do utilizador para a verificação NFC é fundamental para uma implementação bem-sucedida:

• Instruções Claras: Forneça instruções claras e concisas aos utilizadores sobre como posicionar o seu ePassaporte ou eID para a digitalização NFC. Dicas visuais ou animações podem ser muito úteis.
• Tratamento de Erros: Implemente um tratamento de erros robusto e feedback ao utilizador. Se a digitalização NFC falhar, oriente o utilizador sobre potenciais problemas (por exemplo, dispositivo não habilitado para NFC, documento não posicionado corretamente).
• Avisos Contextuais: Explique por que a verificação NFC é necessária (por exemplo, "Para segurança aprimorada e verificação mais rápida"), construindo confiança e reduzindo a hesitação do utilizador.
• Desempenho: A verificação NFC é tipicamente rápida, mas certifique-se de que a sua aplicação continua responsiva durante o processo.
• Opções de Recuo: Embora o NFC seja altamente seguro, considere oferecer métodos de verificação alternativos (por exemplo, upload manual, verificação de foto) para utilizadores que possam ter documentos mais antigos ou dispositivos não habilitados para NFC, embora comunicando claramente as vantagens de segurança do NFC.

A arquitetura modular da Didit permite combinar facilmente a Verificação NFC com outras ferramentas poderosas, como a deteção de Prova de Vida Passiva e Ativa, para combater deepfakes e garantir que a pessoa que apresenta o documento é o seu legítimo titular. Esta abordagem em várias camadas cria uma defesa formidável contra a fraude de identidade.

Como a Didit Ajuda

A Didit é a plataforma de identidade nativa de IA, focada no programador, projetada para tornar a verificação de identidade robusta acessível e escalável. Para a verificação NFC de documentos, o SDK Android da Didit destaca-se por fornecer uma solução abrangente e fácil de integrar. O nosso produto de Verificação NFC lê sem problemas dados de ePassaportes e eIDs, garantindo o mais alto nível de autenticidade do documento. Isto faz parte da nossa suite mais ampla de Verificação de Identidade, que inclui OCR, MRZ e digitalização de códigos de barras, tornando a Didit uma solução completa para verificações de identidade baseadas em documentos.

O que distingue a Didit é o seu compromisso com a modularidade e a facilidade para programadores. Pode ligar e usar verificações de identidade, orquestrando fluxos de trabalho complexos com o nosso motor sem código ou através de APIs limpas. Oferecemos um nível KYC Essencial Gratuito, permitindo que empresas de todos os tamanhos comecem a verificar identidades sem custos iniciais. A nossa abordagem nativa de IA garante alta precisão e melhoria contínua na deteção de fraude, incluindo verificações de prova de vida sofisticadas para prevenir ataques de spoofing e deepfakes. Sem taxas de configuração e um modelo de pagamento por verificação bem-sucedida, a Didit oferece uma solução económica e poderosa para as necessidades globais de verificação de identidade.

Pronto para Começar?

Pronto para ver a Didit em ação? Obtenha uma demonstração gratuita hoje.

Comece a verificar identidades gratuitamente com o nível gratuito da Didit.