VoLTE / VoNR (modo IMS)
:::tip ¿Busca la descripción general? Consulte la página de IMS, VoLTE y VoWiFi en el sitio web de MonoPbx, y los requisitos de red para los puertos del ePDG (UDP 500 y 4500). :::
El modo IMS permite que MonoPbx actúe como el núcleo IMS de las SIM propias de un operador. Los teléfonos se registran a través de la red móvil (VoLTE) o de cualquier Wi-Fi mediante un ePDG (VoWiFi), demuestran su identidad con la SIM y usan el PBX para voz y SMS. Cada SIM está vinculada a una extensión común, de modo que una llamada a la extensión hace sonar el número celular del teléfono y viceversa.
Es opcional y está desactivado de forma predeterminada. Nada de lo que se describe aquí se ejecuta, y la consola solo muestra una explicación, hasta que un administrador del sistema lo activa.
:::info A quién va dirigido Operadores móviles, operadores de LTE privado y de redes de campus, y OMV que operan su propio núcleo de paquetes. Necesita las claves de las SIM (K y OPc, u OP) o un HSS o UDM que las contenga. :::
Guías paso a paso
Recorridos desde un servidor vacío hasta una primera llamada, con los ajustes exactos de ambos lados:
- Usar MonoPbx como IMS de una red privada 4G/5G con Open5GS
- Usar MonoPbx como IMS de una red privada 5G con free5GC
Qué se ejecuta
| Proceso | Requiere | Qué hace |
|---|---|---|
| El motor del PBX | nada especial | Registra los teléfonos, verifica la SIM (IMS-AKA), transporta SMS, se comunica con su HSS, UDM, PCRF o PCF y autentica los túneles de VoWiFi |
El rol P-CSCF (mpbx --role pcscf) | Linux, CAP_NET_ADMIN | Termina el SIP de los teléfonos y establece los túneles IPsec de TS 33.203 |
El ePDG (mpbx-epdg) | Linux, una dirección pública, un certificado, CAP_NET_ADMIN y permiso para enlazar UDP 500 y 4500 | IKEv2 y ESP para teléfonos VoWiFi. Nunca guarda una clave de SIM |
Los procesos con privilegios se comunican con el motor mediante enlaces autenticados (un secreto compartido de 32 bytes aleatorios por enlace, openssl rand -base64 32). Mantenga esos enlaces en una red privada.
Enlaces Diameter
Las conexiones a un HSS (Cx) o a un PCRF (Rx) funcionan sobre TCP o SCTP, cada una con TLS opcional y un certificado de CA de confianza propio. SCTP funciona solo en Linux y no es multihomed. Cada par tiene su propia prioridad, intervalo de watchdog y rol, por lo que puede mantener uno principal y uno de respaldo. Los ajustes están en la misma página que los pares; no hay un paquete aparte que instalar.
Activarlo
El modo IMS está activado de forma predeterminada en cada instalación (los instaladores escriben MPBX_IMS_ENABLED=true; el valor predeterminado del servidor de [ims] enabled es true), con VoWiFi y los códecs móviles activados en los ajustes iniciales. Sin SIM, nada cambia para sus teléfonos. Para desactivarlo, defina MPBX_IMS_ENABLED=false en .env (Compose y los instaladores) o [ims] enabled = false en la configuración de la instalación y reinicie; entonces cada página de IMS indica que el modo IMS está desactivado. La sección Red móvil (VoLTE / VoNR) aparece en el menú de la consola de administración, con estas páginas: Red, HSS y UDM, Diameter y políticas, Seguridad, VoWiFi, Multimedia, Abonados IMS y eSIM. La dirección anterior /admin/ims abre Red.
Ajustes
Cada página de Red móvil (VoLTE / VoNR) (administradores del sistema) guarda su propia parte de los ajustes:
- Red: el respaldo de datos de abonados (este PBX, un HSS mediante Diameter Cx o un UDM 5G mediante Nudm), los ajustes iniciales y el formato del identificador de llamada. Los ajustes iniciales son MCC y MNC (las instalaciones nuevas comienzan con los valores de laboratorio 001 y 01, y el dominio local
ims.mnc001.mcc001.3gppnetwork.org), el dominio local de IMS (calculado comoims.mnc<MNC>.mcc<MCC>.3gppnetwork.orgy que sigue al MCC y al MNC hasta que usted lo edite), el formato del IMPI (predeterminado{imsi}@{ims_domain}) y los formatos del IMPU (predeterminadosip:{imsi}@{ims_domain}, ytel:{msisdn}cuando usted asigna números de teléfono a las SIM) con un ejemplo en vivo, el número del centro de SMS y una dirección P-CSCF opcional para las SIM nuevas. La página termina con una tarjeta de Estado, descrita más adelante. - HSS y UDM: el algoritmo de los abonados nuevos (Milenage o TUAK); para un UDM 5G, la URL base, la autenticación, un token de solo escritura, la CA, el recurso IMS y el nombre de la red de servicio. Los pares Diameter de un HSS externo están en Diameter y políticas.
- Diameter y políticas: nuestra identidad Diameter, la tabla de pares Diameter (TCP o SCTP, TLS, rol, prioridad, watchdog) y el control de políticas (
off, Diameter Rx hacia un PCRF o HTTP N5 hacia un PCF) que solicita a su núcleo un portador dedicado para los medios de cada llamada. El control de políticas es independiente del origen de los datos de abonados. - Seguridad: IPsec activado o desactivado para los registros VoLTE, los algoritmos que permite y el rango de SPI del P-CSCF.
- VoWiFi: voz sobre Wi-Fi activada o desactivada (activada en una instalación nueva) y el rango de SPI del ePDG. El proceso del ePDG en sí (
mpbx-epdg, UDP 500 y 4500, un certificado para su nombre) no lo inician los instaladores: configúrelo cuando use VoWiFi y abra esos dos puertos UDP. - Multimedia: códecs móviles (activados en una instalación nueva): ofrece AMR-WB y AMR a los teléfonos IMS y agrega G.711 para el otro lado de la llamada, de modo que un teléfono pueda hablar con teléfonos de escritorio y troncales. Requiere un servidor de medios (rtpengine) que pueda codificar AMR, y las licencias de los códecs AMR y EVS son responsabilidad suya; revíselas y desactívelo aquí si no le convienen.
Algunos valores se definen en el archivo de configuración del servidor porque abren sockets o cargan certificados: las direcciones, los puertos, la identidad y los archivos de certificado del P-CSCF y del ePDG. Seguridad y VoWiFi los muestran de solo lectura con una insignia Requiere reinicio; edite el archivo y reinicie el PBX para cambiarlos.
Los secretos (los tokens de N5 y UDM) son de solo escritura: una vez guardados nunca se vuelven a mostrar. La página solo indica que hay uno definido.
Paquetes de eSIM
En Red móvil (VoLTE / VoNR), eSIM puede comprar eSIM para su propia red en lugar de pedir SIM de plástico. Cada eSIM lleva su MCC y MNC, el dominio IMS, los formatos de IMPI e IMPU y el número del centro de SMS de los ajustes iniciales, y se instala en un teléfono escaneando un código QR.
Antes de comprar:
- En Red, guarde su MCC, MNC y los demás ajustes iniciales. Los botones Comprar permanecen deshabilitados, con un enlace a los ajustes, hasta que se guarden el MCC y el MNC; el servidor también rechaza un pedido sin ellos. Las instalaciones nuevas comienzan con los valores de laboratorio MCC 001, MNC 01 y el dominio
ims.mnc001.mcc001.3gppnetwork.org, y el número del centro de SMS es un marcador de posición (+000000000000): reemplácelos con los suyos. - Inicie sesión en su cuenta de licencia de MonoPbx desde la página Licencia y agregue un método de pago a esa cuenta. La página de eSIM muestra la tarjeta que se cobrará (por ejemplo "Paying with Visa •••• 4242 (exp 12/28)"). Sin tarjeta muestra una advertencia y un botón que abre su cuenta en una pestaña nueva; cuando regresa, la página vuelve a comprobar. Comprar también está deshabilitado hasta que haya una tarjeta registrada.
- Opcionalmente, defina el Perfil de la SIM y el Prefijo del ICCID en la misma página (vea más abajo).
Se ofrecen paquetes de 1, 10 y 50 eSIM; los precios se muestran en las tarjetas de los paquetes, con el precio por eSIM y el total, y el paquete más grande está marcado como Mejor precio. Comprar le pide confirmar el paquete, el total y la tarjeta, y luego cobra la tarjeta. Si la tarjeta es rechazada, verá un mensaje y el mismo botón para actualizar el método de pago. El pedido aparece entonces en la tabla Pedidos mientras se construye, con su progreso. Cada pedido muestra su id en forma corta (el primer bloque; pase el cursor para ver el id completo o pulse Copiar para ponerlo en el portapapeles: es el id de su recibo y el que le pide el soporte), y un pedido que falló muestra el motivo. Cuando se devolvió dinero a la tarjeta, el pedido indica Reembolsado o Reembolsado parcialmente con el monto (Reembolso en curso hasta que se haya hecho el reembolso a la tarjeta).
Cuando las eSIM están listas, se entregan a este PBX en forma cifrada y se escriben en el HSS integrado en un solo paso, por lo que pueden registrarse de inmediato. La tabla eSIM lista cada ICCID, IMSI, número de teléfono y el estado en el HSS; Mostrar código QR muestra el código de activación que se escanea en un teléfono. El historial de sus pedidos y eSIM lo conserva MonoPbx y se muestra aquí aunque este PBX haya perdido su propia copia; las claves no: el HSS de este PBX es el único lugar que las conserva.
Descargar el archivo de claves
Para cargar las mismas eSIM en otro núcleo de red (por ejemplo Open5GS), descargue el archivo de claves de un pedido: un CSV con ICCID, IMSI, número de teléfono, K, OPc, AMF, SQN, PIN y PUK, ADM1, el código de activación, el IMPI y los IMPU. Solo se puede descargar una vez: la página le pide confirmar y después el PBX ya no tiene el archivo (un segundo intento responde que ya no existe). Guarde el archivo en un lugar seguro; contiene secretos. La descarga queda registrada en el registro de auditoría y solo los administradores del sistema pueden hacerla.
Perfil de la SIM y prefijo del ICCID
La tarjeta Perfil de la SIM define con qué se construyen las eSIM: el nombre del proveedor de servicios (de 1 a 16 caracteres, predeterminado MonoPbx), cuándo lo muestra el teléfono (siempre, oculto en roaming, con el nombre de la red o ambas reglas), un nombre de red opcional, redes locales equivalentes (EHPLMN), redes preferidas y permitidas con las tecnologías de radio que puede usar cada una (4G, 5G, 3G, 2G; máximo 20) y redes prohibidas (máximo 4). Una red es un MCC de 3 dígitos y un MNC de 2 o 3 dígitos; una red no puede aparecer dos veces.
Aplicaciones de Android con privilegios de operador lista aplicaciones (máximo 10) por el hash SHA-256 o SHA-1 del certificado con el que están firmadas (la salida de apksigner verify --print-certs, o la clave de firma de la aplicación en Play Console; con o sin dos puntos) y, opcionalmente, un nombre de paquete. Se guardan con el pedido; se aplicarán a las SIM en una versión posterior.
El prefijo del ICCID son los dígitos posteriores a 89 en el ICCID de cada eSIM (de 1 a 8 dígitos). El valor predeterminado 99901 es un rango privado; cámbielo solo si es titular de un rango de emisor de ICCID.
Abonados
Los administradores de la empresa agregan abonados en Red móvil (VoLTE / VoNR), Abonados IMS: el IMSI, K y OPc (u OP), el algoritmo (Milenage o TUAK), la extensión vinculada y las identidades públicas. K y OPc se sellan al ingresarlos y nunca se pueden leer de nuevo, exportar ni mostrar en un registro de auditoría; para cambiarlos se rotan. La política de acceso de una SIM indica dónde puede registrarse: any, volte (solo a través del P-CSCF) o vowifi (solo a través del ePDG). Para muchas SIM use la importación masiva, o mpbx ims import para lotes grandes.
Una SIM se registra solo cuando su abonado está activo, vinculado a una extensión habilitada de un usuario activo, y su política de acceso permite el acceso. Cualquier otro caso se rechaza con un 403 simple; el teléfono no recibe ninguna información sobre el motivo.
VoLTE
- Configure los ajustes anteriores y agregue los abonados.
- Para IPsec, ejecute el rol P-CSCF en un host Linux: su dirección, la dirección del enlace y el secreto compartido van en su configuración, y los motores reciben el
link_connectcorrespondiente. Los teléfonos negocian entonces el túnel IPsec con el encabezado SIPSecurity-Client, como exige TS 33.203, y el motor rechaza un registro que debe estar protegido y no lo está. - Defina el número del centro de SMS en Red para transportar SMS sobre IMS.
VoWiFi
- En los motores:
[ims.epdg] link_listen, el secreto del enlace y el mismopoolque usa el ePDG. - En el host del ePDG: la
addresspública, unidde IKE (un FQDN), una cadena de certificados y su clave,link_connect, elpoolde direcciones internas y las direccionespcscfydnsque se envían a los teléfonos. - Configure los ajustes de operador de los teléfonos para que usen el FQDN del ePDG.
El ePDG ofrece solo intercambio de claves moderno (X25519, P-256, P-384), autentica al teléfono con EAP-AKA' a través del motor y le da una dirección interna, y las direcciones del P-CSCF y del DNS. Un teléfono que se conecta de nuevo reemplaza su túnel anterior. Cuando el motor no está accesible, el ePDG rechaza todos los túneles en lugar de dejar entrar a cualquiera.
Estado
La página Red termina con una tarjeta de Estado, que se actualiza cada diez segundos:
- cada par Diameter (Cx y Rx) como conectado, conectando o caído, con el motivo;
- el enlace P-CSCF de cada motor;
- cada ePDG: los túneles en uso y las direcciones internas asignadas de su pool.
Un proceso que deja de reportar desaparece de la tarjeta después de 30 segundos.
Alertas y errores
Un respaldo de abonados caído falla de forma cerrada (los registros se rechazan con 500, nunca se atienden con datos más débiles) y genera la alerta Respaldo de abonados IMS no disponible. Los códigos de error de la API comienzan con MPBX-IMS-, por ejemplo MPBX-IMS-OFF (IMS está desactivado en el nodo), MPBX-IMS-SETTINGS-INVALID y MPBX-IMS-PEER-IN-USE; los códigos de error de la API los listan todos con su solución.
Conviene saber
- Las identidades IMS nunca funcionan como nombres de usuario de SIP digest, y un registro IMS fallido nunca recurre a digest.
- Los hosts de VoWiFi deben descartar los paquetes cuyo origen esté en el pool del ePDG a menos que lleguen por un túnel: el PBX interpreta un origen dentro del pool como el acceso Wi-Fi.
- No se admiten: la fragmentación de mensajes IKE, MOBIKE ni el recambio de claves de un túnel (un teléfono que cambia las claves simplemente se reconecta).