VoLTE / VoNR (режим IMS)
:::tip Ищете общий обзор? См. страницу об IMS, VoLTE и VoWiFi на сайте MonoPbx, а также сетевые требования к портам ePDG (UDP 500 и 4500). :::
Режим IMS позволяет MonoPbx выступать ядром IMS для собственных SIM-карт оператора. Телефоны регистрируются через мобильную сеть (VoLTE) или через любую сеть Wi-Fi с помощью ePDG (VoWiFi), подтверждают свою личность с помощью SIM и используют АТС для голоса и SMS. Каждая SIM привязана к обычному внутреннему номеру, поэтому звонок на внутренний номер вызывает сотовый номер телефона, и наоборот.
Режим необязателен и по умолчанию выключен. Ничего из описанного здесь не работает, а консоль показывает только пояснение, пока системный администратор его не включит.
:::info Для кого это Для мобильных операторов, операторов частных LTE и кампусных сетей и MVNO, у которых собственное пакетное ядро. Вам нужны ключи SIM-карт (K и OPc или OP) либо HSS или UDM, в которых они хранятся. :::
Пошаговые руководства
Инструкции от пустого сервера до первого звонка с точными настройками с обеих сторон:
Что запускается
| Процесс | Требуется | Что делает |
|---|---|---|
| Движок АТС | ничего особого | Регистрирует телефоны, проверяет SIM (IMS-AKA), передаёт SMS, обращается к вашему HSS, UDM, PCRF или PCF и аутентифицирует туннели VoWiFi |
Роль P-CSCF (mpbx --role pcscf) | Linux, CAP_NET_ADMIN | Завершает SIP телефонов и устанавливает туннели IPsec по TS 33.203 |
ePDG (mpbx-epdg) | Linux, публичный адрес, сертификат, CAP_NET_ADMIN и право занимать UDP 500 и 4500 | IKEv2 и ESP для телефонов VoWiFi. Никогда не хранит ключ SIM |
Привилегированные процессы общаются с движком по аутентифицированным каналам (общий секрет из 32 случайных байт на канал, openssl rand -base64 32). Держите эти каналы в частной сети.
Каналы Diameter
Соединения с HSS (Cx) или PCRF (Rx) работают по TCP или SCTP, каждое с необязательным TLS и собственным доверенным сертификатом ЦС. SCTP работает только в Linux и не поддерживает multi-homing. У каждого узла свои приоритет, интервал watchdog и роль, так что можно держать основной и резервный. Параметры находятся на той же странице, что и узлы; отдельный пакет устанавливать не нужно.
Включение
Режим IMS по умолчанию включён при любой установке (установщики записывают MPBX_IMS_ENABLED=true; значение сервера по умолчанию для [ims] enabled — true), а VoWiFi и мобильные кодеки включены в начальных настройках. Если SIM-карт нет, для ваших телефонов ничего не меняется. Чтобы выключить режим, задайте MPBX_IMS_ENABLED=false в .env (Compose и установщики) или [ims] enabled = false в конфигурации установки и перезапустите; тогда на каждой странице IMS будет сообщение, что режим IMS выключен. Раздел Мобильная сеть (VoLTE / VoNR) появляется в меню консоли администратора со страницами: Сеть, HSS и UDM, Diameter и политики, Безопасность, VoWiFi, Медиа, Абоненты IMS и eSIM. Старый адрес /admin/ims открывает Сеть.
Настройки
Каждая страница раздела Мобильная сеть (VoLTE / VoNR) (для системных администраторов) сохраняет свою часть настроек:
- Сеть: источник данных об абонентах (эта АТС, HSS по Diameter Cx или UDM 5G по Nudm), начальные настройки и формат идентификатора вызывающего абонента. Начальные настройки: MCC и MNC (новые установки начинают с лабораторных значений 001 и 01 и домашнего домена
ims.mnc001.mcc001.3gppnetwork.org), домашний домен IMS (вычисляется какims.mnc<MNC>.mcc<MCC>.3gppnetwork.orgи следует за MCC и MNC, пока вы его не измените), формат IMPI (по умолчанию{imsi}@{ims_domain}) и форматы IMPU (по умолчаниюsip:{imsi}@{ims_domain}, а такжеtel:{msisdn}, когда вы назначаете SIM телефонные номера) с примером в реальном времени, номер SMS-центра и необязательный адрес P-CSCF для новых SIM. Страница заканчивается карточкой Состояние, описанной ниже. - HSS и UDM: алгоритм для новых абонентов (Milenage или TUAK); для UDM 5G — базовый URL, аутентификация, токен только для записи, ЦС, ресурс IMS и имя обслуживающей сети. Узлы Diameter внешнего HSS находятся на странице Diameter и политики.
- Diameter и политики: наша идентичность Diameter, таблица узлов Diameter (TCP или SCTP, TLS, роль, приоритет, watchdog) и управление политиками (
off, Diameter Rx к PCRF или HTTP N5 к PCF), которое запрашивает у вашего ядра выделенный канал для медиа каждого звонка. Управление политиками не зависит от того, откуда берутся данные об абонентах. - Безопасность: IPsec включён или выключен для регистраций VoLTE, разрешённые алгоритмы и диапазон SPI P-CSCF.
- VoWiFi: голос по Wi-Fi включён или выключен (в новой установке включён) и диапазон SPI ePDG. Сам процесс ePDG (
mpbx-epdg, UDP 500 и 4500, сертификат для его имени) установщики не запускают: настройте его, когда используете VoWiFi, и откройте эти два порта UDP. - Медиа: мобильные кодеки (в новой установке включены): предлагает AMR-WB и AMR телефонам IMS и добавляет G.711 для другой стороны звонка, чтобы телефон мог общаться с настольными телефонами и транками. Нужен медиасервер (rtpengine), умеющий кодировать AMR; лицензии на кодеки AMR и EVS — ваша ответственность, проверьте их и отключите кодеки здесь, если они вам не подходят.
Некоторые значения задаются в файле конфигурации сервера, потому что они открывают сокеты или загружают сертификаты: адреса, порты, идентичность и файлы сертификатов P-CSCF и ePDG. Безопасность и VoWiFi показывают их только для чтения с пометкой Требуется перезапуск; чтобы изменить их, отредактируйте файл и перезапустите АТС.
Секреты (токены N5 и UDM) доступны только для записи: после сохранения они больше никогда не показываются. Страница лишь сообщает, что секрет задан.
Пакеты eSIM
В разделе Мобильная сеть (VoLTE / VoNR), eSIM можно покупать eSIM для своей сети вместо заказа пластиковых SIM-карт. Каждая eSIM несёт ваши MCC и MNC, домен IMS, форматы IMPI и IMPU и номер SMS-центра из начальных настроек и устанавливается на телефон сканированием QR-кода.
Прежде чем покупать:
- На странице Сеть сохраните MCC, MNC и остальные начальные настройки. Кнопки Купить остаются отключёнными, со ссылкой на настройки, пока MCC и MNC не сохранены; сервер также отклоняет заказ без них. Новые установки начинают с лабораторных значений MCC 001, MNC 01 и домена
ims.mnc001.mcc001.3gppnetwork.org, а номер SMS-центра — это заглушка (+000000000000): замените их своими. - Войдите в лицензионную учётную запись MonoPbx на странице Лицензия и добавьте в неё способ оплаты. Страница eSIM показывает карту, с которой будет списана оплата (например, «Paying with Visa •••• 4242 (exp 12/28)»). Без карты отображается предупреждение и кнопка, открывающая вашу учётную запись в новой вкладке; когда вы возвращаетесь, страница проверяет снова. Покупка также отключена, пока карта не сохранена.
- При желании задайте Профиль SIM и Префикс ICCID на той же странице (см. ниже).
Предлагаются пакеты по 1, 10 и 50 eSIM; цены показаны на карточках пакетов вместе с ценой за одну eSIM и итогом, а самый большой пакет отмечен как Выгоднее всего. Купить просит подтвердить пакет, итоговую сумму и карту, после чего списывает оплату с карты. Если карта отклонена, вы увидите сообщение и ту же кнопку для изменения способа оплаты. Затем заказ появляется в таблице Заказы по мере создания, с индикацией хода выполнения. Для каждого заказа показан его идентификатор в сокращённом виде (первый блок; наведите курсор, чтобы увидеть полный идентификатор, или нажмите Копировать, чтобы поместить его в буфер обмена: это идентификатор из вашей квитанции, и именно его запрашивает поддержка), а у неудавшегося заказа указана причина. Когда деньги возвращены на карту, у заказа отображается Возвращено или Возвращено частично с суммой (Возврат выполняется, пока возврат на карту не произведён).
Когда eSIM готовы, они доставляются в эту АТС в зашифрованном виде и одним шагом записываются во встроенный HSS, поэтому могут сразу регистрироваться. Таблица eSIM перечисляет каждый ICCID, IMSI, номер телефона и состояние в HSS; Показать QR-код отображает код активации для сканирования на телефоне. История ваших заказов и eSIM хранится в MonoPbx и показывается здесь, даже если эта АТС потеряла собственную копию; ключи — нет: единственное место, где они хранятся, — HSS этой АТС.
Скачивание файла ключей
Чтобы загрузить те же eSIM в другое ядро сети (например, Open5GS), скачайте файл ключей заказа: CSV с ICCID, IMSI, номером телефона, K, OPc, AMF, SQN, PIN и PUK, ADM1, кодом активации, IMPI и IMPU. Его можно скачать только один раз: страница просит подтвердить, а после этого у АТС файла больше нет (повторная попытка сообщит, что файла нет). Храните файл надёжно; в нём секреты. Скачивание записывается в журнал аудита, и выполнить его могут только системные администраторы.
Профиль SIM и префикс ICCID
Карточка Профиль SIM задаёт, с чем создаются eSIM: название поставщика услуг (от 1 до 16 символов, по умолчанию MonoPbx), когда телефон его показывает (всегда, скрыто в роуминге, вместе с названием сети или по обоим правилам), необязательное название сети, эквивалентные домашние сети (EHPLMN), предпочтительные и разрешённые сети с радиотехнологиями, которые может использовать каждая (4G, 5G, 3G, 2G; не более 20) и запрещённые сети (не более 4). Сеть — это MCC из 3 цифр и MNC из 2 или 3 цифр; одну сеть нельзя указать дважды.
Приложения Android с привилегиями оператора перечисляет приложения (не более 10) по хешу SHA-256 или SHA-1 сертификата их подписи (вывод apksigner verify --print-certs или ключ подписи приложения в Play Console; с двоеточиями или без) и, при желании, имени пакета. Они сохраняются вместе с заказом; к SIM они будут применяться в одной из следующих версий.
Префикс ICCID — это цифры после 89 в ICCID каждой eSIM (от 1 до 8 цифр). Значение по умолчанию 99901 относится к частному диапазону; меняйте его, только если вы владеете диапазоном эмитента ICCID.
Абоненты
Администраторы компании добавляют абонентов в разделе Мобильная сеть (VoLTE / VoNR), Абоненты IMS: IMSI, K и OPc (или OP), алгоритм (Milenage или TUAK), привязанный внутренний номер и публичные идентификаторы. K и OPc запечатываются при вводе и не могут быть прочитаны, экспортированы или показаны в записи аудита; чтобы изменить их, выполняется ротация. Политика доступа SIM определяет, где она может регистрироваться: any, volte (только через P-CSCF) или vowifi (только через ePDG). Для большого числа SIM используйте массовый импорт или mpbx ims import для крупных партий.
SIM регистрируется, только когда её абонент активен, привязан к включённому внутреннему номеру активного пользователя, а политика доступа допускает данный тип доступа. Во всех остальных случаях возвращается «голый» 403; телефон не получает никаких сведений о причине.
VoLTE
- Настройте параметры выше и добавьте абонентов.
- Для IPsec запустите роль P-CSCF на хосте Linux: её адрес, адрес канала и общий секрет указываются в её конфигурации, а движки получают соответствующий
link_connect. Затем телефоны согласуют туннель IPsec с помощью заголовка SIPSecurity-Client, как требует TS 33.203, а движок отклоняет регистрацию, которая должна быть защищена, но не защищена. - Задайте номер SMS-центра на странице Сеть, чтобы передавать SMS через IMS.
VoWiFi
- На движках:
[ims.epdg] link_listen, секрет канала и тот жеpool, который использует ePDG. - На хосте ePDG: публичный
address,idIKE (FQDN), цепочка сертификатов и ключ к ней,link_connect,poolвнутренних адресов, адресаpcscfиdns, передаваемые телефонам. - Настройте параметры оператора на телефонах так, чтобы они использовали FQDN ePDG.
ePDG предлагает только современный обмен ключами (X25519, P-256, P-384), аутентифицирует телефон по EAP-AKA' через движок и выдаёт ему внутренний адрес, а также адреса P-CSCF и DNS. Телефон, подключившийся повторно, заменяет свой прежний туннель. Если движок недоступен, ePDG отклоняет все туннели, а не пускает кого попало.
Состояние
Страница Сеть заканчивается карточкой Состояние, обновляемой каждые десять секунд:
- каждый узел Diameter (Cx и Rx): подключён, подключается или недоступен, с причиной;
- канал P-CSCF каждого движка;
- каждый ePDG: используемые туннели и внутренние адреса, выданные из его пула.
Процесс, переставший сообщать о себе, исчезает из карточки через 30 секунд.
Оповещения и ошибки
Недоступный источник данных об абонентах отказывает безопасно (регистрации отклоняются с 500, а не обслуживаются по менее надёжным данным) и вызывает оповещение Источник данных об абонентах IMS недоступен. Коды ошибок API начинаются с MPBX-IMS-, например MPBX-IMS-OFF (IMS выключен на узле), MPBX-IMS-SETTINGS-INVALID и MPBX-IMS-PEER-IN-USE; в кодах ошибок API перечислены все со способами их устранения.
Полезно знать
- Идентификаторы IMS никогда не работают как имена пользователей SIP digest, а неудавшаяся регистрация IMS никогда не переходит на digest.
- Хосты VoWiFi должны отбрасывать пакеты, источник которых находится в пуле ePDG, если они не пришли через туннель: АТС считает источник внутри пула доступом по Wi-Fi.
- Не поддерживаются: фрагментация сообщений IKE, MOBIKE и смена ключей туннеля (телефон, меняющий ключи, просто подключается заново).