Saltar al contenido principal

Use MonoPbx como el IMS de una red privada 4G/5G con Open5GS

Esta guía conecta a MonoPbx una red LTE o 5G privada construida con Open5GS. Open5GS se encarga del lado de radio y datos (attach, portadores, 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 normal de MonoPbx para voz y SMS.

Al terminar, un teléfono de su red podrá registrarse para VoLTE, llamar a una extensión y recibir una llamada de una extensión.

:::info Página de referencia Esta guía es un recorrido paso a paso. Cada ajuste de IMS se describe en Modo IMS (VoLTE y VoWiFi). ¿Ejecuta un núcleo solo 5G con free5GC? Vea IMS para una red privada con free5GC. :::

Qué va a construir​

data (internet APN)
Phone ──radio── eNB / gNB ──┬──────────────────────────────▶ internet
(SIM) │
┌─────────▼───────────── Open5GS ─────────────┐
│ MME / AMF SGW-U/UPF SMF HSS / UDM │
│ │ PCRF (4G) / PCF (5G)
└──────────┬───────────────┼─────────┬────────┘
│ "ims" APN/DNN │ │ Diameter Rx (4G)
│ (own subnet) │ │ TCP 3868
┌──────────▼───────────────┘ │
│ MonoPbx │
│ P-CSCF + S-CSCF + registrar ◀────┘
│ SIP 5060, built-in subscriber data (HSS 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 conecta (attach) al APN predeterminado (internet) y luego abre una segunda conexión PDN en el APN ims (DNN en 5G). Open5GS asigna a esa sesión su propio rango de direcciones y le indica al teléfono la dirección del P-CSCF durante el establecimiento de la sesión. 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, así que MonoPbx necesita los mismos K y OPc que el abonado de Open5GS.
  • Rx (4G): en cada llamada, MonoPbx pide al PCRF de Open5GS un portador dedicado para el flujo de voz. Es opcional; sin él, las llamadas usan el portador predeterminado de ims.
  • VoWiFi (opcional): el teléfono construye un túnel IKEv2 hacia el ePDG de MonoPbx por cualquier Wi-Fi. Open5GS no interviene.

Antes de comenzar​

NecesitaNotas
Open5GSUna red que funcione, donde un teléfono ya se conecta y tiene internet por el APN internet. Las claves de configuración de abajo se verificaron con los archivos de Open5GS 2.8.0. Vea el inicio rápido de Open5GS.
SIM que pueda programarDebe conocer el IMSI, K y OPc (o OP) de cada SIM. Open5GS y MonoPbx deben tener los mismos valores. En esta guía se usa la PLMN de prueba 001/01. Open5GS también incluye 999/70 como valor predeterminado; si la usa, reemplace mnc001.mcc001 por mnc070.mcc999 en todas partes.
TeléfonosTeléfonos que admitan VoLTE y a los que se pueda indicar que lo usen en su PLMN (vea el paso 6).
Un host de MonoPbxLinux, accesible desde el plano de usuario de Open5GS (UPF) en una dirección IP fija. El paso 1 enlaza a las guías de instalación.
RedUna ruta desde la subred de UE ims al 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 001/01: ims.mnc001.mcc001.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. Reemplácelas por las suyas.

NombreEjemplo
Host de MonoPbx (P-CSCF)192.0.2.10
Host del núcleo Open5GS (SMF, PCRF, UPF)192.0.2.20
Subred de UE internet10.45.0.0/16
Subred de UE ims10.46.0.0/16
Dirección del ePDG (VoWiFi)192.0.2.30
Identidad Diameter de MonoPbxmpbx.ims.mnc001.mcc001.3gppnetwork.org, realm ims.mnc001.mcc001.3gppnetwork.org

Paso 1. Instale MonoPbx​

Instale MonoPbx con el instalador de VM, Docker Compose, paquetes o Kubernetes, y complete la primera ejecución. Después cree al menos un usuario con una extensión para cada SIM, como en Agregar usuarios, extensiones y teléfonos. Una SIM solo se registra contra una extensión habilitada de un usuario activo.

Abra estos puertos hacia el plano de usuario de Open5GS (la subred de UE ims): UDP y TCP 5060 (SIP) y el rango RTP de rtpengine. MonoPbx se conecta hacia afuera al PCRF por TCP 3868, así que nada escucha Diameter. La lista completa está en Requisitos de red.

:::tip A dónde envían SIP los teléfonos Los teléfonos envían SIP a la dirección del P-CSCF que les entrega Open5GS. 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 configure el realm​

IMS está desactivado de forma predeterminada. Un administrador del sistema lo activa en la configuración de la instalación y después reinicia MonoPbx.

En una instalación por paquetes o 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 con un archivo de reemplazo 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, así que use 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)001Su PLMN
Código de red móvil (MNC)01Su PLMN. 2 o 3 dígitos
Dominio principal IMSims.mnc001.mcc001.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 Open5GS
Proteger los registros con IPsecDesactivado para esta primera pruebaVea la nota de abajo
Permitir voz por Wi-FiDesactivado hasta la sección opcional de VoWiFi

Guarde. El IMPI predeterminado de una SIM nueva pasa a ser <IMSI>@ims.mnc001.mcc001.3gppnetwork.org.

:::note IPsec (TS 33.203) Con IPsec desactivado, los registros viajan por SIP sin cifrar en la sesión 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. Open5GS: el APN ims y la dirección del P-CSCF​

Los teléfonos necesitan una segunda sesión llamada ims con su propio rango de direcciones, y la dirección del P-CSCF en el establecimiento de la sesión. Haga los cambios de abajo y luego reinicie los daemons que se indican al final.

SMF: pool de direcciones para ims y el P-CSCF​

En smf.yaml, asigne a cada DNN su propia subred (esta estructura es la del archivo de ejemplo de Open5GS) y defina p-cscf como MonoPbx. Ambos son claves bajo smf:.

smf:
session:
- subnet: 10.45.0.0/16
gateway: 10.45.0.1
dnn: internet
- subnet: 10.46.0.0/16
gateway: 10.46.0.1
dnn: ims
p-cscf:
- 192.0.2.10

El archivo de ejemplo de Open5GS advierte que un UE que solicite un DNN distinto de los que usted enumera puede hacer fallar el SMF y el UPF, así que enumere todos los DNN que usen sus teléfonos. En 5G, si restringe los DNN con el bloque info: del SMF, agregue ims a la lista de DNN del slice.

UPF: la interfaz correspondiente​

upf.yaml necesita los mismos dos pools, y cada uno tiene un dispositivo de red con la dirección de la puerta de enlace (del archivo de ejemplo de Open5GS):

upf:
session:
- subnet: 10.45.0.0/16
gateway: 10.45.0.1
dnn: internet
- subnet: 10.46.0.0/16
gateway: 10.46.0.1
dnn: ims
dev: ogstun2

Cree el segundo dispositivo y asígnele la dirección de la puerta de enlace (el pool internet conserva el ogstun predeterminado):

sudo ip tuntap add name ogstun2 mode tun
sudo ip addr add 10.46.0.1/16 dev ogstun2
sudo ip link set ogstun2 up

Enrutamiento y firewall​

La subred ims debe llegar a MonoPbx y MonoPbx debe llegar de vuelta a ella:

  • Si MonoPbx está en otro host, agregue una ruta de retorno en él (o en el router que use): sudo ip route add 10.46.0.0/16 via 192.0.2.20
  • No aplique NAT a la subred ims hacia MonoPbx. MonoPbx pide un portador al PCRF usando la dirección del teléfono tal como la ve en SIP, y el PCRF encuentra la sesión por esa dirección.
  • Si aplicó el endurecimiento del inicio rápido de Open5GS (reglas que descartan el tráfico de las subredes de UE hacia el host del núcleo), permita 10.46.0.0/16 hacia 192.0.2.10 en UDP/TCP 5060 y en el rango de rtpengine.
  • Mantenga activo el reenvío (net.ipv4.ip_forward=1), igual que para el pool internet.

QoS de la sesión ims​

QCI 5 (5QI 5) es la QoS estándar de señalización IMS y Open5GS la necesita en el portador predeterminado de la sesión ims. Se configura por abonado en el paso 4.

Reinicie los daemons que leen estos archivos:

sudo systemctl restart open5gs-smfd open5gs-upfd

Paso 4. Abonados​

Cada SIM existe en dos lugares: en Open5GS (para que el teléfono pueda conectarse) y en MonoPbx (para que el teléfono pueda registrarse para voz). Ambos deben tener el mismo IMSI, K, OPc y AMF.

En la WebUI de Open5GS​

Abra http://<open5gs host>:9999, Subscriber, y agregue o edite la SIM:

Campo de la WebUIValor
IMSI001010000000001 (el IMSI de la SIM)
Subscriber Key (K)la K de la SIM
USIM Type / Operator KeyOPc (u OP) y su valor
Authentication Management Field (AMF)8000 (el valor predeterminado)
MSISDNopcional, el número de teléfono

En Slice Configurations, Session Configurations, agregue dos sesiones:

DNN/APNTipo5QI/QCIARP Priority LevelCapabilityVulnerability
internetIPv498DisabledDisabled
imsIPv451DisabledDisabled

Los valores son los del tutorial de VoLTE de Open5GS. Asigne a la sesión ims un Session-AMBR (por ejemplo 3850 Kbps de bajada y 1530 Kbps de subida, del mismo tutorial).

Para portadores dedicados (el paso opcional de Rx), agregue una PCC Rule a la sesión ims: 5QI/QCI 1 (voz), ARP priority 2, Capability Enabled, Vulnerability Enabled, MBR y GBR de 128 Kbps en ambos sentidos. El PCRF de Open5GS busca una regla con QCI 1 para cada flujo de audio y rechaza la solicitud cuando no hay ninguna. Guarde.

En MonoPbx​

  1. Vaya a Red móvil (VoLTE / VoNR), Abonados IMS, Agregar un abonado.
  2. Ingrese el IMSI, la clave del 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 solo se registra 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:001010000000001@ims.mnc001.mcc001.3gppnetwork.org, y el IMPI predeterminado 001010000000001@ims.mnc001.mcc001.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 mostrarlos, 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 ese acceso. Cualquier otro caso recibe un 403 sin más.

:::info Dónde viven las claves Usted ingresa las claves dos veces porque Open5GS autentica el attach (su propio HSS) y MonoPbx autentica el registro IMS. No necesitan comunicarse entre sí para esto. MonoPbx mantiene su propio número de secuencia para cada SIM, así que el primer registro puede tardar un intercambio adicional mientras la SIM y MonoPbx se ponen de acuerdo. Eso es normal.

MonoPbx también puede tomar los datos de abonados de un HSS externo por Cx, para los HSS que implementan Cx; vea Modo IMS. Esta guía no lo usa. :::

Paso 5. Control de políticas por Rx (4G)​

Este paso es opcional. Hace que Open5GS cree un portador de voz dedicado (QCI 1) para cada llamada. Si lo omite, las llamadas usan el portador ims predeterminado, lo cual está bien para una primera prueba.

MonoPbx abre una conexión Diameter con el PCRF de Open5GS y envía solicitudes Rx para los medios de la llamada. Open5GS responde creando el portador a través del SMF.

Lado de Open5GS: freeDiameter​

Open5GS funciona sobre freeDiameter. El PCRF solo acepta pares que conoce, así que agregue MonoPbx a pcrf.conf (en la instalación de Open5GS es /etc/freeDiameter/pcrf.conf) y haga que el PCRF escuche en una dirección a la que MonoPbx pueda llegar. El archivo de ejemplo escucha solo en 127.0.0.9:

Identity = "pcrf.localdomain";
Realm = "localdomain";
ListenOn = "127.0.0.9";
ListenOn = "192.0.2.20";
NoRelay;

ConnectPeer = "smf.localdomain" { ConnectTo = "127.0.0.4"; No_TLS; };
ConnectPeer = "mpbx.ims.mnc001.mcc001.3gppnetwork.org" { ConnectTo = "192.0.2.10"; No_TLS; };
  • Conserve las líneas que ya están en su archivo (Identity, Realm, TLS_*, LoadExtension, el par smf). Solo agregue el segundo ListenOn y el ConnectPeer de mpbx.
  • El nombre en ConnectPeer debe ser exactamente el Origin-Host que usted asigne a MonoPbx más abajo. freeDiameter descarta la conexión si la identidad en la respuesta de capacidades es distinta.
  • No_TLS significa sin TLS en el enlace, como en el archivo de ejemplo. MonoPbx no escucha Diameter, así que los intentos del propio PCRF de conectarse a 192.0.2.10 fallarán y se reintentarán; eso es inofensivo. La conexión que MonoPbx abre hacia el PCRF es la que transporta el tráfico.
  • La Identity y el Realm predeterminados en Open5GS son pcrf.localdomain y localdomain. Si los cambió, use sus valores en MonoPbx.
  • Si su compilación de freeDiameter rechaza dos líneas ListenOn, reemplace la línea de loopback por la nueva dirección y cambie ConnectTo en smf.conf a la misma dirección.

Reinicie el PCRF y el SMF:

sudo systemctl restart open5gs-pcrfd open5gs-smfd

Lado de MonoPbx: par Diameter y control de políticas​

En Red móvil (VoLTE / VoNR):

  1. En Control de políticas (portadores dedicados) configure Servidor de políticas en PCRF por Diameter Rx.
  2. Configure Origin-Host Diameter propio como mpbx.ims.mnc001.mcc001.3gppnetwork.org y Origin-Realm Diameter propio como ims.mnc001.mcc001.3gppnetwork.org.
  3. En Pares Diameter, Agregar un par:
Campo de la consolaValor
Nombreopen5gs-pcrf
Identidad del par (Destination-Host)pcrf.localdomain
Realm del par (Destination-Realm)localdomain
Nombre de host o dirección IP192.0.2.20
Puerto3868
TransporteTCP
Usar TLSdesactivado (el par PCRF usa No_TLS)
Se usa paraRx (control de políticas)
Prioridad (la más baja primero)1
Enviar solicitudes de watchdogactivado, 30 segundos
En usoactivado
  1. Guarde y luego reinicie el motor de MonoPbx para que abra la conexión (los pares Diameter y el control 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.

El Realm del par debe ser el realm propio del PCRF: MonoPbx dirige cada solicitud a él y el PCRF no retransmite mensajes de otros realms.

La tarjeta Estado al final de la página de ajustes muestra el par como Conectado después de unos segundos. El intercambio de capacidades (CER/CEA) requiere que el PCRF admita la aplicación Rx y responda con la identidad que usted configuró; de lo contrario, la tarjeta indica por qué el par está caído.

Para proteger el enlace Diameter con TLS, entregue a MonoPbx la CA del certificado del PCRF y active Usar TLS; del lado de Open5GS, quite No_TLS de ese ConnectPeer. Esta guía no cubre la configuración del certificado.

5G (N5 hacia un PCF)​

En un núcleo 5G no se usa el PCRF de Open5GS. MonoPbx consulta a un PCF por HTTP con el mismo fin (Servidor de políticas: PCF por HTTP (N5), la URL base del PCF, la autenticación y, opcionalmente, las redes de origen del PCF). Está pensado para un PCF que acepte solicitudes de sesión de aplicación de Npcf_PolicyAuthorization tal como las envía MonoPbx.

Open5GS funciona con N5 a partir de esta versión de MonoPbx. MonoPbx envía el atributo de funciones admitidas (suppFeat, la función IMS-SBI) que el PCF de Open5GS exige en una solicitud de creación de sesión de aplicación; las versiones anteriores no lo hacían y el PCF rechazaba cada solicitud con HTTP 400. Use esta versión de MonoPbx o una posterior. En la WebUI de Open5GS asigne a la sesión ims una PCC Rule como para Rx (5QI 1, paso 4) y revise el registro del PCF para ver la solicitud de sesión de aplicación después de una llamada. Si se rechaza una solicitud, la llamada sigue funcionando en el flujo QoS predeterminado de la sesión ims (5QI 5).

Paso 6. Teléfonos​

  1. Inserte la SIM programada. El teléfono debe conectarse a su PLMN (001/01) y tener datos en el APN internet.
  2. Agregue un APN de IMS: nombre ims, APN ims, tipo ims (algunos teléfonos llaman al tipo "IMS" y lo mantienen separado del APN de datos predeterminado). El nombre del APN debe coincidir con el DNN que creó en Open5GS.
  3. Active VoLTE.
    • Los teléfonos solo usan VoLTE donde la configuración del operador lo permite para la PLMN de la SIM, y una PLMN de laboratorio no la tiene. Los teléfonos difieren en esto, así que verifique qué admite su equipo.
    • Android: lo decide la configuración del operador. Las claves relevantes de CarrierConfigManager son KEY_CARRIER_VOLTE_AVAILABLE_BOOL (carrier_volte_available_bool) para VoLTE y KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL (carrier_wfc_ims_available_bool) para las llamadas por Wi-Fi. Pueden definirse con 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: VoLTE y las llamadas por Wi-Fi se habilitan con el perfil de operador instalado para la SIM, así que una SIM de laboratorio necesita un perfil que las permita. Pregunte a su proveedor de SIM qué equipos ha verificado.
  4. Configure la dirección del SMSC del teléfono con la que definió en MonoPbx (paso 7), si la solicita.
  5. Alterne el modo avión para que el teléfono se conecte de nuevo y construya la sesión ims. El teléfono debe mostrar un indicador de VoLTE o HD Voice una vez registrado.

Si el SMF devolvió una dirección de P-CSCF, el teléfono la usará. En muchos teléfonos puede leerla en el registro del módem o de IMS; debe ser 192.0.2.10.

Paso 7. Primera llamada y SMS​

Llamadas.

  1. En la consola, abra Abonados IMS y verifique que el abonado de la SIM esté Activo.
  2. Después de que 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 móvil.
  4. Marque un número externo desde el teléfono móvil para probar su troncal y las reglas de salida, igual que con cualquier extensión.

Los medios pasan por rtpengine, así que la dirección de rtpengine que MonoPbx anuncia debe ser accesible desde la subred ims.

:::info Llamadas a otros tipos de teléfono Un teléfono VoLTE habla AMR-WB o AMR; los teléfonos de escritorio y las troncales hablan G.711. Las llamadas de teléfono móvil a teléfono móvil no necesitan conversión. Para llamadas entre un teléfono móvil y cualquier otra cosa, active Códecs móviles para VoLTE y VoWiFi (AMR-WB, AMR) en los ajustes y use un rtpengine que pueda codificar AMR. Lea primero la nota de licencia de ese ajuste; las licencias de los códecs AMR y EVS son su responsabilidad. Vea Modo IMS. :::

SMS.

  1. En los ajustes de IMS, configure 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 texto desde el teléfono móvil. 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 reporte de entrega al teléfono.
  3. Un texto que la empresa reciba para un número enrutado al usuario o a la extensión de la SIM también se entrega al teléfono móvil.

Lista de verificación​

Recórrala en orden. Deténgase en la primera que falle y use la tabla de solución de problemas.

  • El teléfono se conectó y tiene internet en el APN internet. En Open5GS: sudo journalctl -u open5gs-mmed -u open5gs-smfd muestran el attach y la sesión.
  • Existe una segunda sesión para el APN ims, con una dirección de 10.46.0.0/16 (el registro del SMF muestra la segunda sesión).
  • Desde la dirección ims del teléfono, el puerto SIP de MonoPbx responde: verifique en el host de MonoPbx que llegue SIP desde 10.46.x.x (sudo tcpdump -ni any udp port 5060).
  • El REGISTER del teléfono se responde con 401 y luego 200 OK. Con el registro del motor en 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 Rx: en Red móvil (VoLTE / VoNR), Red, la tarjeta Estado muestra el par Diameter como Conectado.
  • Solo Rx: haga una llamada y luego busque en /var/log/open5gs/pcrf.log la solicitud Rx de MonoPbx y en los registros del SMF y del MME la creación de un portador dedicado. Con dbg_msg_dumps cargado como en el archivo de ejemplo, el PCRF imprime los mensajes Diameter que recibe. Al terminar la llamada, el portador se elimina.
  • Una llamada en cada sentido tiene audio en ambos sentidos.
  • Un texto desde el teléfono móvil llega a su destino y un texto al número de la SIM llega al teléfono móvil.

Solución de problemas​

SíntomaCausa probableQué revisar
El teléfono se conecta pero no tiene sesión imsFalta el APN en el teléfono o en el abonado, o el DNN no tiene poolQue el APN ims del teléfono coincida exactamente con el DNN; que el abonado tenga una sesión ims en la WebUI; que smf.yaml y upf.yaml incluyan la subred ims; que el SMF y el UPF se hayan reiniciado
El teléfono tiene la sesión ims pero nunca se registraNo se entregó la dirección del P-CSCFQue p-cscf esté definido bajo smf: y el SMF se haya reiniciado; que el APN de IMS del teléfono tenga tipo ims
El REGISTER nunca llega a MonoPbxEnrutamiento, firewall o NATLa ruta de retorno a 10.46.0.0/16; puertos 5060 UDP/TCP abiertos; sin NAT de la subred ims; las reglas de endurecimiento del inicio rápido
El REGISTER recibe 401 una y otra vezLa K o el OPc difieren entre Open5GS y MonoPbx, o el teléfono rechaza la redVuelva a ingresar K y OPc en MonoPbx con Reemplazar claves; verifique que el AMF sea 8000 en ambos lados. Si el número de secuencia de la SIM va adelantado, MonoPbx se resincroniza solo; 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 ese acceso; la identidad To no es una de las identidades públicas de la SIM; se requiere IPsec pero no está configuradoLa página del abonado; para una SIM agregada con una versión anterior, agregue sip:<IMSI>@ims.mnc001.mcc001.3gppnetwork.org como IMPU; el ajuste de IPsec
El REGISTER recibe 500 con Retry-AfterEl back end de abonados no está disponibleEl modo es Esta instalación (integrado) en esta guía; un back end distinto debe ser accesible
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 en un solo sentido o sin audioEl UPF no llega a rtpengine, o rtpengine anuncia una dirección a la que la subred ims no llegaEl enrutamiento de 10.46.0.0/16 a la dirección de rtpengine y al rango RTP; RTPE_ADVERTISE; el firewall; después revise Códecs móviles si una llamada de teléfono móvil a troncal está en silencio
El par Diameter permanece Caído o ConectandoEl PCRF no conoce a MonoPbx, las identidades difieren o un firewall bloquea 3868Que el nombre de ConnectPeer sea igual al Origin-Host de MonoPbx exactamente; que la Identidad del par sea igual a la Identity del PCRF; que el PCRF escuche en 192.0.2.20 (ss -ltn sport = :3868); que TCP 3868 esté abierto desde el host de MonoPbx; la tarjeta de estado muestra el motivo
El par está Conectado pero las llamadas no tienen portador dedicadoNo hay regla PCC con QCI 1, no hay sesión Gx para la dirección del teléfono, o hay NAT entre el UPF y MonoPbxQue la sesión ims tenga una regla PCC con QCI 1 en la WebUI; pcrf.log en busca de "No PCC Rule" o "Cannot find Gx Session"; que la dirección del teléfono, tal como la ve MonoPbx, no esté traducida
Las llamadas se cortan cuando no se puede establecer un portadorEl PCRF lo rechazó o la radio no admite portadores dedicadosUn rechazo normalmente deja la llamada en el portador predeterminado; verifique que el eNB admita QoS y portadores dedicados

Opcional: VoWiFi (llamadas por Wi-Fi) con el ePDG​

Con VoWiFi, el teléfono construye 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. Open5GS no participa: el túnel transporta solo la señalización y los medios IMS del teléfono hacia MonoPbx, y no hay conexión S2b con el SMF de Open5GS.

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, tomados 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.mnc001.mcc001.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 confíe el teléfono. Los teléfonos validan el certificado del ePDG contra su propio almacén de confianza, así que para una red privada use un certificado de una CA pública, o instale su CA en los teléfonos de prueba. Después 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 pool que no lleguen a través del 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 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.mnc001.mcc001.pub.3gppnetwork.org (PLMN 001/01)
  • 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 solo responde para redes aprovisionadas mediante la membresía de la GSMA y el IPX. Una red privada o de laboratorio no está en ella, así que usted mismo debe responder a este nombre: ejecute un resolvedor DNS con una zona local para él y haga que los teléfonos usen ese resolvedor.
  • Configure 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 ejecuta. Cada ejemplo responde epdg.epc.mnc001.mcc001.pub.3gppnetwork.org con 192.0.2.30:

dnsmasq

address=/epdg.epc.mnc001.mcc001.pub.3gppnetwork.org/192.0.2.30

Unbound

server:
local-zone: "epdg.epc.mnc001.mcc001.pub.3gppnetwork.org." redirect
local-data: "epdg.epc.mnc001.mcc001.pub.3gppnetwork.org. 300 IN A 192.0.2.30"

BIND (named.conf, y luego un archivo de zona)

zone "epdg.epc.mnc001.mcc001.pub.3gppnetwork.org" {
type master;
file "/etc/bind/db.epdg.mnc001.mcc001";
};
$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

Después haga que los teléfonos usen ese resolvedor. El servidor DHCP de la red Wi-Fi entrega servidores DNS a los teléfonos que se unen a ella; configure ahí la dirección del resolvedor (para dnsmasq en el mismo equipo, dhcp-option=option:dns-server,192.0.2.53) y verifique que el teléfono no use un servicio de DNS privado, una VPN ni un resolvedor celular para esta búsqueda. Compruébelo desde una laptop en el mismo Wi-Fi: dig epdg.epc.mnc001.mcc001.pub.3gppnetwork.org debe devolver 192.0.2.30.

En Android tiene dos opciones más para dispositivos de prueba:

  • Use el mismo reemplazo de DNS. Funciona sin cambiar el teléfono.
  • Defina la dirección del ePDG en la configuración del 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 dirección. 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.
    • Estas son claves de configuración del operador; una app normal no puede cambiarlas. Vea la referencia de Android.

Cómo encuentra el teléfono al P-CSCF​

  • Por LTE, el teléfono aprende la dirección del P-CSCF de la red cuando establece la sesión ims: Open5GS coloca las direcciones p-cscf de smf.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 de IKEv2, junto con la dirección interna y los servidores DNS.

Si usa el dominio IMS (ims.mnc001.mcc001.3gppnetwork.org) como dominio SIP, los teléfonos solo lo usan dentro de los mensajes SIP enviados a la dirección del P-CSCF que se les entregó; no tiene que resolverse en DNS para esta configuración.

Verifique 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 Rx está activado, una llamada por Wi-Fi pide un portador al PCRF de Open5GS usando la dirección del túnel del teléfono, que el PCRF no conoce. El PCRF la rechaza y la llamada continúa sin portador 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.

Siguientes pasos​