Visão geral da emulação de cartão baseada em host

Muitos dispositivos com tecnologia Android que oferecem a funcionalidade NFC já são compatíveis com emulação de cartão NFC. Na maioria dos casos, o cartão é emulado por um chip separado no dispositivo, chamado de Elemento de segurança. Muitos chips fornecidos por operadoras de celular também contêm um elemento de segurança.

O Android 4.4 e versões mais recentes oferecem um outro método de emulação de cartão que não envolve um elemento de segurança, chamado emulação de cartão com base no host. Isso permite que qualquer app Android emule um cartão e se comunique diretamente com o leitor de NFC. Este tópico descreve como a emulação de cartão baseada em host (HCE, na sigla em inglês) funciona no Android e como desenvolver um app que emula um cartão NFC usando essa técnica.

Emulação de cartão com um Elemento de segurança

Quando a emulação de cartão NFC é fornecida usando um Elemento de segurança, o cartão a ser emulado é provisionado no Elemento de segurança do dispositivo por um app Android. Em seguida, quando o usuário segura o dispositivo sobre um terminal NFC, o controlador NFC no dispositivo encaminha todos os dados do leitor diretamente para o elemento de segurança. A Figura 1 ilustra esse conceito:

Diagrama com o leitor NFC passando por um controlador NFC para recuperar informações de um elemento de segurança
Figura 1. Emulação de cartão de NFC com um elemento de segurança.

O próprio elemento de segurança realiza a comunicação com o terminal NFC, e nenhum app Android está envolvido na transação. Depois que a transação é concluída, um app Android pode consultar o elemento de segurança diretamente para saber o status da transação e notificar o usuário.

Emulação de cartão com base no host

Quando um cartão NFC é emulado usando a emulação de cartão com base em host, os dados são roteados diretamente para a CPU do host, em vez de serem roteados para um elemento de segurança. A Figura 2 ilustra como a emulação de cartão com base em host funciona:

Diagrama com o leitor NFC passando por um controlador NFC para recuperar informações da CPU
Figura 2. Emulação de cartão de NFC sem um elemento de segurança.

Cartões e protocolos de NFC compatíveis

Diagrama mostrando a pilha de protocolos de HCE
Figura 3. Pilha de protocolo HCE do Android.

Os padrões NFC oferecem suporte para muitos protocolos diferentes, e há vários tipos de cartões que você pode emular.

O Android 4.4 e versões mais recentes oferecem suporte a vários protocolos comuns no mercado atual. Muitos cartões por aproximação já usam esses protocolos, como os cartões de pagamento por aproximação. Esses protocolos também são compatíveis com muitos leitores NFC no mercado atual, incluindo dispositivos Android NFC que funcionam como leitores (consulte a classe IsoDep). Isso permite criar e implantar uma solução de NFC completa em torno da HCE usando apenas dispositivos Android.

Especificamente, o Android 4.4 e versões mais recentes oferecem suporte à emulação de cartões baseados na especificação ISO-DEP do NFC-Forum (com base na ISO/IEC 14443-4) e processam unidades de dados de protocolo de aplicativo (APDUs, na sigla em inglês), conforme definido na especificação ISO/IEC 7816-4. O Android exige a emulação de ISO-DEP apenas sobre a tecnologia Nfc-A (ISO/IEC 14443-3 Tipo A). O suporte à tecnologia Nfc-B (ISO/IEC 14443-4 Tipo B) é opcional. A Figura 3 ilustra as camadas de todas essas especificações.

Serviços de HCE

A arquitetura de HCE no Android é baseada em componentes Service do Android, conhecidos como serviços de HCE. Uma das principais vantagens de um serviço é que ele pode ser executado em segundo plano sem qualquer interface do usuário. Isso é ideal para muitos aplicativos de HCE, como cartões de fidelidade ou de transporte público, que o usuário não precisa abrir um app para usar. Em vez disso, tocar o dispositivo no leitor NFC inicia o serviço correto, se ele ainda não estiver em execução, e executa a transação em segundo plano. É claro que você pode iniciar outras interfaces (como notificações do usuário) no seu serviço quando apropriado.

Seleção de serviço

Quando o usuário aproxima um dispositivo de um leitor de NFC, o sistema Android precisa saber com qual serviço de HCE o leitor de NFC quer se comunicar. A especificação ISO/IEC 7816-4 define uma maneira de selecionar aplicativos, centrada em um ID do aplicativo (AID). Um AID consiste em até 16 bytes. Se você estiver emulando cartões para uma infraestrutura de leitor de NFC, os AIDs que esses leitores procuram geralmente são conhecidos e registrados publicamente (por exemplo, os AIDs de redes de pagamento, como Visa e MasterCard).

Se você quiser implantar uma nova infraestrutura de leitor para seu aplicativo, registre seus próprios AIDs. O procedimento de registro para AIDs é definido na especificação ISO/IEC 7816-5. Recomendamos registrar um AID de acordo com a norma 7816-5 se você estiver implantando um aplicativo de HCE para Android, porque isso evita colisões com outros aplicativos.

Grupos de AID

Em alguns casos, um serviço de HCE pode precisar registrar vários AIDs e ser definido como o gerenciador padrão para todos os AIDs para implementar um determinado aplicativo. Não é possível que alguns AIDs do grupo sejam direcionados para outro serviço.

Uma lista de AIDs mantidos juntos é chamada de grupo de AIDs. Para todos os AIDs em um grupo, o Android garante uma das seguintes opções:

  • Todos os AIDs no grupo são roteados para esse serviço de HCE.
  • Nenhum AID no grupo é roteado para esse serviço de HCE (por exemplo, porque o usuário preferiu outro serviço que também solicitou um ou mais AIDs no seu grupo).

Em outras palavras, não há um estado intermediário em que alguns AIDs do grupo possam ser roteados para um serviço de HCE e outros para outro.

Categorias e grupos de AID

É possível associar cada grupo de AID a uma categoria. Isso permite que o Android agrupe serviços de HCE por categoria, o que permite que o usuário defina padrões no nível da categoria, em vez do nível do AID. Evite mencionar AIDs em qualquer parte do aplicativo voltada ao usuário, porque eles não significam nada para o usuário comum.

O Android 4.4 e versões mais recentes oferecem suporte a duas categorias:

Os apps que registram AIDs em CATEGORY_PAYMENT só podem processar uma transação se:

  • O usuário define o app como o app de pagamento padrão (titular da função de carteira em dispositivos Android 15+), OU
  • O app está em primeiro plano e invoca setPreferredService.

Implementar um serviço de HCE

Para emular um cartão NFC usando a emulação de cartão baseada em host, é necessário criar um componente Service que processe as transações por NFC.

Verificar se há suporte para HCE

Seu aplicativo pode verificar se um dispositivo é compatível com HCE procurando o recurso FEATURE_NFC_HOST_CARD_EMULATION. Use a tag <uses-feature> no manifesto do aplicativo para declarar que o app usa o recurso HCE e se ele é necessário para o funcionamento do app.

Implementação do serviço

O Android 4.4 e versões mais recentes oferecem uma classe Service de conveniência que pode ser usada como base para implementar um serviço de HCE: a classe HostApduService.

A primeira etapa é estender HostApduService, conforme mostrado no exemplo de código abaixo:

class MyHostApduService : HostApduService() {

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

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

HostApduService declara dois métodos abstratos que você precisa substituir e implementar. Um deles, processCommandApdu(), é chamado sempre que um leitor NFC envia uma unidade de dados de protocolo de aplicativo (APDU, na sigla em inglês) ao seu serviço. As APDUs são definidas na especificação ISO/IEC 7816-4. As APDUs são os pacotes no nível do aplicativo que estão sendo trocados entre o leitor de NFC e seu serviço de HCE. Esse protocolo no nível do aplicativo é half-duplex: o leitor de NFC envia um comando APDU e aguarda o envio de uma resposta APDU em retorno.

Como mencionado anteriormente, o Android usa o AID para determinar com qual serviço de HCE o leitor quer se comunicar. Normalmente, a primeira APDU que um leitor de NFC envia ao seu dispositivo é uma APDU SELECT AID, que contém o AID com que o leitor quer se comunicar. O Android extrai esse AID da APDU, o resolve para um serviço de HCE e encaminha essa APDU para o serviço resolvido.

É possível enviar uma APDU de resposta retornando os bytes da APDU de resposta de processCommandApdu(). Esse método é chamado na linha de execução principal do aplicativo, que não pode ser bloqueada. Se não for possível calcular e retornar uma APDU de resposta imediatamente, retorne nulo. Em seguida, você pode fazer o trabalho necessário em outra linha de execução e usar o método sendResponseApdu(), definido na classe HostApduService, para enviar a resposta quando terminar.

O Android continua encaminhando novas APDUs do leitor para seu serviço até que uma das seguintes situações ocorra:

  • O leitor de NFC envia outra APDU SELECT AID, que o SO resolve para um serviço diferente.
  • o link de NFC entre o leitor de NFC e seu dispositivo seja quebrado.

Nesses dois casos, a implementação de onDeactivated() da classe é chamada com um argumento que indica qual das duas situações ocorreu.

Se você estiver trabalhando com uma infraestrutura de leitor, será necessário implementar o protocolo no nível do aplicativo que os leitores esperam no seu serviço de HCE.

Se você estiver implantando uma nova infraestrutura de leitor que também controla, poderá definir seu próprio protocolo e sequência de APDU. Tente limitar a quantidade de APDUs e o tamanho dos dados a serem trocados: isso garante que os usuários só precisem manter o dispositivo sobre o leitor de NFC por um curto período. Um limite superior razoável é de cerca de 1 KB de dados, que geralmente podem ser trocados em 300 ms.

Declaração de manifesto de serviço e registro de AID

Você precisa declarar o serviço no manifesto como de costume, mas também precisa adicionar algumas outras partes à declaração do serviço:

  1. Para informar à plataforma que se trata de um serviço de HCE que implementa uma interface HostApduService, adicione um filtro de intent para a ação SERVICE_INTERFACE à declaração do serviço.

  2. Para informar à plataforma quais grupos de AIDs são solicitados por esse serviço, inclua uma tag SERVICE_META_DATA <meta-data> na declaração do serviço, apontando para um recurso XML com mais informações sobre o serviço de HCE.

  3. Defina o atributo android:exported como true e exija a permissão android.permission.BIND_NFC_SERVICE na declaração do serviço. O primeiro garante que o serviço possa ser vinculado por apps externos. O último garante que apenas aplicativos externos com a permissão android.permission.BIND_NFC_SERVICE possam se vincular ao serviço. Como android.permission.BIND_NFC_SERVICE é uma permissão do sistema, isso garante que apenas o SO Android possa se vincular ao seu serviço.

Confira a seguir um exemplo de declaração de manifesto 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>

Essa tag de metadados aponta para um arquivo apduservice.xml. Veja a seguir um exemplo de um arquivo desse tipo com uma única declaração de grupo de AID contendo dois AIDs proprietários:

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

A tag <host-apdu-service> precisa conter um atributo <android:description> com uma descrição fácil de usar do serviço que pode ser mostrada na interface do app. Use o atributo requireDeviceUnlock para especificar que o dispositivo precisa ser desbloqueado antes de invocar esse serviço para processar APDUs.

O <host-apdu-service> precisa conter uma ou mais tags <aid-group>. Cada tag <aid-group> precisa fazer o seguinte:

  • Ter um atributo android:description que contenha uma descrição fácil de usar do grupo de AID, adequada para exibição na interface.
  • Ter o atributo android:category definido para indicar a categoria a que o grupo de AID pertence, como as constantes de string definidas por CATEGORY_PAYMENT ou CATEGORY_OTHER.
  • Contém uma ou mais tags <aid-filter>, cada uma com um único AID. Especifique o AID no formato hexadecimal e verifique se ele contém um número par de caracteres.

O aplicativo também precisa ter a permissão NFC para se registrar como um serviço de HCE.

Resolução de conflitos de AID

Vários componentes HostApduService podem ser instalados em um único dispositivo, e o mesmo AID pode ser registrado por mais de um serviço. O Android determina qual serviço invocar seguindo estas etapas:

  1. Se o app de carteira padrão selecionado pelo usuário tiver registrado o AID, esse app será invocado.
  2. Se o app de carteira padrão não tiver registrado o AID, o serviço que o registrou será invocado.
  3. Se mais de um serviço tiver registrado o AID, o Android vai perguntar ao usuário qual serviço invocar.

Preferência de serviço em primeiro plano

Os apps em primeiro plano podem invocar setPreferredService para especificar qual serviço de emulação de cartão deve ser preferencial enquanto uma atividade específica está em primeiro plano. Essa preferência de aplicativo em primeiro plano substitui a resolução de conflitos de AID. Essa é uma prática recomendada quando o app prevê que o usuário pode usar a emulação de cartão NFC.

Android 13 e versões mais recentes

Para se ajustar melhor à lista de seleção de pagamento padrão na interface de configurações, ajuste o requisito do banner para um ícone quadrado. O ideal é que ele seja idêntico ao design do ícone do inicializador do aplicativo. Esse ajuste cria mais consistência e uma aparência mais limpa.

Android 12 e versões anteriores

Defina o tamanho do banner de serviço como 260 x 96 dp e, em seguida, defina o tamanho do banner de serviço no arquivo XML de metadados adicionando o atributo android:apduServiceBanner à tag <host-apdu-service>, que aponta para o recurso drawable. Confira o seguinte exemplo:

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

Aplicativos de carteira

O Android 15 e versões mais recentes incluem uma função padrão de app de carteira que o usuário pode selecionar em Configurações > Apps > Apps padrão. Isso define o aplicativo de carteira padrão a ser invocado quando um terminal de pagamento é tocado. O Android considera os serviços de HCE que declararam um grupo de AID com a categoria de pagamento como aplicativos de carteira.

Verificar se o app é o padrão da carteira

Os apps podem verificar se são o app de carteira padrão transmitindo RoleManager.ROLE_WALLET para RoleManager.isRoleHeld().

Se o app não for o padrão, você poderá solicitar o papel de carteira padrão transmitindo RoleManager.ROLE_WALLET para RoleManager.createRequestRoleIntent().

Recursos necessários para aplicativos de carteira

Para oferecer uma experiência do usuário mais atraente, os aplicativos de carteira de HCE precisam fornecer um banner de serviço.

Modo de observação

O Android 15 apresenta o recurso Modo de observação. Quando ativado, o Modo de Observação permite que o dispositivo observe loops de sondagem NFC e envie notificações sobre eles aos componentes HostApduService apropriados para que eles possam se preparar para interagir com um determinado terminal NFC. Um HostApduService pode colocar o dispositivo no Modo de Observação transmitindo true para setObserveModeEnabled(). Isso instrui a pilha NFC a não permitir transações por NFC e, em vez disso, observar passivamente os loops de sondagem.

Filtros de loop de sondagem

É possível registrar filtros de loop de sondagem para um HostApduService usando um dos seguintes métodos:

Quando um filtro de loop de sondagem corresponde a frames de sondagem não padrão, a pilha de NFC encaminha esses frames para o HostApduService correspondente chamando o método processPollingFrames(). Isso permite que o serviço tome as medidas necessárias para garantir que o usuário esteja pronto para realizar a transação e pretenda fazer isso, por exemplo, autenticando o usuário. Se um leitor de NFC estiver usando apenas frames padrão no loop de sondagem, a pilha de NFC vai encaminhar esses frames de sondagem para o serviço em primeiro plano preferencial, se esse serviço estiver em primeiro plano, ou para o titular da função de carteira padrão, caso contrário.

As notificações de frame de sondagem também incluem uma medição de intensidade de campo específica do fornecedor que pode ser recuperada chamando getVendorSpecificGain(). Os fornecedores podem fornecer medições usando a própria escala, desde que ela caiba em um único byte.

Responder a loops de sondagem e sair do modo de observação

Quando o serviço estiver pronto para realizar transações, ele poderá sair do Modo de Observação transmitindo false para setObserveModeEnabled(). A pilha de NFC vai permitir que as transações prossigam.

Os componentes HostApduService podem indicar que o Modo de Observação precisa ser ativado sempre que forem o serviço de pagamento preferencial, definindo shouldDefaultToObserveMode como true no manifesto ou chamando CardEmulation.setShouldDefaultToObserveModeForService().

Os componentes HostApduService e OffHostApduService também podem indicar que os filtros de loop de sondagem que correspondem aos frames de loop de sondagem recebidos precisam desativar automaticamente o Modo de Observação e permitir que as transações continuem definindo autoTransact como true na declaração PollingLoopFilter no manifesto.

Preferência de serviço em primeiro plano

Os apps em primeiro plano podem invocar setPreferredService para especificar qual serviço de emulação de cartão deve ser preferencial enquanto uma atividade específica está em primeiro plano. Essa preferência de aplicativo em primeiro plano substitui o estado do Modo de Observação do dispositivo correspondente ao valor de shouldDefaultToObserveMode para um determinado serviço, que pode ser definido de uma das seguintes maneiras:

Tela desativada e comportamento da tela de bloqueio

O comportamento dos serviços de HCE varia de acordo com a versão do Android em execução no dispositivo.

Android 15 e versões mais recentes

Se o app de carteira padrão ativar o Modo de Observação em um dispositivo compatível, ele vai substituir o comportamento de desbloqueio e tela desligada, porque controla quando uma transação pode continuar. Alguns apps de carteira podem exigir que o dispositivo seja desbloqueado antes que uma transação possa continuar se o Modo de Observação não detectar um padrão de loop de sondagem identificável.

Recomendamos que os desenvolvedores trabalhem com os dispositivos de leitura para emitir padrões de loop de sondagem identificáveis e se registrem para processar esses padrões no app.

Android 12 e versões mais recentes

Em apps destinados ao Android 12 (nível 31 da API) e versões mais recentes, é possível ativar pagamentos por aproximação sem que a tela do dispositivo esteja ligada. Para isso, defina requireDeviceScreenOn como false.

Android 10 e versões mais recentes

Dispositivos com o Android 10 (nível 29 da API) ou versões mais recentes oferecem suporte à NFC segura. Enquanto a NFC segura estiver ativada, todos os emuladores de cartão (aplicativos hospedados e fora do host) vão ficar indisponíveis quando a tela do dispositivo estiver desligada. Enquanto a NFC segura estiver desativada, os aplicativos fora do host vão ficar disponíveis quando a tela do dispositivo estiver desligada. É possível verificar se há suporte para NFC segura usando isSecureNfcSupported().

Em dispositivos com o Android 10 e versões mais recentes, a mesma funcionalidade para definir android:requireDeviceUnlock como true se aplica aos dispositivos com o Android 9 e versões anteriores, mas apenas quando a NFC segura está desativada. Ou seja, se a NFC segura estiver ativada, os serviços de HCE não poderão funcionar na tela de bloqueio, independentemente da configuração de android:requireDeviceUnlock.

Android 9 e versões anteriores

Em dispositivos com o Android 9 (nível 28 da API) e versões anteriores, o controlador NFC e o processador de aplicativo são totalmente desativados quando a tela do dispositivo é desligada. Portanto, os serviços de HCE não funcionam quando a tela está desligada.

No Android 9 e versões anteriores, os serviços de HCE também podem funcionar na tela de bloqueio. No entanto, isso é controlado pelo atributo android:requireDeviceUnlock na tag <host-apdu-service> do serviço de HCE. Por padrão, o desbloqueio do dispositivo não é necessário, e o serviço é invocado mesmo que o dispositivo esteja bloqueado.

Se você definir o atributo android:requireDeviceUnlock como true para o serviço HCE, o Android vai pedir que o usuário desbloqueie o dispositivo quando o seguinte acontecer:

  • o usuário toca em um leitor de NFC.
  • o leitor de NFC seleciona um AID que é resolvido para seu serviço.

Depois de desbloquear, o Android mostra uma caixa de diálogo solicitando que o usuário toque novamente para concluir a transação. Isso é necessário porque o usuário pode ter afastado o dispositivo do leitor de NFC para desbloqueá-lo.

Coexistência com cartões de elemento de segurança

Esta seção é de interesse para desenvolvedores que implantaram um aplicativo que depende de um elemento de segurança para emulação de cartão. A implementação de HCE do Android foi projetada para funcionar em paralelo com outros métodos de implementação de emulação de cartão, incluindo o uso de elementos de segurança.

Essa coexistência é baseada em um princípio chamado roteamento de AID. O controlador NFC mantém uma tabela de roteamento que consiste em uma lista (finita) de regras de rota. Cada regra de roteamento contém um AID e um destino. O destino pode ser a CPU do host, em que os apps Android estão em execução, ou um elemento de segurança conectado.

Quando o leitor de NFC envia uma APDU com um SELECT AID, o controlador de NFC a analisa e verifica se os AIDs correspondem a algum AID na tabela de roteamento. Se houver uma correspondência, essa APDU e todas as seguintes serão enviadas ao destino associado ao AID, até que outra APDU SELECT AID seja recebida ou o link de NFC seja quebrado.

A Figura 4 ilustra essa arquitetura:

Diagrama com o leitor de NFC se comunicando com um elemento de segurança e a CPU
Figura 4. O Android opera com o elemento de segurança e a emulação de cartão host.

O controlador de NFC normalmente também contém uma rota padrão para APDUs. Quando um AID não é encontrado na tabela de roteamento, a rota padrão é usada. Embora essa configuração possa ser diferente de um dispositivo para outro, os dispositivos Android precisam garantir que os AIDs registrados pelo app sejam roteados corretamente para o host.

Os apps Android que implementam um serviço de HCE ou que usam um elemento de segurança não precisam se preocupar com a configuração da tabela de roteamento, que é processada pelo Android automaticamente. O Android só precisa saber quais AIDs podem ser processados pelos serviços de HCE e quais podem ser processados pelo elemento de segurança. A tabela de roteamento é configurada automaticamente com base nos serviços instalados e nos que o usuário configurou como preferenciais.

A seção a seguir explica como declarar AIDs para aplicativos que usam um elemento de segurança para emulação de cartão.

Registro do AID do elemento de segurança

Os aplicativos que usam um Elemento de segurança para emulação de cartão podem declarar um serviço fora do host no manifesto. A declaração desse serviço é quase idêntica à de um serviço de HCE. As exceções são as seguintes:

  • A ação usada no filtro de intent precisa ser definida como SERVICE_INTERFACE.
  • O atributo de nome dos metadados precisa ser definido como SERVICE_META_DATA.
  • O arquivo XML de metadados precisa usar a tag raiz <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>

Veja a seguir um exemplo do arquivo apduservice.xml correspondente registrando dois AIDs:

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

O atributo android:requireDeviceUnlock não se aplica a serviços fora do host, porque a CPU do host não está envolvida na transação e, portanto, não pode impedir que o elemento de segurança execute transações quando o dispositivo está bloqueado.

O atributo android:apduServiceBanner é obrigatório para serviços fora do host que são aplicativos de pagamento e para ser selecionável como um aplicativo de pagamento padrão.

Invocação de serviço fora do host

O Android nunca inicia ou se vincula a um serviço declarado como "fora do host", porque as transações reais são executadas pelo elemento de segurança, e não pelo serviço do Android. A declaração de serviço apenas permite que os aplicativos registrem AIDs presentes no elemento de segurança.

HCE e segurança

A arquitetura de HCE oferece um elemento de segurança essencial: como seu serviço é protegido pela permissão do sistema BIND_NFC_SERVICE, somente o SO pode se vincular e se comunicar com ele. Isso garante que qualquer APDU recebida seja realmente uma APDU recebida pelo SO do controlador NFC e que qualquer APDU enviada de volta seja enviada apenas para o SO, que, por sua vez, encaminha diretamente as APDUs para o controlador NFC.

A última preocupação é de onde você recebe os dados que o app envia para o leitor de NFC. Isso é intencionalmente dissociado no design da HCE. Não importa de onde os dados vêm, apenas que sejam transportados com segurança para o controlador NFC e para o leitor NFC.

Para armazenar e recuperar com segurança os dados que você quer enviar do seu serviço HCE, use, por exemplo, o sandbox de apps Android, que isola os dados do seu app de outros. Para mais detalhes sobre a segurança do Android, leia as Dicas de segurança.

Parâmetros de protocolo e detalhes

Esta seção é de interesse dos desenvolvedores que querem entender quais parâmetros de protocolo os dispositivos HCE usam durante as fases de anticolisão e ativação dos protocolos NFC. Isso permite criar uma infraestrutura de leitor compatível com dispositivos Android HCE.

Anticolisão e ativação do protocolo Nfc-A (ISO/IEC 14443 tipo A)

Como parte da ativação do protocolo Nfc-A, vários frames são trocados.

Na primeira parte da troca, o dispositivo HCE apresenta o UID. É preciso presumir que os dispositivos HCE têm um UID aleatório. Isso significa que, a cada toque, o UID apresentado ao leitor é gerado aleatoriamente. Por isso, os leitores de NFC não devem depender do UID de dispositivos HCE como uma forma de autenticação ou identificação.

O leitor de NFC pode selecionar o dispositivo HCE enviando um comando SEL_REQ. A resposta SEL_RES do dispositivo HCE tem pelo menos o sexto bit (0x20) definido, indicando que o dispositivo é compatível com ISO-DEP. Outros bits no SEL_RES também podem ser definidos, indicando, por exemplo, compatibilidade com o protocolo NFC-DEP (p2p). Como outros bits podem ser definidos, os leitores que quiserem interagir com dispositivos HCE precisam verificar explicitamente apenas o sexto bit e não comparar o SEL_RES completo com um valor de 0x20.

Ativação de ISO-DEP

Depois que o protocolo Nfc-A é ativado, o leitor de NFC inicia a ativação do protocolo ISO-DEP. Ele envia um comando RATS (Request for Answer To Select). O controlador NFC gera a resposta RATS, o ATS. O ATS não é configurável por serviços de HCE. No entanto, as implementações de HCE precisam atender aos requisitos do NFC Forum para a resposta ATS, para que os leitores NFC possam contar com esses parâmetros definidos de acordo com os requisitos do NFC Forum para qualquer dispositivo HCE.

A seção abaixo fornece mais detalhes sobre os bytes individuais da resposta ATS fornecida pelo controlador NFC em um dispositivo HCE:

  • TL: comprimento da resposta ATS. Não pode indicar um comprimento maior que 20 bytes.
  • T0: os bits 5, 6 e 7 precisam ser definidos em todos os dispositivos HCE, indicando que TA(1), TB(1) e TC(1) estão incluídos na resposta ATS. Os bits de 1 a 4 indicam o FSCI, codificando o tamanho máximo do frame. Em dispositivos HCE, o valor de FSCI precisa estar entre 0h e 8h.
  • T(A)1: define as taxas de bits entre o leitor e o emulador e se elas podem ser assimétricas. Não existem requisitos ou garantias de taxa de bits para dispositivos HCE.
  • T(B) 1: os bits 1 a 4 indicam o inteiro de tempo de ativação do frame de inicialização (SFGI, na sigla em inglês). Em dispositivos HCE, o SFGI precisa ser <= 8h. Os bits 5 a 8 indicam o número inteiro do tempo de espera do frame (FWI, na sigla em inglês) e codificam o tempo de espera do frame (FWT, na sigla em inglês). Em dispositivos HCE, o FWI precisa ser <= 8h.
  • T(C) 1: o bit 5 indica suporte para "Recursos avançados do protocolo". Os dispositivos HCE podem ou não oferecer suporte aos "recursos de protocolo avançado". O bit 2 indica suporte para DID. Os dispositivos HCE podem ou não ser compatíveis com DID. O bit 1 indica suporte para NAD. Dispositivos HCE não devem ser compatíveis com NAD e definir o bit 1 como zero.
  • Bytes históricos: os dispositivos HCE podem retornar até 15 bytes históricos. Os leitores NFC que interagem com os serviços de HCE não devem fazer suposições sobre o conteúdo dos bytes históricos ou a presença deles.

Muitos dispositivos HCE provavelmente estão em conformidade com os requisitos de protocolo que as redes de pagamento unidas na EMVCo especificaram na especificação "Protocolo de comunicação por aproximação". Especificamente, as seguintes:

  • O FSCI em T0 precisa estar entre 2h e 8h.
  • T(A)1 precisa ser definido como 0x80, indicando que apenas a taxa de bits de 106 kbit/s é compatível e que taxas de bits assimétricas entre o leitor e o emulador não são compatíveis.
  • O FWI em T(B)1 precisa ser <= 7h.

Troca de dados da APDU

Como observado anteriormente, as implementações de HCE são compatíveis com apenas um canal lógico. A tentativa de selecionar aplicativos em canais lógicos diferentes não funciona em um dispositivo HCE.