Use MonoPbx como IMS de una red 5G privada con free5GC
Esta guía conecta a MonoPbx una red 5G independiente (standalone) privada construida sobre free5GC. free5GC se encarga del lado de radio y datos (registro, sesiones PDU, direcciones IP). MonoPbx es el IMS: es el P-CSCF con el que se registran los teléfonos, verifica la SIM (IMS-AKA) y asigna a cada SIM una extensión ordinaria de MonoPbx para voz y SMS.
free5GC es un núcleo exclusivamente 5G. No hay attach LTE ni PCRF, por lo que los teléfonos usan voz sobre NR (VoNR) en la red de datos ims, y la QoS opcional para las llamadas pasa por el PCF (N5), no por Diameter Rx.
:::info Página de referencia Esta guía es un tutorial paso a paso. Cada ajuste de IMS se describe en Modo IMS (VoLTE y VoWiFi). ¿Usa Open5GS? Vea IMS para una red privada con Open5GS. :::
Qué va a construir
data (internet DNN)
Phone ──NR── gNB ──┬──────────────────────────────────────▶ internet
(SIM) │
┌─────────▼────────────── free5GC ────────────────┐
│ AMF UPF (gtp5g) SMF UDM / UDR PCF │
└───────┬──────────────────────────────┬──────────┘
│ "ims" DNN │ N5 (HTTPS)
│ (own subnet) │ Npcf_PolicyAuthorization
┌───────▼──────────────────────────────▼──────────┐
│ MonoPbx │
│ P-CSCF + S-CSCF + registrar │
│ SIP 5060, built-in subscriber data (HSS/UDM │
│ role), rtpengine for media, extensions, SMS │
└───────▲─────────────────────────────────────────┘
│ IKEv2 / ESP, UDP 500 and 4500 (optional)
Phone ──Wi-Fi── internet ePDG (VoWiFi)
Cómo encaja todo:
- El teléfono se registra en el núcleo 5G y abre una segunda sesión PDU en el DNN
ims. free5GC asigna a esa sesión su propio rango de direcciones y, cuando el teléfono lo solicita, la dirección del P-CSCF. Esa dirección es MonoPbx. - El teléfono envía SIP
REGISTERa MonoPbx por la sesiónims. MonoPbx lo desafía con IMS-AKA y verifica la respuesta con la clave de la SIM, por lo que MonoPbx necesita el mismo IMSI, K y OPc que el abonado de free5GC. MonoPbx no se comunica con el UDM de free5GC para esto. - N5 (opcional): para cada llamada, MonoPbx pide al PCF de free5GC un flujo QoS para el flujo de voz. Sin él, las llamadas usan el flujo QoS predeterminado de la sesión
ims. - VoWiFi (opcional): el teléfono establece un túnel IKEv2 hacia el ePDG de MonoPbx por cualquier red Wi-Fi. free5GC no interviene.
Antes de comenzar
| Necesita | Notas |
|---|---|
| free5GC | Una red 5G SA en funcionamiento donde un teléfono ya se registra y tiene internet en el DNN internet. Las claves de configuración siguientes se verificaron con los archivos de ejemplo de free5GC v4.3.0 y con el código actual de SMF, PCF y WebConsole. Vea la guía de instalación de free5GC. |
| SIM que pueda programar | Debe conocer el IMSI, K y OPc (u OP) de cada SIM. free5GC y MonoPbx deben tener los mismos valores. Esta guía usa la PLMN de ejemplo de free5GC 208/93; sustitúyala por la suya en todos los casos. |
| Teléfonos | Teléfonos compatibles con voz sobre NR (VoNR) en su PLMN. Este es el requisito indispensable de un núcleo solo 5G: si el teléfono no admite VoNR, no puede hacer llamadas IMS en esta red (vea el paso 6). |
| Un host de MonoPbx | Linux, accesible desde el UPF de free5GC con una dirección IP fija. El paso 1 enlaza a las guías de instalación. |
| Red | Una ruta desde la subred de UE ims hasta el host de MonoPbx y de regreso (vea el paso 3), y sin NAT entre el UPF y MonoPbx. |
| Sus nombres | El realm de IMS se deriva de la PLMN: ims.mnc<MNC>.mcc<MCC>.3gppnetwork.org, con el MNC rellenado a tres dígitos. Para la PLMN 208/93: ims.mnc093.mcc208.3gppnetwork.org. Los teléfonos lo construyen a partir de la SIM; no necesita registrarlo en el DNS público. |
Los ejemplos usan direcciones de los rangos de documentación. Sustitúyalas por las suyas.
| Nombre | Ejemplo |
|---|---|
| Host de MonoPbx (P-CSCF) | 192.0.2.10 |
| Host de free5GC (SMF, UPF, PCF) | 192.0.2.20 |
Subred de UE internet | 10.60.0.0/16 |
Subred de UE ims | 10.62.0.0/16 |
| Dirección del ePDG (VoWiFi) | 192.0.2.30 |
| PCF, tal como MonoPbx llega a él (a través del frontal HTTPS del paso 5) | https://pcf.example.net:8443 |
Paso 1. Instale MonoPbx
Instale MonoPbx con el instalador de VM, Docker Compose, paquetes o Kubernetes, y complete el primer arranque. Luego cree al menos un usuario con una extensión para cada SIM, como se indica en Agregar usuarios, extensiones y teléfonos. Una SIM se registra solo contra una extensión habilitada de un usuario activo.
Abra estos puertos hacia el plano de usuario de free5GC (la subred de UE ims): UDP y TCP 5060 (SIP) y el rango RTP de rtpengine. La lista completa está en Requisitos de red.
:::tip Adónde envían SIP los teléfonos
Los teléfonos envían SIP a la dirección del P-CSCF que les entrega free5GC. Use la dirección real del host (192.0.2.10) como dirección de escucha SIP y como sip.advertise. Con el paquete Compose para Linux, el borde SIP (mpbx-sip) ya escucha en el puerto 5060 del host.
:::
Paso 2. Active el modo IMS y defina el realm
IMS está desactivado de forma predeterminada. Un administrador del sistema lo activa en la configuración de la instalación y luego reinicia MonoPbx.
En una instalación por paquetes o de VM, agregue esto al archivo de configuración (mpbx.toml):
[ims]
enabled = true
El mismo ajuste como variable de entorno es MPBX__IMS__ENABLED=true. En el paquete de Docker Compose para Linux, defínalo en los servicios que ejecutan la API y el motor SIP mediante un archivo de sobrescritura adicional junto al paquete (compose.ims.yaml), y agréguelo al comando docker compose ... up -d de la guía de instalación. start.sh no incluye el archivo adicional, por lo que debe usar este comando para iniciar y reiniciar:
services:
mpbx:
environment:
MPBX__IMS__ENABLED: "true"
mpbx-sip-engine:
environment:
MPBX__IMS__ENABLED: "true"
docker compose -f compose.yaml -f compose.linux.yaml -f compose.ims.yaml up -d --wait
Después del reinicio, la sección Red móvil (VoLTE / VoNR) aparece en la consola de administración. Abra Red (administradores del sistema) y configure:
| Campo de la consola | Valor para esta guía | Por qué |
|---|---|---|
| Código de país móvil (MCC) | 208 | Su PLMN |
| Código de red móvil (MNC) | 93 | Su PLMN. 2 o 3 dígitos |
| Dominio principal IMS | ims.mnc093.mcc208.3gppnetwork.org | El realm que los teléfonos derivan de la SIM |
| Datos de abonados desde | Esta instalación (integrado) | Vea el paso 4 |
| Algoritmo predeterminado para abonados nuevos | Milenage | Lo que usa free5GC (el WebConsole ofrece OPc y OP) |
| Proteger los registros con IPsec | Desactivado para esta primera prueba | Vea la nota siguiente |
| Permitir voz por Wi-Fi | Desactivado hasta la sección opcional de VoWiFi |
Guarde. El IMPI predeterminado de una SIM nueva pasa entonces a ser <IMSI>@ims.mnc093.mcc208.3gppnetwork.org.
:::note IPsec (TS 33.203)
Con IPsec desactivado, los registros se ejecutan sobre SIP sin cifrar en la sesión PDU ims, que es una red privada propia. Es la forma más sencilla de lograr una primera llamada. Para proteger los registros con IPsec, ejecute el rol P-CSCF y apunte los motores hacia él como se describe en Modo IMS, VoLTE. Una SIM cuya política de IPsec sea required es rechazada hasta que eso esté configurado.
:::
Paso 3. free5GC: el DNN ims y la dirección del P-CSCF
Los teléfonos necesitan una segunda sesión PDU en el DNN ims, con su propio rango de direcciones y la dirección del P-CSCF en el establecimiento de la sesión. El mismo nombre de DNN debe aparecer en la configuración de AMF, SMF y UPF y en el abonado. Los fragmentos muestran solo lo que usted agrega; conserve el resto de cada archivo de ejemplo.
AMF: permitir el DNN y anunciar voz sobre PS
En config/amfcfg.yaml:
configuration:
supportDnnList:
- internet
- ims
nasIE:
networkFeatureSupport5GS:
enable: true
imsVoPS: 1 # IMS voice over PS session supported; the sample file has 0
imsVoPS es el «indicador de sesión de voz IMS sobre PS» del IE de soporte de funciones de red 5GS (TS 24.501). Es 0 en el archivo de ejemplo. Un teléfono solo inicia voz sobre NR cuando la red indica que se admite voz IMS sobre PS, así que defínalo en 1.
SMF: DNN, grupo de direcciones y P-CSCF
En config/smfcfg.yaml, agregue ims a cada S-NSSAI que transporte voz, con su DNS y el P-CSCF (la clave pcscf va junto a dns), y asigne al UPF un grupo y una interfaz para él. Esta es la estructura del archivo de ejemplo; las partes nuevas son las entradas ims:
configuration:
snssaiInfos:
- sNssai:
sst: 1
sd: 010203
dnnInfos:
- dnn: internet
dns:
ipv4: 8.8.8.8
ipv6: 2001:4860:4860::8888
- dnn: ims
dns:
ipv4: 8.8.8.8
ipv6: 2001:4860:4860::8888
pcscf:
ipv4: 192.0.2.10
userplaneInformation:
upNodes:
UPF:
type: UPF
nodeID: 127.0.0.8
addr: 127.0.0.8
sNssaiUpfInfos:
- sNssai:
sst: 1
sd: 010203
dnnUpfInfoList:
- dnn: internet
pools:
- cidr: 10.60.0.0/16
- dnn: ims
pools:
- cidr: 10.62.0.0/16
interfaces:
- interfaceType: N3
endpoints:
- 127.0.0.8
networkInstances:
- internet
- ims
pcscf: ipv4: es leída por el SMF para cada DNN y se devuelve a un teléfono que solicita una dirección de P-CSCF en su solicitud de sesión PDU (las opciones de configuración de protocolo extendidas). Es solo IPv4. Repita las entradas ims para cada S-NSSAI que usen sus SIM (el archivo de ejemplo tiene un segundo, 112233, con su propio grupo).
UPF: el grupo de direcciones
En config/upfcfg.yaml, agregue el grupo junto al de internet:
dnnList:
- dnn: internet
cidr: 10.60.0.0/16
ipForwardEnable: true
- dnn: ims
cidr: 10.62.0.0/16
ipForwardEnable: true
Los valores de cidr deben coincidir con los pools del SMF.
Enrutamiento y firewall
La subred ims debe llegar a MonoPbx y MonoPbx debe llegar a ella de regreso:
- Si MonoPbx está en otro host, agregue una ruta de retorno en él (o en el router que use):
sudo ip route add 10.62.0.0/16 via 192.0.2.20 - No aplique NAT a la subred
imshacia MonoPbx. La guía de instalación de free5GC enmascara el tráfico que sale por la interfaz de la red de datos (iptables -t nat -A POSTROUTING -o <dn_interface> -j MASQUERADE). Si se llega a MonoPbx por esa interfaz, limite la regla al grupo de internet, por ejemplo-s 10.60.0.0/16, para que el SIP y el medio de10.62.0.0/16conserven su dirección real. El PCF encuentra la sesión del teléfono por esa dirección. - Mantenga activado el reenvío (
sudo sysctl -w net.ipv4.ip_forward=1) y permita10.62.0.0/16hacia192.0.2.10en UDP/TCP 5060 y en el rango de rtpengine en cualquier firewall que haya entre ambos.
Reinicie free5GC para que todas las funciones de red lean los archivos nuevos.
Paso 4. Abonados
Cada SIM existe en dos lugares: en free5GC (para que el teléfono pueda registrarse en el núcleo 5G) y en MonoPbx (para que el teléfono pueda registrarse para voz). Ambos deben tener el mismo IMSI, K, OPc y AMF.
En el WebConsole de free5GC
Abra el WebConsole en http://<WebConsole host>:5000 (el inicio de sesión predeterminado en el readme del WebConsole es admin / free5gc; cámbielo), luego Subscribers y cree el abonado:
| Campo del WebConsole | Valor |
|---|---|
| SUPI (IMSI) | imsi-208930000000001, el IMSI de la SIM |
| PLMN ID | 20893 |
| GPSI (MSISDN) | opcional, el número de teléfono |
| Authentication Management Field (AMF) | 8000 (el predeterminado) |
| Operator Code Type / Value | OPc (u OP) y su valor |
| Permanent Authentication Key | la K de la SIM |
| SQN | deje el valor predeterminado |
Para el slice (SST 1, SD 010203), configure dos redes de datos:
| Data Network Name | Default 5QI | Notas |
|---|---|---|
internet | 9 | Session AMBR según lo necesite |
ims | 5 | El 5QI estándar para la señalización IMS; asígnele un Session AMBR, por ejemplo 1 Mbps en ambos sentidos |
Guarde. El S-NSSAI del abonado debe ser uno que sus AMF y SMF admitan (paso 3).
En MonoPbx
- Vaya a Red móvil (VoLTE / VoNR), Abonados IMS, Agregar un abonado.
- Introduzca el IMSI (
208930000000001, sin el prefijoimsi-), la clave de abonado K y la clave del operador (OPc u OP, que MonoPbx convierte una sola vez y no almacena). Deje Acceso permitido en VoLTE y VoWiFi e IPsec en Seguir el ajuste de la instalación. - Elija la Extensión a la que pertenece esta SIM. Una SIM se registra solo contra una extensión habilitada de un usuario activo.
- MonoPbx agrega por sí mismo la identidad pública (IMPU) con la que se registra una SIM sin aplicación ISIM,
sip:208930000000001@ims.mnc093.mcc208.3gppnetwork.org, y el IMPI predeterminado208930000000001@ims.mnc093.mcc208.3gppnetwork.org. En Identidades públicas (IMPU) agregue solo identidades adicionales, por ejemplotel:+15551230001(el número del teléfono, opcional pero necesario para llegar al teléfono por número). Para muchas SIM use la importación masiva descrita en Modo IMS, abonados. Para cambiar la extensión de una SIM que ya agregó, ábrala con Administrar y elija otra Extensión.
K y OPc son de solo escritura: después de guardar, MonoPbx nunca vuelve a mostrarlas, así que conserve su propio registro.
Una SIM se registra solo cuando está activa, vinculada a una extensión habilitada de un usuario activo, y su política de acceso permite el acceso. En cualquier otro caso recibe un 403 sin más.
:::info Dónde residen las claves Usted introduce las claves dos veces porque free5GC autentica el registro 5G (su UDM) y MonoPbx autentica el registro IMS. Para esto nunca necesitan comunicarse entre sí. MonoPbx mantiene su propio número de secuencia para cada SIM, por lo que el primer registro puede requerir un intercambio adicional mientras la SIM y MonoPbx se ponen de acuerdo. Es normal.
MonoPbx también puede tomar los datos de abonados de un HSS externo por Cx o de un UDM 5G por Nudm, para los núcleos que atienden la autenticación IMS de esa manera; vea Modo IMS. Esta guía no usa ninguno de los dos. :::
Paso 5. Control de políticas por N5 (opcional)
Este paso es opcional. Pide al PCF un flujo QoS para el flujo de voz de cada llamada. Si lo omite, las llamadas usan el flujo QoS predeterminado de la sesión ims, lo cual es suficiente para una primera prueba. El registro, las llamadas y los SMS no dependen de él.
Qué admite free5GC
El PCF de free5GC incluye npcf-policyauthorization en su serviceList. En el código actual del PCF, acepta una solicitud de creación de sesión de aplicación de un AF, encuentra la sesión PDU por la dirección IPv4 o IPv6 del teléfono, convierte cada componente de medio de audio en una regla PCC con 5QI 1 e informa al SMF, que a su vez establece el flujo QoS. También admite el evento de notificación de QoS. MonoPbx envía la dirección del teléfono, los flujos de audio y los eventos que desea, por lo que ambos encajan sobre el papel. Que el flujo QoS se transporte de extremo a extremo en su UPF depende de su versión de free5GC y gtp5g; pruébelo como indica la lista de verificación.
Llegar al PCF por HTTPS
El cliente N5 de MonoPbx acepta una dirección de PCF https:// (http:// simple solo para localhost y 127.0.0.1). El SBI de ejemplo de free5GC usa scheme: http. Puede:
- colocar un proxy inverso con terminación TLS frente al PCF (en el host de MonoPbx o en el de free5GC) que escuche en
https://pcf.example.net:8443y reenvíe albindingIPv4:portdel PCF depcfcfg.yaml(127.0.0.7:8000en el ejemplo), hablando HTTP/2 sobre texto claro con él como hacen las funciones de red de free5GC; o - cambiar el SBI de free5GC a HTTPS como se describe en la documentación de configuración de free5GC.
Use un certificado en el que MonoPbx confíe (una CA pública, o proporcione su CA en los ajustes). No exponga el PCF a nada más que a MonoPbx.
Ajustes de MonoPbx
En Red móvil (VoLTE / VoNR), Diameter y políticas, en Control de políticas (portadores dedicados):
| Campo de la consola | Valor |
|---|---|
| Servidor de políticas | PCF por HTTP (N5) |
| URL base del PCF | https://pcf.example.net:8443 |
| Autenticación del PCF | Ninguna (el PCF de ejemplo no tiene OAuth2 en el SBI), o Token bearer estático si su frontal lo exige |
| Redes de origen del PCF (opcional) | la dirección desde la que el PCF o su proxy envía las notificaciones, como bloque CIDR |
| URL del NRF (opcional) | déjelo vacío |
Guarde y luego reinicie el motor de MonoPbx para que lea los ajustes de políticas (se leen cuando arrancan los motores): docker compose -f compose.yaml -f compose.linux.yaml -f compose.ims.yaml restart mpbx-sip-engine en el paquete Compose para Linux, o reinicie el servicio mpbx en una instalación de un solo proceso. La autenticación con certificado de cliente (mTLS) hacia el PCF no está disponible; use Ninguna o un token bearer.
MonoPbx incluye una dirección de notificación en cada solicitud, https://<base domain>/api/v1/ims/n5/notify/<token>, donde <base domain> es el http.base_domain del PBX. El PCF envía allí los eventos de QoS, por lo que el host del PCF debe poder llegar a esa dirección HTTPS y confiar en su certificado. Si no puede, las llamadas siguen funcionando, pero MonoPbx no se entera cuando se pierde un flujo QoS.
Paso 6. Teléfonos
free5GC ofrece solo 5G, por lo que un teléfono hace llamadas IMS con voz sobre NR.
- Inserte la SIM programada. El teléfono debe registrarse en su PLMN (
208/93) en modo 5G standalone y tener datos en el DNNinternet. - Agregue el APN de IMS: nombre
ims, APNims, tipoims. El nombre debe coincidir con el DNN que creó en free5GC. - Active VoNR y las llamadas VoLTE/IMS.
- Los teléfonos solo usan VoNR donde la configuración de operador lo permite para la PLMN de la SIM, y una PLMN de laboratorio no tiene ninguna. Si el teléfono no puede usar VoNR en su PLMN, no puede hacer llamadas IMS aquí. Compruebe qué admite su equipo.
- Android: la configuración de operador decide. Las claves relevantes de
CarrierConfigManagersonKEY_CARRIER_VOLTE_AVAILABLE_BOOL(carrier_volte_available_bool) para las llamadas IMS,KEY_VONR_ENABLED_BOOL(vonr_enabled_bool) yKEY_VONR_SETTING_VISIBILITY_BOOL(vonr_setting_visibility_bool) para la voz sobre NR,KEY_VONR_ON_BY_DEFAULT_BOOL(vonr_on_by_default_bool) para activarla de forma predeterminada,KEY_CARRIER_NR_AVAILABILITIES_INT_ARRAY(carrier_nr_availabilities_int_array) para los modos 5G que admite el operador, yKEY_CARRIER_WFC_IMS_AVAILABLE_BOOL(carrier_wfc_ims_available_bool) para las llamadas por Wi-Fi. Pueden definirse mediante una app con privilegios de operador (una SIM con reglas de privilegio de operador) o con las herramientas de ingeniería de un dispositivo. Vea la referencia de Android. - iPhone: la voz sobre NR, VoLTE y las llamadas por Wi-Fi se habilitan con el perfil de operador instalado para la SIM, por lo que una SIM de laboratorio necesita un perfil que las permita. Pregunte a su proveedor de SIM qué equipos ha verificado.
- Defina la dirección del SMSC del teléfono con la que configuró en MonoPbx (paso 7), si la solicita.
- Active y desactive el modo avión para que el teléfono se registre de nuevo y construya la sesión PDU
ims.
El teléfono debe usar la dirección del P-CSCF que devolvió el SMF (pcscf: ipv4:, aquí 192.0.2.10). En muchos teléfonos puede leerla del registro del módem o de IMS. Si un teléfono no solicita una dirección de P-CSCF en su solicitud de sesión PDU, el SMF no envía ninguna: algunos equipos necesitan entonces un P-CSCF estático en su configuración de operador.
Paso 7. Primera llamada y SMS
Llamadas.
- En la consola, abra Abonados IMS y compruebe que el abonado de la SIM esté Activo.
- Cuando el teléfono se registre (vea la lista de verificación), llame a la extensión de la SIM desde un teléfono de escritorio o softphone registrado en MonoPbx. El teléfono suena.
- Llame a otra extensión desde el teléfono.
- Marque un número externo desde el teléfono para probar su troncal y las reglas de salida, igual que con cualquier extensión.
El medio pasa por rtpengine, por lo que la dirección de rtpengine que MonoPbx anuncia debe ser alcanzable desde la subred ims.
:::info Llamadas a otros tipos de teléfono Un teléfono IMS usa AMR-WB o AMR; los teléfonos de escritorio y las troncales usan G.711. Las llamadas entre teléfonos IMS no necesitan conversión. Para las llamadas entre un teléfono IMS y cualquier otra cosa, active Códecs móviles para VoLTE y VoWiFi (AMR-WB, AMR) en los ajustes y use un rtpengine capaz de codificar AMR. Lea primero la nota de licencia de ese ajuste; las licencias de los códecs AMR y EVS son responsabilidad suya. Vea Modo IMS. :::
SMS.
- En los ajustes de IMS, defina la dirección del SMSC (un número E.164, un host o un URI SIP, por ejemplo
+10000000000) y asegúrese de que la empresa tenga un servicio de SMS con un número para el usuario. - Envíe un mensaje de texto desde el teléfono. MonoPbx lo acepta, lo envía por el servicio de SMS de la empresa desde uno de los números del usuario y devuelve el informe de entrega al teléfono.
- Un mensaje que la empresa reciba para un número dirigido al usuario o a la extensión de la SIM también se entrega al teléfono.
Lista de verificación
Recórrala en orden. Deténgase en el primer punto que falle y use la tabla de solución de problemas.
- El teléfono se registró en el núcleo 5G y tiene internet en el DNN
internet(los registros de AMF y SMF muestran el registro y la sesión). - Existe una segunda sesión PDU para el DNN
ims, con una dirección de10.62.0.0/16. - Desde la dirección
imsdel teléfono, el puerto SIP de MonoPbx responde: compruebe en el host de MonoPbx que llega SIP desde10.62.x.x(sudo tcpdump -ni any udp port 5060). - El
REGISTERdel teléfono se responde con401y luego con200 OK. Con el registro del motor en nivel debug, MonoPbx indica el motivo del rechazo de un403(nunca las claves). - En la consola, la extensión de la SIM aparece como registrada.
- Solo N5: realice una llamada y luego busque en el registro del PCF la solicitud de sesión de aplicación («App Session Id ... Create») y en el registro del SMF el flujo QoS. Al terminar la llamada, la sesión se elimina.
- Una llamada en cada sentido tiene audio en ambas direcciones.
- Un mensaje de texto del teléfono llega a su destino y un mensaje al número de la SIM llega al teléfono.
Solución de problemas
| Síntoma | Causa probable | Qué comprobar |
|---|---|---|
El teléfono se registra pero no tiene sesión PDU ims | Falta el DNN en el teléfono, el abonado, el supportDnnList del AMF, el SMF o el UPF | Que el APN ims del teléfono coincida exactamente; que el abonado tenga una red de datos ims; que ims esté en supportDnnList, en dnnInfos, dnnUpfInfoList y networkInstances del SMF, y en dnnList del UPF; que free5GC se haya reiniciado |
| El teléfono nunca inicia voz sobre NR | La red no anuncia voz IMS sobre PS, o el teléfono no tiene VoNR para esta PLMN | imsVoPS: 1 en amfcfg.yaml; la configuración de operador del teléfono (paso 6) |
El teléfono tiene la sesión ims pero nunca se registra | No se entregó ninguna dirección de P-CSCF | Que pcscf: ipv4: esté definido para el DNN ims en cada S-NSSAI que usa la SIM y que el SMF se haya reiniciado; que el teléfono solicite una dirección de P-CSCF en su solicitud de sesión PDU |
El REGISTER nunca llega a MonoPbx | Enrutamiento, firewall o NAT | La ruta de retorno a 10.62.0.0/16; los puertos 5060 UDP/TCP abiertos; que la regla de enmascaramiento no cubra la subred ims |
El REGISTER recibe 401 una y otra vez | La K o el OPc difieren entre free5GC y MonoPbx, o el teléfono rechaza la red | Vuelva a introducir K y OPc en MonoPbx con Reemplazar claves; compruebe que el AMF sea 8000 en ambos lados. Si el número de secuencia de la SIM va adelantado, MonoPbx se resincroniza por sí mismo; un 401 que nunca termina es una discrepancia de claves |
El REGISTER recibe 403 | El abonado está suspendido o no está vinculado a una extensión habilitada de un usuario activo; la política de acceso no permite el acceso; la identidad To no es una de las identidades públicas de la SIM; se exige IPsec pero no está configurado | La página del abonado; para una SIM agregada con una versión anterior, agregue sip:<IMSI>@ims.mnc093.mcc208.3gppnetwork.org como IMPU; el ajuste de IPsec |
El REGISTER recibe 500 con Retry-After | El respaldo de datos de abonados no está disponible | En esta guía el modo es Esta instalación (integrado); un respaldo distinto debe ser alcanzable |
| El teléfono se registra pero una llamada nunca hace sonar la extensión | La SIM está vinculada a otra extensión, o la extensión está deshabilitada | El vínculo del abonado; el estado de la extensión |
| Las llamadas se conectan con audio unidireccional o sin audio | El UPF no llega a rtpengine, o rtpengine anuncia una dirección que la subred ims no alcanza | El enrutamiento desde 10.62.0.0/16 hasta la dirección de rtpengine y el rango RTP; RTPE_ADVERTISE; el firewall; luego revise Códecs móviles si una llamada de teléfono a troncal queda en silencio |
| Las solicitudes N5 fallan | El PCF no es alcanzable por HTTPS, el certificado no es de confianza, o el PCF no tiene sesión para la dirección del teléfono | La URL base y el certificado del PCF; que la dirección del teléfono, tal como la ve MonoPbx, no esté traducida; el registro del PCF en busca de «Session Binding failed»; la llamada continúa en el flujo QoS predeterminado |
| N5 funciona pero MonoPbx no se entera de un flujo QoS perdido | El PCF no llega a https://<base domain>/api/v1/ims/n5/notify/... | http.base_domain, el certificado y Redes de origen del PCF |
Opcional: VoWiFi (llamadas por Wi-Fi) con el ePDG
Con VoWiFi, el teléfono establece un túnel IKEv2 hacia el ePDG de MonoPbx por cualquier red Wi-Fi y se registra a través de él. El ePDG autentica el teléfono con EAP-AKA' usando la misma clave de SIM del paso 4 y le asigna una dirección dentro del túnel, la dirección del P-CSCF y un servidor DNS. free5GC no participa: el túnel transporta solo la señalización y el medio IMS del teléfono hacia MonoPbx, y no hay conexión con el núcleo de free5GC.
Ejecute el ePDG
El ePDG es el proceso mpbx-epdg en un host Linux con una dirección pública o enrutable, un certificado para su nombre y permiso para enlazar UDP 500 y 4500. Ajustes, de Modo IMS, VoWiFi:
En los motores:
[ims.epdg]
link_listen = "0.0.0.0:7444" # where the ePDG connects to the engine
pool = "10.9.0.0/22" # the same pool the ePDG uses
El secreto del enlace es la variable de entorno MPBX_IMS_EPDG_LINK_SECRET (32 bytes aleatorios, openssl rand -base64 32), el mismo valor en el motor y en el ePDG.
En el host del ePDG:
[ims]
enabled = true
[ims.epdg]
address = "192.0.2.30"
id = "epdg.epc.mnc093.mcc208.pub.3gppnetwork.org"
cert_file = "/etc/mpbx/epdg.crt"
key_file = "/etc/mpbx/epdg.key"
link_connect = "192.0.2.10:7444"
pool = "10.9.0.0/22"
pcscf = ["192.0.2.10"]
dns = ["192.0.2.53"]
El nombre del certificado debe coincidir con id, y su cadena debe ser una en la que el teléfono confíe. Los teléfonos validan el certificado del ePDG contra su propio almacén de confianza, por lo que en una red privada debe usar un certificado de una CA pública o instalar su CA en los teléfonos de prueba. Luego active Permitir voz por Wi-Fi en los ajustes de IMS. El Acceso permitido de la SIM debe ser VoLTE y VoWiFi o Solo VoWiFi. Descarte los paquetes del grupo que no lleguen por el túnel, como se describe en Modo IMS, Conviene saber.
Cómo encuentra el teléfono al ePDG
El teléfono busca el ePDG por nombre en el DNS. El nombre se construye a partir de la PLMN de la SIM:
epdg.epc.mnc<MNC>.mcc<MCC>.pub.3gppnetwork.org (MNC padded to three digits)
epdg.epc.mnc093.mcc208.pub.3gppnetwork.org (PLMN 208/93)
- En un iPhone, el nombre se deriva del MCC y el MNC de la SIM y no se puede cambiar.
- La zona pública
pub.3gppnetwork.orgse administra a través de la GSMA y responde solo para las redes aprovisionadas mediante la membresía de la GSMA e IPX. Una red privada o de laboratorio no está en ella, por lo que usted mismo debe responder este nombre: ejecute un resolvedor DNS con una zona local para él y haga que los teléfonos usen ese resolvedor. - Defina
iden la configuración del ePDG con este mismo nombre y apunte el nombre a la dirección del ePDG (192.0.2.30).
Elija el resolvedor que ya ejecute. Cada ejemplo responde epdg.epc.mnc093.mcc208.pub.3gppnetwork.org con 192.0.2.30:
dnsmasq
address=/epdg.epc.mnc093.mcc208.pub.3gppnetwork.org/192.0.2.30
Unbound
server:
local-zone: "epdg.epc.mnc093.mcc208.pub.3gppnetwork.org." redirect
local-data: "epdg.epc.mnc093.mcc208.pub.3gppnetwork.org. 300 IN A 192.0.2.30"
BIND (named.conf, luego un archivo de zona)
zone "epdg.epc.mnc093.mcc208.pub.3gppnetwork.org" {
type master;
file "/etc/bind/db.epdg.mnc093.mcc208";
};
$TTL 300
@ IN SOA ns.example.net. admin.example.net. ( 1 3600 600 86400 300 )
IN NS ns.example.net.
IN A 192.0.2.30
Luego haga que los teléfonos usen ese resolvedor. El servidor DHCP de la red Wi-Fi entrega los servidores DNS a los teléfonos que se unen a ella; defina allí la dirección del resolvedor (para dnsmasq en el mismo equipo, dhcp-option=option:dns-server,192.0.2.53) y compruebe que el teléfono no use un servicio DNS privado, una VPN ni un resolvedor celular para esta consulta. Verifique desde una laptop en el mismo Wi-Fi: dig epdg.epc.mnc093.mcc208.pub.3gppnetwork.org debe devolver 192.0.2.30.
En Android tiene dos opciones más para los dispositivos de prueba:
- Use la misma sobrescritura de DNS. Funciona sin modificar el teléfono.
- Defina la dirección del ePDG en la configuración de operador, con las claves
CarrierConfigManager.Iwlan(Android 12, nivel de API 31 y posteriores):KEY_EPDG_STATIC_ADDRESS_STRING(iwlan.epdg_static_address_string): la dirección IP o el FQDN del ePDG.KEY_EPDG_ADDRESS_PRIORITY_INT_ARRAY(iwlan.epdg_address_priority_int_array): el orden en que se prueban las fuentes de direcciones.EPDG_ADDRESS_STATICes0yEPDG_ADDRESS_PLMNes1; ponga0primero para usar la dirección estática.- Las llamadas por Wi-Fi en sí se habilitan con
KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL. - Son claves de configuración de operador; una app normal no puede cambiarlas. Vea la referencia de Android.
Cómo encuentra el teléfono al P-CSCF
- Por 5G, el teléfono obtiene la dirección del P-CSCF de la red cuando establece la sesión PDU
ims: el SMF de free5GC coloca la direcciónpcscfdesmfcfg.yamlen el establecimiento de la sesión (paso 3). No usa DNS para esto. - Por Wi-Fi, el P-CSCF proviene del ePDG: este envía al teléfono las direcciones de
[ims.epdg] pcscfen la carga de configuración IKEv2, junto con la dirección interna y los servidores DNS.
Si usa el dominio IMS (ims.mnc093.mcc208.3gppnetwork.org) como dominio SIP, los teléfonos solo lo usan dentro de los mensajes SIP enviados a la dirección de P-CSCF que se les dio; no tiene que resolverse en DNS para esta configuración.
Compruebe VoWiFi
- Active las llamadas por Wi-Fi y únase a la red Wi-Fi que usa su resolvedor.
- En la consola, la tarjeta Estado muestra el ePDG con sus túneles y las direcciones internas asignadas.
- El teléfono se registra como en VoLTE y la extensión aparece como registrada.
Si el servidor de políticas N5 está activado, una llamada por Wi-Fi pide al PCF de free5GC un flujo QoS usando la dirección de túnel del teléfono, que el PCF no conoce. La solicitud se rechaza y la llamada continúa sin un flujo QoS dedicado.
Las causas habituales cuando el túnel no se establece: el nombre DNS no se resuelve al ePDG, UDP 500 o 4500 está filtrado, el nombre del certificado no coincide con id, o la política de acceso de la SIM es Solo VoLTE. La página del modo IMS describe la tarjeta Estado.
Adónde ir después
- Modo IMS (VoLTE y VoWiFi): todos los ajustes, la tarjeta de estado y los códigos de error.
- IMS para una red privada con Open5GS: la misma configuración para un núcleo Open5GS, con Diameter Rx para LTE.
- Requisitos de red: todos los puertos.
- SMS y mensajería: el servicio de SMS que transporta los mensajes desde y hacia los teléfonos.