Перейти к основному содержимому

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 и 4500IKEv2 и 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-кода.

Прежде чем покупать:

  1. На странице Сеть сохраните MCC, MNC и остальные начальные настройки. Кнопки Купить остаются отключёнными, со ссылкой на настройки, пока MCC и MNC не сохранены; сервер также отклоняет заказ без них. Новые установки начинают с лабораторных значений MCC 001, MNC 01 и домена ims.mnc001.mcc001.3gppnetwork.org, а номер SMS-центра — это заглушка (+000000000000): замените их своими.
  2. Войдите в лицензионную учётную запись MonoPbx на странице Лицензия и добавьте в неё способ оплаты. Страница eSIM показывает карту, с которой будет списана оплата (например, «Paying with Visa •••• 4242 (exp 12/28)»). Без карты отображается предупреждение и кнопка, открывающая вашу учётную запись в новой вкладке; когда вы возвращаетесь, страница проверяет снова. Покупка также отключена, пока карта не сохранена.
  3. При желании задайте Профиль 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​

  1. Настройте параметры выше и добавьте абонентов.
  2. Для IPsec запустите роль P-CSCF на хосте Linux: её адрес, адрес канала и общий секрет указываются в её конфигурации, а движки получают соответствующий link_connect. Затем телефоны согласуют туннель IPsec с помощью заголовка SIP Security-Client, как требует TS 33.203, а движок отклоняет регистрацию, которая должна быть защищена, но не защищена.
  3. Задайте номер SMS-центра на странице Сеть, чтобы передавать SMS через IMS.

VoWiFi​

  1. На движках: [ims.epdg] link_listen, секрет канала и тот же pool, который использует ePDG.
  2. На хосте ePDG: публичный address, id IKE (FQDN), цепочка сертификатов и ключ к ней, link_connect, pool внутренних адресов, адреса pcscf и dns, передаваемые телефонам.
  3. Настройте параметры оператора на телефонах так, чтобы они использовали 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 и смена ключей туннеля (телефон, меняющий ключи, просто подключается заново).