Roteamento de AID no HCE do Android: como o celular escolhe qual app responde
Quando um leitor envia SELECT AID, o Android escolhe um serviço HCE para responder. Veja como a tabela de roteamento, os grupos de AID, as categorias e as regras de conflito definem qual será.
Introdução
Quando você encosta um celular Android em um leitor, apenas um app responde, mesmo que vários apps possam emular um cartão. O Android decide usando o Application ID (AID) que o leitor solicita, uma tabela de roteamento no controlador NFC e uma pequena lista de regras de conflito. Este guia mostra esse caminho para o host card emulation, que o Android oferece desde a versão 4.4.
O que o leitor realmente envia
A primeira coisa que um leitor costuma enviar é um comando SELECT AID. Ele é um APDU transportado por ISO-DEP e contém um AID de até 16 bytes que indica a aplicação que o leitor quer. Segundo o guia de HCE do Android, o Android extrai esse AID, o associa a um serviço HCE e encaminha o APDU para esse serviço.
A partir daí, o serviço recebe todos os APDUs do leitor, até que o leitor envie outro SELECT AID que aponte para um serviço diferente, ou até que o link NFC seja interrompido. Nos dois casos, o callback onDeactivated() do serviço é executado.
Duas camadas: a tabela do controlador e depois o Android
O roteamento acontece duas vezes. Primeiro, o controlador NFC mantém uma tabela de roteamento com regras, cada uma associando um AID a um destino: a CPU do host ou um secure element. Quando o SELECT AID chega, o controlador consulta a tabela. Se houver correspondência, esse APDU e todos os seguintes vão para o destino correspondente.
Se o AID não estiver na tabela, o controlador usa a rota padrão. Os dispositivos Android precisam garantir que os AIDs registrados pelo seu app cheguem ao host. Você nunca monta essa tabela por conta própria. O Android a configura a partir dos serviços instalados e das preferências do usuário. O Android também não oferece suporte, em dispositivos HCE, à ideia de correspondência parcial de AID da ISO 7816-4.
Segundo, quando o APDU chega ao host, o Android associa o AID a um serviço. Apps que mantêm o cartão em um secure element declaram um serviço off-host. O Android nunca inicia nem se conecta a esses serviços, porque o secure element cuida da transação.
Grupos de AID e categorias
Um serviço registra AIDs em grupos. Para cada AID de um grupo, o Android garante um de dois resultados: todos são roteados para o seu serviço, ou nenhum é. Metade de um grupo nunca vai para outro app.
Cada grupo também tem uma categoria, que pode ser payment ou other. Apenas um grupo da categoria payment pode estar ativado por vez. Cartões de circuito fechado, como um cartão de valor armazenado que funciona em um único estabelecimento, pertencem a other, em que os grupos podem ficar ativos o tempo todo. Um app da categoria payment só pode atender a um toque se o usuário o tiver definido como app de pagamento padrão (a função Carteira no Android 15 e posteriores) ou se ele estiver em primeiro plano e tiver chamado setPreferredService.
Quem vence um conflito
Vários serviços podem registrar o mesmo AID. O Android resolve isso nesta ordem:
- Se o app de carteira padrão do usuário registrou o AID, esse app é acionado.
- Caso contrário, o serviço que registrou o AID é acionado.
- Se mais de um serviço o registrou, o Android pergunta ao usuário.
Um app em primeiro plano pode sobrepor tudo isso. A referência de CardEmulation descreve o setPreferredService: chame-o em onResume() e chame unsetPreferredService em onPause(), porque o sistema não mantém a preferência. A chamada pode falhar se o usuário tiver bloqueado a sobreposição do serviço de pagamento padrão por apps em primeiro plano.
Os AIDs normalmente vêm do apduservice.xml no manifesto, escritos em hexadecimal com um número par de caracteres. Os apps também podem chamar registerAidsForService, que substitui a lista anterior dessa categoria. Alguns dispositivos aceitam um prefixo de AID como A000000004*, e supportsAidPrefixRegistration() informa se o seu aceita.
Quando o app errado responde
Se um toque chegar ao app errado, siga esta lista:
- O grupo de AID está dividido? Coloque os AIDs que pertencem juntos em um único grupo.
- Outro app é a carteira padrão? Ele tem prioridade sobre o seu serviço para qualquer AID que tenha registrado.
- Seu grupo está em
paymentquando deveria estar emother? - Você está dependendo de correspondência por prefixo em um dispositivo que não a oferece?
- Você esqueceu de chamar
setPreferredServicede novo depois que a activity voltou ao primeiro plano?
O NFCore lê, grava e inspeciona tags NFC no iOS e no Android. Ele não é uma ferramenta para rastrear o roteamento de HCE, então, para essas verificações, use um segundo leitor e observe qual serviço registra o SELECT AID nos logs.
Conclusão
O Android responde a um toque em duas etapas: a tabela de roteamento do controlador NFC envia o AID para o host ou para um secure element, e depois o Android escolhe um serviço pelo padrão da carteira, pelo único registrante ou pela escolha do usuário, com um app em primeiro plano podendo sobrepor essa decisão. Mantenha AIDs relacionados em um único grupo, escolha a categoria certa e defina o serviço preferido a cada retomada.
Perguntas frequentes
Como o Android decide qual app HCE responde a um toque?
O leitor envia SELECT AID. O Android associa esse AID a um serviço: primeiro o app de carteira padrão, se ele registrou o AID, depois o único serviço que o registrou. Se vários o registraram, o Android pergunta ao usuário. Um app em primeiro plano que use setPreferredService sobrepõe essa ordem.
Dois apps podem registrar o mesmo AID?
Sim. O Android permite e resolve o conflito no momento do toque, usando a ordem acima. Se mais de um serviço registrou o AID e nenhum é o preferido, o usuário é consultado.
O Android oferece suporte a correspondência por prefixo de AID?
Correspondências parciais da ISO 7816-4 não são suportadas em dispositivos Android com HCE, mas alguns dispositivos permitem que um app registre um prefixo de AID. Chame supportsAidPrefixRegistration() para verificar.
Um grupo de AID pode ser dividido entre dois apps?
Não. Ou todos os AIDs do grupo são roteados para o serviço, ou nenhum é.