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 APNims(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
REGISTERa MonoPbx por la sesiónims. 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
| Necesita | Notas |
|---|---|
| Open5GS | Una 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 programar | Debe 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éfonos | Teléfonos que admitan VoLTE y a los que se pueda indicar que lo usen en su PLMN (vea el paso 6). |
| Un host de MonoPbx | Linux, 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. |
| Red | Una 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 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 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.
| Nombre | Ejemplo |
|---|---|
| Host de MonoPbx (P-CSCF) | 192.0.2.10 |
| Host del núcleo Open5GS (SMF, PCRF, UPF) | 192.0.2.20 |
Subred de UE internet | 10.45.0.0/16 |
Subred de UE ims | 10.46.0.0/16 |
| Dirección del ePDG (VoWiFi) | 192.0.2.30 |
| Identidad Diameter de MonoPbx | mpbx.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 consola | Valor para esta guía | Por qué |
|---|---|---|
| Código de país móvil (MCC) | 001 | Su PLMN |
| Código de red móvil (MNC) | 01 | Su PLMN. 2 o 3 dígitos |
| Dominio principal IMS | ims.mnc001.mcc001.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 Open5GS |
| Proteger los registros con IPsec | Desactivado para esta primera prueba | Vea la nota de abajo |
| Permitir voz por Wi-Fi | Desactivado 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
imshacia 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/16hacia192.0.2.10en UDP/TCP 5060 y en el rango de rtpengine. - Mantenga activo el reenvío (
net.ipv4.ip_forward=1), igual que para el poolinternet.
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 WebUI | Valor |
|---|---|
| IMSI | 001010000000001 (el IMSI de la SIM) |
| Subscriber Key (K) | la K de la SIM |
| USIM Type / Operator Key | OPc (u OP) y su valor |
| Authentication Management Field (AMF) | 8000 (el valor predeterminado) |
| MSISDN | opcional, el número de teléfono |
En Slice Configurations, Session Configurations, agregue dos sesiones:
| DNN/APN | Tipo | 5QI/QCI | ARP Priority Level | Capability | Vulnerability |
|---|---|---|---|---|---|
internet | IPv4 | 9 | 8 | Disabled | Disabled |
ims | IPv4 | 5 | 1 | Disabled | Disabled |
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
- Vaya a Red móvil (VoLTE / VoNR), Abonados IMS, Agregar un abonado.
- 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.
- Elija la Extensión a la que pertenece esta SIM. Una SIM solo se registra 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:001010000000001@ims.mnc001.mcc001.3gppnetwork.org, y el IMPI predeterminado001010000000001@ims.mnc001.mcc001.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 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 parsmf). Solo agregue el segundoListenOny elConnectPeerdempbx. - El nombre en
ConnectPeerdebe 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_TLSsignifica sin TLS en el enlace, como en el archivo de ejemplo. MonoPbx no escucha Diameter, así que los intentos del propio PCRF de conectarse a192.0.2.10fallará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.localdomainylocaldomain. 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 cambieConnectToensmf.confa 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):
- En Control de políticas (portadores dedicados) configure Servidor de políticas en PCRF por Diameter Rx.
- Configure Origin-Host Diameter propio como
mpbx.ims.mnc001.mcc001.3gppnetwork.orgy Origin-Realm Diameter propio comoims.mnc001.mcc001.3gppnetwork.org. - En Pares Diameter, Agregar un par:
| Campo de la consola | Valor |
|---|---|
| Nombre | open5gs-pcrf |
| Identidad del par (Destination-Host) | pcrf.localdomain |
| Realm del par (Destination-Realm) | localdomain |
| Nombre de host o dirección IP | 192.0.2.20 |
| Puerto | 3868 |
| Transporte | TCP |
| Usar TLS | desactivado (el par PCRF usa No_TLS) |
| Se usa para | Rx (control de políticas) |
| Prioridad (la más baja primero) | 1 |
| Enviar solicitudes de watchdog | activado, 30 segundos |
| En uso | activado |
- 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-engineen el paquete Compose para Linux, o reinicie el serviciompbxen 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
- Inserte la SIM programada. El teléfono debe conectarse a su PLMN (
001/01) y tener datos en el APNinternet. - Agregue un APN de IMS: nombre
ims, APNims, tipoims(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. - 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
CarrierConfigManagersonKEY_CARRIER_VOLTE_AVAILABLE_BOOL(carrier_volte_available_bool) para VoLTE yKEY_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.
- Configure la dirección del SMSC del teléfono con la que definió en MonoPbx (paso 7), si la solicita.
- 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.
- En la consola, abra Abonados IMS y verifique que el abonado de la SIM esté Activo.
- 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.
- Llame a otra extensión desde el teléfono móvil.
- 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.
- 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. - 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.
- 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-smfdmuestran el attach y la sesión. - Existe una segunda sesión para el APN
ims, con una dirección de10.46.0.0/16(el registro del SMF muestra la segunda sesión). - Desde la dirección
imsdel teléfono, el puerto SIP de MonoPbx responde: verifique en el host de MonoPbx que llegue SIP desde10.46.x.x(sudo tcpdump -ni any udp port 5060). - El
REGISTERdel teléfono se responde con401y luego200 OK. Con el registro del motor en 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 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.logla solicitud Rx de MonoPbx y en los registros del SMF y del MME la creación de un portador dedicado. Condbg_msg_dumpscargado 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íntoma | Causa probable | Qué revisar |
|---|---|---|
El teléfono se conecta pero no tiene sesión ims | Falta el APN en el teléfono o en el abonado, o el DNN no tiene pool | Que 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 registra | No se entregó la dirección del P-CSCF | Que 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 MonoPbx | Enrutamiento, firewall o NAT | La 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 vez | La K o el OPc difieren entre Open5GS y MonoPbx, o el teléfono rechaza la red | Vuelva 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 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 ese acceso; la identidad To no es una de las identidades públicas de la SIM; se requiere IPsec pero no está configurado | La 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-After | El back end de abonados no está disponible | El 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ó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 en un solo sentido o sin audio | El UPF no llega a rtpengine, o rtpengine anuncia una dirección a la que la subred ims no llega | El 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 Conectando | El PCRF no conoce a MonoPbx, las identidades difieren o un firewall bloquea 3868 | Que 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 dedicado | No 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 MonoPbx | Que 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 portador | El PCRF lo rechazó o la radio no admite portadores dedicados | Un 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.orgse 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
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 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_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. - 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 direccionesp-cscfdesmf.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 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
- 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 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
- Modo IMS (VoLTE y VoWiFi): todos los ajustes, la tarjeta de estado y los códigos de error.
- IMS para una red 5G privada con free5GC: la misma configuración para un núcleo free5GC.
- Requisitos de red: todos los puertos.
- SMS y mensajería: el servicio de SMS que transporta los textos desde y hacia los teléfonos.