NFC işlevi sunan birçok Android cihaz, NFC kart emülasyonunu zaten destekler. Çoğu durumda kart, cihazda güvenlik unsuru adı verilen ayrı bir çip tarafından emüle edilir. Kablosuz operatörler tarafından sağlanan birçok SIM kartta da güvenlik unsuru bulunur.
Android 4.4 ve sonraki sürümler, güvenlik unsuru içermeyen ek bir kart emülasyonu yöntemi sunar. Bu yönteme ana makine tabanlı kart emülasyonu adı verilir. Bu sayede, tüm Android uygulamaları bir kartı emüle edebilir ve doğrudan NFC okuyucuyla iletişim kurabilir. Bu konuda, ana makine tabanlı kart emülasyonunun (HCE) Android'de nasıl çalıştığı ve bu tekniği kullanarak NFC kart emülasyonu yapan bir uygulamayı nasıl geliştirebileceğiniz açıklanmaktadır.
Güvenlik unsuruyla kart emülasyonu
NFC kart emülasyonu bir güvenlik unsuru kullanılarak sağlandığında, emüle edilecek kart bir Android uygulaması aracılığıyla cihazdaki güvenlik unsuruna sağlanır. Ardından, kullanıcı cihazı bir NFC terminalinin üzerinde tuttuğunda cihazdaki NFC denetleyicisi, okuyucudan gelen tüm verileri doğrudan güvenlik unsuruna yönlendirir. Şekil 1'de bu kavram gösterilmektedir:
Şekil 1. Güvenlik unsuruyla NFC kart emülasyonu
NFC terminaliyle iletişimi güvenlik unsuru gerçekleştirir ve işleme hiçbir Android uygulaması dahil olmaz. İşlem tamamlandıktan sonra Android uygulaması, işlem durumu için doğrudan güvenlik unsurunu sorgulayabilir ve kullanıcıyı bilgilendirebilir.
Ana makine tabanlı kart emülasyonu
Bir NFC kartı, ana makine tabanlı kart emülasyonu kullanılarak emüle edildiğinde veriler, güvenlik unsuruna yönlendirilmek yerine doğrudan ana makine CPU'suna yönlendirilir. Şekil 2'de, ana makine tabanlı kart emülasyonunun işleyiş şekli gösterilmektedir:
Şekil 2. Güvenlik unsuru olmadan NFC kart emülasyonu.
Desteklenen NFC kartları ve protokolleri
Şekil 3. Android'in HCE protokol yığını.
NFC standartları birçok farklı protokolü destekler ve emüle edebileceğiniz farklı kart türleri vardır.
Android 4.4 ve sonraki sürümler, günümüzde piyasada yaygın olarak kullanılan çeşitli protokolleri destekler. Temassız ödeme kartları gibi mevcut temassız kartların çoğu bu protokolleri temel alır. Bu protokoller, günümüzde piyasada bulunan ve okuyucu olarak çalışan Android NFC cihazları da dahil olmak üzere birçok NFC okuyucu tarafından desteklenir (IsoDep sınıfına bakın). Bu sayede, yalnızca Android destekli cihazları kullanarak HCE tabanlı uçtan uca bir NFC çözümü oluşturup dağıtabilirsiniz.
Özellikle Android 4.4 ve sonraki sürümler, NFC-Forum ISO-DEP spesifikasyonunu (ISO/IEC 14443-4'e dayalı) temel alan ve ISO/IEC 7816-4 spesifikasyonunda tanımlandığı şekilde Uygulama Protokolü Veri Birimleri'ni (APDU'lar) işleyen kartların emülasyonunu destekler. Android, ISO-DEP'nin yalnızca Nfc-A (ISO/IEC 14443-3 Tip A) teknolojisi üzerinde emüle edilmesini zorunlu kılar. Nfc-B (ISO/IEC 14443-4 Type B) teknolojisi desteği isteğe bağlıdır. Şekil 3'te tüm bu spesifikasyonların katmanları gösterilmektedir.
HCE hizmetleri
Android'deki HCE mimarisi, Android Service bileşenlerini (HCE hizmetleri olarak bilinir) temel alır. Hizmetlerin en önemli avantajlarından biri, herhangi bir kullanıcı arayüzü olmadan arka planda çalışabilmeleridir. Bu, kullanıcının kullanmak için bir uygulama başlatması gerekmeyen bağlılık veya toplu taşıma kartları gibi birçok HCE uygulaması için doğal bir uyumdur. Bunun yerine, cihazı NFC okuyucuya dokundurduğunuzda doğru hizmet çalışmıyorsa başlatılır ve işlem arka planda yürütülür. Elbette, uygun olduğunda hizmetinizden ek kullanıcı arayüzü (ör. kullanıcı bildirimleri) başlatabilirsiniz.
Hizmet seçimi
Kullanıcı bir cihazı NFC okuyucuya dokundurduğunda Android sisteminin, NFC okuyucunun hangi HCE hizmetiyle iletişim kurmak istediğini bilmesi gerekir. ISO/IEC 7816-4 spesifikasyonu, uygulama kimliği (AID) odaklı bir uygulama seçme yöntemi tanımlar. AID en fazla 16 bayttan oluşur. Mevcut bir NFC okuyucu altyapısı için kart emülasyonu yapıyorsanız bu okuyucuların aradığı AID'ler genellikle iyi bilinir ve herkese açık olarak kayıtlıdır (ör. Visa ve MasterCard gibi ödeme ağlarının AID'leri).
Kendi uygulamanız için yeni okuyucu altyapısı dağıtmak istiyorsanız kendi AID'lerinizi kaydetmeniz gerekir. AID'ler için kayıt prosedürü ISO/IEC 7816-5 spesifikasyonunda tanımlanmıştır. Android için bir HCE uygulaması dağıtıyorsanız diğer uygulamalarla çakışmaları önlemek için 7816-5'e göre bir AID kaydetmenizi öneririz.
AID grupları
Bazı durumlarda, bir HCE hizmetinin belirli bir uygulamayı uygulamak için birden fazla AID kaydetmesi ve tüm AID'ler için varsayılan işleyici olarak ayarlanması gerekebilir. Gruptaki bazı AID'lerin başka bir hizmete gitmesi desteklenmez.
Bir arada tutulan AID'lerin listesine AID grubu denir. Android, bir AID grubundaki tüm AID'ler için aşağıdakilerden birini garanti eder:
- Gruptaki tüm AID'ler bu HCE hizmetine yönlendirilir.
- Gruptaki hiçbir AID bu HCE hizmetine yönlendirilmez (örneğin, kullanıcı grubunuzdaki bir veya daha fazla AID'yi de isteyen başka bir hizmeti tercih ettiği için).
Başka bir deyişle, gruptaki bazı AID'lerin bir HCE hizmetine, bazılarının ise başka bir hizmete yönlendirilebileceği bir ara durum yoktur.
AID grupları ve kategorileri
Her AID grubunu bir kategoriyle ilişkilendirebilirsiniz. Bu sayede Android, HCE hizmetlerini kategoriye göre gruplandırabilir. Bu da kullanıcının AID düzeyi yerine kategori düzeyinde varsayılanları ayarlamasına olanak tanır. Uygulamanızın kullanıcıya yönelik bölümlerinde AID'lerden bahsetmeyin. Bu bilgiler ortalama bir kullanıcı için bir şey ifade etmez.
Android 4.4 ve sonraki sürümler iki kategoriyi destekler:
CATEGORY_PAYMENT(sektör standardı ödeme uygulamalarını kapsar)CATEGORY_OTHER(diğer tüm HCE uygulamaları için)
CATEGORY_PAYMENT altında AID'leri kaydeden uygulamalar, yalnızca aşağıdaki durumlarda işlem yapabilir:
- Kullanıcı, uygulamayı varsayılan ödeme uygulaması olarak ayarlar (Android 15 ve sonraki sürümleri çalıştıran cihazlarda Cüzdan rolü sahibi) VEYA
- Uygulama ön plandadır ve
setPreferredServiceyöntemini çağırır.
HCE hizmeti uygulama
Ana makine tabanlı kart emülasyonu kullanarak bir NFC kartının emülasyonunu yapmak için NFC işlemlerini işleyen bir Service bileşeni oluşturmanız gerekir.
HCE desteğini kontrol etme
Uygulamanız, FEATURE_NFC_HOST_CARD_EMULATION özelliğini kontrol ederek bir cihazın HCE'yi destekleyip desteklemediğini kontrol edebilir. Uygulamanızın HCE özelliğini kullandığını ve bu özelliğin uygulamanın çalışması için gerekli olup olmadığını beyan etmek için uygulamanızın manifest dosyasında <uses-feature> etiketini kullanın.
Hizmet uygulaması
Android 4.4 ve sonraki sürümler, HCE hizmeti uygulamak için temel olarak kullanabileceğiniz kullanışlı bir Service sınıfı sağlar: HostApduService sınıfı.
İlk adım, aşağıdaki kod örneğinde gösterildiği gibi HostApduService sınıfını genişletmektir:
class MyHostApduService : HostApduService() { override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray { // ... } override fun onDeactivated(reason: Int) { // ... } }
HostApduService, geçersiz kılmanız ve uygulamanız gereken iki soyut yöntem bildirir. Bunlardan biri olan processCommandApdu(), bir NFC okuyucu hizmetinize Uygulama Protokolü Veri Birimi (APDU) gönderdiğinde çağrılır. APDU'lar ISO/IEC 7816-4 spesifikasyonunda tanımlanmıştır. APDU'lar, NFC okuyucu ile HCE hizmetiniz arasında değiş tokuş edilen uygulama düzeyindeki paketlerdir. Bu uygulama düzeyindeki protokol yarım çift yönlüdür: NFC okuyucu size bir komut APDU'su gönderir ve karşılığında bir yanıt APDU'su göndermenizi bekler.
Daha önce de belirtildiği gibi Android, okuyucunun hangi HCE hizmetiyle iletişim kurmak istediğini belirlemek için AID'yi kullanır. Genellikle bir NFC okuyucunun cihazınıza gönderdiği ilk APDU, SELECT AID APDU'dur. Bu APDU, okuyucunun iletişim kurmak istediği AID'yi içerir. Android, bu AID'yi APDU'dan çıkarır, bir HCE hizmetine çözümler ve ardından bu APDU'yu çözümlenen hizmete yönlendirir.
processCommandApdu() yönteminden yanıt APDU'sunun baytlarını döndürerek yanıt APDU'su gönderebilirsiniz. Bu yöntemin, uygulamanızın ana iş parçacığında çağrıldığını ve bu iş parçacığını engellememeniz gerektiğini unutmayın. Yanıt APDU'sunu hemen hesaplayıp döndüremiyorsanız null değerini döndürün. Ardından, başka bir ileti dizisinde gerekli işlemleri yapabilir ve işiniz bittiğinde yanıtı göndermek için HostApduService sınıfında tanımlanan sendResponseApdu() yöntemini kullanabilirsiniz.
Android, aşağıdaki durumlardan biri gerçekleşene kadar okuyucudan hizmetinize yeni APDU'lar yönlendirmeye devam eder:
- NFC okuyucu, işletim sisteminin farklı bir hizmete çözümlediği başka bir
SELECT AIDAPDU gönderir. - NFC okuyucu ile cihazınız arasındaki NFC bağlantısı kesildi.
Bu iki durumda da sınıfınızın onDeactivated() uygulaması, ikisinden hangisinin gerçekleştiğini belirten bir bağımsız değişkenle çağrılır.
Mevcut okuyucu altyapısıyla çalışıyorsanız okuyucuların HCE hizmetinizde beklediği mevcut uygulama düzeyindeki protokolü uygulamanız gerekir.
Kontrol ettiğiniz yeni bir okuyucu altyapısı dağıtıyorsanız kendi protokolünüzü ve APDU sıranızı tanımlayabilirsiniz. APDU miktarını ve aktarılacak verilerin boyutunu sınırlamaya çalışın. Böylece kullanıcılarınızın cihazlarını NFC okuyucunun üzerinde yalnızca kısa bir süre tutması yeterli olur. Makul bir üst sınır, genellikle 300 ms içinde değiştirilebilen yaklaşık 1 KB'lık veridir.
Hizmet manifesti beyanı ve AID kaydı
Hizmetinizi her zamanki gibi manifest dosyasında beyan etmeniz gerekir ancak hizmet beyanına bazı ek parçalar da eklemeniz gerekir:
Platforma,
HostApduServicearayüzünü uygulayan bir HCE hizmeti olduğunu bildirmek için hizmet beyanınızaSERVICE_INTERFACEişlemi için bir intent filtresi ekleyin.Platforma bu hizmet tarafından hangi AID gruplarının istendiğini bildirmek için hizmet beyanına, HCE hizmeti hakkında ek bilgiler içeren bir XML kaynağına işaret eden bir
SERVICE_META_DATA<meta-data>etiketi ekleyin.android:exportedözelliğinitrueolarak ayarlayın ve hizmet beyanınızdaandroid.permission.BIND_NFC_SERVICEiznini zorunlu kılın. İlki, hizmetin harici uygulamalar tarafından bağlanabilmesini sağlar. Ardından, yalnızcaandroid.permission.BIND_NFC_SERVICEiznine sahip harici uygulamaların hizmetinize bağlanabilmesini zorunlu kılar.android.permission.BIND_NFC_SERVICEbir sistem izni olduğundan, hizmetinize yalnızca Android OS'in bağlanabilmesini zorunlu kılar.
Aşağıda, HostApduService manifest beyanına dair bir örnek verilmiştir:
<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>
Bu meta veri etiketi bir apduservice.xml dosyasına işaret ediyor. Aşağıda, iki özel AID içeren tek bir AID grubu beyanına sahip bir dosya örneği verilmiştir:
<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>
<host-apdu-service> etiketi, uygulama kullanıcı arayüzünde gösterebileceğiniz hizmetin kullanıcı dostu bir açıklamasını içeren bir <android:description> özelliği içermelidir. APDU'ları işlemek için bu hizmeti çağırmadan önce cihazın kilidinin açıldığını belirtmek üzere requireDeviceUnlock özelliğini kullanabilirsiniz.
<host-apdu-service>, bir veya daha fazla <aid-group> etiketi içermelidir. Her <aid-group> etiketinin aşağıdakileri yapması gerekir:
- AID grubunun kullanıcı dostu bir açıklamasını içeren ve kullanıcı arayüzünde gösterilmeye uygun bir
android:descriptionözelliği içermelidir. android:categoryözelliğinin, AID grubunun ait olduğu kategoriyi (ör.CATEGORY_PAYMENTveyaCATEGORY_OTHERtarafından tanımlanan dize sabitleri) gösterecek şekilde ayarlanmış olması gerekir.- Her biri tek bir AID içeren bir veya daha fazla
<aid-filter>etiketi içerir. AID'yi onaltılık biçimde belirtin ve çift sayıda karakter içerdiğinden emin olun.
Uygulamanızın HCE hizmeti olarak kaydolmak için NFC iznine de sahip olması gerekir.
AID çakışma çözümü
Tek bir cihaza birden fazla HostApduService bileşeni yüklenebilir ve aynı AID birden fazla hizmet tarafından kaydedilebilir. Android, aşağıdaki adımları kullanarak hangi hizmetin çağrılacağını belirler:
- Kullanıcının seçtiği varsayılan cüzdan uygulaması AID'yi kaydettiyse bu uygulama çağrılır.
- Varsayılan cüzdan uygulaması AID'yi kaydetmediyse AID'yi kaydeden hizmet çağrılır.
- AID'yi birden fazla hizmet kaydettiyse Android, kullanıcıya hangi hizmetin çağrılacağını sorar.
Ön plan hizmeti tercihi
Ön plandaki uygulamalar, belirli bir etkinlik ön plandayken hangi kart emülasyonu hizmetinin tercih edilmesi gerektiğini belirtmek için setPreferredService yöntemini çağırabilir. Bu ön planda çalışan uygulama tercihi, AID çakışma çözümünü geçersiz kılar. Uygulama, kullanıcının NFC kart emülasyonu kullanabileceğini tahmin ettiğinde bu yöntem önerilir.
Android 13 ve sonraki sürümler
Ayarlar kullanıcı arayüzündeki varsayılan ödeme seçim listesine daha iyi uyması için banner şartını kare simge olarak ayarlayın. İdeal olarak, uygulama başlatıcı simge tasarımıyla aynı olmalıdır. Bu düzenleme, daha tutarlı ve daha temiz bir görünüm sağlar.
Android 12 ve önceki sürümler
Hizmet banner'ının boyutunu 260x96 dp olarak ayarlayın, ardından meta veri XML dosyanızda hizmet banner'ının boyutunu ayarlamak için <host-apdu-service> etiketine android:apduServiceBanner özelliğini ekleyin. Bu özellik, drawable kaynağı işaret eder. Aşağıda bir örnek verilmiştir:
<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>
Cüzdan uygulamaları
Android 15 ve sonraki sürümlerde, kullanıcının Ayarlar > Uygulamalar > Varsayılan Uygulamalar'a giderek seçebileceği varsayılan bir cüzdan uygulaması rolü bulunur. Bu, bir ödeme noktasına dokunulduğunda çağrılacak varsayılan cüzdan uygulamasını tanımlar. Android, ödeme kategorisiyle bir AID grubu beyan eden HCE hizmetlerini cüzdan uygulamaları olarak kabul eder.
Uygulamanızın varsayılan cüzdan uygulaması olup olmadığını kontrol etme
Uygulamalar, RoleManager.ROLE_WALLET değerini RoleManager.isRoleHeld() yöntemine ileterek varsayılan cüzdan uygulaması olup olmadıklarını kontrol edebilir.
Uygulamanız varsayılan uygulama değilse RoleManager.createRequestRoleIntent() yöntemine RoleManager.ROLE_WALLET değerini ileterek varsayılan cüzdan rolünü isteyebilirsiniz.
Cüzdan uygulamaları için gerekli öğeler
HCE cüzdan uygulamalarının, görsel açıdan daha çekici bir kullanıcı deneyimi sunmak için hizmet banner'ı sağlaması gerekir.
Gözlem Modu
Android 15'te Gözlem Modu özelliği kullanıma sunuldu. Gözlem modu etkinleştirildiğinde cihaz, NFC yoklama döngülerini gözlemleyebilir ve bunlarla ilgili bildirimleri uygun HostApduService bileşenlerine göndererek belirli bir NFC terminaliyle etkileşime girmeye hazırlanmalarını sağlayabilir. HostApduService, setObserveModeEnabled() öğesine true değerini ileterek cihazı Gözlem Modu'na geçirebilir.
Bu, NFC yığınının NFC işlemlerine izin vermemesini ve bunun yerine yoklama döngülerini pasif olarak gözlemlemesini sağlar.
Anket döngüsü filtreleri
Aşağıdaki yöntemlerden birini kullanarak HostApduService için yoklama döngüsü filtreleri kaydedebilirsiniz:
registerPollingLoopFilterForService()Bir yoklama karesiyle tam olarak eşleşmesi gereken filtreler için.- Anket kareleriyle eşleşen normal ifade filtreleri için
registerPollingLoopPatternFilterForService().
Bir yoklama döngüsü filtresi standart olmayan yoklama çerçeveleriyle eşleştiğinde NFC yığını, bu yoklama çerçevelerini ilgili HostApduService öğesine yönlendirir. Bunun için processPollingFrames() yöntemini çağırır. Bu sayede hizmet, kullanıcının işlem yapmaya hazır ve istekli olduğundan emin olmak için gerekli adımları (ör. kullanıcının kimliğini doğrulama) atabilir. NFC okuyucu, yoklama döngüsünde yalnızca standart çerçeveler kullanıyorsa NFC yığını, bu yoklama çerçevelerini ön plandaysa tercih edilen ön plan hizmetine, aksi takdirde varsayılan cüzdan rolü sahibine yönlendirir.
Sorgulama çerçevesi bildirimleri, getVendorSpecificGain() yöntemini çağırarak alabileceğiniz, tedarikçiye özel bir alan gücü ölçümü de içerir.
Tedarikçiler, tek bir bayta sığdığı sürece kendi ölçeklerini kullanarak ölçüm sağlayabilir.
Sorgulama döngülerine yanıt verme ve Gözlem Modu'ndan çıkma
Hizmet, işlem yapmaya hazır olduğunda setObserveModeEnabled() yöntemine false değerini ileterek gözlem modundan çıkabilir. NFC yığını, işlemlerin devam etmesine izin verir.
HostApduService bileşenleri, manifest dosyasında shouldDefaultToObserveMode değerini true olarak ayarlayarak veya CardEmulation.setShouldDefaultToObserveModeForService() yöntemini çağırarak tercih edilen ödeme hizmeti olduklarında gözlem modunun etkinleştirilmesi gerektiğini belirtebilir.
HostApduService ve OffHostApduService bileşenleri, alınan yoklama döngüsü çerçeveleriyle eşleşen yoklama döngüsü filtrelerinin, manifest dosyasındaki PollingLoopFilter beyanında autoTransact değerini true olarak ayarlayarak Gözlem Modu'nu otomatik olarak devre dışı bırakması ve işlemlerin devam etmesine izin vermesi gerektiğini de belirtebilir.
Ön plan hizmeti tercihi
Ön plandaki uygulamalar, belirli bir etkinlik ön plandayken hangi kart emülasyonu hizmetinin tercih edilmesi gerektiğini belirtmek için setPreferredService yöntemini çağırabilir. Bu ön planda çalışan uygulama tercihi, belirli bir hizmet için shouldDefaultToObserveMode değerine karşılık gelen cihazın Gözlem Modu durumunu geçersiz kılar. Bu durum, aşağıdaki yöntemlerden biriyle ayarlanabilir:
- Söz konusu hizmetin manifest dosyasında
shouldDefaultToObserveModedurumunu ayarlama. - İlgili hizmet ve durumla
CardEmulation.setShouldDefaultToObserveModeForService()çağrılıyor.
Ekran kapalıyken ve kilit ekranında davranış
HCE hizmetlerinin davranışı, cihazda çalışan Android sürümüne göre değişir.
Android 15 ve sonraki sürümler
Varsayılan cüzdan uygulaması, Gözlem Modu'nu destekleyen bir cihazda bu modu etkinleştirirse kilit açma ve ekran kapatma davranışını geçersiz kılar. Bunun nedeni, uygulamanın bir işlemin ne zaman devam edebileceğini kontrol etmesidir. Gözlem modu, tanımlanabilir bir yoklama döngüsü kalıbı algılamadıysa bazı cüzdan uygulamaları, işlemin devam edebilmesi için cihazın kilidinin açılmasını gerektirebilir.
Geliştiricilerin, tanımlanabilir yoklama döngüsü kalıpları yayınlamak için okuyucu cihazlarıyla birlikte çalışması ve uygulamalarından bu kalıpları işlemek için kaydolması önerilir.
Android 12 ve sonraki sürümler
Android 12 (API düzeyi 31) ve sonraki sürümleri hedefleyen uygulamalarda, requireDeviceScreenOn değerini false olarak ayarlayarak cihazın ekranı açık olmadan NFC ile ödemeleri etkinleştirebilirsiniz.
Android 10 ve sonraki sürümler
Android 10 (API düzeyi 29) veya sonraki sürümlerin yüklü olduğu cihazlar güvenli NFC'yi destekler. Güvenli NFC açıkken cihaz ekranı kapalıysa tüm kart emülatörleri (ana makine uygulamaları ve barındırılan uygulamalar) kullanılamaz. Güvenli NFC kapalıyken cihaz ekranı kapalıysa barındırılan uygulamalar kullanılabilir. Güvenli NFC desteğini isSecureNfcSupported() kullanarak kontrol edebilirsiniz.
Android 10 ve sonraki sürümlerin yüklü olduğu cihazlarda, android:requireDeviceUnlock ayarını true olarak belirlemek için Android 9 ve önceki sürümlerin yüklü olduğu cihazlardaki işlevler geçerlidir ancak bu işlevler yalnızca güvenli NFC kapalıyken kullanılabilir. Yani güvenli NFC açıksa HCE hizmetleri, android:requireDeviceUnlock ayarından bağımsız olarak kilit ekranından çalıştırılamaz.
Android 9 ve önceki sürümler
Android 9 (API düzeyi 28) ve önceki sürümleri çalıştıran cihazlarda, cihazın ekranı kapatıldığında NFC denetleyicisi ve uygulama işlemcisi tamamen kapatılır. Bu nedenle, ekran kapalıyken HCE hizmetleri çalışmaz.
Ayrıca Android 9 ve önceki sürümlerde HCE hizmetleri kilit ekranından çalışabilir.
Ancak bu, HCE hizmetinizin <host-apdu-service> etiketindeki android:requireDeviceUnlock özelliği tarafından kontrol edilir. Varsayılan olarak, cihaz kilidinin açılması gerekmez ve cihaz kilitli olsa bile hizmetiniz çağrılır.
HCE hizmetiniz için android:requireDeviceUnlock özelliğini true olarak ayarlarsanız Android, aşağıdaki durumlarda kullanıcıdan cihazın kilidini açmasını ister:
- Kullanıcı, bir NFC okuyucuya dokunur.
- NFC okuyucu, hizmetinizle eşleşen bir AID seçer.
Android, kilit açıldıktan sonra kullanıcıdan işlemi tamamlamak için tekrar dokunmasını isteyen bir iletişim kutusu gösterir. Kullanıcı, cihazın kilidini açmak için cihazı NFC okuyucudan uzaklaştırmış olabileceğinden bu işlem gereklidir.
Güvenlik unsuru kartlarıyla birlikte kullanım
Bu bölüm, kart emülasyonu için güvenlik unsuru kullanan bir uygulama dağıtan geliştiricileri ilgilendirir. Android'in HCE uygulaması, güvenlik unsurlarının kullanımı da dahil olmak üzere kart emülasyonu uygulamanın diğer yöntemleriyle paralel çalışacak şekilde tasarlanmıştır.
Bu bir arada kullanım, AID yönlendirme adı verilen bir ilkeye dayanır. NFC denetleyicisi, (sonlu) bir yönlendirme kuralları listesinden oluşan bir yönlendirme tablosu tutar. Her rota kuralı bir AID ve bir hedef içerir. Hedef, Android uygulamalarının çalıştığı ana makine CPU'su veya bağlı bir güvenlik unsuru olabilir.
NFC okuyucu, SELECT AID içeren bir APDU gönderdiğinde NFC denetleyici bunu ayrıştırır ve AID'lerin, yönlendirme tablosundaki herhangi bir AID ile eşleşip eşleşmediğini kontrol eder. Eşleşme varsa bu APDU ve sonraki tüm APDU'lar, başka bir SELECT AID APDU alınana veya NFC bağlantısı kesilene kadar AID ile ilişkili hedefe gönderilir.
Şekil 4'te bu mimari gösterilmektedir:
Şekil 4. Android, hem güvenlik unsuru hem de ana kart emülasyonu ile çalışır.
NFC denetleyicisi genellikle APDU'lar için varsayılan bir rota da içerir. Yönlendirme tablosunda AID bulunamadığında varsayılan rota kullanılır. Bu ayar cihazdan cihaza farklılık gösterse de Android cihazların, uygulamanız tarafından kaydedilen AID'lerin ana makineye doğru şekilde yönlendirildiğinden emin olması gerekir.
HCE hizmeti uygulayan veya güvenlik unsuru kullanan Android uygulamalarının yönlendirme tablosunu yapılandırması gerekmez. Bu işlem Android tarafından otomatik olarak gerçekleştirilir. Android'in yalnızca hangi AID'lerin HCE hizmetleri tarafından, hangilerinin ise güvenlik unsuru tarafından işlenebileceğini bilmesi gerekir. Yönlendirme tablosu, hangi hizmetlerin yüklü olduğuna ve kullanıcının hangilerini tercih edilen olarak yapılandırdığına göre otomatik olarak yapılandırılır.
Aşağıdaki bölümde, kart emülasyonu için güvenlik unsuru kullanan uygulamalarda AID'lerin nasıl tanımlanacağı açıklanmaktadır.
Güvenlik unsuru AID kaydı
Kart emülasyonu için güvenlik unsuru kullanan uygulamalar, manifest dosyalarında ana makine dışı hizmet beyan edebilir. Bu tür bir hizmetin beyanı, HCE hizmetinin beyanıyla neredeyse aynıdır. İstisnalar aşağıdaki gibidir:
- Intent filtresinde kullanılan işlem
SERVICE_INTERFACEolarak ayarlanmalıdır. - Meta veri adı özelliği
SERVICE_META_DATAolarak ayarlanmalıdır. Meta veri XML dosyası,
<offhost-apdu-service>kök etiketini kullanmalıdır.<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>
Aşağıda, iki AID kaydeden ilgili apduservice.xml dosyasına dair bir örnek verilmiştir:
<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>
android:requireDeviceUnlock özelliği, barındırıcı dışı hizmetler için geçerli değildir. Bunun nedeni, barındırıcı CPU'sunun işleme dahil olmaması ve bu nedenle cihaz kilitliyken güvenlik unsurunun işlem yapmasını engelleyememesidir.
android:apduServiceBanner özelliği, ödeme uygulaması olan ve varsayılan ödeme uygulaması olarak seçilebilen barındırıcı dışı hizmetler için gereklidir.
Ana makine dışı hizmet çağrısı
Android, "ana makine dışı" olarak tanımlanan bir hizmeti hiçbir zaman başlatmaz veya bu hizmete bağlanmaz. Bunun nedeni, asıl işlemlerin Android hizmeti tarafından değil, güvenlik unsuru tarafından yürütülmesidir. Hizmet beyanı, uygulamaların yalnızca güvenlik unsurunda bulunan AID'leri kaydetmesine olanak tanır.
HCE ve güvenlik
HCE mimarisi, temel bir güvenlik parçası sağlar: Hizmetiniz BIND_NFC_SERVICE sistem izniyle korunduğu için yalnızca işletim sistemi hizmetinize bağlanabilir ve hizmetinizle iletişim kurabilir.
Bu sayede, aldığınız tüm APDU'ların OS tarafından NFC denetleyicisinden alınan APDU'lar olduğundan ve geri gönderdiğiniz tüm APDU'ların yalnızca OS'ye gittiğinden emin olabilirsiniz. OS de APDU'ları doğrudan NFC denetleyicisine yönlendirir.
Son olarak, uygulamanızın NFC okuyucuya gönderdiği verileri nereden aldığınızı belirtmeniz gerekir. Bu, HCE tasarımında kasıtlı olarak ayrılmıştır. Verilerin nereden geldiği önemli değildir, yalnızca NFC denetleyicisine ve NFC okuyucuya güvenli bir şekilde taşınmasını sağlar.
HCE hizmetinizden göndermek istediğiniz verileri güvenli bir şekilde depolamak ve almak için, uygulamanızın verilerini diğer uygulamalardan ayıran Android Uygulama Korumalı Alanı'nı kullanabilirsiniz. Android güvenliği hakkında daha fazla bilgi için Güvenlik ipuçları başlıklı makaleyi okuyun.
Protokol parametreleri ve ayrıntıları
Bu bölüm, HCE cihazlarının NFC protokollerinin çakışma önleme ve etkinleştirme aşamalarında hangi protokol parametrelerini kullandığını anlamak isteyen geliştiriciler için önemlidir. Bu sayede, Android HCE cihazlarla uyumlu bir okuyucu altyapısı oluşturulabilir.
Nfc-A (ISO/IEC 14443 türü A) protokolü çakışma önleme ve etkinleştirme
Nfc-A protokolü etkinleştirilirken birden fazla kare paylaşılır.
Değişimin ilk bölümünde HCE cihazı UID'sini sunar. HCE cihazlarının rastgele bir UID'ye sahip olduğu varsayılmalıdır. Bu, her dokunuşta okuyucuya sunulan UID'nin rastgele oluşturulmuş bir UID olduğu anlamına gelir. Bu nedenle, NFC okuyucular kimlik doğrulama veya tanımlama biçimi olarak HCE cihazlarının UID'sine bağlı olmamalıdır.
NFC okuyucu, daha sonra bir SEL_REQ komutu göndererek HCE cihazını seçebilir. HCE cihazının SEL_RES yanıtında en az 6. bit (0x20) ayarlanmıştır. Bu, cihazın ISO-DEP'yi desteklediğini gösterir. SEL_RES içindeki diğer bitlerin de ayarlanabileceğini unutmayın. Bu, örneğin NFC-DEP (p2p) protokolü için destek olduğunu gösterir. Diğer bitler ayarlanabileceğinden, HCE cihazlarıyla etkileşimde bulunmak isteyen okuyucular yalnızca 6. biti açıkça kontrol etmeli ve tüm SEL_RES değerini 0x20 değeriyle karşılaştırmamalıdır.
ISO-DEP etkinleştirme
Nfc-A protokolü etkinleştirildikten sonra NFC okuyucu, ISO-DEP protokolü etkinleştirmesini başlatır. RATS (Seçim İçin Yanıt İsteği) komutu gönderir. NFC denetleyicisi, RATS yanıtını (ATS) oluşturur. ATS, HCE hizmetleri tarafından yapılandırılamaz. Ancak HCE uygulamaları, ATS yanıtı için NFC Forum şartlarını karşılamalıdır. Bu sayede NFC okuyucular, bu parametrelerin herhangi bir HCE cihazı için NFC Forum şartlarına uygun şekilde ayarlanacağından emin olabilir.
Aşağıdaki bölümde, HCE cihazındaki NFC denetleyicisi tarafından sağlanan ATS yanıtının her bir baytı hakkında daha fazla bilgi verilmiştir:
- TL: ATS yanıtının uzunluğu. 20 bayttan uzun olmamalıdır.
- T0: 5, 6 ve 7. bitler tüm HCE cihazlarında ayarlanmalıdır. Bu, TA(1), TB(1) ve TC(1)'in ATS yanıtına dahil edildiğini gösterir. 1 ila 4. bitler, maksimum çerçeve boyutunu kodlayan FSCI'yi gösterir. HCE cihazlarda FSCI değeri 0h ile 8h arasında olmalıdır.
- T(A)1: Okuyucu ile emülatör arasındaki bit hızlarını ve bunların asimetrik olup olamayacağını tanımlar. HCE cihazlar için bit hızı şartı veya garantisi yoktur.
- T(B)1: 1 ila 4 arasındaki bitler, Başlatma Çerçevesi Koruma Süresi Tam Sayısı'nı (SFGI) gösterir. HCE cihazlarda SFGI <= 8 saat olmalıdır. 5 ila 8. bitler, Çerçeve Bekleme Süresi Tam Sayısı'nı (FWI) gösterir ve Çerçeve Bekleme Süresi'ni (FWT) kodlar. HCE cihazlarda FWI en fazla 8 saat olmalıdır.
- T(C)1: 5. bit, "Gelişmiş Protokol özellikleri" için destek olduğunu gösterir. HCE cihazları "Gelişmiş Protokol özelliklerini" destekleyebilir veya desteklemeyebilir. Bit 2, DID desteğini gösterir. HCE cihazları DID'yi destekleyebilir veya desteklemeyebilir. Bit 1, NAD desteğini gösterir. HCE cihazları NAD'yi desteklememeli ve 1. biti sıfıra ayarlamalıdır.
- Geçmiş baytlar: HCE cihazlar 15 geçmiş bayta kadar veri döndürebilir. HCE hizmetleriyle etkileşim kurmak isteyen NFC okuyucular, geçmiş baytların içeriği veya varlığı hakkında herhangi bir varsayımda bulunmamalıdır.
Birçok HCE cihazının, EMVCo'da birleşen ödeme ağlarının "Temassız İletişim Protokolü" spesifikasyonunda belirttiği protokol şartlarına uygun hale getirildiğini unutmayın. Özellikle:
- T0'daki FSCI, 2 ile 8 saat arasında olmalıdır.
- T(A)1, 0x80 olarak ayarlanmalıdır. Bu, yalnızca 106 kbit/sn bit hızının desteklendiğini ve okuyucu ile emülatör arasındaki asimetrik bit hızlarının desteklenmediğini gösterir.
- T(B)1'deki FWI <= 7 saat olmalıdır.
APDU veri alışverişi
Daha önce de belirtildiği gibi, HCE uygulamaları yalnızca tek bir mantıksal kanalı destekler. Farklı mantıksal kanallardaki uygulamaları seçmeye çalışmak HCE cihazlarda işe yaramaz.