Zurück zu den Anleitungen

Android HCE AID-Routing: So wählt dein Smartphone die antwortende App aus

Wenn ein Lesegerät SELECT AID sendet, wählt Android genau einen HCE-Service aus, der antwortet. Hier erfährst du, wie Routing-Tabelle, AID-Gruppen, Kategorien und Konfliktregeln die Entscheidung treffen.

Veröffentlicht
Android HCE AID-Routing: So wählt dein Smartphone die antwortende App aus

Einführung

Wenn du ein Android-Smartphone an ein Lesegerät hältst, antwortet genau eine App, auch wenn mehrere Apps eine Karte emulieren können. Android entscheidet anhand der Application ID (AID), die das Lesegerät anfordert, einer Routing-Tabelle im NFC-Controller und einer kurzen Liste von Konfliktregeln. Dieser Leitfaden beschreibt diesen Ablauf für Host Card Emulation, die Android seit Version 4.4 unterstützt.

Was das Lesegerät tatsächlich sendet

Das Erste, was ein Lesegerät üblicherweise sendet, ist ein SELECT AID-Befehl. Er ist ein APDU, wird über ISO-DEP übertragen und enthält eine AID mit bis zu 16 Bytes, die die gewünschte Anwendung benennt. Laut Android-HCE-Leitfaden extrahiert Android diese AID, ordnet sie einem HCE-Service zu und leitet das APDU an diesen Service weiter.

Ab da erhält der Service jedes APDU des Lesegeräts, bis das Lesegerät ein weiteres SELECT AID sendet, das zu einem anderen Service führt, oder bis die NFC-Verbindung abbricht. In beiden Fällen wird der Callback onDeactivated() des Services ausgeführt.

Zwei Ebenen: erst die Controller-Tabelle, dann Android

Das Routing findet zweimal statt. Zuerst führt der NFC-Controller eine Routing-Tabelle mit Regeln, die jeweils eine AID mit einem Ziel verknüpfen: der Host-CPU oder einem Secure Element. Trifft SELECT AID ein, prüft der Controller seine Tabelle. Bei einem Treffer gehen dieses APDU und alle folgenden an das passende Ziel.

Steht die AID nicht in der Tabelle, verwendet der Controller seine Standardroute. Android-Geräte müssen sicherstellen, dass die AIDs, die deine App registriert, den Host erreichen. Diese Tabelle baust du nie selbst auf. Android konfiguriert sie anhand der installierten Services und der Einstellungen des Nutzers. Außerdem unterstützt Android auf HCE-Geräten nicht das Konzept der teilweisen AID-Übereinstimmung aus ISO 7816-4.

Zweitens ordnet Android die AID einem Service zu, sobald das APDU den Host erreicht. Apps, die ihre Karte in einem Secure Element halten, deklarieren stattdessen einen Off-Host-Service. Android startet diese nie und bindet sich auch nicht an sie, weil das Secure Element die Transaktion abwickelt.

AID-Gruppen und Kategorien

Ein Service registriert AIDs in Gruppen. Für jede AID einer Gruppe garantiert Android eines von zwei Ergebnissen: Entweder werden alle an deinen Service geleitet oder keine. Eine halbe Gruppe geht nie an eine andere App.

Jede Gruppe hat außerdem eine Kategorie, entweder payment oder other. Es kann immer nur eine Gruppe der Kategorie payment aktiviert sein. Closed-Loop-Karten, etwa eine Guthabenkarte, die nur bei einem einzelnen Händler funktioniert, gehören in other, wo Gruppen dauerhaft aktiv bleiben können. Eine App der Kategorie payment kann einen Tap nur verarbeiten, wenn der Nutzer sie zur Standard-Zahlungs-App gemacht hat (ab Android 15 die Wallet-Rolle) oder wenn sie im Vordergrund läuft und setPreferredService aufgerufen hat.

Wer einen Konflikt gewinnt

Mehrere Services können dieselbe AID registrieren. Android löst das in dieser Reihenfolge auf:

  1. Hat die Standard-Wallet-App des Nutzers die AID registriert, wird diese App aufgerufen.
  2. Andernfalls wird der Service aufgerufen, der die AID registriert hat.
  3. Haben mehrere Services sie registriert, fragt Android den Nutzer.

Eine Vordergrund-App kann all das überschreiben. Die CardEmulation-Referenz beschreibt setPreferredService: Rufe es in onResume() auf und unsetPreferredService in onPause(), denn das Betriebssystem speichert die Einstellung nicht dauerhaft. Der Aufruf kann fehlschlagen, wenn der Nutzer Vordergrund-Apps daran gehindert hat, den Standard-Zahlungsservice zu überschreiben.

AIDs stammen meist aus der apduservice.xml im Manifest und werden hexadezimal mit einer geraden Anzahl an Zeichen geschrieben. Apps können auch registerAidsForService aufrufen, was die frühere Liste für diese Kategorie ersetzt. Manche Geräte akzeptieren ein AID-Präfix wie A000000004*, und supportsAidPrefixRegistration() verrät dir, ob deines das tut.

Wenn die falsche App antwortet

Erreicht ein Tap die falsche App, gehe diese Liste durch:

  • Ist die AID-Gruppe aufgeteilt? Verschiebe die AIDs, die zusammengehören, in eine Gruppe.
  • Ist eine andere App die Standard-Wallet? Sie sticht deinen Service bei jeder AID aus, die sie registriert hat.
  • Liegt deine Gruppe in payment, obwohl sie in other gehören sollte?
  • Verlässt du dich auf Präfix-Matching bei einem Gerät, das es nicht anbietet?
  • Hast du vergessen, setPreferredService nach dem Fortsetzen der Activity erneut aufzurufen?

NFCore liest, beschreibt und analysiert NFC-Tags auf iOS und Android. Es ist kein Werkzeug, um HCE-Routing nachzuverfolgen. Nutze für diese Prüfungen daher ein zweites Lesegerät und beobachte, welcher Service das SELECT AID protokolliert.

Fazit

Android beantwortet einen Tap in zwei Schritten: Die Routing-Tabelle des NFC-Controllers leitet die AID an den Host oder ein Secure Element, und Android wählt dann einen Service anhand von Wallet-Standard, einzigem Registrierenden oder Nutzerentscheidung, wobei eine Vordergrund-App das überschreiben kann. Halte zusammengehörige AIDs in einer Gruppe, wähle die richtige Kategorie und setze den bevorzugten Service bei jedem Fortsetzen.

Häufig gestellte Fragen

Wie entscheidet Android, welche HCE-App auf einen Tap antwortet?

Das Lesegerät sendet SELECT AID. Android ordnet diese AID einem Service zu: zuerst der Standard-Wallet-App, falls sie die AID registriert hat, dann dem einzigen Service, der sie registriert hat. Haben mehrere sie registriert, fragt Android den Nutzer. Eine Vordergrund-App, die setPreferredService verwendet, überschreibt das.

Können zwei Apps dieselbe AID registrieren?

Ja. Android erlaubt das und löst den Konflikt beim Tap in der oben genannten Reihenfolge auf. Haben mehrere Services die AID registriert und keiner ist bevorzugt, wird der Nutzer gefragt.

Unterstützt Android AID-Präfix-Matching?

Teilweise Übereinstimmungen nach ISO 7816-4 werden auf Android-HCE-Geräten nicht unterstützt, doch manche Geräte erlauben es einer App, ein AID-Präfix zu registrieren. Rufe supportsAidPrefixRegistration() auf, um das zu prüfen.

Kann eine AID-Gruppe auf zwei Apps aufgeteilt werden?

Nein. Entweder werden alle AIDs der Gruppe an den Service geleitet oder keine.