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

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
hostSIP-прокси Microsoft: sip.pstnhub.microsoft.com (также sip2., sip3.; sip.pstnhub.gov.teams.microsoft.us и sip.pstnhub.dod.teams.microsoft.us для GCC High и DoD). Создайте по одному транку на прокси для отказоустойчивости или один транк и доверьте переключение DNS.
transport, porttls, 5061 (пусто)
from_domainFQDN SBC (DNS-имя минимум из трёх частей, не IP-адрес и не домен Microsoft). Это хост в From и Contact (<sip:…@FQDN:5061;transport=tls>) каждого INVITE и OPTIONS.
srtprequired (SDES; медиа Teams всегда зашифровано)
inbound_auth, inbound_cidrsip, диапазоны сигнализации 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 — задача владельца.