Verificació NFC: API per a passaports electrònics i eID

L’autenticació basada en NFC et permet verificar documents d’identitat llegint el xip segur integrat en passaports i documents d’identitat moderns mitjançant les capacitats NFC d’un telèfon mòbil. Això proporciona el nivell més alt de seguretat disponible per a la Verificació d’identitat.

Beneficis clau

Benefici	Descripció
Màxima seguretat	Verifica signatures criptogràfiques directament dels emissors governamentals
Fàcil d’utilitzar	Funciona automàticament amb qualsevol telèfon amb NFC
A prova de manipulacions	Detecta manipulacions al document invisibles a l’ull humà
Dades completes	Extreu dades addicionals no disponibles només mitjançant OCR
Alternativa flexible	Passa de manera fluida a la verificació estàndard si l’NFC no està disponible

Com habilitar la verificació NFC

Integració amb SDK natiu (Recomanada)

La verificació NFC està disponible a través dels nostres SDK natius, que ofereixen accés complet a les capacitats NFC del dispositiu:

Plataforma	Suport d’NFC	Documentació
iOS	✅ Suport complet	Documentació de l’SDK per a iOS
Android	✅ Suport complet	Documentació de l’SDK per a Android

L’SDK per a iOS gestiona tota la configuració d’NFC automàticament, incloent-hi:

Identificadors d’aplicació ISO7816 per a passaports electrònics (ePassports)
Configuració de drets i capacitats
Lectura del xip en temps real amb indicacions visuals

Integració web

⚠️ Limitacions del navegador La verificació NFC no està disponible en navegadors web a causa de restriccions de la plataforma:
Navegador Suport d’NFC
Chrome (Android) API Web NFC experimental: inestable, requereix permisos explícits
Safari (iOS) Sense suport per a l’API Web NFC
Altres navegadors Sense suport
En integracions web, la verificació NFC s’omet automàticament i els usuaris continuen amb la verificació estàndard de document + selfie.

Navegador	Suport d’NFC
Chrome (Android)	API Web NFC experimental: inestable, requereix permisos explícits
Safari (iOS)	Sense suport per a l’API Web NFC
Altres navegadors	Sense suport

Com funciona

Inici de la sessió

L’usuari inicia el procés de verificació a través de la teva aplicació o plataforma:

SDK natiu: inicia el flux de verificació directament a la teva aplicació
Web / Web mòbil: es guia l’usuari perquè utilitzi la Didit App per a la verificació NFC, o bé continua amb la verificació estàndard

Captura de fotos del document

L’usuari fotografia el seu document d’identitat, capturant:

MRZ (zona de lectura mecànica) — s’utilitza per derivar les claus d’accés al xip
Imatges de l’anvers i el revers del document — dades visuals i característiques de seguretat
Característiques visuals de seguretat — hologrames, filigranes, microimpressió

Detecció de compatibilitat amb NFC

El sistema comprova automàticament la compatibilitat del dispositiu i del document:

Comprovació	Descripció
Tipus de document	És un passaport electrònic o document d’identitat electrònic amb xip NFC?
Capacitat del dispositiu	El telèfon permet llegir NFC?
Permisos	S’han concedit els permisos NFC necessaris?

Si l’NFC no està disponible, la verificació continua sense problemes amb la verificació estàndard de document + biometria.

Lectura del xip NFC

Per a dispositius i documents compatibles:

Es guia l’usuari perquè col·loqui el seu document a prop del lector NFC del telèfon
Els indicadors visuals mostren el progrés de la lectura en temps real
S’estableix una comunicació segura amb el xip mitjançant els protocols PACE/BAC

Extracció de dades

El sistema extreu dades completes del xip seguint els estàndards ICAO 9303:

Grup de dades	Contingut	Descripció
SOD	Objecte de seguretat del document	Signatures digitals de tots els grups de dades
DG1	Dades personals	Nom, número d’identificació, data de naixement, data de caducitat
DG2	Imatge facial	Foto digital d’alta resolució del titular
DG7	Signatura	Representació digital de la signatura del titular
DG11-14	Dades addicionals	Poden incloure empremtes dactilars, escanejos d’iris (si estan emmagatzemats)

Verificació criptogràfica

Les dades extretes se sotmeten a una verificació criptogràfica rigorosa:

Verificació de la signatura digital

Es verifica el hash de cada grup de dades respecte a les signatures emmagatzemades al SOD, garantint la integritat de les dades.

Validació de la cadena de certificats

Es valida la cadena de confiança: Certificat del document → CA de signatura del país → Arrel PKD de l’ICAO, comprovant-la contra les llistes mestres CSCA i el Directori de Claus Públiques (PKD) de l’ICAO.

Comprovació de revocació de certificats

Els certificats es verifiquen contra llistes de revocació de certificats (CRL) per garantir que no han estat revocats i que el document no s’ha notificat com a robat o compromès.

Validació creuada

Les dades extretes per NFC es validen de manera creuada amb les dades d’OCR de les fotos del document, la comparació biomètrica facial i la verificació de sumes de control de l’MRZ.

Resultat i puntuació de confiança

El resultat final de la verificació inclou:

Sortida	Descripció
Estat de la verificació NFC	Satisfactori, fallit o omès
Puntuació de coherència de les dades	Grau de coincidència entre les dades NFC i les dades visuals
Validació de certificats	Estat de verificació de la cadena completa
Increment de confiança	L’NFC aporta un augment significatiu de la confiança en la verificació global

Documents admesos

La verificació NFC funciona amb passaports electrònics i documents d’identitat electrònics que contenen un xip NFC, normalment indicat per aquest símbol al document:

La majoria dels passaports emesos després del 2006 contenen xips NFC. La cobertura varia segons el país per als documents d’identitat nacionals. Consulta tots els documents admesos. La targeta My Number del Japó té un tipus de xip diferent, que es llegeix mitjançant JPKI en lloc de l’ICAO 9303. Consulta Targeta My Number del Japó (JPKI).

Japan My Number Card (JPKI)

La Japan My Number Card (マイナンバーカード) té un xip, però aquest no és de tipus ICAO 9303. Conté certificats emesos sota JPKI, la infraestructura de clau pública del Japó, i claus privades que només signen després que el titular introdueixi el PIN de la targeta. Didit la llegeix en el mateix pas d’NFC, mitjançant JPKI en lloc d’ICAO 9303, i cada resultat d’NFC indica quin protocol s’ha utilitzat a chip_protocol (icao o jpki).

Encara no disponible. La lectura de la My Number Card mitjançant JPKI no està activada a producció. Fins que ho estigui, una My Number Card capturada en un SDK natiu omet el pas d’NFC amb el motiu d’omissió JPKI_UNAVAILABLE, i la targeta es verifica amb la captura de documents i la coincidència facial com abans.

Requisits

Requisit	Detall
Document	Només la Japan My Number Card. Els passaports japonesos mantenen la lectura de xip ICAO 9303.
Integració	Una versió de l’SDK natiu que llegeixi My Number Cards (iOS, Android o els SDK de React Native i Flutter basats en aquests). L’SDK indica a Didit que pot llegir JPKI; una versió més antiga omet el pas amb `JPKI_UNAVAILABLE`. Les integracions web i WebView l’ometen amb `INTEGRATION_WITHOUT_NFC_ACCESS`.
Dispositiu	Un telèfon amb lector NFC. Sense aquest, el pas s’omet amb `DEVICE_WITHOUT_NFC`.
Aplicació amfitriona d’iOS	`D392F000260100000001` als identificadors de selecció ISO7816 de l’aplicació. Consulta la configuració d’NFC per a iOS.
Persona	Coneix el PIN de 4 dígits de la targeta, i també la contrasenya de signatura quan el teu flux de treball sol·licita les dades del titular.

Què fa la persona

Fotografiar la targeta

La persona captura la My Number Card en el pas de verificació d’identitat, com es fa amb qualsevol document. Didit reconeix la targeta i envia un pas d’NFC amb JPKI en comptes d’una lectura de xip de passaport.

Introduir el PIN de la targeta

L’SDK demana el PIN de 4 dígits de la targeta (利用者証明用電子証明書の暗証番号). Quan el paràmetre jpki_request_attributes del node d’NFC està activat (per defecte), també demana la contrasenya de signatura, anomenada també PIN de signatura (署名用電子証明書の暗証番号, de 6 a 16 caràcters, formats per lletres majúscules i números).

Apropar la targeta al telèfon

L’SDK llegeix els certificats de la targeta, i la targeta signa un desafiament d’un sol ús de Didit amb la seva pròpia clau. L’SDK puja els certificats i les signatures. Els PIN només van a la targeta, mai a Didit.

La targeta compta les entrades incorrectes: bloqueja el PIN de 4 dígits després de 3 intents consecutius i la contrasenya de signatura després de 5, i si es bloqueja s’ha de restablir a l’oficina municipal del titular. Després d’un intent incorrecte, l’SDK mostra quants intents queden. Mai realitza l’últim intent: quan només en queda un, s’atura i indica a la persona on pot restablir-lo. Demana als usuaris que tinguin preparats el seu PIN i la contrasenya de signatura abans de començar.

Què comprova Didit

Comprovació	Què verifica Didit	Advertència quan falla (acció per defecte)
Cadena de certificats	Cada certificat enllaça amb l’autoritat de certificació JPKI del seu tipus, està dins del seu període de validesa i és un certificat de My Number Card (`jpki.chain_valid`).	`JPKI_CERTIFICATE_INVALID` (Rebutjar)
Targeta i PIN	La signatura de la targeta sobre el desafiament d’un sol ús es verifica contra el seu certificat (`jpki.signature_valid`). La targeta només signa després d’introduir el seu PIN, per la qual cosa això demostra que la persona té la targeta i en coneix el PIN.	`JPKI_SIGNATURE_INVALID` (Rebutjar)
Revocació	Cap certificat ha estat revocat (`jpki.revocation_status`).	`JPKI_CERTIFICATE_REVOKED` quan és `revoked` (Rebutjar), `JPKI_REVOCATION_UNCHECKED` quan és `unchecked` (Revisió)
Dades del titular	El nom, la data de naixement, el sexe i l’adreça del certificat de signatura coincideixen amb les dades llegides de la foto de la mateixa targeta (`jpki.attributes_match_ocr`, `jpki.mismatched_attributes`).	`JPKI_AND_OCR_DATA_NOT_SAME` (Revisió)

Cada acció és una opció de configuració del node d’NFC, de manera que pots canviar-la a Sense acció, Revisió o Rebutjar. Consulta les advertències d’NFC i la configuració de la funcionalitat d’NFC.

Què significa un estat de revocació no comprovat

revocation_status: "unchecked" significa que Didit ha verificat la cadena de certificats i la signatura de la targeta, però no ha obtingut resposta sobre si algun certificat ha estat revocat. Un certificat es revoca quan, per exemple, es denuncia la pèrdua de la targeta. Com que no es pot descartar una targeta revocada, unchecked mai es tracta com a good. Genera JPKI_REVOCATION_UNCHECKED, la qual cosa envia el pas d’NFC a revisió per defecte. Tria un resultat diferent amb jpki_revocation_unchecked_action. Quan la cadena de certificats o la signatura no és vàlida, Didit no consulta sobre la revocació: l’estat es manté en unchecked i només es genera l’advertència de la cadena o de la signatura.

Dades del titular i privacitat

Amb jpki_request_attributes activat, la decisió inclou el nom, la data de naixement, el sexe i l’adreça del titular del certificat de signatura a jpki.attributes. Amb aquesta opció desactivada, la persona només introdueix el PIN de 4 dígits: la lectura continua demostrant la targeta i el PIN, però no conté dades del titular ni es compara amb la foto de la targeta.
El pas d’NFC mai llegeix del xip el número individual de 12 dígits (My Number) de la targeta.
La decisió informa d’allò que la targeta ha demostrat, mai dels certificats en si, dels seus números de sèrie ni de les signatures.

El resultat complet es descriu a l’informe de verificació NFC.

Exemples d’integració

SDK d’iOS (Ja disponible)

import DiditSdk

// NFC is automatically enabled when the document supports it
let config = DiditSdk.Configuration(
    // NFC configuration is handled automatically
    // Just ensure your app has the required entitlements
)

let result = try await DiditSdk.shared.startVerification(
    with: sessionId,
    configuration: config
)

Documentació completa de l’SDK d’iOS →

SDK d’Android (Ja disponible)

import me.didit.sdk.DiditSdk

// NFC is automatically enabled when the document supports it
DiditSdk.startVerification(
    token = "your-session-token"
) { result ->
    handleResult(result)
}

Documentació de l’SDK d’Android →

Arquitectura de seguretat

┌─────────────────────────────────────────────────────────────┐
│                    NFC Verification Flow                     │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────┐    ┌──────────┐    ┌──────────────────────┐  │
│  │ Document │───▶│  Phone   │───▶│   Didit Backend      │  │
│  │ NFC Chip │    │ NFC Read │    │                      │  │
│  └──────────┘    └──────────┘    │  ┌────────────────┐  │  │
│                                   │  │ ICAO PKD       │  │  │
│                                   │  │ Validation     │  │  │
│                                   │  └────────────────┘  │  │
│                                   │  ┌────────────────┐  │  │
│                                   │  │ CSCA Master    │  │  │
│                                   │  │ List Check     │  │  │
│                                   │  └────────────────┘  │  │
│                                   │  ┌────────────────┐  │  │
│                                   │  │ CRL Revocation │  │  │
│                                   │  │ Check          │  │  │
│                                   │  └────────────────┘  │  │
│                                   └──────────────────────┘  │
│                                              │               │
│                                              ▼               │
│                                   ┌──────────────────────┐  │
│                                   │  Verification Result │  │
│                                   │  + Confidence Score  │  │
│                                   └──────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

Autenticació

Verificació

Monitoratge

Plataforma

Verificació NFC: API per a passaports electrònics i eID

Beneficis clau

Com habilitar la verificació NFC

Integració amb SDK natiu (Recomanada)

Integració web

Com funciona

Documents admesos

Japan My Number Card (JPKI)

Requisits

Què fa la persona

Què comprova Didit

Què significa un estat de revocació no comprovat

Dades del titular i privacitat

Exemples d’integració

SDK d’iOS (Ja disponible)

SDK d’Android (Ja disponible)

Arquitectura de seguretat

Preguntes freqüents

​Beneficis clau

​Com habilitar la verificació NFC

​Integració amb SDK natiu (Recomanada)

​Integració web

​Com funciona

​Documents admesos

​Japan My Number Card (JPKI)

​Requisits

​Què fa la persona

​Què comprova Didit

​Què significa un estat de revocació no comprovat

​Dades del titular i privacitat

​Exemples d’integració

​SDK d’iOS (Ja disponible)

​SDK d’Android (Ja disponible)

​Arquitectura de seguretat

​Preguntes freqüents

Beneficis clau

Com habilitar la verificació NFC

Integració amb SDK natiu (Recomanada)

Integració web

Com funciona

Documents admesos

Japan My Number Card (JPKI)

Requisits

Què fa la persona

Què comprova Didit

Què significa un estat de revocació no comprovat

Dades del titular i privacitat

Exemples d’integració

SDK d’iOS (Ja disponible)

SDK d’Android (Ja disponible)

Arquitectura de seguretat

Preguntes freqüents