Muchos dispositivos con Android que ofrecen la función de NFC ya admiten la emulación de tarjeta NFC. En la mayoría de los casos, la tarjeta se emula usando un chip independiente dentro del dispositivo que se denomina Elemento seguro. Muchas tarjetas SIM que proporcionan los operadores de servicios inalámbricos también contienen un elemento seguro.
Android 4.4 y versiones posteriores proporcionan un método adicional de emulación de tarjeta que no involucra un elemento seguro, que se llama emulación de tarjeta basada en host. Esto permite que cualquier aplicación para Android emule una tarjeta y se comunique directamente con el lector de NFC. En este tema, se describe cómo funciona la emulación de tarjeta basada en el host (HCE) en Android y cómo puedes desarrollar una app que emule una tarjeta NFC con esta técnica.
Emulación de tarjetas con un elemento seguro
Cuando la emulación de tarjeta NFC se proporciona con un elemento seguro, la tarjeta que se emulará se aprovisiona en el elemento seguro del dispositivo a través de una aplicación para Android. Luego, cuando el usuario sostiene el dispositivo sobre una terminal NFC, el controlador NFC del dispositivo enruta todos los datos del lector directamente al elemento seguro. En la Figura 1, se ilustra este concepto:
Figura 1: Emulación de tarjeta NFC con un Elemento seguro
El elemento seguro realiza la comunicación con la terminal NFC, y no hay ninguna aplicación para Android involucrada en la transacción. Una vez que se completa la transacción, una aplicación para Android puede consultar el elemento seguro directamente para conocer el estado de la transacción y notificar al usuario.
Emulación de tarjetas basada en el host
Cuando se emula una tarjeta NFC con la emulación de tarjeta basada en host, los datos se enrutan directamente a la CPU del host en lugar de enrutarse a un elemento seguro. En la Figura 2, se ilustra cómo funciona la emulación de tarjetas basada en el host:
Figura 2: Emulación de tarjeta NFC sin un Elemento seguro
Tarjetas y protocolos NFC compatibles
Figura 3: Pila de protocolos HCE de Android
Los estándares de NFC ofrecen compatibilidad con muchos protocolos diferentes, y hay distintos tipos de tarjetas que puedes emular.
Android 4.4 y versiones posteriores admiten varios protocolos que son comunes en el mercado actual. Muchas tarjetas sin contacto existentes ya se basan en estos protocolos, como las tarjetas de pago sin contacto. Muchos lectores de NFC del mercado actual también admiten estos protocolos, incluidos los dispositivos Android con NFC que funcionan como lectores (consulta la clase IsoDep). Esto te permite compilar e implementar una solución de NFC de extremo a extremo en torno a la HCE con solo dispositivos con tecnología de Android.
Específicamente, Android 4.4 y versiones posteriores admiten la emulación de tarjetas que se basan en la especificación ISO-DEP de NFC-Forum (basada en ISO/IEC 14443-4) y procesan unidades de datos de protocolo de aplicación (APDU), como se define en la especificación ISO/IEC 7816-4. Android exige emular ISO-DEP solo sobre la tecnología Nfc-A (ISO/IEC 14443-3 tipo A). La compatibilidad con la tecnología Nfc-B (ISO/IEC 14443-4 tipo B) es opcional. En la figura 3, se ilustra la disposición en capas de todas estas especificaciones.
Servicios de HCE
La arquitectura de HCE en Android se basa en los componentes Service de Android (conocidos como servicios de HCE). Una de las ventajas clave de un servicio es que se puede ejecutar en segundo plano sin ninguna interfaz de usuario. Esto es ideal para muchas aplicaciones de HCE, como las tarjetas de transporte público o de lealtad, que el usuario no debería necesitar para iniciar una app. En cambio, si acercas el dispositivo al lector NFC, se inicia el servicio correcto si aún no se está ejecutando y se realiza la transacción en segundo plano. Por supuesto, puedes iniciar una IU adicional (como
notificaciones para el usuario) desde tu servicio cuando sea apropiado.
Selección de servicios
Cuando el usuario acerca un dispositivo a un lector de NFC, el sistema Android necesita saber con qué servicio de HCE quiere comunicarse el lector de NFC. La especificación ISO/IEC 7816-4 define una forma de seleccionar aplicaciones, centrada en un ID de aplicación (AID). Un AID consta de hasta 16 bytes. Si emulas tarjetas para una infraestructura de lector NFC existente, los AID que buscan esos lectores suelen ser conocidos y estar registrados públicamente (por ejemplo, los AID de redes de pago como Visa y MasterCard).
Si quieres implementar una infraestructura de lector nueva para tu propia aplicación, debes registrar tus propios AID. El procedimiento de registro de los AID se define en la especificación ISO/IEC 7816-5. Te recomendamos que registres un AID según la norma 7816-5 si implementas una aplicación de HCE para Android, ya que evita colisiones con otras aplicaciones.
Grupos de AID
En algunos casos, es posible que un servicio de HCE deba registrar varios AID y establecerse como el controlador predeterminado para todos los AID con el objetivo de implementar una aplicación determinada. No se admite que algunos AID del grupo vayan a otro servicio.
Una lista de AID que se mantienen juntas se denomina grupo de AID. Para todos los AID de un grupo de AID, Android garantiza una de las siguientes opciones:
- Todos los AID del grupo se enrutan a este servicio de HCE.
- No se enruta ningún AID del grupo a este servicio de HCE (por ejemplo, porque el usuario prefirió otro servicio que también solicitó uno o más AID de tu grupo).
En otras palabras, no hay un estado intermedio en el que algunos AID del grupo se puedan enrutar a un servicio de HCE y otros a otro.
Grupos y categorías de AID
Puedes asociar cada grupo de AID con una categoría. Esto permite que Android agrupe los servicios de HCE por categoría, lo que, a su vez, permite que el usuario establezca valores predeterminados a nivel de la categoría en lugar de a nivel del AID. Evita mencionar los AID en cualquier parte de la aplicación que esté orientada al usuario, ya que no significan nada para el usuario promedio.
Android 4.4 y versiones posteriores admiten dos categorías:
CATEGORY_PAYMENT(abarca las apps de pagos que cumplen con los estándares de la industria)CATEGORY_OTHER(para todas las demás apps de HCE)
Las apps que registran AID en CATEGORY_PAYMENT solo pueden procesar una transacción si se cumplen las siguientes condiciones:
- El usuario establece la app como la app de pagos predeterminada (titular del rol de la Billetera en dispositivos con Android 15 o versiones posteriores).
- La app está en primer plano y, además, invoca
setPreferredService.
Implementa un servicio de HCE
Para emular una tarjeta NFC con la emulación de tarjetas basada en el host, debes crear un componente Service que controle las transacciones NFC.
Verifica la compatibilidad con HCE
Tu aplicación puede verificar si un dispositivo admite HCE comprobando la función FEATURE_NFC_HOST_CARD_EMULATION. Usa la etiqueta <uses-feature> en el manifiesto de tu aplicación para declarar que tu app usa la función de HCE y si es necesaria para que la app funcione o no.
Implementación del servicio
Android 4.4 y versiones posteriores proporcionan una clase Service de conveniencia que puedes usar como base para implementar un servicio de HCE: la clase HostApduService.
El primer paso es extender HostApduService, como se muestra en la siguiente muestra de código:
class MyHostApduService : HostApduService() { override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray { // ... } override fun onDeactivated(reason: Int) { // ... } }
HostApduService declara dos métodos abstractos que debes anular y, luego, implementar. Se llama a uno de ellos,
processCommandApdu(),
cada vez que un lector de NFC envía una unidad de datos de protocolo de aplicación (APDU)
a tu servicio. Las APDU se definen en la especificación ISO/IEC 7816-4. Las APDU son los paquetes a nivel de la aplicación que se intercambian entre el lector de NFC y tu servicio de HCE. Ese protocolo de nivel de aplicación es dúplex medio: el lector de NFC te envía una APDU de comando y espera que le envíes una APDU de respuesta.
Como se mencionó antes, Android usa el AID para determinar con qué servicio de HCE quiere comunicarse el lector. Por lo general, la primera APDU que un lector NFC envía a tu dispositivo es una APDU SELECT AID, que contiene el AID con el que el lector quiere comunicarse. Android extrae ese AID de la APDU, lo resuelve en un servicio de HCE y, luego, reenvía esa APDU al servicio resuelto.
Para enviar una APDU de respuesta, devuelve los bytes de la APDU de respuesta desde
processCommandApdu(). Ten en cuenta que se llama a este método en el subproceso principal de tu aplicación, que no debes bloquear. Si no puedes calcular y devolver
una APDU de respuesta de inmediato, devuelve un valor nulo. Luego, puedes realizar el trabajo necesario en
otro subproceso y usar el método
sendResponseApdu()
definido en la clase HostApduService para enviar la respuesta cuando
termines.
Android sigue reenviando nuevas APDU del lector a tu servicio hasta que ocurra una de las siguientes situaciones:
- El lector de NFC envía otra APDU
SELECT AID, que el SO resuelve en un servicio diferente. - Deja de funcionar el vínculo de NFC entre el lector de NFC y tu dispositivo.
En ambos casos, se llama a la implementación onDeactivated() de tu clase con un argumento que indica cuál de los dos eventos ocurrió.
Si trabajas con una infraestructura de lectores existente, debes implementar el protocolo existente a nivel de la aplicación que los lectores esperan en tu servicio de HCE.
Si implementas una infraestructura de lector nueva que también controlas, puedes definir tu propio protocolo y secuencia de APDU. Intenta limitar la cantidad de APDU y el tamaño de los datos que se intercambiarán. De esta manera, te aseguras de que los usuarios solo tengan que mantener el dispositivo sobre el lector de NFC durante un período breve. Un límite superior razonable es de alrededor de 1 KB de datos, que, por lo general, se pueden intercambiar en un plazo de 300 ms.
Declaración del servicio en el manifiesto y registro del AID
Debes declarar tu servicio en el manifiesto como de costumbre, pero también debes agregar algunos elementos adicionales a la declaración del servicio:
Para indicarle a la plataforma que se trata de un servicio de HCE que implementa una interfaz
HostApduService, agrega un filtro de intents para la acciónSERVICE_INTERFACEa la declaración del servicio.Para indicarle a la plataforma qué grupos de AID solicita este servicio, incluye una etiqueta
SERVICE_META_DATA<meta-data>en la declaración del servicio, que apunte a un recurso XML con información adicional sobre el servicio de HCE.Establece el atributo
android:exportedentruey solicita el permisoandroid.permission.BIND_NFC_SERVICEen la declaración de tu servicio. El primero garantiza que las aplicaciones externas puedan vincularse al servicio. Este último, luego, aplica de manera forzosa que solo las aplicaciones externas que tengan el permisoandroid.permission.BIND_NFC_SERVICEpuedan vincularse a tu servicio. Comoandroid.permission.BIND_NFC_SERVICEes un permiso del sistema, esto aplica de manera forzosa que solo el SO Android pueda vincularse a tu servicio.
El siguiente es un ejemplo de una declaración de manifiesto de 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>
Esta etiqueta de metadatos dirige a un archivo apduservice.xml. A continuación, se muestra un ejemplo de un archivo de este tipo con una sola declaración de grupo de AID que contiene dos AID de propiedad:
<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 etiqueta <host-apdu-service> debe contener un atributo <android:description> que incluya una descripción fácil de usar del servicio que puedes mostrar en la IU de la app. Puedes usar el atributo requireDeviceUnlock para especificar que el dispositivo se desbloquee antes de invocar este servicio para controlar las APDU.
El <host-apdu-service> debe contener una o más etiquetas <aid-group>. Cada etiqueta <aid-group> debe cumplir con los siguientes requisitos:
- Contener un atributo
android:descriptionque incluya una descripción fácil de usar del grupo de AID, adecuada para mostrarse en la IU - Tener su atributo
android:categoryconfigurado para indicar la categoría a la que pertenece el grupo de AID, como las constantes de cadena definidas porCATEGORY_PAYMENToCATEGORY_OTHER - Contener una o más etiquetas
<aid-filter>, cada una de las cuales contiene un solo AID Especifica el AID en formato hexadecimal y asegúrate de que contenga una cantidad par de caracteres.
Tu aplicación también debe tener el permiso NFC para registrarse como un servicio de HCE.
Resolución de conflictos de AID
Se pueden instalar varios componentes HostApduService en un solo dispositivo, y más de un servicio puede registrar el mismo AID. Android determina qué servicio invocar con los siguientes pasos:
- Si la app de billetera predeterminada que seleccionó el usuario registró el AID, se invocará esa app.
- Si la app de billetera predeterminada no registró el AID, se invocará el servicio que lo haya registrado.
- Si más de un servicio registró el AID, Android le preguntará al usuario qué servicio invocar.
Preferencia de servicio en primer plano
Las apps en primer plano pueden invocar setPreferredService para especificar qué servicio de emulación de tarjetas se debe preferir mientras una actividad específica está en primer plano. Esta preferencia de app en primer plano anula la resolución de conflictos de AID. Esta es una práctica recomendada cuando la app prevé que el usuario podría usar la emulación de tarjeta NFC.
Android 13 y versiones posteriores
Para que se ajuste mejor a la lista de selección de pagos predeterminada en la IU de Configuración, ajusta el requisito del banner a un ícono cuadrado. Idealmente, debería ser idéntico al diseño del ícono del selector de aplicaciones. Este ajuste crea más coherencia y un aspecto más limpio.
Android 12 y versiones anteriores
Establece el tamaño del banner del servicio en 260 × 96 dp y, luego, configúralo en el archivo en formato XML de metadatos agregando el atributo android:apduServiceBanner a la etiqueta <host-apdu-service>, que apunta al recurso de elementos de diseño. A continuación,
se muestra un ejemplo:
<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>
Aplicaciones de billetera
Android 15 y versiones posteriores incluyen un rol de app de billetera predeterminada que el usuario puede seleccionar navegando a Configuración > Apps > Apps predeterminadas. Esto define la aplicación de billetera predeterminada que se invocará cuando se presione una terminal de pago. Android considera que los servicios de HCE que declararon un grupo de AID con la categoría de pago son aplicaciones de billetera.
Verifica si tu app es la app de billetera predeterminada
Las apps pueden verificar si son la app de billetera predeterminada pasando RoleManager.ROLE_WALLET a RoleManager.isRoleHeld().
Si tu app no es la predeterminada, puedes solicitar el rol de billetera predeterminada pasando RoleManager.ROLE_WALLET a RoleManager.createRequestRoleIntent().
Recursos obligatorios para las aplicaciones de billetera
Para proporcionar una experiencia del usuario más atractiva visualmente, las aplicaciones de billetera de HCE deben proporcionar un banner de servicio.
Modo de observación
Android 15 presenta la función Modo de observación. Cuando está habilitado, el modo de observación
permite que el dispositivo observe los bucles de sondeo de NFC y envíe notificaciones sobre ellos
a los componentes de HostApduService adecuados para que puedan prepararse para
interactuar con una terminal NFC determinada. Un HostApduService puede poner el dispositivo en
modo de observación pasando true a
setObserveModeEnabled().
Esto indica a la pila de NFC que no permita las transacciones NFC y, en su lugar, observe de forma pasiva los bucles de sondeo.
Filtros de bucle de sondeo
Puedes registrar filtros de bucle de sondeo para un HostApduService con cualquiera de
los siguientes métodos:
registerPollingLoopFilterForService()para los filtros que deben coincidir exactamente con un marco de sondeo.registerPollingLoopPatternFilterForService()para los filtros que coinciden con una expresión regular en los marcos de sondeo.
Cuando un filtro de bucle de sondeo coincide con marcos de sondeo no estándar, la pila de NFC enruta esos marcos de sondeo al HostApduService correspondiente llamando a su método processPollingFrames(). Esto permite que el servicio tome las medidas necesarias para garantizar que el usuario esté listo para realizar la transacción y tenga la intención de hacerlo, por ejemplo, autenticar al usuario. Si un lector de NFC usa solo marcos estándar en su bucle de sondeo, la pila de NFC enruta esos marcos de sondeo al servicio en primer plano preferido si ese servicio está en primer plano o al titular de la función de billetera predeterminada de lo contrario.
Las notificaciones de marcos de sondeo también incluyen una medición de la intensidad del campo específica del proveedor que puedes recuperar llamando a getVendorSpecificGain().
Los proveedores pueden proporcionar mediciones con su propia escala, siempre que quepa en
un solo byte.
Responde a los bucles de sondeo y sal del modo de observación
Cuando el servicio esté listo para realizar transacciones, puede salir del modo de observación pasando
false a setObserveModeEnabled(). Luego, la pila de NFC permitirá que continúen las transacciones.
Los componentes HostApduService pueden indicar que el modo de observación debe habilitarse
cuando son el servicio de pago preferido estableciendo
shouldDefaultToObserveMode en true en el manifiesto o llamando a
CardEmulation.setShouldDefaultToObserveModeForService().
Los componentes HostApduService y OffHostApduService también pueden indicar que los filtros de bucle de sondeo que coinciden con los marcos de bucle de sondeo recibidos deben inhabilitar automáticamente el modo de observación y permitir que las transacciones continúen configurando autoTransact como true en la declaración PollingLoopFilter en el manifiesto.
Preferencia de servicio en primer plano
Las apps en primer plano pueden invocar setPreferredService para especificar qué servicio de emulación de tarjetas se debe preferir mientras una actividad específica está en primer plano. Esta preferencia de app en primer plano anula el estado del modo de observación del dispositivo correspondiente al valor de shouldDefaultToObserveMode para un servicio determinado, que se puede establecer de una de las siguientes maneras:
- Establecer el estado de
shouldDefaultToObserveModeen el manifiesto para ese servicio - Invoca
CardEmulation.setShouldDefaultToObserveModeForService()con el servicio y el estado correspondientes.
Pantalla apagada y comportamiento de pantalla de bloqueo
El comportamiento de los servicios de HCE varía según la versión de Android que se ejecuta en el dispositivo.
Android 15 y versiones posteriores
Si la app de billetera predeterminada activa el modo de observación en un dispositivo que lo admite, esa app anula el comportamiento de desbloqueo y de pantalla apagada, ya que controla cuándo puede continuar una transacción. Es posible que algunas apps de billetera requieran que se desbloquee el dispositivo antes de que se pueda realizar una transacción si el modo de observación no detectó un patrón de bucle de sondeo identificable.
Se recomienda a los desarrolladores que trabajen con sus dispositivos lectores para emitir patrones de bucle de sondeo identificables y registrarse para controlar esos patrones desde su app.
Android 12 y versiones posteriores
En las apps que se orientan a Android 12 (nivel de API 31) y versiones posteriores, puedes habilitar los pagos NFC sin que la pantalla del dispositivo esté encendida. Para ello, configura requireDeviceScreenOn como false.
Android 10 y versiones posteriores
Los dispositivos que ejecutan Android 10 (nivel de API 29) o versiones posteriores admiten NFC seguro. Mientras la opción NFC seguro está activada, todos los emuladores de tarjetas (aplicaciones de host y aplicaciones alojadas) no están disponibles cuando la pantalla del dispositivo está apagada. Mientras la opción NFC seguro está desactivada, las aplicaciones alojadas están disponibles cuando la pantalla del dispositivo está apagada. Puedes verificar la compatibilidad con NFC seguro con isSecureNfcSupported().
En dispositivos con Android 10 y versiones posteriores, se aplica la misma funcionalidad para establecer android:requireDeviceUnlock en true que en dispositivos con Android 9 y versiones anteriores, pero solo cuando la opción NFC seguro está desactivada. Es decir, si la opción NFC seguro está activada, los servicios de HCE no pueden funcionar desde la pantalla de bloqueo, independientemente de la configuración de android:requireDeviceUnlock.
Android 9 y versiones anteriores
En los dispositivos que ejecutan Android 9 (nivel de API 28) y versiones anteriores, el controlador NFC y el procesador de aplicaciones se desactivan por completo cuando se apaga la pantalla del dispositivo. Por lo tanto, los servicios de HCE no funcionan cuando la pantalla está apagada.
Además, en Android 9 y versiones anteriores, los servicios de HCE pueden funcionar desde la pantalla de bloqueo.
Sin embargo, esto se controla con el atributo android:requireDeviceUnlock en la etiqueta <host-apdu-service> de tu servicio de HCE. De forma predeterminada, no se requiere el desbloqueo del dispositivo y se invoca tu servicio incluso si el dispositivo está bloqueado.
Si configuras el atributo android:requireDeviceUnlock como true para tu servicio de HCE, Android le solicita al usuario que desbloquee el dispositivo cuando ocurre lo siguiente:
- el usuario acerca el dispositivo a un lector de NFC.
- El lector de NFC selecciona un AID que se resuelve en tu servicio.
Después de desbloquear el dispositivo, Android muestra un diálogo en el que se le solicita al usuario que vuelva a acercar el dispositivo para completar la transacción. Esto es necesario porque es posible que el usuario haya alejado el dispositivo del lector de NFC para desbloquearlo.
Coexistencia con tarjetas que tienen Elemento seguro
Esta sección es de interés para los desarrolladores que implementaron una aplicación que se basa en un elemento seguro para la emulación de tarjetas. La implementación de HCE de Android está diseñada para funcionar en paralelo con otros métodos de implementación de emulación de tarjeta, incluido el uso de elementos seguros.
Esta coexistencia se basa en un principio llamado enrutamiento de AID. El controlador de NFC mantiene una tabla de enrutamiento que consiste en una lista (finita) de reglas de enrutamiento. Cada una de ellas contiene un AID y un destino. El destino puede ser la CPU del host, en la que se ejecutan las apps para Android, o un elemento seguro conectado.
Cuando el lector de NFC envía una APDU con un SELECT AID, el controlador de NFC la analiza y verifica si los AID coinciden con algún AID de su tabla de enrutamiento. Si coincide, esa APDU y todas las APDU que la siguen se envían al destino asociado con el AID, hasta que se reciba otra APDU SELECT AID o se rompa el vínculo NFC.
En la figura 4, se ilustra esta arquitectura:
Figura 4: Android funciona con el elemento seguro y la emulación de tarjeta de host.
Por lo general, el controlador de NFC también contiene una ruta predeterminada para las APDU. Cuando no se encuentra un AID en la tabla de enrutamiento, se usa la ruta predeterminada. Si bien este parámetro de configuración puede variar de un dispositivo a otro, los dispositivos Android deben garantizar que los AID que registra tu app se enruten correctamente al host.
Las aplicaciones para Android que implementan un servicio de HCE o que usan un elemento seguro no tienen que preocuparse por configurar la tabla de enrutamiento, ya que Android se encarga de eso automáticamente. Android solo necesita saber qué AID pueden controlar los servicios de HCE y cuáles puede controlar el elemento seguro. La tabla de enrutamiento se configura automáticamente según los servicios que estén instalados y los que el usuario haya configurado como preferidos.
En la siguiente sección, se explica cómo declarar AID para aplicaciones que usan un elemento seguro para la emulación de tarjetas.
Registro de AID con Elementos seguros
Las aplicaciones que usan un elemento seguro para la emulación de tarjetas pueden declarar un servicio fuera del host en su manifiesto. La declaración de este servicio es casi idéntica a la de un servicio de HCE. Las excepciones son las siguientes:
- La acción que se usa en el filtro de intents debe establecerse en
SERVICE_INTERFACE. - El atributo de nombre de los metadatos debe establecerse en
SERVICE_META_DATA. El archivo XML de metadatos debe usar la etiqueta raíz
<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>
A continuación, se muestra un ejemplo del archivo apduservice.xml correspondiente que registra dos 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>
El atributo android:requireDeviceUnlock no se aplica a los servicios fuera del host,
ya que la CPU del host no participa en la transacción y, por lo tanto, no puede
evitar que el elemento seguro ejecute transacciones cuando el dispositivo está
bloqueado.
El atributo android:apduServiceBanner es obligatorio para los servicios fuera del host que son aplicaciones de pago y para que se puedan seleccionar como una aplicación de pago predeterminada.
Invocación de servicios fuera del host
Android nunca inicia un servicio que se declara como "fuera del host" ni se vincula a él, ya que las transacciones reales las ejecuta el elemento seguro y no el servicio de Android. La declaración del servicio solo permite que las aplicaciones registren los AID presentes en el elemento seguro.
HCE y seguridad
La arquitectura de HCE proporciona una pieza central de seguridad: debido a que tu servicio está protegido por el permiso del sistema BIND_NFC_SERVICE, solo el SO puede vincularse a tu servicio y comunicarse con él.
Esto garantiza que cualquier APDU que recibas sea, en realidad, una APDU que el SO recibió del controlador NFC y que cualquier APDU que envíes solo vaya al SO, que, a su vez, reenvía las APDU directamente al controlador NFC.
La última preocupación restante es de dónde obtienes los datos que tu app envía al lector de NFC. Esto se desvincula de forma intencional en el diseño de HCE; no importa de dónde provengan los datos, solo se asegura de que se transporten de forma segura al controlador NFC y al lector NFC.
Para almacenar y recuperar de forma segura los datos que quieres enviar desde tu servicio de HCE, puedes, por ejemplo, confiar en la zona de pruebas de la aplicación para Android, que aísla los datos de tu app de otras apps. Para obtener más detalles sobre la seguridad de Android, consulta Sugerencias de seguridad.
Parámetros y detalles del protocolo
Esta sección es de interés para los desarrolladores que desean comprender qué parámetros de protocolo usan los dispositivos con HCE durante las fases de anticolisión y activación de los protocolos de NFC. Esto permite compilar una infraestructura de lector que sea compatible con los dispositivos HCE de Android.
Anticolisión y activación del protocolo Nfc-A (ISO/IEC 14443 tipo A)
Como parte de la activación del protocolo Nfc-A, se intercambian múltiples tramas.
En la primera parte del intercambio, el dispositivo de HCE presenta su UID. Se debe suponer que los dispositivos de HCE tienen un UID aleatorio. Esto significa que, en cada presión, el UID que se presenta al lector es un UID generado de forma aleatoria. Por este motivo, los lectores de NFC no deben depender del UID de los dispositivos con HCE como forma de autenticación o identificación.
Posteriormente, el lector de NFC puede seleccionar el dispositivo de HCE enviando un comando SEL_REQ. La respuesta SEL_RES del dispositivo HCE tiene al menos el sexto bit (0x20) configurado, lo que indica que el dispositivo admite ISO-DEP. Ten en cuenta que también se pueden configurar otros bits en el SEL_RES, lo que indica, por ejemplo, compatibilidad con el protocolo NFC-DEP (p2p). Dado que se pueden establecer otros bits, los lectores que quieran interactuar con
dispositivos HCE deben verificar explícitamente solo el sexto bit y no comparar
el SEL_RES completo con un valor de 0x20.
Activación de ISO-DEP
Después de que se activa el protocolo Nfc-A, el lector de NFC inicia la activación del protocolo ISO-DEP. Envía un comando RATS (solicitud de respuesta para seleccionar). El controlador NFC genera la respuesta RATS, la ATS; los servicios de HCE no pueden configurar la ATS. Sin embargo, las implementaciones de HCE deben cumplir con los requisitos del NFC Forum para la respuesta de ATS, de modo que los lectores de NFC puedan contar con que estos parámetros se establezcan de acuerdo con los requisitos del NFC Forum para cualquier dispositivo de HCE.
En la siguiente sección, se proporcionan más detalles sobre los bytes individuales de la respuesta de ATS que proporciona el controlador NFC en un dispositivo HCE:
- TL: Es la longitud de la respuesta ATS. No debe indicar una longitud superior a 20 bytes.
- T0: Los bits 5, 6 y 7 deben estar configurados en todos los dispositivos HCE, lo que indica que TA(1), TB(1) y TC(1) se incluyen en la respuesta de ATS. Los bits del 1 al 4 indican el FSCI, que codifica el tamaño máximo de la trama. En los dispositivos HCE, el valor de FSCI debe estar entre 0h y 8h.
- T(A)1: Define las tasas de bits entre el lector y el emulador, y si pueden ser asimétricas. No hay garantías ni requisitos de tasas de bits para los dispositivos con HCE.
- T(B)1: Los bits 1 a 4 indican el número entero del tiempo de seguridad de la trama de inicio (SFGI). En los dispositivos con HCE, el SFGI debe ser de 8 h o menos. Los bits del 5 al 8 indican el número entero del tiempo de espera de la trama (FWI) y codifican el tiempo de espera de la trama (FWT). En los dispositivos con HCE, el FWI debe ser de 8 h o menos.
- T(C)1: El bit 5 indica compatibilidad con las funciones avanzadas del protocolo. Es posible que los dispositivos con HCE admitan o no las "funciones de protocolo avanzado". El bit 2 indica la compatibilidad con DID. Los dispositivos con HCE pueden o no ser compatibles con el DID. El bit 1 indica la compatibilidad con NAD. Los dispositivos con HCE no deben admitir la NAD y deben establecer el bit 1 en cero.
- Bytes históricos: Los dispositivos con HCE pueden mostrar hasta 15 bytes históricos. Los lectores de NFC que deseen interactuar con los servicios de HCE no deben hacer suposiciones sobre el contenido de los bytes históricos ni su presencia.
Ten en cuenta que es probable que muchos dispositivos HCE cumplan con los requisitos de protocolo que las redes de pago unidas en EMVCo especificaron en su especificación de "Protocolo de comunicación sin contacto". En particular:
- El FSCI en T0 debe ser de entre 2 h y 8 h.
- T(A)1 debe establecerse en 0x80, lo que indica que solo se admite la tasa de bits de 106 kbit/s y que no se admiten las tasas de bits asimétricas entre el lector y el emulador.
- El FWI en T(B)1 debe ser <= 7 h.
Intercambio de datos de APDU
Como se indicó antes, las implementaciones de HCE solo admiten un canal lógico. Intentar seleccionar aplicaciones en diferentes canales lógicos no funciona en un dispositivo HCE.