¿Cómo configuro un APN en dispositivos Android con Applivery?

Abre la política Android, ve a Red → APN Policies, pon overrideApns en OVERRIDE_APNS_ENABLED y añade un elemento en apnSettings con apn, displayName y apnTypes. Después, guarda y asigna la política.

¿Qué hace overrideApns?

Activa o desactiva el uso de los APN definidos por política. Con OVERRIDE_APNS_ENABLED, los APN de la política pueden prevalecer sobre los demás APN del dispositivo.

¿Qué versión de Android necesito?

Android 10 o superior en dispositivos totalmente administrados y Android 13 o superior en perfiles de trabajo.

¿Puedo configurar un APN en un perfil de trabajo?

Sí, con Android 13 o superior y solo con el tipo de APN ENTERPRISE.

¿Qué campos son obligatorios en un APN?

apn, displayName y apnTypes. Si alguno falta o está vacío, la política se rechaza.

¿Qué pasa si dos APN de la lista coinciden?

Si coinciden en todos los valores clave (operador, APN, proxies, MMSC, tipo MVNO y protocolos), la política se rechaza.

¿Por qué el dispositivo reporta API_LEVEL o MANAGEMENT_MODE?

API_LEVEL indica una versión de Android inferior a la necesaria. MANAGEMENT_MODE indica un perfil de trabajo con Android inferior a 13 o con un tipo distinto de ENTERPRISE.

¿Cómo compruebo que el APN se ha aplicado?

En el dispositivo, abre Ajustes → Redes móviles → Nombres de punto de acceso y comprueba que aparece el APN con su displayName. Después, prueba los datos móviles con la Wi-Fi desactivada.

Configurar APN en Android con Applivery

El APN (Access Point Name) es el punto de acceso que usa el dispositivo para conectarse a la red de datos de su operador. Cuando una flota usa SIM corporativas con un APN privado (por ejemplo, para acceder a la red interna de la empresa a través del operador), configurarlo a mano en cada dispositivo no escala. Con apnPolicy lo declaras una vez en la política y llega a todos los dispositivos asignados, sin intervención del usuario.

Applivery envía la configuración de la política Android a los dispositivos a través de la Android Management API (AMAPI), así que los campos y los requisitos de apnPolicy son los que define Google en su referencia de políticas.

Requisitos previos

Requisito	Detalle
Dispositivo con SIM o eSIM activa	El APN solo tiene efecto sobre la conexión de datos móviles del operador.
Dispositivo Android inscrito en Applivery	Con una política Android Enterprise asignada.
Totalmente administrado	Android 10 o superior. Se admiten varios tipos de APN.
Perfil de trabajo	Android 13 o superior, y solo APN con tipo `ENTERPRISE`.
Datos del APN facilitados por el operador	Nombre del APN, usuario y contraseña si aplica, tipo de autenticación, MCC+MNC, proxy, etc.

Note

Si el dispositivo no cumple la versión mínima, no falla nada visible: el ajuste se descarta y el dispositivo reporta un motivo de no conformidad (API_LEVEL o MANAGEMENT_MODE).

Cómo funciona

apnPolicy tiene dos campos:

overrideApns: activa o desactiva el uso de los APN definidos por política. Valores: OVERRIDE_APNS_UNSPECIFIED, OVERRIDE_APNS_DISABLED y OVERRIDE_APNS_ENABLED. Con OVERRIDE_APNS_ENABLED, los APN de la política pueden prevalecer sobre los demás APN del dispositivo. El comportamiento se corresponde con DevicePolicyManager.setOverrideApnsEnabled de Android.
apnSettings: la lista de APN. Cada elemento es un objeto ApnSetting.

Warning

No puede haber conflictos entre los APN de la lista. Dos entradas entran en conflicto cuando coinciden en todos estos campos: numericOperatorId, apn, proxyAddress, proxyPort, mmsProxyAddress, mmsProxyPort, mmsc, mvnoType, protocol y roamingProtocol. Si hay conflicto, la política se rechaza.

Configurar un APN

Abre la política

En el panel de Applivery, ve a Políticas 1 y abre la política Android que quieres modificar, o crea una nueva. En el menú lateral izquierdo, haz clic en la sección Red 2 y localiza la configuración de Política de APN 3.

Establece overrideApns en OVERRIDE_APNS_ENABLED.

Añade los APN

Añade un elemento en apnSettings por cada APN y completa, como mínimo, los campos obligatorios: apn, displayName y apnTypes.

Guarda y asigna

Haz clic en Guardar y asigna la política a los dispositivos o grupos correspondientes.

Referencia de campos

Obligatorios

Campo	Descripción
`apn`	Nombre del APN. La política se rechaza si está vacío.
`displayName`	Nombre descriptivo del APN. La política se rechaza si está vacío.
`apnTypes`	Lista de tipos de uso del APN. Se rechaza si está vacía, si contiene `APN_TYPE_UNSPECIFIED` o si hay duplicados.

Valores de apnTypes: ENTERPRISE, BIP, CBS, DEFAULT, DUN, EMERGENCY, FOTA, HIPRI, IA, IMS, MCX, MMS, RCS, SUPL, VSIM y XCAP.

Note

En dispositivos totalmente administrados puedes combinar varios tipos. En perfiles de trabajo, ENTERPRISE es el único tipo permitido. Los tipos que el dispositivo o el modo de gestión no admiten se ignoran; si ninguno es válido, la entrada completa se ignora y se reporta INVALID_VALUE.

Opcionales

Campo	Descripción
`authType`	Tipo de autenticación: `NONE`, `PAP`, `CHAP` o `PAP_OR_CHAP`.
`username` / `password`	Credenciales del APN, si el operador las exige.
`numericOperatorId`	Identificador numérico del operador: MCC (código de país) + MNC (código de red).
`mvnoType`	Tipo de coincidencia MVNO: `GID`, `ICCID`, `IMSI` o `SPN`.
`carrierId`	ID de operador. `0` significa no establecido; no se admiten negativos.
`protocol` / `roamingProtocol`	Protocolo de conexión, normal y en roaming: `IP`, `IPV4V6`, `IPV6`, `NON_IP`, `PPP` o `UNSTRUCTURED`.
`networkTypes`	Tecnologías de radio que puede usar el APN: `EDGE`, `GPRS`, `GSM`, `HSDPA`, `HSPA`, `HSPAP`, `HSUPA`, `IWLAN`, `LTE`, `NR`, `TD_SCDMA` y `UMTS`. No admite duplicados.
`proxyAddress` / `proxyPort`	Proxy del APN. Puerto `0` significa no establecido.
`mmsc` / `mmsProxyAddress` / `mmsProxyPort`	Parámetros de mensajería multimedia (MMS). La dirección del proxy MMS es una IP o un nombre de host, no una URL.
`mtuV4` / `mtuV6`	Tamaño MTU en bytes para IPv4 e IPv6. Requiere Android 13 o superior.
`alwaysOnSetting`	`NOT_ALWAYS_ON` o `ALWAYS_ON`. Indica si se activan los recursos de plano de usuario en cada transición de CM-IDLE a CM-CONNECTED (3GPP TS 23.501, sección 5.6.13).

Comprobar que se ha aplicado

En el dispositivo, abre Ajustes → Redes móviles → Nombres de punto de acceso (la ruta varía según el fabricante) y comprueba que aparece el APN con el displayName definido.
Verifica que el dispositivo tiene conexión de datos móviles con la Wi-Fi desactivada.
Si el APN no aparece, revisa los motivos de no conformidad del dispositivo.

Solución de problemas

Síntoma	Causa probable	Qué hacer
El dispositivo reporta `API_LEVEL`	Android inferior a 10 (cualquier modo), o uso de `mtuV4`/`mtuV6` con Android inferior a 13.	Actualiza el dispositivo o elimina los campos que requieren Android 13.
El dispositivo reporta `MANAGEMENT_MODE`	Perfil de trabajo con Android inferior a 13, o con un `apnTypes` distinto de `ENTERPRISE`.	Usa solo `ENTERPRISE` en perfiles de trabajo y Android 13 o superior.
Se reporta `INVALID_VALUE`	Ninguno de los tipos de `apnTypes` es compatible con el dispositivo o el modo de gestión.	Revisa los tipos declarados.
La política se rechaza al guardar	Falta `apn`, `displayName` o `apnTypes`; hay duplicados en `apnTypes` o `networkTypes`; o hay APN en conflicto.	Corrige los campos y revisa que no haya dos APN con los mismos valores clave.
El APN se aplica pero no hay datos	Datos del operador incorrectos (APN, autenticación, protocolo).	Confirma los parámetros con el operador y prueba con `protocol` y `roamingProtocol` en `IPV4V6`.

Key Takeaways

El APN se declara una vez en la política y llega a todos los dispositivos asignados.

overrideApns en OVERRIDE_APNS_ENABLED activa los APN definidos por política.

apn, displayName y apnTypes son obligatorios.

En perfiles de trabajo solo se admite el tipo ENTERPRISE y Android 13 o superior.

Dos APN con los mismos valores clave hacen que la política se rechace.