Routage des AID HCE sous Android : comment votre téléphone choisit l'appli qui répond
Quand un lecteur envoie SELECT AID, Android choisit un seul service HCE pour répondre. Voici comment la table de routage, les groupes d'AID, les catégories et les règles de conflit déterminent lequel.
Introduction
Lorsque vous approchez un téléphone Android d'un lecteur, une seule appli répond, même si plusieurs applis peuvent émuler une carte. Android décide à partir de l'Application ID (AID) demandé par le lecteur, d'une table de routage située dans le contrôleur NFC et d'une courte liste de règles de conflit. Ce guide détaille ce parcours pour l'émulation de carte hôte, qu'Android prend en charge depuis la version 4.4.
Ce que le lecteur envoie réellement
La première chose qu'un lecteur envoie généralement est une commande SELECT AID. C'est une APDU transportée via ISO-DEP, qui contient un AID de 16 octets maximum désignant l'application voulue par le lecteur. D'après le guide Android sur la HCE, Android extrait cet AID, le résout vers un service HCE et transmet l'APDU à ce service.
À partir de là, le service reçoit toutes les APDU du lecteur, jusqu'à ce que celui-ci envoie un autre SELECT AID qui renvoie vers un service différent, ou jusqu'à la rupture de la liaison NFC. Dans les deux cas, le rappel onDeactivated() du service est exécuté.
Deux niveaux : la table du contrôleur, puis Android
Le routage se fait en deux temps. D'abord, le contrôleur NFC conserve une table de routage composée de règles associant chacune un AID à une destination : le processeur hôte ou un élément sécurisé. Quand SELECT AID arrive, le contrôleur consulte sa table. En cas de correspondance, cette APDU et toutes les suivantes sont envoyées à la destination correspondante.
Si l'AID ne figure pas dans la table, le contrôleur utilise sa route par défaut. Les appareils Android doivent faire en sorte que les AID enregistrés par votre appli atteignent l'hôte. Vous ne construisez jamais cette table vous-même : Android la configure à partir des services installés et des préférences de l'utilisateur. Android ne prend pas non plus en charge, sur les appareils HCE, la notion de correspondance partielle d'AID de l'ISO 7816-4.
Ensuite, une fois l'APDU arrivée à l'hôte, Android résout l'AID vers un service. Les applis qui conservent leur carte dans un élément sécurisé déclarent à la place un service hors hôte. Android ne les démarre ni ne s'y lie jamais, car l'élément sécurisé gère la transaction.
Groupes d'AID et catégories
Un service enregistre ses AID par groupes. Pour chaque AID d'un groupe, Android garantit l'un de ces deux résultats : tous sont routés vers votre service, ou aucun ne l'est. Un demi-groupe n'est jamais attribué à une autre appli.
Chaque groupe possède aussi une catégorie, payment ou other. Un seul groupe de catégorie payment peut être activé à la fois. Les cartes à circuit fermé, comme une carte prépayée valable chez un seul commerçant, relèvent de other, où les groupes peuvent rester actifs en permanence. Une appli de catégorie payment ne peut traiter un contact que si l'utilisateur en a fait son appli de paiement par défaut (le rôle Wallet à partir d'Android 15) ou si elle est au premier plan et a appelé setPreferredService.
Qui l'emporte en cas de conflit
Plusieurs services peuvent enregistrer le même AID. Android résout le conflit dans cet ordre :
- Si l'appli de portefeuille par défaut de l'utilisateur a enregistré l'AID, c'est elle qui est appelée.
- Sinon, le service qui a enregistré l'AID est appelé.
- Si plusieurs services l'ont enregistré, Android demande à l'utilisateur.
Une appli au premier plan peut tout écraser. La référence CardEmulation décrit setPreferredService : appelez-la dans onResume() et appelez unsetPreferredService dans onPause(), car l'OS ne conserve pas cette préférence. L'appel peut échouer si l'utilisateur a interdit aux applis au premier plan de remplacer le service de paiement par défaut.
Les AID proviennent généralement du fichier apduservice.xml du manifeste, écrits en hexadécimal avec un nombre pair de caractères. Les applis peuvent aussi appeler registerAidsForService, qui remplace la liste précédente pour cette catégorie. Certains appareils acceptent un préfixe d'AID tel que A000000004*, et supportsAidPrefixRegistration() vous indique si c'est le cas du vôtre.
Quand la mauvaise appli répond
Si un contact aboutit à la mauvaise appli, passez en revue cette liste :
- Le groupe d'AID est-il scindé ? Regroupez dans un seul groupe les AID qui vont ensemble.
- Une autre appli est-elle le portefeuille par défaut ? Elle passe avant votre service pour tout AID qu'elle a enregistré.
- Votre groupe est-il en
paymentalors qu'il devrait être enother? - Comptez-vous sur la correspondance par préfixe sur un appareil qui ne la propose pas ?
- Avez-vous oublié d'appeler à nouveau
setPreferredServiceaprès la reprise de l'activité ?
NFCore lit, écrit et inspecte les tags NFC sur iOS et Android. Ce n'est pas un outil de traçage du routage HCE : pour ces vérifications, utilisez un second lecteur et observez quel service journalise le SELECT AID.
Conclusion
Android répond à un contact en deux étapes : la table de routage du contrôleur NFC envoie l'AID vers l'hôte ou un élément sécurisé, puis Android choisit un service selon le portefeuille par défaut, l'unique service enregistré ou le choix de l'utilisateur, une appli au premier plan pouvant tout écraser. Gardez les AID liés dans un même groupe, choisissez la bonne catégorie et définissez le service préféré à chaque reprise.
Foire aux questions
Comment Android décide-t-il quelle appli HCE répond à un contact ?
Le lecteur envoie SELECT AID. Android résout cet AID vers un service : d'abord l'appli de portefeuille par défaut si elle a enregistré l'AID, puis le seul service qui l'a enregistré. Si plusieurs l'ont fait, il demande à l'utilisateur. Une appli au premier plan qui utilise setPreferredService écrase ce comportement.
Deux applis peuvent-elles enregistrer le même AID ?
Oui. Android l'autorise et règle le conflit au moment du contact selon l'ordre ci-dessus. Si plusieurs services ont enregistré l'AID et qu'aucun n'est préféré, l'utilisateur est sollicité.
Android prend-il en charge la correspondance par préfixe d'AID ?
Les correspondances partielles de l'ISO 7816-4 ne sont pas prises en charge sur les appareils Android HCE, mais certains appareils permettent à une appli d'enregistrer un préfixe d'AID. Appelez supportsAidPrefixRegistration() pour le vérifier.
Un groupe d'AID peut-il être partagé entre deux applis ?
Non. Soit tous les AID du groupe sont routés vers le service, soit aucun ne l'est.