Microsoft Teams Direct Routing
MonoPbx может быть пограничным контроллером сессий (SBC), который тенант Microsoft 365 связывает с Teams Direct Routing. Тогда пользователи Teams звонят в телефонную сеть через операторов компании на MonoPbx, а номера, направленные на транк Teams, вызывают пользователей Teams. Это транк вида teams_direct_routing (POST /api/v1/trunks с "kind": "teams_direct_routing" или Админ > Звонки и маршрутизация > Транки, тип Microsoft Teams Direct Routing). Код: pbx/crates/trunks/src/teams.rs; модель транка и API те же, что у SIP-транков.
Часть 1 (это руководство) охватывает сигнализацию SBC: TLS, FQDN SBC, проверку OPTIONS, X-MS-SBC, SRTP, медиа через медиа-ретранслятор MonoPbx. Обход медиа, ICE-lite, синхронизация присутствия и набор номера из Teams — следующие этапы (планируется).
Что нужно
| Требование | Зачем | Где |
|---|---|---|
Публичный FQDN для SBC в домене, подтверждённом тенантом Microsoft 365 (например sbc.contoso.com; не *.onmicrosoft.com) | Microsoft связывает SBC по FQDN и находит его в заголовке Contact | Домен From транка (from_domain) |
| A/AAAA-запись DNS для этого FQDN на публичный адрес SIP-границы MonoPbx | Прокси Microsoft подключаются к SBC по имени | Ваш DNS |
| TLS-сертификат для FQDN от УЦ, которому доверяет Microsoft (публичный УЦ, SHA-256, FQDN в SAN; подстановочный сертификат домена принимается) | Microsoft отклоняет самоподписанные сертификаты и сертификаты частного УЦ | TLS-слушатель SIP-границы, см. сертификаты |
| Порт 5061/TCP открыт для входящих из диапазонов сигнализации Microsoft, и SBC может обращаться к прокси Microsoft на 5061 | Только SIP поверх TLS | Межсетевой экран |
Медиапорты медиа-ретранслятора открыты для медиадиапазонов Microsoft (52.112.0.0/14, 52.122.0.0/15, UDP 3478–3481 и 49152–53247) | Обход медиа выключен: медиа идёт между медиапроцессорами Microsoft и ретранслятором MonoPbx | Межсетевой экран, NAT и TURN |
| Тенант Microsoft 365 с лицензиями Teams Phone и правами администратора Teams (PowerShell) | Связывание SBC и голосовая маршрутизация | Microsoft 365 |
Транк
Тип задаёт требования Microsoft; проверка (MPBX-TRUNK-INVALID, с именем поля) отклоняет всё остальное:
| Поле | Значение для транка Teams |
|---|---|
host | SIP-прокси Microsoft: sip.pstnhub.microsoft.com (также sip2., sip3.; sip.pstnhub.gov.teams.microsoft.us и sip.pstnhub.dod.teams.microsoft.us для GCC High и DoD). Создайте по одному транку на прокси для отказоустойчивости или один транк и доверьте переключение DNS. |
transport, port | tls, 5061 (пусто) |
from_domain | FQDN SBC (DNS-имя минимум из трёх частей, не IP-адрес и не домен Microsoft). Это хост в From и Contact (<sip:…@FQDN:5061;transport=tls>) каждого INVITE и OPTIONS. |
srtp | required (SDES; медиа Teams всегда зашифровано) |
inbound_auth, inbound_cidrs | ip, диапазоны сигнализации Microsoft как префиксы /16: 52.112.0.0/16 … 52.115.0.0/16, 52.122.0.0/16, 52.123.0.0/16 (заполняются при выборе типа). Microsoft не отвечает на digest-запросы; имени пользователя и пароля на транке нет. |
options_interval_secs | от 5 до 180 (по умолчанию 60). Microsoft помечает SBC неактивным, когда OPTIONS прекращаются, поэтому проверку состояния выключить нельзя. |
codecs | Из PCMU, PCMA, G722, G729, opus (по умолчанию PCMU, PCMA, G722) |
outbound_proxy, registrar | Пусто |
Каждый OPTIONS и INVITE к Microsoft несёт X-MS-SBC: MonoPbx/SBC/<version>. Заголовки X-MS-*, которые Microsoft добавляет к звонкам из Teams, читает только SBC, и они никогда не пересылаются на другое плечо. База данных тоже хранит эти правила (trunks_teams_direct_routing_check: TLS, обязательный SRTP, FQDN SBC, аутентификация входящих по IP).
Входящие звонки из Teams допускаются как любые звонки транка (адрес источника в списке разрешённых, DID берётся из Request-URI) и маршрутизируются планом набора компании; звонки на номера Teams — это исходящий маршрут плана набора на транк Teams. Транк Teams принадлежит одной компании, как и любой транк.
Связывание в Microsoft 365 (Teams PowerShell)
Connect-MicrosoftTeams
New-CsOnlinePSTNGateway -Fqdn sbc.contoso.com -SipSignalingPort 5061 -MaxConcurrentSessions 50 -Enabled $true -MediaBypass $false
Set-CsPhoneNumberAssignment -Identity user@contoso.com -PhoneNumber +525550000101 -PhoneNumberType DirectRouting
New-CsOnlinePstnUsage -Identity Global -Usage @{Add="MonoPbx"}
New-CsOnlineVoiceRoute -Identity "MonoPbx" -NumberPattern ".*" -OnlinePstnGatewayList sbc.contoso.com -OnlinePstnUsages "MonoPbx"
New-CsOnlineVoiceRoutingPolicy "MonoPbx" -OnlinePstnUsages "MonoPbx"
Grant-CsOnlineVoiceRoutingPolicy -Identity user@contoso.com -PolicyName "MonoPbx"
После связывания центр администрирования Teams показывает SBC с TLS connectivity status: Active и SIP OPTIONS status: Active через несколько минут после того, как OPTIONS от MonoPbx дойдут до Microsoft; в MonoPbx статус транка становится исправным, когда Microsoft отвечает на них.
Устранение неполадок
| Симптом | Что проверить |
|---|---|
| Статус SIP OPTIONS «Warning» или «Inactive» в Teams | Транк включён, проверка состояния включена, домен From совпадает со связанным FQDN; исходящий порт 5061 открыт |
| TLS connectivity «Inactive» | Сертификат покрывает FQDN, выдан публичным УЦ, цепочка полная; DNS-запись указывает на границу |
| Звонки из Teams отклоняются с 403 или не приходят | Адрес источника есть в inbound_cidrs; входящий порт 5061 открыт |
| Односторонний звук или его отсутствие | SRTP равен required; медиадиапазоны открыты; см. качество звука |
Тестирование
- Модульные тесты и проверка:
cargo nextest run -p mpbx-trunks -p mpbx-b2bua -E 'test(teams)'(пресеты вида и проверка, OPTIONS с Contact по FQDN иX-MS-SBC, проверка предложения SRTP; звонок B2BUA через транк Teams с Contact по FQDN иX-MS-SBC). - SIPp изображает прокси Microsoft по TLS в Docker:
make teams-sipp(pbx/crates/trunks/sipp/run-teams.sh: OPTIONS, INVITE с заголовкамиX-MS-*и SRTP с ответом SRTP, ACK, BYE и INVITE с обычным RTP, отклонённый с 488). Собственный TLS-клиент SIPp 3.7.3 не проходит рукопожатие, поэтому SIPp говорит по TCP сtls_bridge.py, который открывает TLS-соединение к SBC на каждое соединение SIPp и проверяет сертификат по тестовому УЦ для FQDN SBC, как это делает Microsoft. - Прогон на реальном тенанте разработчика Microsoft 365 — задача владельца.