Banyak perangkat Android yang menawarkan fungsi NFC sudah mendukung emulasi kartu NFC. Pada umumnya, kartu diemulasikan oleh chip terpisah di perangkat, yang disebut elemen pengaman. Banyak kartu SIM yang disediakan oleh operator nirkabel juga berisi elemen pengaman.
Android 4.4 dan yang lebih tinggi menyediakan metode emulasi kartu tambahan yang tidak melibatkan elemen pengaman, yang disebut emulasi kartu berbasis host. Hal ini memungkinkan aplikasi Android apa pun mengemulasi kartu dan berkomunikasi langsung dengan pembaca NFC. Topik ini menjelaskan cara kerja emulasi kartu berbasis host (HCE) di Android dan cara mengembangkan aplikasi yang mengemulasi kartu NFC menggunakan teknik ini.
Emulasi kartu dengan elemen pengaman
Jika emulasi kartu NFC disediakan menggunakan elemen pengaman, kartu yang akan diemulasikan disediakan ke elemen pengaman di perangkat melalui aplikasi Android. Kemudian, saat pengguna mendekatkan perangkat ke terminal NFC, pengontrol NFC di perangkat akan mengarahkan semua data dari pembaca langsung ke elemen pengaman. Gambar 1 mengilustrasikan konsep ini:
Gambar 1. Emulasi kartu NFC dengan elemen pengaman.
Elemen pengaman itu sendiri yang melakukan komunikasi dengan terminal NFC, dan tidak ada aplikasi Android yang terlibat dalam transaksi. Setelah transaksi selesai, aplikasi Android dapat mengkueri elemen pengaman secara langsung untuk status transaksi dan memberi tahu pengguna.
Emulasi kartu berbasis host
Saat kartu NFC diemulasikan menggunakan emulasi kartu berbasis host, data dirutekan langsung ke CPU host, bukan ke elemen pengaman. Gambar 2 mengilustrasikan cara kerja emulasi kartu berbasis host:
Gambar 2. Emulasi kartu NFC tanpa elemen pengaman.
Kartu dan protokol NFC yang didukung
Gambar 3. Stack protokol HCE Android.
Standar NFC menawarkan dukungan untuk berbagai protokol, dan ada berbagai jenis kartu yang dapat Anda emulasikan.
Android 4.4 dan yang lebih tinggi mendukung beberapa protokol yang umum di pasar
saat ini. Banyak kartu nirsentuh yang sudah ada didasarkan pada protokol ini,
seperti kartu pembayaran nirsentuh. Protokol ini juga didukung oleh banyak
pembaca NFC di pasar saat ini, termasuk perangkat NFC Android yang berfungsi sebagai
pembaca (lihat class
IsoDep). Hal ini memungkinkan Anda membangun dan men-deploy solusi NFC menyeluruh di sekitar
HCE hanya menggunakan perangkat yang didukung Android.
Secara khusus, Android 4.4 dan yang lebih tinggi mendukung emulasi kartu yang didasarkan pada spesifikasi ISO-DEP NFC-Forum (berdasarkan ISO/IEC 14443-4) dan memproses Application Protocol Data Unit (APDU) seperti yang ditentukan dalam spesifikasi ISO/IEC 7816-4. Android mewajibkan emulasi ISO-DEP hanya di atas teknologi Nfc-A (ISO/IEC 14443-3 Type A). Dukungan untuk teknologi Nfc-B (ISO/IEC 14443-4 Jenis B) bersifat opsional. Gambar 3 mengilustrasikan pelapisan semua spesifikasi ini.
Layanan HCE
Arsitektur HCE di Android didasarkan pada komponen
Service Android (dikenal sebagai layanan
HCE). Salah satu keunggulan utama layanan adalah dapat berjalan di
latar belakang tanpa antarmuka pengguna. Hal ini cocok untuk banyak aplikasi HCE, seperti kartu loyalitas atau kartu transportasi umum, yang tidak mengharuskan pengguna meluncurkan aplikasi untuk menggunakannya. Sebagai gantinya, mengetuk perangkat ke pembaca NFC akan memulai
layanan yang benar jika belum berjalan dan menjalankan transaksi
di latar belakang. Tentu saja, Anda bebas meluncurkan UI tambahan (seperti
notifikasi pengguna) dari layanan Anda jika sesuai.
Pilihan layanan
Saat pengguna mengetuk perangkat ke pembaca NFC, sistem Android perlu mengetahui layanan HCE yang ingin diajak berkomunikasi oleh pembaca NFC. Spesifikasi ISO/IEC 7816-4 menentukan cara memilih aplikasi, yang berpusat pada ID Aplikasi (AID). AID terdiri dari hingga 16 byte. Jika Anda mengemulasi kartu untuk infrastruktur pembaca NFC yang ada, AID yang dicari pembaca tersebut biasanya sudah dikenal dan terdaftar secara publik (misalnya, AID jaringan pembayaran seperti Visa dan MasterCard).
Jika ingin men-deploy infrastruktur pembaca baru untuk aplikasi Anda sendiri, Anda harus mendaftarkan AID Anda sendiri. Prosedur pendaftaran untuk AID ditentukan dalam spesifikasi ISO/IEC 7816-5. Sebaiknya daftarkan AID sesuai dengan 7816-5 jika Anda men-deploy aplikasi HCE untuk Android, karena hal ini akan menghindari konflik dengan aplikasi lain.
Grup AID
Dalam beberapa kasus, layanan HCE mungkin perlu mendaftarkan beberapa AID dan ditetapkan sebagai pengendali default untuk semua AID guna mengimplementasikan aplikasi tertentu. Beberapa AID dalam grup yang beralih ke layanan lain tidak didukung.
Daftar AID yang disimpan bersama disebut grup AID. Untuk semua AID dalam grup AID, Android menjamin salah satu hal berikut:
- Semua AID dalam grup dirutekan ke layanan HCE ini.
- Tidak ada AID dalam grup yang dirutekan ke layanan HCE ini (misalnya, karena pengguna lebih memilih layanan lain yang juga meminta satu atau beberapa AID dalam grup Anda).
Dengan kata lain, tidak ada status di antara, di mana beberapa AID dalam grup dapat dirutekan ke satu layanan HCE, dan beberapa ke layanan lainnya.
Grup dan kategori AID
Anda dapat mengaitkan setiap grup AID dengan kategori. Hal ini memungkinkan Android mengelompokkan layanan HCE berdasarkan kategori, dan pada gilirannya memungkinkan pengguna menetapkan setelan default di tingkat kategori, bukan di tingkat AID. Hindari menyebutkan AID di bagian aplikasi yang ditampilkan kepada pengguna, karena AID tidak berarti apa-apa bagi pengguna biasa.
Android 4.4 dan yang lebih tinggi mendukung dua kategori:
CATEGORY_PAYMENT(mencakup aplikasi pembayaran standar industri)CATEGORY_OTHER(untuk semua aplikasi HCE lainnya)
Aplikasi yang mendaftarkan AID di bagian CATEGORY_PAYMENT hanya dapat memproses transaksi
jika:
- Pengguna menetapkan aplikasi sebagai aplikasi pembayaran default (pemegang peran Wallet di perangkat Android 15+), ATAU
- Aplikasi berada di latar depan dan memanggil
setPreferredService.
Mengimplementasikan layanan HCE
Untuk mengemulasi kartu NFC menggunakan emulasi kartu berbasis host, Anda perlu membuat
komponen Service yang menangani transaksi NFC.
Memeriksa dukungan HCE
Aplikasi Anda dapat memeriksa apakah perangkat mendukung HCE dengan memeriksa fitur
FEATURE_NFC_HOST_CARD_EMULATION. Gunakan tag <uses-feature>
dalam manifes aplikasi Anda untuk mendeklarasikan bahwa aplikasi Anda menggunakan fitur
HCE, dan apakah fitur tersebut diperlukan agar aplikasi dapat berfungsi atau tidak.
Pelaksanaan layanan
Android 4.4 dan yang lebih tinggi menyediakan class Service praktis yang dapat Anda gunakan
sebagai dasar untuk mengimplementasikan layanan HCE: class
HostApduService.
Langkah pertama adalah memperluas HostApduService, seperti yang ditunjukkan dalam contoh kode
berikut:
class MyHostApduService : HostApduService() { override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray { // ... } override fun onDeactivated(reason: Int) { // ... } }
HostApduService mendeklarasikan dua metode abstrak yang harus Anda ganti dan
terapkan. Salah satunya,
processCommandApdu(),
dipanggil setiap kali pembaca NFC mengirimkan Application Protocol Data Unit (APDU)
ke layanan Anda. APDU ditentukan dalam spesifikasi ISO/IEC 7816-4. APDU
adalah paket tingkat aplikasi yang dipertukarkan antara pembaca NFC dan
layanan HCE Anda. Protokol tingkat aplikasi tersebut bersifat half-duplex: pembaca NFC
mengirimkan APDU perintah kepada Anda, dan menunggu Anda mengirimkan APDU respons sebagai
balasan.
Seperti yang disebutkan sebelumnya, Android menggunakan AID untuk menentukan layanan HCE yang
ingin diajak berkomunikasi oleh pembaca. Biasanya, APDU pertama yang dikirim pembaca NFC ke perangkat Anda adalah APDU SELECT AID; APDU ini berisi AID yang ingin diajak berkomunikasi oleh pembaca. Android mengekstrak AID tersebut dari APDU, me-resolve-nya ke layanan
HCE, lalu meneruskan APDU tersebut ke layanan yang di-resolve.
Anda dapat mengirim APDU respons dengan menampilkan byte APDU respons dari
processCommandApdu(). Perhatikan bahwa metode ini dipanggil di thread utama
aplikasi Anda, yang tidak boleh Anda blokir. Jika Anda tidak dapat menghitung dan menampilkan
APDU respons dengan segera, tampilkan null. Kemudian, Anda dapat melakukan pekerjaan yang diperlukan di
thread lain dan menggunakan metode
sendResponseApdu()
yang ditentukan di class HostApduService untuk mengirim respons setelah
selesai.
Android terus meneruskan APDU baru dari pembaca ke layanan Anda, hingga salah satu hal berikut terjadi:
- Pembaca NFC mengirimkan APDU
SELECT AIDlain, yang diselesaikan oleh OS ke layanan yang berbeda. - Link NFC antara pembaca NFC dan perangkat Anda rusak.
Dalam kedua kasus ini, implementasi
onDeactivated()
class Anda dipanggil dengan argumen yang menunjukkan salah satu dari dua hal yang terjadi.
Jika Anda menggunakan infrastruktur pembaca yang ada, Anda harus menerapkan protokol tingkat aplikasi yang ada yang diharapkan pembaca di layanan HCE Anda.
Jika Anda men-deploy infrastruktur pembaca baru yang juga Anda kontrol, Anda dapat menentukan protokol dan urutan APDU Anda sendiri. Cobalah untuk membatasi jumlah APDU dan ukuran data yang akan dipertukarkan: hal ini memastikan bahwa pengguna hanya perlu mendekatkan perangkat mereka ke pembaca NFC dalam waktu singkat. Batas atas yang wajar adalah sekitar 1 KB data, yang biasanya dapat dipertukarkan dalam waktu 300 md.
Deklarasi manifes layanan dan pendaftaran AID
Anda harus mendeklarasikan layanan dalam manifes seperti biasa, tetapi Anda juga harus menambahkan beberapa bagian tambahan ke deklarasi layanan:
Untuk memberi tahu platform bahwa layanan tersebut adalah layanan HCE yang mengimplementasikan antarmuka
HostApduService, tambahkan filter intent untuk tindakanSERVICE_INTERFACEke deklarasi layanan Anda.Untuk memberi tahu platform grup AID mana yang diminta oleh layanan ini, sertakan tag
SERVICE_META_DATA<meta-data>dalam deklarasi layanan, yang mengarah ke resource XML dengan informasi tambahan tentang layanan HCE.Tetapkan atribut
android:exportedketrue, dan wajibkan izinandroid.permission.BIND_NFC_SERVICEdalam deklarasi layanan Anda. Poin pertama memastikan bahwa layanan dapat diikat oleh aplikasi eksternal. Layanan yang terakhir kemudian menerapkan bahwa hanya aplikasi eksternal yang memiliki izinandroid.permission.BIND_NFC_SERVICEyang dapat mengikat ke layanan Anda. Karenaandroid.permission.BIND_NFC_SERVICEadalah izin sistem, hal ini secara efektif menerapkan bahwa hanya Android OS yang dapat mengikat ke layanan Anda.
Berikut adalah contoh deklarasi manifes HostApduService:
<service android:name=".MyHostApduService" android:exported="true" android:permission="android.permission.BIND_NFC_SERVICE"> <intent-filter> <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/> </intent-filter> <meta-data android:name="android.nfc.cardemulation.host_apdu_service" android:resource="@xml/apduservice"/> </service>
Tag metadata ini mengarah ke file apduservice.xml. Berikut adalah
contoh file tersebut dengan satu deklarasi grup AID yang berisi dua
AID eksklusif:
<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android" android:description="@string/servicedesc" android:requireDeviceUnlock="false"> <aid-group android:description="@string/aiddescription" android:category="other"> <aid-filter android:name="F0010203040506"/> <aid-filter android:name="F0394148148100"/> </aid-group> </host-apdu-service>
Tag <host-apdu-service> harus berisi atribut <android:description>
yang berisi deskripsi layanan yang mudah digunakan yang dapat Anda tampilkan di
UI aplikasi. Anda dapat menggunakan atribut requireDeviceUnlock untuk menentukan bahwa
perangkat dibuka kuncinya sebelum Anda memanggil layanan ini untuk menangani APDU.
<host-apdu-service> harus berisi satu atau beberapa tag <aid-group>. Setiap tag <aid-group> harus melakukan hal berikut:
- Berisi atribut
android:descriptionyang berisi deskripsi grup AID yang mudah digunakan, yang cocok untuk ditampilkan di UI. - Memiliki atribut
android:categoryyang ditetapkan untuk menunjukkan kategori grup AID, seperti konstanta string yang ditentukan olehCATEGORY_PAYMENTatauCATEGORY_OTHER. - Berisi satu atau beberapa tag
<aid-filter>, yang masing-masing berisi satu AID. Tentukan AID dalam format heksadesimal, dan pastikan AID berisi jumlah karakter genap.
Aplikasi Anda juga harus memiliki
izin NFC untuk mendaftar sebagai
layanan HCE.
Penyelesaian konflik AID
Beberapa komponen HostApduService dapat diinstal di satu perangkat, dan
AID yang sama dapat didaftarkan oleh lebih dari satu layanan. Android menentukan
layanan mana yang akan dipanggil menggunakan langkah-langkah berikut:
- Jika aplikasi dompet default yang dipilih pengguna telah mendaftarkan AID, aplikasi tersebut akan dipanggil.
- Jika aplikasi dompet default belum mendaftarkan AID, layanan yang telah mendaftarkan AID akan dipanggil.
- Jika lebih dari satu layanan telah mendaftarkan AID, Android akan menanyakan kepada pengguna layanan mana yang akan dipanggil.
Preferensi layanan latar depan
Aplikasi di latar depan dapat memanggil setPreferredService
untuk menentukan layanan emulasi kartu mana yang harus diprioritaskan saat aktivitas
tertentu berada di latar depan. Preferensi aplikasi latar depan ini menggantikan resolusi konflik AID. Praktik ini direkomendasikan saat aplikasi mengantisipasi
bahwa pengguna mungkin menggunakan emulasi kartu NFC.
Android 13 dan yang lebih baru
Agar lebih sesuai dengan daftar pilihan pembayaran default di UI Setelan, sesuaikan persyaratan banner menjadi ikon persegi. Idealnya, ikon ini harus sama dengan desain ikon peluncur aplikasi. Penyesuaian ini menciptakan konsistensi yang lebih baik dan tampilan yang lebih rapi.
Android 12 dan yang lebih lama
Tetapkan ukuran banner layanan ke 260x96 dp, lalu tetapkan ukuran banner layanan
dalam file XML metadata Anda dengan menambahkan atribut android:apduServiceBanner ke
tag <host-apdu-service>, yang mengarah ke resource drawable. Berikut
adalah contohnya:
<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android" android:description="@string/servicedesc" android:requireDeviceUnlock="false" android:apduServiceBanner="@drawable/my_banner"> <aid-group android:description="@string/aiddescription" android:category="payment"> <aid-filter android:name="F0010203040506"/> <aid-filter android:name="F0394148148100"/> </aid-group> </host-apdu-service>
Aplikasi Wallet
Android 15 dan yang lebih tinggi menyertakan peran aplikasi dompet default yang dapat dipilih pengguna dengan membuka Setelan > Aplikasi > Aplikasi Default. Tindakan ini menentukan aplikasi dompet default yang akan dipanggil saat terminal pembayaran diketuk. Android menganggap layanan HCE yang telah mendeklarasikan grup AID dengan kategori pembayaran sebagai aplikasi dompet.
Memeriksa apakah aplikasi Anda adalah aplikasi dompet default
Aplikasi dapat memeriksa apakah aplikasi tersebut adalah aplikasi dompet default dengan meneruskan
RoleManager.ROLE_WALLET
ke
RoleManager.isRoleHeld().
Jika aplikasi Anda bukan aplikasi default, Anda dapat meminta peran dompet default dengan
meneruskan RoleManager.ROLE_WALLET ke
RoleManager.createRequestRoleIntent().
Aset yang diperlukan untuk aplikasi dompet
Untuk memberikan pengalaman pengguna yang lebih menarik secara visual, aplikasi dompet HCE diperlukan untuk menyediakan banner layanan.
Mode Pengamatan
Android 15 memperkenalkan fitur Mode Pengamatan. Jika diaktifkan, Mode Pengamatan
memungkinkan perangkat mengamati loop polling NFC dan mengirim notifikasi tentangnya
ke komponen HostApduService yang sesuai sehingga komponen tersebut dapat bersiap untuk
berinteraksi dengan terminal NFC tertentu. HostApduService dapat menempatkan perangkat dalam
Mode Pengamatan dengan meneruskan true ke
setObserveModeEnabled().
Hal ini menginstruksikan stack NFC untuk tidak mengizinkan transaksi NFC dan mengamati loop polling secara pasif.
Filter loop polling
Anda dapat mendaftarkan filter loop polling untuk HostApduService menggunakan salah satu
metode berikut:
registerPollingLoopFilterForService()untuk filter yang harus sama persis dengan frame polling.registerPollingLoopPatternFilterForService()untuk filter yang mencocokkan ekspresi reguler dengan frame polling.
Jika filter loop polling cocok dengan frame polling nonstandar, stack NFC
akan merutekan frame polling tersebut ke HostApduService yang sesuai dengan memanggil
metode
processPollingFrames()-nya. Hal ini memungkinkan layanan mengambil langkah-langkah yang diperlukan untuk memastikan bahwa
pengguna siap bertransaksi dan berniat melakukannya—misalnya, mengautentikasi
pengguna. Jika pembaca NFC hanya menggunakan frame standar dalam loop polling-nya, stack NFC akan merutekan frame polling tersebut ke layanan latar depan pilihan jika
layanan tersebut berada di latar depan atau ke pemegang peran dompet default
jika tidak.
Notifikasi frame polling juga menyertakan pengukuran kekuatan medan khusus vendor yang dapat Anda ambil dengan memanggil getVendorSpecificGain().
Vendor dapat memberikan pengukuran menggunakan skala mereka sendiri asalkan sesuai dalam
satu byte.
Merespons loop polling dan beralih dari Mode Pengamatan
Saat siap melakukan transaksi, layanan dapat keluar dari Mode Pengamatan dengan meneruskan
false ke setObserveModeEnabled(). Stack NFC kemudian akan mengizinkan transaksi
untuk dilanjutkan.
Komponen HostApduService dapat menunjukkan bahwa Mode Pengamatan harus diaktifkan
setiap kali komponen tersebut menjadi layanan pembayaran pilihan dengan menetapkan
shouldDefaultToObserveMode ke true dalam manifes atau dengan memanggil
CardEmulation.setShouldDefaultToObserveModeForService().
Komponen HostApduService dan OffHostApduService juga dapat menunjukkan bahwa
filter loop polling yang cocok dengan frame loop polling yang diterima harus
otomatis menonaktifkan Mode Pengamatan dan mengizinkan transaksi dilanjutkan dengan menetapkan
autoTransact ke true dalam deklarasi PollingLoopFilter dalam manifes.
Preferensi layanan latar depan
Aplikasi di latar depan dapat memanggil setPreferredService
untuk menentukan layanan emulasi kartu mana yang harus diprioritaskan saat aktivitas
tertentu berada di latar depan. Preferensi aplikasi latar depan ini mengganti
status Mode Pengamatan perangkat yang sesuai dengan nilai
shouldDefaultToObserveMode untuk layanan tertentu, yang dapat ditetapkan dengan salah satu
cara berikut:
- Menetapkan status
shouldDefaultToObserveModedalam manifes untuk layanan tersebut. - Memanggil
CardEmulation.setShouldDefaultToObserveModeForService()dengan layanan dan status yang sesuai.
Perilaku layar kunci dan layar nonaktif
Perilaku layanan HCE bervariasi berdasarkan versi Android yang berjalan di perangkat.
Android 15 dan yang lebih baru
Jika aplikasi dompet default mengaktifkan Mode Pengamatan di perangkat yang mendukungnya, aplikasi tersebut akan mengganti perilaku buka kunci dan layar nonaktif, karena aplikasi tersebut mengontrol kapan transaksi dapat dilanjutkan. Beberapa aplikasi dompet mungkin mengharuskan perangkat dibuka kuncinya sebelum transaksi dapat dilanjutkan jika Mode Pengamatan tidak mendeteksi pola loop polling yang dapat diidentifikasi.
Developer dianjurkan untuk menggunakan perangkat pembaca mereka untuk memancarkan pola loop polling yang dapat diidentifikasi dan mendaftar untuk menangani pola tersebut dari aplikasi mereka.
Android 12 dan yang lebih baru
Pada aplikasi yang menargetkan Android 12 (level API 31) dan yang lebih tinggi, Anda dapat mengaktifkan pembayaran NFC
tanpa mengaktifkan layar perangkat dengan menyetel
requireDeviceScreenOn ke
false.
Android 10 dan yang lebih baru
Perangkat yang menjalankan Android 10 (level API 29) atau yang lebih tinggi mendukung
NFC
Aman. Saat Amankan
NFC aktif, semua emulator kartu (aplikasi host dan aplikasi off-host) tidak
tersedia saat layar perangkat nonaktif. Saat Amankan NFC nonaktif, aplikasi
off-host tersedia saat layar perangkat nonaktif. Anda dapat memeriksa
dukungan Amankan NFC menggunakan
isSecureNfcSupported().
Pada perangkat yang menjalankan Android 10 dan yang lebih tinggi, fungsi yang sama untuk menyetel
android:requireDeviceUnlock ke true berlaku seperti pada perangkat
yang menjalankan Android 9 dan yang lebih rendah, tetapi hanya jika NFC Aman dinonaktifkan. Artinya, jika
NFC Aman diaktifkan, layanan HCE tidak dapat berfungsi dari layar kunci,
terlepas dari setelan android:requireDeviceUnlock.
Android 9 dan yang lebih lama
Pada perangkat yang menjalankan Android 9 (API level 28) dan yang lebih rendah, pengontrol NFC dan pemroses aplikasi dinonaktifkan sepenuhnya saat layar perangkat dinonaktifkan. Oleh karena itu, layanan HCE tidak berfungsi saat layar nonaktif.
Selain itu, di Android 9 dan yang lebih rendah, layanan HCE dapat berfungsi dari layar kunci.
Namun, hal ini dikontrol oleh atribut android:requireDeviceUnlock di
tag <host-apdu-service> layanan HCE Anda. Secara default, pembukaan kunci perangkat
tidak diperlukan, dan layanan Anda dipanggil meskipun perangkat terkunci.
Jika Anda menetapkan atribut android:requireDeviceUnlock ke true untuk layanan HCE, Android akan meminta pengguna untuk membuka kunci perangkat saat hal berikut terjadi:
- pengguna mengetuk pembaca NFC.
- pembaca NFC memilih AID yang di-resolve ke layanan Anda.
Setelah membuka kunci, Android akan menampilkan dialog yang meminta pengguna mengetuk lagi untuk menyelesaikan transaksi. Hal ini diperlukan karena pengguna mungkin telah memindahkan perangkat dari pembaca NFC untuk membukanya.
Koeksistensi dengan kartu elemen pengaman
Bagian ini ditujukan bagi developer yang telah men-deploy aplikasi yang mengandalkan elemen pengaman untuk emulasi kartu. Implementasi HCE Android dirancang untuk berfungsi secara paralel dengan metode lain dalam mengimplementasikan emulasi kartu, termasuk penggunaan elemen pengaman.
Koeksistensi ini didasarkan pada prinsip yang disebut perutean AID. Pengontrol NFC menyimpan tabel pemilihan rute yang terdiri dari daftar (terbatas) aturan pemilihan rute. Setiap aturan perutean berisi AID dan tujuan. Tujuannya dapat berupa CPU host, tempat aplikasi Android berjalan, atau elemen pengaman yang terhubung.
Saat pembaca NFC mengirim APDU dengan SELECT AID, pengontrol NFC akan mengurainya
dan memeriksa apakah AID cocok dengan AID mana pun dalam tabel peruteannya. Jika cocok, APDU tersebut dan semua APDU yang mengikutinya akan dikirim ke tujuan yang terkait dengan AID, hingga APDU SELECT AID lain diterima atau link NFC terputus.
Gambar 4 mengilustrasikan arsitektur ini:
Gambar 4. Android beroperasi dengan elemen pengaman dan host card emulation.
Biasanya, pengontrol NFC juga memuat rute default untuk APDU. Jika AID tidak ditemukan dalam tabel pemilihan rute, rute default akan digunakan. Meskipun setelan ini mungkin berbeda dari satu perangkat ke perangkat lainnya, perangkat Android harus memastikan bahwa AID yang didaftarkan oleh aplikasi Anda dirutekan dengan benar ke host.
Aplikasi Android yang mengimplementasikan layanan HCE atau yang menggunakan elemen pengaman tidak perlu khawatir tentang mengonfigurasi tabel pemilihan rute; hal itu ditangani oleh Android secara otomatis. Android hanya perlu mengetahui AID mana yang dapat ditangani oleh layanan HCE dan mana yang dapat ditangani oleh elemen pengaman. Tabel pemilihan rute dikonfigurasi secara otomatis berdasarkan layanan yang diinstal dan yang telah dikonfigurasi pengguna sebagai layanan pilihan.
Bagian berikut menjelaskan cara mendeklarasikan AID untuk aplikasi yang menggunakan elemen pengaman untuk emulasi kartu.
Pendaftaran AID elemen pengaman
Aplikasi yang menggunakan elemen pengaman untuk emulasi kartu dapat mendeklarasikan layanan di luar host dalam manifesnya. Deklarasi layanan tersebut hampir identik dengan deklarasi layanan HCE. Pengecualiannya adalah sebagai berikut:
- Tindakan yang digunakan dalam filter intent harus ditetapkan ke
SERVICE_INTERFACE. - Atribut nama metadata harus ditetapkan ke
SERVICE_META_DATA. File XML metadata harus menggunakan tag root
<offhost-apdu-service>.<service android:name=".MyOffHostApduService" android:secureElementName="eSE" android:exported="true" android:permission="android.permission.BIND_NFC_SERVICE"> <intent-filter> <action android:name="android.nfc.cardemulation.action.OFF_HOST_APDU_SERVICE"/> </intent-filter> <meta-data android:name="android.nfc.cardemulation.off_host_apdu_service" android:resource="@xml/apduservice"/> </service>
Berikut adalah contoh file apduservice.xml terkait
yang mendaftarkan dua AID:
<offhost-apdu-service xmlns:android="http://schemas.android.com/apk/res/android" android:description="@string/servicedesc"> <aid-group android:description="@string/subscription" android:category="other"> <aid-filter android:name="F0010203040506"/> <aid-filter android:name="F0394148148100"/> </aid-group> </offhost-apdu-service>
Atribut android:requireDeviceUnlock tidak berlaku untuk layanan di luar host,
karena CPU host tidak terlibat dalam transaksi, sehingga tidak dapat
mencegah elemen pengaman menjalankan transaksi saat perangkat
terkunci.
Atribut android:apduServiceBanner diperlukan untuk layanan di luar host
yang merupakan aplikasi pembayaran dan dapat dipilih sebagai aplikasi pembayaran
default.
Pemanggilan layanan di luar host
Android tidak pernah memulai atau mengikat ke layanan yang dideklarasikan sebagai "off-host", karena transaksi sebenarnya dijalankan oleh elemen pengaman, bukan oleh layanan Android. Deklarasi layanan hanya memungkinkan aplikasi mendaftarkan AID yang ada di elemen pengaman.
HCE dan keamanan
Arsitektur HCE menyediakan satu bagian inti keamanan: karena layanan Anda dilindungi oleh izin sistem BIND_NFC_SERVICE, hanya OS yang dapat terikat dan berkomunikasi dengan layanan Anda.
Hal ini memastikan bahwa APDU apa pun yang Anda terima sebenarnya adalah APDU yang diterima oleh
OS dari pengontrol NFC, dan bahwa APDU apa pun yang Anda kirim kembali hanya akan dikirim ke
OS, yang kemudian meneruskan APDU tersebut langsung ke pengontrol NFC.
Hal terakhir yang perlu diperhatikan adalah tempat Anda mendapatkan data yang dikirim aplikasi ke pembaca NFC. Hal ini sengaja dipisahkan dalam desain HCE; tidak peduli dari mana data berasal, hal ini hanya memastikan bahwa data tersebut dipindahkan dengan aman ke pengontrol NFC dan keluar ke pembaca NFC.
Untuk menyimpan dan mengambil data yang ingin Anda kirim dari layanan HCE dengan aman, Anda dapat, misalnya, mengandalkan Sandbox Aplikasi Android, yang mengisolasi data aplikasi Anda dari aplikasi lain. Untuk mengetahui detail selengkapnya tentang keamanan Android, baca Tips keamanan.
Parameter protokol dan detailnya
Bagian ini penting bagi developer yang ingin memahami parameter protokol yang digunakan perangkat HCE selama fase anti-tabrakan dan aktivasi protokol NFC. Hal ini memungkinkan pembuatan infrastruktur pembaca yang kompatibel dengan perangkat HCE Android.
Aktivasi dan pencegahan konflik protokol Nfc-A (ISO/IEC 14443 jenis A)
Sebagai bagian dari aktivasi protokol Nfc-A, beberapa frame ditukarkan.
Di bagian pertama pertukaran, perangkat HCE menampilkan UID-nya; perangkat HCE harus diasumsikan memiliki UID acak. Artinya, pada setiap ketukan, UID yang ditampilkan ke pembaca adalah UID yang dibuat secara acak. Oleh karena itu, pembaca NFC tidak boleh bergantung pada UID perangkat HCE sebagai bentuk autentikasi atau identifikasi.
Pembaca NFC kemudian dapat memilih perangkat HCE dengan mengirimkan perintah
SEL_REQ. Respons SEL_RES perangkat HCE memiliki setidaknya bit ke-6
(0x20) yang ditetapkan, yang menunjukkan bahwa perangkat mendukung ISO-DEP. Perhatikan bahwa bit lain dalam
SEL_RES juga dapat ditetapkan, yang menunjukkan misalnya dukungan untuk protokol NFC-DEP
(p2p). Karena bit lain mungkin ditetapkan, pembaca yang ingin berinteraksi dengan
perangkat HCE harus secara eksplisit memeriksa bit ke-6 saja, dan tidak membandingkan
SEL_RES lengkap dengan nilai 0x20.
Aktivasi ISO-DEP
Setelah protokol Nfc-A diaktifkan, pembaca NFC memulai aktivasi protokol ISO-DEP. Perangkat mengirimkan perintah RATS (Request for Answer To Select). Pengontrol NFC menghasilkan respons RATS, ATS; ATS tidak dapat dikonfigurasi oleh layanan HCE. Namun, implementasi HCE harus memenuhi persyaratan NFC Forum untuk respons ATS, sehingga pembaca NFC dapat mengandalkan parameter ini yang ditetapkan sesuai dengan persyaratan NFC Forum untuk perangkat HCE apa pun.
Bagian di bawah memberikan detail selengkapnya tentang setiap byte respons ATS yang diberikan oleh pengontrol NFC di perangkat HCE:
- TL: panjang respons ATS. Tidak boleh menunjukkan panjang lebih dari 20 byte.
- T0: bit 5, 6, dan 7 harus ditetapkan di semua perangkat HCE, yang menunjukkan TA(1), TB(1), dan TC(1) disertakan dalam respons ATS. Bit 1 hingga 4 menunjukkan FSCI, yang mengodekan ukuran frame maksimum. Pada perangkat HCE, nilai FSCI harus antara 0h dan 8h.
- T(A)1: menentukan kecepatan bit antara pembaca dan emulator, serta apakah kecepatan bit tersebut dapat asimetris. Tidak ada jaminan atau persyaratan kecepatan bit untuk perangkat HCE.
- T(B)1: bit 1 sampai 4 menunjukkan Start-up Frame Guard time Integer (SFGI). Pada perangkat HCE, SFGI harus <= 8 jam. Bit 5 hingga 8 menunjukkan Integer Waktu Tunggu Frame (FWI) dan mengodekan Waktu Tunggu Frame (FWT). Pada perangkat HCE, FWI harus <= 8 jam.
- T(C)1: bit 5 menunjukkan dukungan untuk "fitur Protokol Lanjutan". Perangkat HCE mungkin mendukung atau tidak mendukung "fitur Protokol Lanjutan". Bit 2 menunjukkan dukungan untuk DID. Perangkat HCE mungkin mendukung DID, mungkin juga tidak. Bit 1 menunjukkan dukungan untuk NAD. Perangkat HCE tidak boleh mendukung NAD dan menetapkan bit 1 ke nol.
- Byte historis: Perangkat HCE dapat menampilkan hingga 15 byte historis. Pembaca NFC yang ingin berinteraksi dengan layanan HCE tidak boleh membuat asumsi tentang konten byte historis atau keberadaannya.
Perhatikan bahwa banyak perangkat HCE kemungkinan dibuat sesuai dengan persyaratan protokol yang telah ditentukan oleh jaringan pembayaran yang tergabung dalam EMVCo dalam spesifikasi "Protokol Komunikasi Nirsentuh". Khususnya:
- FSCI di T0 harus antara 2 jam dan 8 jam.
- T(A)1 harus ditetapkan ke 0x80, yang menunjukkan bahwa hanya bitrate 106 kbit/dtk yang didukung, dan bitrate asimetris antara pembaca dan emulator tidak didukung.
- FWI di T(B)1 harus kurang dari atau sama dengan 7 jam.
Pertukaran data APDU
Seperti yang disebutkan sebelumnya, implementasi HCE hanya mendukung satu saluran logis. Upaya untuk memilih aplikasi di saluran logis yang berbeda tidak akan berfungsi di perangkat HCE.