Présentation de la technologie HCE

De nombreux appareils Android dotés de la fonctionnalité NFC acceptent déjà l'émulation de carte NFC. Dans la plupart des cas, la carte est émulée par une puce électronique distincte dans l'appareil, appelée composant sécurisé. De nombreuses cartes SIM fournies par les opérateurs de téléphonie mobile contiennent également un composant sécurisé.

Android 4.4 et versions ultérieures proposent une autre méthode d'émulation de carte, appelée émulation de carte basée sur l'hôte, qui n'implique pas de composant sécurisé. Cela permet à n'importe quelle application Android d'émuler une carte et de communiquer directement avec le lecteur NFC. Cet article décrit le fonctionnement de l'émulation de carte hôte (HCE, Host-based Card Emulation) sur Android et explique comment développer une application qui émule une carte NFC à l'aide de cette technique.

Émulation de carte avec un composant sécurisé

Lorsque l'émulation de carte NFC est fournie à l'aide d'un composant sécurisé, la carte à émuler est provisionnée dans le composant sécurisé de l'appareil via une application Android. Ensuite, lorsque l'utilisateur place l'appareil sur un terminal NFC, le contrôleur NFC de l'appareil achemine toutes les données du lecteur directement vers le composant sécurisé. La figure 1 illustre ce concept :

Schéma d'un lecteur NFC passant par un contrôleur NFC pour récupérer des informations à partir d'un composant sécurisé
Figure 1 : Émulation de carte NFC avec un composant sécurisé.

Le composant sécurisé lui-même communique avec le terminal NFC, et aucune application Android n'est impliquée dans la transaction. Une fois la transaction terminée, une application Android peut interroger directement le composant sécurisé pour connaître l'état de la transaction et en informer l'utilisateur.

Émulation de cartes basée sur l'hôte

Lorsqu'une carte NFC est émulée à l'aide de l'émulation de carte basée sur l'hôte, les données sont acheminées directement vers le processeur hôte au lieu d'être acheminées vers un composant sécurisé. La figure 2 illustre le fonctionnement de l'émulation de cartes basée sur l'hôte :

Schéma d'un lecteur NFC passant par un contrôleur NFC pour récupérer des informations du processeur
Figure 2 : Émulation de carte NFC sans composant sécurisé.

Cartes et protocoles NFC compatibles

Schéma illustrant la pile de protocoles HCE
Figure 3 : Pile de protocoles HCE d'Android.

Les normes NFC sont compatibles avec de nombreux protocoles, et vous pouvez émuler différents types de cartes.

Android 4.4 et versions ultérieures sont compatibles avec plusieurs protocoles courants sur le marché actuel. De nombreuses cartes sans contact existantes sont déjà basées sur ces protocoles, comme les cartes de paiement sans contact. Ces protocoles sont également compatibles avec de nombreux lecteurs NFC actuellement sur le marché, y compris les appareils Android NFC qui fonctionnent eux-mêmes comme des lecteurs (voir la classe IsoDep). Cela vous permet de créer et de déployer une solution NFC de bout en bout autour de HCE en utilisant uniquement des appareils Android.

Plus précisément, Android 4.4 et versions ultérieures sont compatibles avec l'émulation de cartes basées sur la spécification ISO-DEP du forum NFC (basée sur la norme ISO/CEI 14443-4) et traitent les unités de données de protocole d'application (APDU) telles que définies dans la spécification ISO/CEI 7816-4. Android impose d'émuler ISO-DEP uniquement sur la technologie Nfc-A (ISO/IEC 14443-3 Type A). La compatibilité avec la technologie Nfc-B (ISO/IEC 14443-4 Type B) est facultative. La figure 3 illustre la superposition de toutes ces spécifications.

Services HCE

L'architecture HCE d'Android est basée sur les composants Service d'Android (appelés services HCE). L'un des principaux avantages d'un service est qu'il peut s'exécuter en arrière-plan sans aucune interface utilisateur. Cette solution est idéale pour de nombreuses applications HCE, telles que les cartes de fidélité ou les cartes de transport, que l'utilisateur ne devrait pas avoir besoin de lancer pour les utiliser. Au lieu de cela, appuyer sur l'appareil contre le lecteur NFC démarre le service approprié s'il n'est pas déjà en cours d'exécution et exécute la transaction en arrière-plan. Bien entendu, vous pouvez lancer une UI supplémentaire (comme des notifications utilisateur) à partir de votre service, le cas échéant.

Sélection des services

Lorsque l'utilisateur appuie sur un appareil pour accéder à un lecteur NFC, le système Android doit savoir avec quel service HCE le lecteur NFC souhaite communiquer. La spécification ISO/IEC 7816-4 définit un moyen de sélectionner des applications, centré sur un ID d'application (AID). Un AID peut comporter jusqu'à 16 octets. Si vous émulez des cartes pour une infrastructure de lecteur NFC existante, les AID recherchés par ces lecteurs sont généralement bien connus et enregistrés publiquement (par exemple, les AID de réseaux de paiement tels que Visa et MasterCard).

Si vous souhaitez déployer une nouvelle infrastructure de lecteur pour votre propre application, vous devez enregistrer vos propres AID. La procédure d'enregistrement des AID est définie dans la spécification ISO/CEI 7816-5. Nous vous recommandons d'enregistrer un AID conformément à la norme 7816-5 si vous déployez une application HCE pour Android, car cela évite les conflits avec d'autres applications.

Groupes AID

Dans certains cas, un service HCE peut avoir besoin d'enregistrer plusieurs AID et d'être défini comme gestionnaire par défaut pour tous les AID afin d'implémenter une certaine application. Il n'est pas possible d'envoyer certains AID du groupe vers un autre service.

Une liste d'AID regroupés est appelée "groupe d'AID". Pour tous les AID d'un groupe d'AID, Android garantit l'un des éléments suivants :

  • Tous les AID du groupe sont acheminés vers ce service HCE.
  • Aucun AID du groupe n'est acheminé vers ce service HCE (par exemple, parce que l'utilisateur a préféré un autre service qui a également demandé un ou plusieurs AID de votre groupe).

En d'autres termes, il n'y a pas d'état intermédiaire, où certains AID du groupe peuvent être acheminés vers un service HCE et d'autres vers un autre.

Groupes et catégories d'AID

Vous pouvez associer chaque groupe d'AID à une catégorie. Cela permet à Android de regrouper les services HCE par catégorie, ce qui permet à l'utilisateur de définir des valeurs par défaut au niveau de la catégorie plutôt qu'au niveau de l'AID. Évitez de mentionner les AID dans les parties de votre application visibles par l'utilisateur, car ils n'ont aucune signification pour l'utilisateur moyen.

Android 4.4 et versions ultérieures sont compatibles avec deux catégories :

Les applications qui enregistrent des AID sous CATEGORY_PAYMENT ne peuvent traiter une transaction que si :

  • L'utilisateur définit l'application comme application de paiement par défaut (titulaire du rôle Wallet sur les appareils Android 15 ou version ultérieure), OU
  • L'application est au premier plan et appelle setPreferredService.

Implémenter un service HCE

Pour émuler une carte NFC à l'aide de l'émulation de cartes hébergées, vous devez créer un composant Service qui gère les transactions NFC.

Vérifier la compatibilité avec la technologie HCE

Votre application peut vérifier si un appareil est compatible avec la technologie HCE en recherchant la fonctionnalité FEATURE_NFC_HOST_CARD_EMULATION. Utilisez la balise <uses-feature> dans le fichier manifeste de votre application pour déclarer qu'elle utilise la fonctionnalité HCE et si elle est nécessaire ou non pour que l'application fonctionne.

Implémentation du service

Android 4.4 et versions ultérieures fournissent une classe Service pratique que vous pouvez utiliser comme base pour implémenter un service HCE : la classe HostApduService.

La première étape consiste à étendre HostApduService, comme illustré dans l'exemple de code suivant :

class MyHostApduService : HostApduService() {

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

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

HostApduService déclare deux méthodes abstraites que vous devez remplacer et implémenter. L'une d'entre elles, processCommandApdu(), est appelée chaque fois qu'un lecteur NFC envoie une unité APDU (Application Protocol Data Unit) à votre service. Les APDU sont définis dans la spécification ISO/CEI 7816-4. Les APDU sont les paquets au niveau de l'application échangés entre le lecteur NFC et votre service HCE. Ce protocole au niveau de l'application est half-duplex : le lecteur NFC vous envoie une commande APDU et attend que vous lui envoyiez une réponse APDU en retour.

Comme indiqué précédemment, Android utilise l'AID pour déterminer le service HCE avec lequel le lecteur souhaite communiquer. En règle générale, la première APDU qu'un lecteur NFC envoie à votre appareil est une APDU SELECT AID. Cette APDU contient l'AID avec lequel le lecteur souhaite communiquer. Android extrait cet AID de l'APDU, le résout en un service HCE, puis transmet cet APDU au service résolu.

Vous pouvez envoyer une APDU de réponse en renvoyant les octets de l'APDU de réponse à partir de processCommandApdu(). Notez que cette méthode est appelée sur le thread principal de votre application, que vous ne devez pas bloquer. Si vous ne pouvez pas calculer et renvoyer immédiatement une APDU de réponse, renvoyez la valeur "null". Vous pouvez ensuite effectuer le travail nécessaire sur un autre thread et utiliser la méthode sendResponseApdu() définie dans la classe HostApduService pour envoyer la réponse lorsque vous avez terminé.

Android continue de transférer les nouvelles APDU du lecteur vers votre service, jusqu'à ce que l'un des événements suivants se produise :

  • Le lecteur NFC envoie une autre APDU SELECT AID, que l'OS résout vers un autre service.
  • La liaison NFC entre le lecteur NFC et votre appareil est interrompue.

Dans les deux cas, l'implémentation onDeactivated() de votre classe est appelée avec un argument indiquant lequel des deux événements s'est produit.

Si vous utilisez une infrastructure de lecteur existante, vous devez implémenter le protocole existant au niveau de l'application que les lecteurs attendent dans votre service HCE.

Si vous déployez une nouvelle infrastructure de lecteur que vous contrôlez également, vous pouvez définir votre propre protocole et votre propre séquence APDU. Essayez de limiter le nombre d'APDU et la taille des données à échanger. Ainsi, vos utilisateurs n'auront à maintenir leur appareil au-dessus du lecteur NFC que pendant une courte période. Une limite supérieure raisonnable est d'environ 1 Ko de données, qui peuvent généralement être échangées en 300 ms.

Déclaration du fichier manifeste du service et enregistrement de l'AID

Vous devez déclarer votre service dans le fichier manifeste comme d'habitude, mais vous devez également ajouter des éléments supplémentaires à la déclaration du service :

  1. Pour indiquer à la plate-forme qu'il s'agit d'un service HCE implémentant une interface HostApduService, ajoutez un filtre d'intent pour l'action SERVICE_INTERFACE à votre déclaration de service.

  2. Pour indiquer à la plate-forme quels groupes d'AID sont demandés par ce service, incluez une balise SERVICE_META_DATA <meta-data> dans la déclaration du service, pointant vers une ressource XML contenant des informations supplémentaires sur le service HCE.

  3. Définissez l'attribut android:exported sur true et demandez l'autorisation android.permission.BIND_NFC_SERVICE dans votre déclaration de service. Le premier garantit que le service peut être lié par des applications externes. Ce dernier applique ensuite la règle selon laquelle seules les applications externes disposant de l'autorisation android.permission.BIND_NFC_SERVICE peuvent s'associer à votre service. Comme android.permission.BIND_NFC_SERVICE est une autorisation système, cela garantit que seul l'OS Android peut être lié à votre service.

Voici un exemple de déclaration de fichier manifeste 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>

Cette balise de métadonnées pointe vers un fichier apduservice.xml. Voici un exemple de fichier de ce type avec une seule déclaration de groupe d'AID contenant deux AID propriétaires :

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

La balise <host-apdu-service> doit contenir un attribut <android:description> qui contient une description conviviale du service que vous pouvez afficher dans l'interface utilisateur de l'application. Vous pouvez utiliser l'attribut requireDeviceUnlock pour spécifier que l'appareil est déverrouillé avant d'appeler ce service pour gérer les APDU.

L'élément <host-apdu-service> doit contenir une ou plusieurs balises <aid-group>. Chaque balise <aid-group> doit :

  • Contenir un attribut android:description qui contient une description conviviale du groupe d'AID, adaptée à l'affichage dans l'interface utilisateur.
  • Son attribut android:category doit être défini pour indiquer la catégorie à laquelle appartient le groupe d'AID, comme les constantes de chaîne définies par CATEGORY_PAYMENT ou CATEGORY_OTHER.
  • Contenir une ou plusieurs balises <aid-filter>, chacune contenant un seul AID. Spécifiez l'AID au format hexadécimal et assurez-vous qu'il contient un nombre pair de caractères.

Votre application doit également disposer de l'autorisation NFC pour s'enregistrer en tant que service HCE.

Résolution des conflits d'ID d'annonce

Plusieurs composants HostApduService peuvent être installés sur un même appareil, et un même AID peut être enregistré par plusieurs services. Android détermine le service à appeler en procédant comme suit :

  1. Si l'application de portefeuille par défaut sélectionnée par l'utilisateur a enregistré l'AID, cette application est appelée.
  2. Si l'application de portefeuille par défaut n'a pas enregistré l'AID, le service qui l'a enregistré est appelé.
  3. Si plusieurs services ont enregistré l'AID, Android demande à l'utilisateur quel service appeler.

Préférence de service de premier plan

Les applications au premier plan peuvent appeler setPreferredService pour spécifier le service d'émulation de carte à privilégier lorsqu'une activité spécifique est au premier plan. Cette préférence d'application au premier plan remplace la résolution des conflits d'AID. Cette pratique est recommandée lorsque l'application anticipe que l'utilisateur pourrait utiliser l'émulation de carte NFC.

Android 13 ou version ultérieure

Pour mieux s'adapter à la liste de sélection du paiement par défaut dans l'UI des paramètres, ajustez l'exigence de bannière à une icône carrée. Idéalement, elle doit être identique à l'icône du lanceur d'applications. Cet ajustement permet d'obtenir un aspect plus cohérent et plus net.

Android 12 et versions antérieures

Définissez la taille de la bannière du service sur 260 x 96 dp, puis définissez la taille de la bannière du service dans votre fichier XML de métadonnées en ajoutant l'attribut android:apduServiceBanner à la balise <host-apdu-service>, qui pointe vers la ressource drawable. Voici un exemple :

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

Applications Wallet

Android 15 et versions ultérieures incluent un rôle d'application de portefeuille par défaut que l'utilisateur peut sélectionner en accédant à Paramètres > Applications > Applications par défaut. Cela définit l'application de portefeuille par défaut à appeler lorsqu'un terminal de paiement est utilisé. Android considère les services HCE qui ont déclaré un groupe d'AID avec la catégorie de paiement comme des applications de portefeuille.

Vérifier si votre application est l'application de portefeuille par défaut

Les applications peuvent vérifier si elles sont l'application de portefeuille par défaut en transmettant RoleManager.ROLE_WALLET à RoleManager.isRoleHeld().

Si votre application n'est pas l'application par défaut, vous pouvez demander le rôle de portefeuille par défaut en transmettant RoleManager.ROLE_WALLET à RoleManager.createRequestRoleIntent().

Composants requis pour les applications de portefeuille

Pour offrir une expérience utilisateur plus attrayante visuellement, les applications de portefeuille HCE doivent fournir une bannière de service.

Mode Observation

Android 15 introduit la fonctionnalité Mode d'observation. Lorsqu'il est activé, le mode Observation permet à l'appareil d'observer les boucles d'interrogation NFC et d'envoyer des notifications à ce sujet aux composants HostApduService appropriés afin qu'ils puissent se préparer à interagir avec un terminal NFC donné. Un HostApduService peut mettre l'appareil en mode Observation en transmettant true à setObserveModeEnabled(). Cela indique à la pile NFC de ne pas autoriser les transactions NFC et d'observer passivement les boucles d'interrogation.

Filtres de boucle d'interrogation

Vous pouvez enregistrer des filtres de boucle d'interrogation pour un HostApduService à l'aide de l'une des méthodes suivantes :

Lorsqu'un filtre de boucle d'interrogation correspond à des frames d'interrogation non standards, la pile NFC achemine ces frames d'interrogation vers le HostApduService correspondant en appelant sa méthode processPollingFrames(). Cela permet au service de prendre toutes les mesures nécessaires pour s'assurer que l'utilisateur est prêt à effectuer une transaction et qu'il en a l'intention (par exemple, en l'authentifiant). Si un lecteur NFC n'utilise que des frames standards dans sa boucle d'interrogation, la pile NFC achemine ces frames d'interrogation vers le service de premier plan préféré si ce service est au premier plan, ou vers le titulaire du rôle de portefeuille par défaut dans le cas contraire.

Les notifications de trame d'interrogation incluent également une mesure de l'intensité du champ spécifique au fournisseur, que vous pouvez récupérer en appelant getVendorSpecificGain(). Les fournisseurs peuvent fournir des mesures en utilisant leur propre échelle, à condition qu'elle tienne sur un seul octet.

Répondre aux boucles d'interrogation et quitter le mode Observation

Lorsque le service est prêt à effectuer des transactions, il peut quitter le mode d'observation en transmettant false à setObserveModeEnabled(). La pile NFC autorisera alors les transactions.

Les composants HostApduService peuvent indiquer que le mode d'observation doit être activé chaque fois qu'ils sont le service de paiement préféré en définissant shouldDefaultToObserveMode sur true dans le fichier manifeste ou en appelant CardEmulation.setShouldDefaultToObserveModeForService().

Les composants HostApduService et OffHostApduService peuvent également indiquer que les filtres de boucle d'interrogation qui correspondent aux frames de boucle d'interrogation reçus doivent désactiver automatiquement le mode Observation et autoriser les transactions en définissant autoTransact sur true dans la déclaration PollingLoopFilter du fichier manifeste.

Préférence de service de premier plan

Les applications au premier plan peuvent appeler setPreferredService pour spécifier le service d'émulation de carte à privilégier lorsqu'une activité spécifique est au premier plan. Cette préférence d'application au premier plan remplace l'état du mode d'observation de l'appareil correspondant à la valeur de shouldDefaultToObserveMode pour un service donné, qui peut être définie de l'une des manières suivantes :

Comportement de l'écran éteint et de l'écran de verrouillage

Le comportement des services HCE varie en fonction de la version d'Android exécutée sur l'appareil.

Android 15 ou version ultérieure

Si l'application de portefeuille par défaut active le mode Observation sur un appareil compatible, elle remplace le comportement de déverrouillage et d'extinction de l'écran, car elle contrôle le moment où une transaction peut avoir lieu. Certaines applications de portefeuille peuvent nécessiter le déverrouillage de l'appareil avant qu'une transaction puisse être effectuée si le mode Observation n'a pas détecté de schéma de boucle d'interrogation identifiable.

Les développeurs sont encouragés à utiliser leurs lecteurs pour émettre des modèles de boucle d'interrogation identifiables et à s'enregistrer pour gérer ces modèles depuis leur application.

Android 12 et versions ultérieures

Dans les applications qui ciblent Android 12 (niveau d'API 31) ou version ultérieure, vous pouvez activer les paiements NFC sans que l'écran de l'appareil soit allumé en définissant requireDeviceScreenOn sur false.

Android 10 ou version ultérieure

Les appareils équipés d'Android 10 (niveau d'API 29) ou version ultérieure sont compatibles avec le NFC sécurisé. Lorsque le NFC sécurisé est activé, tous les émulateurs de carte (applications hôtes et applications hors hôte) ne sont pas disponibles lorsque l'écran de l'appareil est éteint. Lorsque le NFC sécurisé est désactivé, les applications hors hôte sont disponibles lorsque l'écran de l'appareil est éteint. Vous pouvez vérifier la compatibilité avec le NFC sécurisé à l'aide de isSecureNfcSupported().

Sur les appareils équipés d'Android 10 ou version ultérieure, la même fonctionnalité permettant de définir android:requireDeviceUnlock sur true s'applique comme sur les appareils équipés d'Android 9 ou version antérieure, mais uniquement lorsque le NFC sécurisé est désactivé. Autrement dit, si le NFC sécurisé est activé, les services HCE ne peuvent pas fonctionner à partir de l'écran de verrouillage, quel que soit le paramètre de android:requireDeviceUnlock.

Android 9 et versions antérieures

Sur les appareils équipés d'Android 9 (niveau d'API 28) ou d'une version antérieure, le contrôleur NFC et le processeur d'application sont complètement désactivés lorsque l'écran de l'appareil est éteint. Les services HCE ne fonctionnent donc pas lorsque l'écran est éteint.

De plus, sur Android 9 et versions antérieures, les services HCE peuvent fonctionner depuis l'écran de verrouillage. Toutefois, cela est contrôlé par l'attribut android:requireDeviceUnlock dans la balise <host-apdu-service> de votre service HCE. Par défaut, le déverrouillage de l'appareil n'est pas requis et votre service est appelé même si l'appareil est verrouillé.

Si vous définissez l'attribut android:requireDeviceUnlock sur true pour votre service HCE, Android invite l'utilisateur à déverrouiller l'appareil dans les cas suivants :

  • l'utilisateur appuie sur un lecteur NFC.
  • le lecteur NFC sélectionne un AID qui est résolu pour votre service.

Après le déverrouillage, Android affiche une boîte de dialogue invitant l'utilisateur à appuyer de nouveau pour finaliser la transaction. Cette étape est nécessaire, car l'utilisateur peut avoir éloigné l'appareil du lecteur NFC pour le déverrouiller.

Coexistence avec les cartes dotées d'un composant sécurisé

Cette section s'adresse aux développeurs qui ont déployé une application reposant sur un composant sécurisé pour l'émulation de carte. L'implémentation HCE d'Android est conçue pour fonctionner en parallèle avec d'autres méthodes d'implémentation de l'émulation de carte, y compris l'utilisation de composants sécurisés.

Cette coexistence est basée sur un principe appelé routage AID. Le contrôleur NFC conserve une table de routage composée d'une liste (finie) de règles de routage. Chaque règle de routage contient un AID et une destination. La destination peut être le processeur hôte, sur lequel les applications Android sont exécutées, ou un composant sécurisé connecté.

Lorsque le lecteur NFC envoie une APDU avec un SELECT AID, le contrôleur NFC l'analyse et vérifie si les AID correspondent à un AID de sa table de routage. Si l'AID correspond, cette APDU et toutes les APDU suivantes sont envoyées à la destination associée à l'AID, jusqu'à ce qu'une autre APDU SELECT AID soit reçue ou que la liaison NFC soit interrompue.

La figure 4 illustre cette architecture :

Schéma d'un lecteur NFC communiquant à la fois avec un composant sécurisé et le processeur
Figure 4 : Android fonctionne à la fois avec un composant sécurisé et l'émulation de carte hôte.

Le contrôleur NFC contient généralement une route par défaut pour les APDU. Lorsqu'un AID est introuvable dans la table de routage, la route par défaut est utilisée. Bien que ce paramètre puisse varier d'un appareil à l'autre, les appareils Android doivent s'assurer que les AID enregistrés par votre application sont correctement acheminés vers l'hôte.

Les applications Android qui implémentent un service HCE ou qui utilisent un composant sécurisé n'ont pas à se soucier de la configuration de la table de routage, car Android s'en charge automatiquement. Android doit simplement savoir quels AID peuvent être gérés par les services HCE et lesquels peuvent être gérés par le composant sécurisé. La table de routage est configurée automatiquement en fonction des services installés et de ceux que l'utilisateur a configurés comme préférés.

La section suivante explique comment déclarer des AID pour les applications qui utilisent un composant sécurisé pour l'émulation de carte.

Enregistrement de l'AID du composant sécurisé

Les applications qui utilisent un composant sécurisé pour l'émulation de carte peuvent déclarer un service hors hôte dans leur fichier manifeste. La déclaration d'un tel service est presque identique à celle d'un service HCE. Les exceptions sont les suivantes :

  • L'action utilisée dans le filtre d'intent doit être définie sur SERVICE_INTERFACE.
  • L'attribut de nom des métadonnées doit être défini sur SERVICE_META_DATA.
  • Le fichier XML de métadonnées doit utiliser la balise racine <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>

Voici un exemple de fichier apduservice.xml correspondant enregistrant deux 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'attribut android:requireDeviceUnlock ne s'applique pas aux services hors hôte, car le processeur hôte n'est pas impliqué dans la transaction et ne peut donc pas empêcher le composant sécurisé d'exécuter des transactions lorsque l'appareil est verrouillé.

L'attribut android:apduServiceBanner est requis pour les services hors hôte qui sont des applications de paiement et qui peuvent être sélectionnés comme application de paiement par défaut.

Appel de service hors hôte

Android ne démarre ni ne se lie jamais à un service déclaré comme "hors hôte", car les transactions réelles sont exécutées par le composant sécurisé et non par le service Android. La déclaration de service permet simplement aux applications d'enregistrer les AID présents sur le composant sécurisé.

HCE et sécurité

L'architecture HCE fournit un élément de sécurité essentiel : étant donné que votre service est protégé par l'autorisation système BIND_NFC_SERVICE, seul l'OS peut s'associer à votre service et communiquer avec lui. Cela garantit que toute APDU que vous recevez est bien une APDU reçue par l'OS depuis le contrôleur NFC, et que toute APDU que vous renvoyez n'est envoyée qu'à l'OS, qui la transmet ensuite directement au contrôleur NFC.

La dernière question qui se pose est de savoir où vous obtenez les données que votre application envoie au lecteur NFC. Cette dissociation est intentionnelle dans la conception de l'émulation de carte basée sur l'hôte. Elle ne se soucie pas de la provenance des données, mais s'assure simplement qu'elles sont transportées en toute sécurité vers le contrôleur NFC et vers le lecteur NFC.

Pour stocker et récupérer de manière sécurisée les données que vous souhaitez envoyer depuis votre service HCE, vous pouvez par exemple vous appuyer sur le bac à sable de l'application Android, qui isole les données de votre application des autres applications. Pour en savoir plus sur la sécurité Android, consultez Conseils de sécurité.

Paramètres et détails du protocole

Cette section s'adresse aux développeurs qui souhaitent comprendre les paramètres de protocole utilisés par les appareils HCE lors des phases d'anticollision et d'activation des protocoles NFC. Cela permet de créer une infrastructure de lecteur compatible avec les appareils Android HCE.

Anti-collision et activation du protocole Nfc-A (ISO/CEI 14443 type A)

Dans le cadre de l'activation du protocole Nfc-A, plusieurs trames sont échangées.

Dans la première partie de l'échange, l'appareil HCE présente son UID. Les appareils HCE sont censés avoir un UID aléatoire. Cela signifie qu'à chaque pression, l'UID présenté au lecteur est un UID généré de manière aléatoire. C'est pourquoi les lecteurs NFC ne doivent pas dépendre de l'UID des appareils HCE comme forme d'authentification ou d'identification.

Le lecteur NFC peut ensuite sélectionner l'appareil HCE en envoyant une commande SEL_REQ. La réponse SEL_RES de l'appareil HCE comporte au moins le 6e bit (0x20), ce qui indique que l'appareil est compatible avec ISO-DEP. Notez que d'autres bits de SEL_RES peuvent également être définis, indiquant par exemple la compatibilité avec le protocole NFC-DEP (p2p). Étant donné que d'autres bits peuvent être définis, les lecteurs qui souhaitent interagir avec des appareils HCE doivent explicitement vérifier le sixième bit uniquement et ne pas comparer l'intégralité de SEL_RES avec une valeur de 0x20.

Activation ISO-DEP

Une fois le protocole Nfc-A activé, le lecteur NFC lance l'activation du protocole ISO-DEP. Il envoie une commande RATS (Request for Answer To Select). Le contrôleur NFC génère la réponse RATS, l'ATS. L'ATS n'est pas configurable par les services HCE. Toutefois, les implémentations HCE doivent répondre aux exigences du NFC Forum pour la réponse ATS. Les lecteurs NFC peuvent donc compter sur la définition de ces paramètres conformément aux exigences du NFC Forum pour tout appareil HCE.

La section ci-dessous fournit plus de détails sur les octets individuels de la réponse ATS fournie par le contrôleur NFC sur un appareil HCE :

  • TL : longueur de la réponse ATS. Ne doit pas indiquer une longueur supérieure à 20 octets.
  • T0 : les bits 5, 6 et 7 doivent être définis sur tous les appareils HCE, ce qui indique que TA(1), TB(1) et TC(1) sont inclus dans la réponse ATS. Les bits 1 à 4 indiquent le FSCI, qui code la taille maximale de la trame. Sur les appareils HCE, la valeur de FSCI doit être comprise entre 0h et 8h.
  • T(A)1 : définit les débits entre le lecteur et l'émulateur, et s'ils peuvent être asymétriques. Il n'existe aucune exigence ni garantie de débit pour les appareils HCE.
  • T(B)1 : les bits 1 à 4 indiquent l'entier de temps de garde de la trame de démarrage (SFGI, Start-up Frame Guard time Integer). Sur les appareils HCE, le SFGI doit être inférieur ou égal à 8 heures. Les bits 5 à 8 indiquent l'entier du temps d'attente de la trame (FWI, Frame Waiting time Integer) et codent le temps d'attente de la trame (FWT, Frame Waiting Time). Sur les appareils HCE, le FWI doit être inférieur ou égal à 8 h.
  • T(C)1 : le bit 5 indique la compatibilité avec les "fonctionnalités de protocole avancées". Les appareils HCE peuvent ou non prendre en charge les "fonctionnalités de protocole avancées". Le bit 2 indique la compatibilité avec le DID. Les appareils HCE peuvent ou non être compatibles avec le DID. Le bit 1 indique la compatibilité avec NAD. Les appareils HCE ne doivent pas être compatibles avec le NAD et doivent définir le bit 1 sur zéro.
  • Octets d'historique : les appareils HCE peuvent renvoyer jusqu'à 15 octets d'historique. Les lecteurs NFC qui souhaitent interagir avec les services HCE ne doivent pas faire d'hypothèses sur le contenu des octets d'historique ni sur leur présence.

Notez que de nombreux appareils HCE sont susceptibles d'être conformes aux exigences de protocole que les réseaux de paiement réunis au sein d'EMVCo ont spécifiées dans leur spécification "Contactless Communication Protocol". En particulier :

  • L'intervalle FSCI dans T0 doit être compris entre 2 h et 8 h.
  • T(A)1 doit être défini sur 0x80, ce qui indique que seul le débit de 106 kbit/s est accepté et que les débits asymétriques entre le lecteur et l'émulateur ne sont pas acceptés.
  • Le FWI dans T(B)1 doit être <= 7h.

Échange de données APDU

Comme indiqué précédemment, les implémentations HCE ne sont compatibles qu'avec un seul canal logique. La tentative de sélection d'applications sur différents canaux logiques ne fonctionne pas sur un appareil HCE.