Panoramica dell'emulazione della carta basata su host

Molti dispositivi Android che offrono funzionalità NFC supportano già l'emulazione di carte NFC. Nella maggior parte dei casi, la carta viene emulata da un chip separato nel dispositivo, chiamato Secure Element. Molte schede SIM fornite dagli operatori wireless contengono anche un Secure Element.

Android 4.4 e versioni successive offrono un metodo aggiuntivo di emulazione della carta che non prevede un Secure Element, chiamato emulazione della carta basata su host. In questo modo, qualsiasi app per Android può emulare una carta e comunicare direttamente con il lettore NFC. Questo argomento descrive come funziona l'emulazione della carta basata su host (HCE) su Android e come puoi sviluppare un'app che emula una carta NFC utilizzando questa tecnica.

Emulazione della carta con un Secure Element

Quando la simulazione della carta NFC viene fornita utilizzando un Secure Element, la carta da simulare viene eseguito il provisioning nel Secure Element sul dispositivo tramite un'app per Android. Poi, quando l'utente tiene il dispositivo sopra un terminale NFC, il controller NFC nel dispositivo indirizza tutti i dati dal lettore direttamente al Secure Element. La Figura 1 illustra questo concetto:

Diagramma con lettore NFC che passa attraverso un controller NFC per recuperare informazioni da un Secure Element
Figura 1. Emulazione della carta NFC con un Secure Element.

Il Secure Element stesso comunica con il terminale NFC e nessuna app per Android è coinvolta nella transazione. Una volta completata la transazione, un'app per Android può eseguire una query direttamente sul Secure Element per conoscere lo stato della transazione e inviare una notifica all'utente.

Host Card Emulation

Quando una carta NFC viene emulata utilizzando l'emulazione della carta basata su host, i dati vengono indirizzati direttamente alla CPU host anziché a un Secure Element. La Figura 2 illustra il funzionamento dell'emulazione della carta basata su host:

Diagramma con lettore NFC che passa attraverso un controller NFC per recuperare informazioni dalla CPU
Figura 2. Emulazione della carta NFC senza un Secure Element.

Protocolli e schede NFC supportati

Diagramma che mostra lo stack di protocolli HCE
Figura 3. Stack di protocolli HCE di Android.

Gli standard NFC offrono supporto per molti protocolli diversi ed esistono diversi tipi di carte che puoi emulare.

Android 4.4 e versioni successive supportano diversi protocolli comunemente utilizzati sul mercato. Molte carte contactless esistenti sono già basate su questi protocolli, come le carte di pagamento contactless. Questi protocolli sono supportati anche da molti lettori NFC attualmente sul mercato, inclusi i dispositivi NFC Android che fungono da lettori (consulta la classe IsoDep). In questo modo puoi creare e implementare una soluzione NFC end-to-end basata su HCE utilizzando solo dispositivi Android.

In particolare, Android 4.4 e versioni successive supportano l'emulazione di carte basate sulla specifica NFC-Forum ISO-DEP (basata su ISO/IEC 14443-4) ed elaborano le unità APDU (Application Protocol Data Unit) come definito nella specifica ISO/IEC 7816-4. Android richiede l'emulazione di ISO-DEP solo sulla tecnologia Nfc-A (ISO/IEC 14443-3 Tipo A). Il supporto della tecnologia Nfc-B (ISO/IEC 14443-4 Tipo B) è facoltativo. La Figura 3 illustra la stratificazione di tutte queste specifiche.

Servizi HCE

L'architettura HCE in Android si basa sui componenti Service di Android (noti come servizi HCE). Uno dei principali vantaggi di un servizio è che può essere eseguito in background senza alcuna interfaccia utente. Si tratta di una soluzione naturale per molte applicazioni HCE, come le carte fedeltà o le carte del trasporto pubblico, che l'utente non dovrebbe aver bisogno di avviare un'app per utilizzare. Invece, toccando il dispositivo sul lettore NFC, viene avviato il servizio corretto se non è già in esecuzione e viene eseguita la transazione in background. Naturalmente, puoi lanciare UI aggiuntive (come le notifiche utente) dal tuo servizio, se opportuno.

Selezione del servizio

Quando l'utente avvicina un dispositivo a un lettore NFC, il sistema Android deve sapere con quale servizio HCE il lettore NFC vuole comunicare. La specifica ISO/IEC 7816-4 definisce un modo per selezionare le applicazioni, incentrato su un ID applicazione (AID). Un AID è composto da un massimo di 16 byte. Se emuli carte per un'infrastruttura di lettori NFC esistente, gli AID cercati da questi lettori sono in genere noti e registrati pubblicamente (ad esempio, gli AID di reti di pagamento come Visa e MasterCard).

Se vuoi eseguire il deployment di una nuova infrastruttura di lettura per la tua applicazione, devi registrare i tuoi AID. La procedura di registrazione degli AID è definita nella specifica ISO/IEC 7816-5. Se esegui il deployment di un'applicazione HCE per Android, ti consigliamo di registrare un AID in conformità con lo standard 7816-5, perché evita collisioni con altre applicazioni.

Gruppi AID

In alcuni casi, un servizio HCE potrebbe dover registrare più AID ed essere impostato come gestore predefinito per tutti gli AID per implementare una determinata applicazione. Non è supportato il trasferimento di alcuni AID del gruppo a un altro servizio.

Un elenco di AID raggruppati è chiamato gruppo di AID. Per tutti gli AID di un gruppo di AID, Android garantisce una delle seguenti condizioni:

  • Tutti gli AID del gruppo vengono indirizzati a questo servizio HCE.
  • Nessun AID del gruppo viene indirizzato a questo servizio HCE (ad esempio, perché l'utente ha preferito un altro servizio che ha richiesto anche uno o più AID del tuo gruppo).

In altre parole, non esiste uno stato intermedio in cui alcuni AID del gruppo possono essere indirizzati a un servizio HCE e altri a un altro.

Gruppi e categorie AID

Puoi associare ogni gruppo AID a una categoria. In questo modo Android può raggruppare i servizi HCE per categoria, il che a sua volta consente all'utente di impostare i valori predefiniti a livello di categoria anziché di AID. Evita di menzionare gli AID in qualsiasi parte dell'applicazione rivolta agli utenti, perché non significano nulla per l'utente medio.

Android 4.4 e versioni successive supportano due categorie:

Le app che registrano AID in CATEGORY_PAYMENT possono elaborare una transazione solo se:

  • L'utente imposta l'app come app per pagamenti predefinita (titolare del ruolo Wallet sui dispositivi Android 15 e versioni successive) OPPURE
  • L'app è in primo piano e richiama setPreferredService.

Implementa un servizio HCE

Per emulare una carta NFC utilizzando l'emulazione della carta basata su host, devi creare un componente Service che gestisca le transazioni NFC.

Verifica il supporto di HCE

La tua applicazione può verificare se un dispositivo supporta l'HCE controllando la presenza della funzionalità FEATURE_NFC_HOST_CARD_EMULATION. Utilizza il tag <uses-feature> nel file manifest della tua applicazione per dichiarare che l'app utilizza la funzionalità HCE e se è necessaria o meno per il funzionamento dell'app.

Implementazione del servizio

Android 4.4 e versioni successive fornisce una comoda classe Service che puoi utilizzare come base per l'implementazione di un servizio HCE: la classe HostApduService.

Il primo passaggio consiste nell'estendere HostApduService, come mostrato nel seguente esempio di codice:

class MyHostApduService : HostApduService() {

    override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
        // ...
    }

    override fun onDeactivated(reason: Int) {
        // ...
    }
}

HostApduService dichiara due metodi astratti di cui devi eseguire l'override e l'implementazione. Uno di questi, processCommandApdu(), viene chiamato ogni volta che un lettore NFC invia un'unità APDU (Application Protocol Data Unit) al tuo servizio. Le APDU sono definite nella specifica ISO/IEC 7816-4. Le APDU sono i pacchetti a livello di applicazione scambiati tra il lettore NFC e il tuo servizio HCE. Questo protocollo a livello di applicazione è half-duplex: il lettore NFC ti invia un'APDU di comando e attende che tu invii un'APDU di risposta in cambio.

Come accennato in precedenza, Android utilizza l'AID per determinare con quale servizio HCE il lettore vuole comunicare. In genere, la prima APDU che un lettore NFC invia al tuo dispositivo è un'APDU SELECT AID; questa APDU contiene l'AID con cui il lettore vuole comunicare. Android estrae l'AID dall'APDU, lo risolve in un servizio HCE e poi inoltra l'APDU al servizio risolto.

Puoi inviare un'APDU di risposta restituendo i byte dell'APDU di risposta da processCommandApdu(). Tieni presente che questo metodo viene chiamato sul thread principale della tua applicazione, che non deve essere bloccato. Se non riesci a calcolare e restituire immediatamente un'APDU di risposta, restituisci null. Puoi quindi eseguire il lavoro necessario su un altro thread e utilizzare il metodo sendResponseApdu() definito nella classe HostApduService per inviare la risposta al termine.

Android continua a inoltrare nuove APDU dal lettore al tuo servizio finché non si verifica una delle seguenti condizioni:

  • Il lettore NFC invia un'altra APDU SELECT AID, che il sistema operativo risolve in un servizio diverso.
  • Il collegamento NFC tra il lettore NFC e il tuo dispositivo è interrotto.

In entrambi i casi, l'implementazione di onDeactivated() della tua classe viene chiamata con un argomento che indica quale dei due eventi si è verificato.

Se utilizzi un'infrastruttura di lettori esistente, devi implementare il protocollo a livello di applicazione esistente previsto dai lettori nel tuo servizio HCE.

Se stai eseguendo il deployment di una nuova infrastruttura di lettori che controlli, puoi definire il tuo protocollo e la tua sequenza APDU. Cerca di limitare la quantità di APDU e le dimensioni dei dati da scambiare: in questo modo, gli utenti dovranno tenere il dispositivo sopra il lettore NFC solo per un breve periodo di tempo. Un limite superiore ragionevole è di circa 1 KB di dati, che di solito possono essere scambiati entro 300 ms.

Dichiarazione del manifest del servizio e registrazione dell'AID

Devi dichiarare il servizio nel file manifest come di consueto, ma devi anche aggiungere alcuni elementi alla dichiarazione del servizio:

  1. Per comunicare alla piattaforma che si tratta di un servizio HCE che implementa un'interfaccia HostApduService, aggiungi un filtro per intent per l'azione SERVICE_INTERFACE alla dichiarazione del servizio.

  2. Per indicare alla piattaforma quali gruppi di AID sono richiesti da questo servizio, includi un tag SERVICE_META_DATA <meta-data> nella dichiarazione del servizio, che rimandi a una risorsa XML con informazioni aggiuntive sul servizio HCE.

  3. Imposta l'attributo android:exported su true e richiedi l'autorizzazione android.permission.BIND_NFC_SERVICE nella dichiarazione del servizio. Il primo garantisce che il servizio possa essere associato ad applicazioni esterne. Quest'ultimo impone che solo le applicazioni esterne che dispongono dell'autorizzazione android.permission.BIND_NFC_SERVICE possano associarsi al tuo servizio. Poiché android.permission.BIND_NFC_SERVICE è un'autorizzazione di sistema, ciò garantisce di fatto che solo il sistema operativo Android possa associarsi al tuo servizio.

Di seguito è riportato un esempio di dichiarazione del file manifest 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>

Questo tag di metadati rimanda a un file apduservice.xml. Di seguito è riportato un esempio di un file di questo tipo con una singola dichiarazione di gruppo AID contenente due AID proprietari:

<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>

Il tag <host-apdu-service> deve contenere un attributo <android:description> che contiene una descrizione facile da usare del servizio che puoi mostrare nell'UI dell'app. Puoi utilizzare l'attributo requireDeviceUnlock per specificare che il dispositivo deve essere sbloccato prima di richiamare questo servizio per gestire le APDU.

<host-apdu-service> deve contenere uno o più tag <aid-group>. Ogni tag <aid-group> deve:

  • Includere un attributo android:description che contiene una descrizione facile da usare del gruppo AID, adatta per la visualizzazione nell'interfaccia utente.
  • Avere l'attributo android:category impostato per indicare la categoria a cui appartiene il gruppo AID, ad esempio le costanti di stringa definite da CATEGORY_PAYMENT o CATEGORY_OTHER.
  • Contenere uno o più tag <aid-filter>, ognuno dei quali contiene un singolo AID. Specifica l'AID in formato esadecimale e assicurati che contenga un numero pari di caratteri.

L'applicazione deve inoltre disporre dell'autorizzazione NFC per registrarsi come servizio HCE.

Risoluzione dei conflitti AID

Su un singolo dispositivo possono essere installati più componenti HostApduService e lo stesso AID può essere registrato da più servizi. Android determina quale servizio richiamare seguendo questi passaggi:

  1. Se l'app wallet predefinita selezionata dall'utente ha registrato l'AID, viene richiamata l'app in questione.
  2. Se l'app wallet predefinita non ha registrato l'AID, viene richiamato il servizio che ha registrato l'AID.
  3. Se più di un servizio ha registrato l'AID, Android chiede all'utente quale servizio richiamare.

Preferenza per i servizi in primo piano

Le app in primo piano possono richiamare setPreferredService per specificare quale servizio di emulazione della carta deve essere preferito mentre un'attività specifica è in primo piano. Questa preferenza per le app in primo piano sostituisce la risoluzione dei conflitti AID. Questa è la prassi consigliata quando l'app prevede che l'utente possa utilizzare l'emulazione della carta NFC.

Android 13 e versioni successive

Per adattare meglio l'elenco di selezione dei pagamenti predefiniti nell'UI Impostazioni, modifica il requisito del banner in un'icona quadrata. Idealmente, dovrebbe essere identica al design dell'icona in Avvio applicazioni. Questa modifica crea una maggiore coerenza e un aspetto più pulito.

Android 12 e versioni precedenti

Imposta le dimensioni del banner del servizio su 260 x 96 dp, quindi imposta le dimensioni del banner del servizio nel file XML dei metadati aggiungendo l'attributo android:apduServiceBanner al tag <host-apdu-service>, che rimanda alla risorsa drawable. Di seguito è riportato un esempio:

<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>

Applicazioni Wallet

Android 15 e versioni successive includono un ruolo predefinito per l'app wallet che l'utente può selezionare andando su Impostazioni > App > App predefinite. In questo modo viene definita l'applicazione wallet predefinita da richiamare quando si tocca un terminale di pagamento. Android considera i servizi HCE che hanno dichiarato un gruppo AID con la categoria di pagamento come applicazioni wallet.

Controlla se la tua app è l'app Wallet predefinita

Le app possono verificare se sono l'app wallet predefinita passando RoleManager.ROLE_WALLET a RoleManager.isRoleHeld().

Se la tua app non è quella predefinita, puoi richiedere il ruolo di portafoglio predefinito passando RoleManager.ROLE_WALLET a RoleManager.createRequestRoleIntent().

Asset richiesti per le applicazioni di portafoglio

Per offrire un'esperienza utente visivamente più accattivante, le applicazioni di portafoglio HCE devono fornire un banner di servizio.

Modalità di osservazione

Android 15 introduce la funzionalità Modalità di osservazione. Quando è attiva, la modalità di osservazione consente al dispositivo di osservare i loop di polling NFC e di inviare notifiche al riguardo ai componenti HostApduService appropriati, in modo che possano prepararsi a interagire con un determinato terminale NFC. Un HostApduService può impostare il dispositivo in modalità Osserva passando true a setObserveModeEnabled(). In questo modo, lo stack NFC non consente le transazioni NFC e osserva passivamente i loop di polling.

Filtri del loop di polling

Puoi registrare i filtri del loop di polling per un HostApduService utilizzando uno dei seguenti metodi:

Quando un filtro del loop di polling corrisponde a frame di polling non standard, lo stack NFC instrada questi frame di polling al HostApduService corrispondente chiamando il relativo metodo processPollingFrames(). In questo modo, il servizio può adottare tutte le misure necessarie per garantire che l'utente sia pronto a effettuare la transazione e intenda farlo, ad esempio autenticando l'utente. Se un lettore NFC utilizza solo frame standard nel suo loop di polling, lo stack NFC instrada questi frame di polling al servizio in primo piano preferito se questo servizio è in primo piano o, in caso contrario, al titolare del ruolo di wallet predefinito.

Le notifiche dei frame di polling includono anche una misurazione dell'intensità del campo specifica del fornitore che puoi recuperare chiamando getVendorSpecificGain(). I fornitori possono fornire misurazioni utilizzando la propria scala, purché rientri in un singolo byte.

Rispondi ai loop di polling ed esci dalla modalità di osservazione

Quando il servizio è pronto per le transazioni, può uscire dalla modalità di osservazione passando false a setObserveModeEnabled(). Lo stack NFC consentirà quindi di procedere con le transazioni.

I componenti HostApduService possono indicare che la modalità di osservazione deve essere attivata ogni volta che sono il servizio di pagamento preferito impostando shouldDefaultToObserveMode su true nel manifest o chiamando CardEmulation.setShouldDefaultToObserveModeForService().

I componenti HostApduService e OffHostApduService possono anche indicare che i filtri del loop di polling che corrispondono ai frame del loop di polling ricevuti devono disattivare automaticamente la modalità di osservazione e consentire alle transazioni di procedere impostando autoTransact su true nella dichiarazione PollingLoopFilter nel manifest.

Preferenza per i servizi in primo piano

Le app in primo piano possono richiamare setPreferredService per specificare quale servizio di emulazione della carta deve essere preferito mentre un'attività specifica è in primo piano. Questa preferenza per l'app in primo piano sostituisce lo stato della modalità di osservazione del dispositivo corrispondente al valore di shouldDefaultToObserveMode per un determinato servizio, che può essere impostato in uno dei seguenti modi:

Comportamento con schermo spento e schermata di blocco

Il comportamento dei servizi HCE varia in base alla versione di Android in esecuzione sul dispositivo.

Android 15 e versioni successive

Se l'app wallet predefinita attiva la modalità di osservazione su un dispositivo che la supporta, l'app sostituisce il comportamento di sblocco e spegnimento dello schermo, perché controlla quando una transazione può procedere. Alcune app wallet potrebbero richiedere lo sblocco del dispositivo prima di poter procedere con una transazione se la modalità di osservazione non ha rilevato un pattern di loop di polling identificabile.

Gli sviluppatori sono invitati a collaborare con i propri dispositivi di lettura per emettere pattern di loop di polling identificabili e registrarsi per gestire questi pattern dalla propria app.

Android 12 e versioni successive

Nelle app che hanno come target Android 12 (livello API 31) e versioni successive, puoi attivare i pagamenti NFC senza che lo schermo del dispositivo sia acceso impostando requireDeviceScreenOn su false.

Android 10 e versioni successive

I dispositivi con Android 10 (livello API 29) o versioni successive supportano NFC sicuro. Quando l'NFC sicuro è attivo, tutti gli emulatori di carte (applicazioni host e applicazioni off-host) non sono disponibili quando lo schermo del dispositivo è spento. Quando l'NFC sicuro è disattivato, le applicazioni off-host sono disponibili quando lo schermo del dispositivo è spento. Puoi verificare il supporto dell'NFC sicuro utilizzando isSecureNfcSupported().

Sui dispositivi con Android 10 e versioni successive, la stessa funzionalità per l'impostazione di android:requireDeviceUnlock su true si applica come per i dispositivi con Android 9 e versioni precedenti, ma solo quando NFC sicuro è disattivato. In altre parole, se NFC sicuro è attivo, i servizi HCE non possono funzionare dalla schermata di blocco, indipendentemente dall'impostazione di android:requireDeviceUnlock.

Android 9 e versioni precedenti

Sui dispositivi con Android 9 (livello API 28) e versioni precedenti, il controller NFC e l'Application Processor vengono disattivati completamente quando lo schermo del dispositivo è spento. Di conseguenza, i servizi HCE non funzionano quando lo schermo è spento.

Inoltre, su Android 9 e versioni precedenti, i servizi HCE possono funzionare dalla schermata di blocco. Tuttavia, questo è controllato dall'attributo android:requireDeviceUnlock nel tag <host-apdu-service> del tuo servizio HCE. Per impostazione predefinita, lo sblocco del dispositivo non è richiesto e il servizio viene richiamato anche se il dispositivo è bloccato.

Se imposti l'attributo android:requireDeviceUnlock su true per il tuo servizio HCE, Android chiede all'utente di sbloccare il dispositivo quando si verificano le seguenti condizioni:

  • l'utente tocca un lettore NFC.
  • il lettore NFC seleziona un AID che viene risolto nel tuo servizio.

Dopo lo sblocco, Android mostra una finestra di dialogo che invita l'utente a toccare di nuovo per completare la transazione. Questo è necessario perché l'utente potrebbe aver allontanato il dispositivo dal lettore NFC per sbloccarlo.

Coesistenza con le carte Secure Element

Questa sezione è di interesse per gli sviluppatori che hanno eseguito il deployment di un'applicazione che si basa su un Secure Element per l'emulazione della carta. L'implementazione HCE di Android è progettata per funzionare in parallelo con altri metodi di implementazione dell'emulazione della carta, incluso l'utilizzo di Secure Element.

Questa coesistenza si basa su un principio chiamato routing AID. Il controller NFC mantiene una tabella di routing composta da un elenco (finito) di regole di instradamento. Ogni regola di instradamento contiene un AID e una destinazione. La destinazione può essere la CPU host, su cui sono in esecuzione le app per Android, o un Secure Element connesso.

Quando il lettore NFC invia un'APDU con un SELECT AID, il controller NFC la analizza e verifica se gli AID corrispondono a un AID nella tabella di routing. Se corrisponde, l'APDU e tutte le APDU successive vengono inviate alla destinazione associata all'AID, finché non viene ricevuta un'altra APDU SELECT AID o il link NFC non viene interrotto.

La Figura 4 illustra questa architettura:

Diagramma con lettore NFC che comunica sia con un Secure Element sia con la CPU
Figura 4. Android funziona sia con Secure Element sia con Host Card Emulation.

In genere, il controller NFC contiene anche un percorso predefinito per le APDU. Quando un AID non viene trovato nella tabella di routing, viene utilizzata la route predefinita. Sebbene questa impostazione possa variare da dispositivo a dispositivo, i dispositivi Android devono garantire che gli AID registrati dalla tua app vengano indirizzati correttamente all'host.

Le app per Android che implementano un servizio HCE o che utilizzano un Secure Element non devono preoccuparsi di configurare la tabella di routing, che viene gestita automaticamente da Android. Android deve solo sapere quali AID possono essere gestiti dai servizi HCE e quali dal Secure Element. La tabella di routing viene configurata automaticamente in base ai servizi installati e a quelli configurati dall'utente come preferiti.

La sezione seguente spiega come dichiarare gli AID per le applicazioni che utilizzano un Secure Element per l'emulazione della carta.

Registrazione AID Secure Element

Le applicazioni che utilizzano un Secure Element per l'emulazione della carta possono dichiarare un servizio off-host nel proprio manifest. La dichiarazione di un servizio di questo tipo è quasi identica alla dichiarazione di un servizio HCE. Le eccezioni sono le seguenti:

  • L'azione utilizzata nel filtro per intent deve essere impostata su SERVICE_INTERFACE.
  • L'attributo name dei metadati deve essere impostato su SERVICE_META_DATA.
  • Il file XML dei metadati deve utilizzare il 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>

Di seguito è riportato un esempio del file apduservice.xml corrispondente che registra due 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>

L'attributo android:requireDeviceUnlock non si applica ai servizi off-host, perché la CPU host non è coinvolta nella transazione e pertanto non può impedire al Secure Element di eseguire transazioni quando il dispositivo è bloccato.

L'attributo android:apduServiceBanner è obbligatorio per i servizi off-host che sono applicazioni di pagamento e per essere selezionabile come applicazione di pagamento predefinita.

Chiamata di servizio off-host

Android non avvia né si associa mai a un servizio dichiarato come "off-host", perché le transazioni effettive vengono eseguite dal Secure Element e non dal servizio Android. La dichiarazione del servizio consente semplicemente alle applicazioni di registrare gli AID presenti su Secure Element.

HCE e sicurezza

L'architettura HCE fornisce un elemento di sicurezza fondamentale: poiché il tuo servizio è protetto dall'autorizzazione di sistema BIND_NFC_SERVICE, solo il sistema operativo può associarsi e comunicare con il tuo servizio. In questo modo, ogni APDU che ricevi è effettivamente un APDU ricevuto dal sistema operativo dal controller NFC e ogni APDU che invii torna solo al sistema operativo, che a sua volta inoltra direttamente gli APDU al controller NFC.

L'ultimo problema rimasto riguarda la provenienza dei dati che l'app invia al lettore NFC. Questo è intenzionalmente disaccoppiato nel design di HCE; non importa da dove provengono i dati, si assicura solo che vengano trasportati in sicurezza al controller NFC e al lettore NFC.

Per archiviare e recuperare in modo sicuro i dati che vuoi inviare dal tuo servizio HCE, puoi, ad esempio, fare affidamento sulla sandbox dell'app per Android, che isola i dati della tua app da altre app. Per maggiori dettagli sulla sicurezza di Android, leggi i suggerimenti per la sicurezza.

Parametri e dettagli del protocollo

Questa sezione è di interesse per gli sviluppatori che vogliono capire quali parametri di protocollo utilizzano i dispositivi HCE durante le fasi di anticollisione e attivazione dei protocolli NFC. In questo modo è possibile creare un'infrastruttura di lettori compatibile con i dispositivi Android HCE.

Anticollisione e attivazione del protocollo Nfc-A (ISO/IEC 14443 tipo A)

Nell'ambito dell'attivazione del protocollo Nfc-A, vengono scambiati più frame.

Nella prima parte dello scambio, il dispositivo HCE presenta il proprio UID. Si deve presumere che i dispositivi HCE abbiano un UID casuale. Ciò significa che a ogni tocco, l'UID presentato al lettore è un UID generato in modo casuale. Per questo motivo, i lettori NFC non devono fare affidamento sull'UID dei dispositivi HCE come forma di autenticazione o identificazione.

Il lettore NFC può quindi selezionare il dispositivo HCE inviando un comando SEL_REQ. La risposta SEL_RES del dispositivo HCE ha almeno il sesto bit (0x20) impostato, a indicare che il dispositivo supporta ISO-DEP. Tieni presente che potrebbero essere impostati anche altri bit in SEL_RES, a indicare ad esempio il supporto del protocollo NFC-DEP (p2p). Poiché potrebbero essere impostati altri bit, i lettori che vogliono interagire con i dispositivi HCE devono controllare esplicitamente solo il sesto bit e non confrontare l'intero SEL_RES con un valore pari a 0x20.

Attivazione ISO-DEP

Dopo l'attivazione del protocollo Nfc-A, il lettore NFC avvia l'attivazione del protocollo ISO-DEP. Invia un comando RATS (Request for Answer To Select). Il controller NFC genera la risposta RATS, l'ATS; l'ATS non è configurabile dai servizi HCE. Tuttavia, le implementazioni HCE devono soddisfare i requisiti di NFC Forum per la risposta ATS, pertanto i lettori NFC possono fare affidamento su questi parametri impostati in conformità ai requisiti di NFC Forum per qualsiasi dispositivo HCE.

La sezione seguente fornisce ulteriori dettagli sui singoli byte della risposta ATS fornita dal controller NFC su un dispositivo HCE:

  • TL: lunghezza della risposta ATS. Non deve indicare una lunghezza superiore a 20 byte.
  • T0: i bit 5, 6 e 7 devono essere impostati su tutti i dispositivi HCE, indicando che TA(1), TB(1) e TC(1) sono inclusi nella risposta ATS. I bit da 1 a 4 indicano l'FSCI, che codifica la dimensione massima del frame. Sui dispositivi HCE, il valore di FSCI deve essere compreso tra 0h e 8h.
  • T(A)1: definisce i bitrate tra lettore ed emulatore e se possono essere asimmetrici. Non sono previsti requisiti o garanzie di bitrate per i dispositivi HCE.
  • T(B)1: i bit da 1 a 4 indicano il valore intero del tempo di protezione del frame di avvio (SFGI). Sui dispositivi HCE, l'SFGI deve essere <= 8 ore. I bit da 5 a 8 indicano il Frame Waiting Time Integer (FWI) e codificano il Frame Waiting Time (FWT). Sui dispositivi HCE, il valore FWI deve essere <= 8h.
  • T(C)1: il bit 5 indica il supporto per le "funzionalità del protocollo avanzato". I dispositivi HCE possono supportare o meno le "funzionalità di protocollo avanzate". Il bit 2 indica il supporto per DID. I dispositivi HCE possono supportare o meno il DID. Il bit 1 indica il supporto per NAD. I dispositivi HCE non devono supportare NAD e devono impostare il bit 1 su zero.
  • Byte storici: i dispositivi HCE possono restituire fino a 15 byte storici. I lettori NFC che vogliono interagire con i servizi HCE non devono fare supposizioni sui contenuti dei byte storici o sulla loro presenza.

Tieni presente che molti dispositivi HCE sono probabilmente conformi ai requisiti del protocollo specificati dai circuiti di pagamento uniti in EMVCo nella specifica "Contactless Communication Protocol". In particolare:

  • L'FSCI in T0 deve essere compreso tra 2 e 8 ore.
  • T(A)1 deve essere impostato su 0x80, a indicare che è supportato solo il bitrate di 106 kbit/s e che i bitrate asimmetrici tra lettore ed emulatore non sono supportati.
  • FWI in T(B)1 deve essere <= 7 ore.

Scambio di dati APDU

Come indicato in precedenza, le implementazioni HCE supportano un solo canale logico. Il tentativo di selezionare applicazioni su canali logici diversi non funziona su un dispositivo HCE.