Começar
Integrar / SDKs
Verificação de utilizadores
Verificação de empresas
Monitorização de transações
Registo de alterações
Principais vantagens
Como ativar a Verificação NFC
Integração do SDK nativo (Recomendada)
A verificação NFC está disponível através dos nossos SDKs nativos, que fornecem acesso total às funcionalidades NFC do dispositivo:
O SDK para iOS processa toda a configuração de NFC automaticamente, incluindo:
- Identificadores de aplicação ISO7816 para passaportes eletrónicos (ePassports)
- Configuração de permissões e capacidades
- Leitura do chip em tempo real com feedback visual
Integração Web
⚠️ Limitações do navegador A verificação NFC não está disponível em navegadores web devido a restrições de plataforma:Para integrações web, a verificação NFC é ignorada automaticamente e os utilizadores avançam com a verificação padrão de documento + selfie.
Como funciona
Iniciação da sessão
O utilizador inicia o processo de verificação através da sua aplicação ou plataforma:
- SDK nativo: Inicie o fluxo de verificação diretamente na sua aplicação
- Web/Mobile Web: O utilizador é orientado a usar a Didit App para verificação com NFC, ou continua com a verificação padrão
Captura de fotografia do documento
O utilizador fotografa o seu documento de identificação, capturando:
- MRZ (Zona de leitura automática) — utilizada para derivar as chaves de acesso ao chip
- Imagens da frente e do verso do documento — dados visuais e elementos de segurança
- Elementos visuais de segurança — hologramas, marcas de água, microimpressão
Deteção de suporte a NFC
O sistema verifica automaticamente a compatibilidade do dispositivo e do documento:
Se o NFC não estiver disponível, a verificação continua sem interrupções com a verificação padrão de documento + biometria.
Leitura do chip NFC
Para dispositivos e documentos compatíveis:
- O utilizador é orientado a posicionar o seu documento junto ao leitor NFC do telemóvel
- O feedback visual mostra o progresso da leitura em tempo real
- É estabelecida uma comunicação segura com o chip utilizando os protocolos PACE/BAC
Extração de dados
O sistema extrai dados abrangentes do chip de acordo com as normas ICAO 9303:
Verificação criptográfica
Os dados extraídos passam por uma verificação criptográfica rigorosa:
Verificação da assinatura digital
Verificação da assinatura digital
O hash de cada grupo de dados é verificado contra as assinaturas armazenadas no SOD, garantindo a integridade dos dados.
Validação da cadeia de certificados
Validação da cadeia de certificados
A cadeia de confiança é validada: Certificado do documento → CA de assinatura do país → ICAO PKD Root, efetuando a validação contra as listas principais da CSCA e o Diretório de Chaves Públicas da ICAO.
Verificação de revogação de certificados
Verificação de revogação de certificados
Os certificados são verificados contra Listas de Revogação de Certificados (CRLs) para assegurar que não foram revogados e que o documento não foi reportado como roubado/comprometido.
Validação cruzada
Validação cruzada
Os dados extraídos por NFC são validados de forma cruzada contra os dados de OCR das fotografias do documento, a comparação biométrica facial e a verificação do checksum da MRZ.
Resultado e pontuação de confiança
O resultado final da verificação inclui:
Documentos suportados
A verificação NFC funciona com passaportes eletrónicos e eIDs que contenham um chip NFC, habitualmente indicado por este símbolo no documento:
Cartão My Number do Japão (JPKI)
O Cartão My Number do Japão (マイナンバーカード) tem um chip, mas não do padrão ICAO 9303. Contém certificados emitidos sob a JPKI, a infraestrutura de chave pública do Japão, e chaves privadas que apenas assinam após o titular introduzir o PIN do cartão. A Didit lê-o no mesmo passo de NFC, através da JPKI em vez da ICAO 9303, e cada resultado de NFC indica qual o protocolo utilizado emchip_protocol (icao ou jpki).
Requisitos
O que a pessoa faz
Fotografar o cartão
A pessoa captura o My Number Card no passo de verificação de identidade, tal como com qualquer documento. A Didit reconhece o cartão e envia um passo de NFC com JPKI em vez da leitura de chip de passaporte.
Introduzir o PIN do cartão
O SDK solicita o PIN de 4 dígitos do cartão (利用者証明用電子証明書の暗証番号). Quando a definição
jpki_request_attributes do nó de NFC está ativada (o padrão), também solicita a palavra-passe de assinatura, também chamada de PIN de assinatura (署名用電子証明書の暗証番号, 6 a 16 letras maiúsculas e números).Aproximar o cartão do telemóvel
O SDK lê os certificados do cartão e o cartão assina um desafio de utilização única da Didit com a sua própria chave. O SDK envia os certificados e as assinaturas. Os PINs vão apenas para o cartão, nunca para a Didit.
O cartão contabiliza as tentativas incorretas: bloqueia o PIN de 4 dígitos após 3 tentativas consecutivas e a palavra-passe de assinatura após 5; um código bloqueado tem de ser reposto nos serviços municipais do titular. Após uma introdução incorreta, o SDK mostra quantas tentativas restam. Nunca efetua a última tentativa: quando resta apenas uma, para e informa a pessoa sobre onde a pode repor. Peça às pessoas para terem o seu PIN e a palavra-passe de assinatura prontos antes de começarem.
O que a Didit verifica
Cada ação é uma definição no nó de NFC, pelo que pode alterá-la para Sem ação, Revisão ou Recusar. Consulte os avisos de NFC e a configuração da funcionalidade de NFC.
O que significa um estado de revogação não verificado
revocation_status: "unchecked" significa que a Didit verificou a cadeia de certificados e a assinatura do cartão, mas não obteve resposta sobre se um certificado foi revogado. Um certificado é revogado quando, por exemplo, o cartão é comunicado como perdido. Como não é possível excluir que o cartão esteja revogado, unchecked nunca é tratado como good. Aciona o aviso JPKI_REVOCATION_UNCHECKED, que envia o passo de NFC para revisão por padrão. Escolha um resultado diferente com jpki_revocation_unchecked_action.
Quando a cadeia de certificados ou a assinatura não é válida, a Didit não consulta a revogação: o estado permanece unchecked e apenas o aviso da cadeia ou da assinatura é acionado.
Dados do titular e privacidade
- Com
jpki_request_attributesativado, a decisão inclui o nome do titular, data de nascimento, sexo e morada a partir do certificado de assinatura sobjpki.attributes. Com esta opção desativada, a pessoa apenas introduz o PIN de 4 dígitos: a leitura continua a comprovar o cartão e o PIN, mas não transporta dados do titular e não é comparada com a fotografia do cartão. - O passo de NFC nunca lê o Número Individual de 12 dígitos (My Number) do cartão a partir do chip.
- A decisão reporta o que o cartão comprovou, nunca os certificados em si, os seus números de série ou as assinaturas.