API Verifikasi NFC: Chip e-Paspor & eID

Autentikasi berbasis NFC memungkinkan Anda memverifikasi dokumen identitas dengan membaca chip aman yang tersemat pada paspor dan tanda pengenal modern menggunakan kapabilitas NFC ponsel. Hal ini memberikan tingkat keamanan tertinggi yang tersedia untuk Verifikasi Identitas.

Manfaat Utama

Manfaat	Deskripsi
Keamanan Tertinggi	Memverifikasi tanda tangan kriptografis langsung dari penerbit pemerintah
Mudah Digunakan	Berfungsi secara otomatis dengan ponsel apa pun yang mendukung NFC
Tahan Manipulasi	Mendeteksi manipulasi dokumen yang tidak terlihat oleh mata manusia
Data Komprehensif	Mengekstrak data tambahan yang tidak tersedia hanya melalui OCR
Fallback yang Fleksibel	Beralih secara mulus ke verifikasi standar jika NFC tidak tersedia

Cara Mengaktifkan Verifikasi NFC

Integrasi SDK Native (Direkomendasikan)

Verifikasi NFC tersedia melalui SDK native kami, yang menyediakan akses penuh ke kapabilitas NFC perangkat:

Platform	Dukungan NFC	Dokumentasi
iOS	✅ Dukungan Penuh	Dokumentasi SDK iOS
Android	✅ Dukungan Penuh	Dokumentasi SDK Android

SDK iOS menangani semua konfigurasi NFC secara otomatis, termasuk:

Pengidentifikasi aplikasi ISO7816 untuk ePassport
Penyiapan entitlement dan kapabilitas
Pembacaan chip real-time dengan umpan balik visual

Integrasi Web

⚠️ Batasan Browser Verifikasi NFC tidak tersedia di browser web karena pembatasan platform:
Browser Dukungan NFC
Chrome (Android) Web NFC API eksperimental - tidak stabil, memerlukan izin eksplisit
Safari (iOS) Tidak ada dukungan Web NFC API
Browser Lainnya Tidak ada dukungan
Untuk integrasi web, verifikasi NFC secara otomatis dilewati dan pengguna melanjutkan dengan verifikasi dokumen + swafoto standar.

Browser	Dukungan NFC
Chrome (Android)	Web NFC API eksperimental - tidak stabil, memerlukan izin eksplisit
Safari (iOS)	Tidak ada dukungan Web NFC API
Browser Lainnya	Tidak ada dukungan

Cara Kerja

Inisiasi Sesi

Pengguna memulai proses verifikasi melalui aplikasi atau platform Anda:

SDK native: Meluncurkan alur verifikasi secara langsung di aplikasi Anda
Web/Web Seluler: Pengguna dipandu untuk menggunakan Didit App untuk verifikasi yang mendukung NFC, atau melanjutkan dengan verifikasi standar

Pengambilan Foto Dokumen

Pengguna memfoto dokumen identitas mereka, mengambil:

MRZ (Zona yang Dapat Dibaca Mesin) — digunakan untuk memperoleh kunci akses chip
Gambar bagian depan dan belakang dokumen — data visual dan fitur keamanan
Fitur keamanan visual — hologram, tanda air, cetak mikro

Deteksi Dukungan NFC

Sistem secara otomatis memeriksa kompatibilitas perangkat dan dokumen:

Pemeriksaan	Deskripsi
Tipe dokumen	Apakah ini ePassport/eID dengan chip NFC?
Kemampuan perangkat	Apakah ponsel mendukung pembacaan NFC?
Izin	Apakah izin NFC yang diperlukan telah diberikan?

Jika NFC tidak tersedia, verifikasi berlanjut dengan lancar menggunakan verifikasi dokumen + biometrik standar.

Pembacaan Chip NFC

Untuk perangkat dan dokumen yang kompatibel:

Pengguna diarahkan untuk menempatkan dokumen mereka di dekat pembaca NFC ponsel
Umpan balik visual menampilkan progres pembacaan secara real-time
Komunikasi aman dibuat dengan chip menggunakan protokol PACE/BAC

Ekstraksi Data

Sistem mengekstrak data komprehensif dari chip sesuai standar ICAO 9303:

Grup Data	Konten	Deskripsi
SOD	Objek Keamanan Dokumen	Tanda tangan digital untuk semua grup data
DG1	Data Pribadi	Nama, nomor identitas, tanggal lahir, tanggal kedaluwarsa
DG2	Gambar Wajah	Foto digital beresolusi tinggi dari pemegang dokumen
DG7	Tanda Tangan	Representasi digital dari tanda tangan pemegang dokumen
DG11-14	Data Tambahan	Dapat mencakup sidik jari, pemindaian iris (jika tersimpan)

Verifikasi Kriptografis

Data yang diekstrak menjalani verifikasi kriptografis yang ketat:

Verifikasi Tanda Tangan Digital

Hash setiap grup data diverifikasi terhadap tanda tangan yang tersimpan di SOD, memastikan integritas data.

Validasi Rantai Sertifikat

Rantai kepercayaan divalidasi: Sertifikat Dokumen → Country Signing CA → ICAO PKD Root, dengan memeriksa daftar induk CSCA dan ICAO Public Key Directory.

Pemeriksaan Pencabutan Sertifikat

Sertifikat diverifikasi terhadap Daftar Pencabutan Sertifikat (CRL) untuk memastikan sertifikat belum dicabut dan dokumen belum dilaporkan dicuri/dikompromikan.

Validasi Silang

Data yang diekstrak dari NFC divalidasi silang terhadap data OCR dari foto dokumen, perbandingan biometrik wajah, dan verifikasi checksum MRZ.

Hasil & Skor Keyakinan

Hasil verifikasi akhir mencakup:

Keluaran	Deskripsi
Status verifikasi NFC	Berhasil, gagal, atau dilewati
Skor konsistensi data	Seberapa baik data NFC cocok dengan data visual
Validasi sertifikat	Status verifikasi seluruh rantai
Peningkatan keyakinan	NFC menambahkan keyakinan signifikan pada verifikasi secara keseluruhan

Dokumen yang Didukung

Verifikasi NFC berfungsi dengan ePassport dan eID yang memiliki chip NFC, biasanya ditandai dengan simbol ini pada dokumen:

Sebagian besar paspor yang diterbitkan setelah 2006 memiliki chip NFC. Cakupan kartu identitas nasional bervariasi menurut negara. Periksa semua dokumen yang didukung. Japan My Number Card memiliki jenis chip yang berbeda, dibaca melalui JPKI bukan ICAO 9303. Lihat Japan My Number Card (JPKI).

Japan My Number Card (JPKI)

Japan My Number Card (マイナンバーカード) memiliki chip, tetapi bukan chip ICAO 9303. Kartu ini menyimpan sertifikat yang diterbitkan di bawah JPKI, infrastruktur kunci publik Jepang, serta kunci privat yang hanya dapat menandatangani setelah pemegang memasukkan PIN kartu. Didit membacanya dalam langkah NFC yang sama, melalui JPKI dan bukan ICAO 9303, dan setiap hasil NFC mencantumkan protokol mana yang digunakan di chip_protocol (icao atau jpki).

Belum tersedia. Pembacaan My Number Card melalui JPKI belum diaktifkan di produksi. Hingga fitur ini aktif, My Number Card yang diambil di SDK native akan melewati langkah NFC dengan alasan pelewatan JPKI_UNAVAILABLE, dan kartu diverifikasi dengan pengambilan dokumen serta pencocokan wajah seperti sebelumnya.

Persyaratan

Persyaratan	Detail
Dokumen	Hanya Japan My Number Card. Paspor Jepang tetap menggunakan pembacaan chip ICAO 9303.
Integrasi	Rilis SDK native yang membaca My Number Card (iOS, Android, atau SDK React Native dan Flutter yang dibangun di atasnya). SDK memberi tahu Didit bahwa SDK tersebut dapat membaca JPKI; rilis yang lebih lama melewati langkah ini dengan `JPKI_UNAVAILABLE`. Integrasi Web dan WebView melewatinya dengan `INTEGRATION_WITHOUT_NFC_ACCESS`.
Perangkat	Ponsel dengan pembaca NFC. Tanpa pembaca NFC, langkah ini dilewati dengan `DEVICE_WITHOUT_NFC`.
Aplikasi host iOS	`D392F000260100000001` dalam pengidentifikasi pemilihan ISO7816 aplikasi. Lihat konfigurasi NFC iOS.
Orang	Mengetahui PIN 4 digit kartu, serta kata sandi tanda tangannya ketika alur kerja Anda meminta data pemegang.

Apa yang dilakukan pengguna

Foto kartu

Pengguna mengambil foto My Number Card pada langkah verifikasi identitas, seperti halnya dokumen lainnya. Didit mengenali kartu tersebut dan mengirimkan langkah NFC JPKI alih-alih pembacaan chip paspor.

Masukkan PIN kartu

SDK meminta PIN 4 digit kartu (利用者証明用電子証明書の暗証番号). Jika pengaturan jpki_request_attributes pada node NFC aktif (secara bawaan), SDK juga meminta kata sandi tanda tangan, yang juga disebut PIN tanda tangan (署名用電子証明書の暗証番号, 6 hingga 16 huruf besar dan angka).

Tempelkan kartu ke ponsel

SDK membaca sertifikat kartu, dan kartu menandatangani tantangan sekali pakai dari Didit dengan kuncinya sendiri. SDK mengunggah sertifikat dan tanda tangan. PIN hanya dikirimkan ke kartu, tidak pernah ke Didit.

Kartu menghitung entri yang salah: kartu mengunci PIN 4 digit setelah 3 kali salah berturut-turut dan kata sandi tanda tangan setelah 5 kali salah, dan kartu yang terkunci harus diatur ulang di kantor pemerintah daerah pemegang kartu. Setelah entri salah, SDK menampilkan jumlah percobaan yang tersisa. SDK tidak pernah melakukan percobaan terakhir: ketika hanya tersisa satu kali percobaan, SDK berhenti dan memberi tahu pengguna tempat untuk mengatur ulangnya. Minta pengguna untuk menyiapkan PIN dan kata sandi tanda tangan mereka sebelum memulai.

Apa yang diperiksa Didit

Pemeriksaan	Apa yang diverifikasi Didit	Peringatan saat gagal (tindakan default)
Rantai sertifikat	Rantai setiap sertifikat berujung pada otoritas sertifikasi JPKI sesuai jenisnya, berada dalam masa berlakunya, dan merupakan sertifikat My Number Card (`jpki.chain_valid`).	`JPKI_CERTIFICATE_INVALID` (Tolak)
Kartu dan PIN	Tanda tangan kartu atas tantangan sekali pakai terverifikasi terhadap sertifikatnya (`jpki.signature_valid`). Kartu hanya menandatangani setelah PIN-nya dimasukkan, sehingga hal ini membuktikan pengguna memegang kartu dan mengetahui PIN-nya.	`JPKI_SIGNATURE_INVALID` (Tolak)
Pencabutan	Tidak ada sertifikat yang telah dicabut (`jpki.revocation_status`).	`JPKI_CERTIFICATE_REVOKED` saat `revoked` (Tolak), `JPKI_REVOCATION_UNCHECKED` saat `unchecked` (Peninjauan)
Data pemegang	Nama, tanggal lahir, jenis kelamin, dan alamat pada sertifikat tanda tangan cocok dengan data yang dibaca dari foto kartu yang sama (`jpki.attributes_match_ocr`, `jpki.mismatched_attributes`).	`JPKI_AND_OCR_DATA_NOT_SAME` (Peninjauan)

Setiap tindakan merupakan pengaturan pada node NFC, sehingga Anda dapat mengubahnya menjadi Tidak ada tindakan, Peninjauan, atau Tolak. Lihat peringatan NFC dan konfigurasi fitur NFC.

Arti status pencabutan unchecked

revocation_status: "unchecked" berarti Didit telah memverifikasi rantai sertifikat dan tanda tangan kartu, tetapi tidak mendapatkan jawaban mengenai apakah sertifikat telah dicabut. Sertifikat dicabut ketika, misalnya, kartu dilaporkan hilang. Karena kartu yang dicabut tidak dapat dikesampingkan, unchecked tidak pernah dianggap sebagai good. Kondisi ini memicu JPKI_REVOCATION_UNCHECKED, yang secara default mengarahkan langkah NFC ke peninjauan. Pilih hasil yang berbeda dengan jpki_revocation_unchecked_action. Ketika rantai sertifikat atau tanda tangan tidak valid, Didit tidak meminta status pencabutan: status tetap unchecked dan hanya peringatan rantai atau tanda tangan yang dimunculkan.

Data pemegang dan privasi

Dengan jpki_request_attributes aktif, keputusan menyertakan nama pemegang, tanggal lahir, jenis kelamin, dan alamat dari sertifikat tanda tangan di bawah jpki.attributes. Jika dinonaktifkan, pengguna hanya memasukkan PIN 4 digit: pembacaan tetap membuktikan kartu dan PIN, tetapi tidak memuat data pemegang dan tidak dibandingkan dengan foto kartu.
Langkah NFC tidak pernah membaca Nomor Individu 12 digit (My Number) kartu dari chip.
Keputusan melaporkan apa yang dibuktikan kartu, tidak pernah melaporkan sertifikat itu sendiri, nomor serinya, maupun tanda tangannya.

Hasil lengkap dijelaskan dalam laporan verifikasi NFC.

Contoh Integrasi

SDK iOS (Tersedia Sekarang)

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
)

Dokumentasi Lengkap SDK iOS →

SDK Android (Tersedia Sekarang)

import me.didit.sdk.DiditSdk

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

Dokumentasi SDK Android →

Arsitektur Keamanan

┌─────────────────────────────────────────────────────────────┐
│                    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  │  │
│                                   └──────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

Autentikasi

Verifikasi

Pemantauan

Platform

API Verifikasi NFC: Chip e-Paspor & eID

Manfaat Utama

Cara Mengaktifkan Verifikasi NFC

Integrasi SDK Native (Direkomendasikan)

Integrasi Web

Cara Kerja

Dokumen yang Didukung

Japan My Number Card (JPKI)

Persyaratan

Apa yang dilakukan pengguna

Apa yang diperiksa Didit

Arti status pencabutan unchecked

Data pemegang dan privasi

Contoh Integrasi

SDK iOS (Tersedia Sekarang)

SDK Android (Tersedia Sekarang)

Arsitektur Keamanan

Pertanyaan yang Sering Diajukan

​Manfaat Utama

​Cara Mengaktifkan Verifikasi NFC

​Integrasi SDK Native (Direkomendasikan)

​Integrasi Web

​Cara Kerja

​Dokumen yang Didukung

​Japan My Number Card (JPKI)

​Persyaratan

​Apa yang dilakukan pengguna

​Apa yang diperiksa Didit

​Arti status pencabutan unchecked

​Data pemegang dan privasi

​Contoh Integrasi

​SDK iOS (Tersedia Sekarang)

​SDK Android (Tersedia Sekarang)

​Arsitektur Keamanan

​Pertanyaan yang Sering Diajukan

Manfaat Utama

Cara Mengaktifkan Verifikasi NFC

Integrasi SDK Native (Direkomendasikan)

Integrasi Web

Cara Kerja

Dokumen yang Didukung

Japan My Number Card (JPKI)

Persyaratan

Apa yang dilakukan pengguna

Apa yang diperiksa Didit

Arti status pencabutan unchecked

Data pemegang dan privasi

Contoh Integrasi

SDK iOS (Tersedia Sekarang)

SDK Android (Tersedia Sekarang)

Arsitektur Keamanan

Pertanyaan yang Sering Diajukan