Saltar al contenido principal

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 REGISTER a MonoPbx por la sesión ims. 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​

NecesitaNotas
free5GCUna 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 programarDebe 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éfonosTelé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 MonoPbxLinux, accesible desde el UPF de free5GC con una dirección IP fija. El paso 1 enlaza a las guías de instalación.
RedUna 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 nombresEl 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.

NombreEjemplo
Host de MonoPbx (P-CSCF)192.0.2.10
Host de free5GC (SMF, UPF, PCF)192.0.2.20
Subred de UE internet10.60.0.0/16
Subred de UE ims10.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 consolaValor para esta guíaPor qué
Código de país móvil (MCC)208Su PLMN
Código de red móvil (MNC)93Su PLMN. 2 o 3 dígitos
Dominio principal IMSims.mnc093.mcc208.3gppnetwork.orgEl realm que los teléfonos derivan de la SIM
Datos de abonados desdeEsta instalación (integrado)Vea el paso 4
Algoritmo predeterminado para abonados nuevosMilenageLo que usa free5GC (el WebConsole ofrece OPc y OP)
Proteger los registros con IPsecDesactivado para esta primera pruebaVea la nota siguiente
Permitir voz por Wi-FiDesactivado 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 ims hacia 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 de 10.62.0.0/16 conserven 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 permita 10.62.0.0/16 hacia 192.0.2.10 en 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 WebConsoleValor
SUPI (IMSI)imsi-208930000000001, el IMSI de la SIM
PLMN ID20893
GPSI (MSISDN)opcional, el número de teléfono
Authentication Management Field (AMF)8000 (el predeterminado)
Operator Code Type / ValueOPc (u OP) y su valor
Permanent Authentication Keyla K de la SIM
SQNdeje el valor predeterminado

Para el slice (SST 1, SD 010203), configure dos redes de datos:

Data Network NameDefault 5QINotas
internet9Session AMBR según lo necesite
ims5El 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​

  1. Vaya a Red móvil (VoLTE / VoNR), Abonados IMS, Agregar un abonado.
  2. Introduzca el IMSI (208930000000001, sin el prefijo imsi-), 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.
  3. Elija la Extensión a la que pertenece esta SIM. Una SIM se registra solo contra una extensión habilitada de un usuario activo.
  4. 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 predeterminado 208930000000001@ims.mnc093.mcc208.3gppnetwork.org. En Identidades públicas (IMPU) agregue solo identidades adicionales, por ejemplo tel:+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:8443 y reenvíe al bindingIPv4:port del PCF de pcfcfg.yaml (127.0.0.7:8000 en 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 consolaValor
Servidor de políticasPCF por HTTP (N5)
URL base del PCFhttps://pcf.example.net:8443
Autenticación del PCFNinguna (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.

  1. Inserte la SIM programada. El teléfono debe registrarse en su PLMN (208/93) en modo 5G standalone y tener datos en el DNN internet.
  2. Agregue el APN de IMS: nombre ims, APN ims, tipo ims. El nombre debe coincidir con el DNN que creó en free5GC.
  3. 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 CarrierConfigManager son KEY_CARRIER_VOLTE_AVAILABLE_BOOL (carrier_volte_available_bool) para las llamadas IMS, KEY_VONR_ENABLED_BOOL (vonr_enabled_bool) y KEY_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, y KEY_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.
  4. Defina la dirección del SMSC del teléfono con la que configuró en MonoPbx (paso 7), si la solicita.
  5. 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.

  1. En la consola, abra Abonados IMS y compruebe que el abonado de la SIM esté Activo.
  2. 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.
  3. Llame a otra extensión desde el teléfono.
  4. 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.

  1. 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.
  2. 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.
  3. 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 de 10.62.0.0/16.
  • Desde la dirección ims del teléfono, el puerto SIP de MonoPbx responde: compruebe en el host de MonoPbx que llega SIP desde 10.62.x.x (sudo tcpdump -ni any udp port 5060).
  • El REGISTER del teléfono se responde con 401 y luego con 200 OK. Con el registro del motor en nivel debug, MonoPbx indica el motivo del rechazo de un 403 (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íntomaCausa probableQué comprobar
El teléfono se registra pero no tiene sesión PDU imsFalta el DNN en el teléfono, el abonado, el supportDnnList del AMF, el SMF o el UPFQue 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 NRLa red no anuncia voz IMS sobre PS, o el teléfono no tiene VoNR para esta PLMNimsVoPS: 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 registraNo se entregó ninguna dirección de P-CSCFQue 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 MonoPbxEnrutamiento, firewall o NATLa 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 vezLa K o el OPc difieren entre free5GC y MonoPbx, o el teléfono rechaza la redVuelva 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 403El 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á configuradoLa 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-AfterEl respaldo de datos de abonados no está disponibleEn 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ónLa SIM está vinculada a otra extensión, o la extensión está deshabilitadaEl vínculo del abonado; el estado de la extensión
Las llamadas se conectan con audio unidireccional o sin audioEl UPF no llega a rtpengine, o rtpengine anuncia una dirección que la subred ims no alcanzaEl 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 fallanEl 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éfonoLa 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 perdidoEl 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.org se 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 id en 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_STATIC es 0 y EPDG_ADDRESS_PLMN es 1; ponga 0 primero 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ón pcscf de smfcfg.yaml en 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] pcscf en 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​

  1. Active las llamadas por Wi-Fi y únase a la red Wi-Fi que usa su resolvedor.
  2. En la consola, la tarjeta Estado muestra el ePDG con sus túneles y las direcciones internas asignadas.
  3. 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​