# Configurar ajustes de APN

> Despliega uno o varios APN en dispositivos Android gestionados con apnPolicy desde una política de Applivery, sin configurarlos a mano en cada dispositivo.

Source: https://docs.applivery.com/es/device-management/android/policies/configure-apn-settings/  •  Last updated: 2026-10-16

**Key topics:** apnPolicy y overrideApns, Configuración del APN en la política, Referencia de campos de ApnSetting, Comprobación en el dispositivo, Solución de problemas, Applivery, Android, Android Management API, APN

---

**TL;DR:** Un APN se despliega con el objeto apnPolicy de la política Android: activas overrideApns y declaras uno o varios apnSettings. Requiere Android 10 o superior en totalmente administrados y Android 13 o superior, solo con tipo ENTERPRISE, en perfiles de trabajo.

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](https://developers.google.com/android/management/reference/rest/v1/enterprises.policies).

## Requisitos previos

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Requisito</p></th><th colspan="1" rowspan="1"><p>Detalle</p></th></tr><tr><td colspan="1" rowspan="1"><p>Dispositivo con SIM o eSIM activa</p></td><td colspan="1" rowspan="1"><p>El APN solo tiene efecto sobre la conexión de datos móviles del operador.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Dispositivo Android inscrito en Applivery</p></td><td colspan="1" rowspan="1"><p>Con una política Android Enterprise asignada.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Totalmente administrado</strong></p></td><td colspan="1" rowspan="1"><p>Android 10 o superior. Se admiten varios tipos de APN.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Perfil de trabajo</strong></p></td><td colspan="1" rowspan="1"><p>Android 13 o superior, y solo APN con tipo <code>ENTERPRISE</code>.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Datos del APN facilitados por el operador</p></td><td colspan="1" rowspan="1"><p>Nombre del APN, usuario y contraseña si aplica, tipo de autenticación, MCC+MNC, proxy, etc.</p></td></tr></tbody></table>

:::info
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**](https://dashboard.applivery.io/), ve a **Políticas** 1 y abre la política Android que quieres modificar, o [**crea una nueva**](https://docs.applivery.com/es/device-management/general-settings/create-device-policies/). 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`.

![apn](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/e2b1075d-fb4d-4f8b-a930-b07418015175.png)

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

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Campo</p></th><th colspan="1" rowspan="1"><p>Descripción</p></th></tr><tr><td colspan="1" rowspan="1"><p><code>apn</code></p></td><td colspan="1" rowspan="1"><p>Nombre del APN. La política se rechaza si está vacío.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>displayName</code></p></td><td colspan="1" rowspan="1"><p>Nombre descriptivo del APN. La política se rechaza si está vacío.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>apnTypes</code></p></td><td colspan="1" rowspan="1"><p>Lista de tipos de uso del APN. Se rechaza si está vacía, si contiene <code>APN_TYPE_UNSPECIFIED</code> o si hay duplicados.</p></td></tr></tbody></table>

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

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

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Campo</p></th><th colspan="1" rowspan="1"><p>Descripción</p></th></tr><tr><td colspan="1" rowspan="1"><p><code>authType</code></p></td><td colspan="1" rowspan="1"><p>Tipo de autenticación: <code>NONE</code>, <code>PAP</code>, <code>CHAP</code> o <code>PAP_OR_CHAP</code>.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>username</code> / <code>password</code></p></td><td colspan="1" rowspan="1"><p>Credenciales del APN, si el operador las exige.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>numericOperatorId</code></p></td><td colspan="1" rowspan="1"><p>Identificador numérico del operador: MCC (código de país) + MNC (código de red).</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>mvnoType</code></p></td><td colspan="1" rowspan="1"><p>Tipo de coincidencia MVNO: <code>GID</code>, <code>ICCID</code>, <code>IMSI</code> o <code>SPN</code>.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>carrierId</code></p></td><td colspan="1" rowspan="1"><p>ID de operador. <code>0</code> significa no establecido; no se admiten negativos.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>protocol</code> / <code>roamingProtocol</code></p></td><td colspan="1" rowspan="1"><p>Protocolo de conexión, normal y en roaming: <code>IP</code>, <code>IPV4V6</code>, <code>IPV6</code>, <code>NON_IP</code>, <code>PPP</code> o <code>UNSTRUCTURED</code>.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>networkTypes</code></p></td><td colspan="1" rowspan="1"><p>Tecnologías de radio que puede usar el APN: <code>EDGE</code>, <code>GPRS</code>, <code>GSM</code>, <code>HSDPA</code>, <code>HSPA</code>, <code>HSPAP</code>, <code>HSUPA</code>, <code>IWLAN</code>, <code>LTE</code>, <code>NR</code>, <code>TD_SCDMA</code> y <code>UMTS</code>. No admite duplicados.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>proxyAddress</code> / <code>proxyPort</code></p></td><td colspan="1" rowspan="1"><p>Proxy del APN. Puerto <code>0</code> significa no establecido.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>mmsc</code> / <code>mmsProxyAddress</code> / <code>mmsProxyPort</code></p></td><td colspan="1" rowspan="1"><p>Parámetros de mensajería multimedia (MMS). La dirección del proxy MMS es una IP o un nombre de host, no una URL.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>mtuV4</code> / <code>mtuV6</code></p></td><td colspan="1" rowspan="1"><p>Tamaño MTU en bytes para IPv4 e IPv6. Requiere Android 13 o superior.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>alwaysOnSetting</code></p></td><td colspan="1" rowspan="1"><p><code>NOT_ALWAYS_ON</code> o <code>ALWAYS_ON</code>. 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).</p></td></tr></tbody></table>

## Comprobar que se ha aplicado

1.  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.
    
2.  Verifica que el dispositivo tiene conexión de datos móviles con la Wi-Fi desactivada.
    
3.  Si el APN no aparece, revisa los motivos de no conformidad del dispositivo.
    

## Solución de problemas

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