Microsoft Teams Direct Routing
MonoPbx puede ser el Session Border Controller (SBC) que un tenant de Microsoft 365 empareja con Teams Direct Routing. Los usuarios de Teams llaman entonces a la red telefónica pública a través de los operadores de la empresa en MonoPbx, y los números enrutados al troncal de Teams hacen sonar a los usuarios de Teams. Es un troncal de tipo teams_direct_routing (POST /api/v1/trunks con "kind": "teams_direct_routing" o Admin > Llamadas y enrutamiento > Troncales, tipo Microsoft Teams Direct Routing). Código: pbx/crates/trunks/src/teams.rs; el modelo del troncal y la API son los de los troncales SIP.
La parte 1 (esta guía) cubre la señalización del SBC: TLS, el FQDN del SBC, el sondeo OPTIONS, X-MS-SBC, SRTP y el audio por el relé de medios de MonoPbx. El desvío de medios, ICE-lite, la sincronización de presencia y la llamada con un clic desde Teams son pasos posteriores (planeado).
Qué necesita
| Requisito | Para qué | Dónde |
|---|---|---|
Un FQDN público para el SBC, en un dominio que el tenant de Microsoft 365 haya verificado (por ejemplo sbc.contoso.com; no *.onmicrosoft.com) | Microsoft empareja el SBC por su FQDN y lo encuentra en el encabezado Contact | El dominio From del troncal (from_domain) |
| Un registro DNS A/AAAA de ese FQDN hacia la dirección pública del borde SIP de MonoPbx | Los proxies de Microsoft se conectan al SBC por nombre | Su DNS |
| Un certificado TLS para el FQDN de una CA en la que Microsoft confíe (CA pública, SHA-256, el FQDN en el SAN; se acepta un comodín del dominio) | Microsoft rechaza certificados autofirmados o de CA privada | El listener TLS del borde SIP, vea certificados |
| Puerto 5061/TCP abierto de entrada desde los rangos de señalización de Microsoft y el SBC con alcance a los proxies de Microsoft en 5061 | Solo SIP sobre TLS | Firewall |
Puertos de medios del relé abiertos a los rangos de medios de Microsoft (52.112.0.0/14, 52.122.0.0/15, UDP 3478-3481 y 49152-53247) | El desvío de medios está apagado: el audio fluye entre los procesadores de medios de Microsoft y el relé de MonoPbx | Firewall, NAT y TURN |
| Un tenant de Microsoft 365 con licencias de Teams Phone y permisos de administrador de Teams (PowerShell) | Emparejar el SBC y el enrutamiento de voz | Microsoft 365 |
El troncal
El tipo fija los requisitos de Microsoft; la validación (MPBX-TRUNK-INVALID, con el campo nombrado) rechaza todo lo demás:
| Campo | Valor en un troncal de Teams |
|---|---|
host | Un proxy SIP de Microsoft: sip.pstnhub.microsoft.com (también sip2., sip3.; sip.pstnhub.gov.teams.microsoft.us y sip.pstnhub.dod.teams.microsoft.us para GCC High y DoD). Cree un troncal por proxy para conmutación por error, o un troncal y deje que el DNS conmute. |
transport, port | tls, 5061 (vacío) |
from_domain | El FQDN del SBC (un nombre DNS con al menos tres etiquetas, nunca una dirección IP ni un dominio de Microsoft). Es el host de From y de Contact (<sip:…@FQDN:5061;transport=tls>) en cada INVITE y OPTIONS. |
srtp | required (SDES; el audio de Teams siempre va cifrado) |
inbound_auth, inbound_cidrs | ip, los rangos de señalización de Microsoft como prefijos /16: 52.112.0.0/16 … 52.115.0.0/16, 52.122.0.0/16, 52.123.0.0/16 (se llenan al elegir el tipo). Microsoft no responde a desafíos digest; el troncal no lleva usuario ni contraseña. |
options_interval_secs | 5 a 180 (predeterminado 60). Microsoft marca un SBC como inactivo cuando dejan de llegar los OPTIONS, así que el chequeo de salud no se puede apagar. |
codecs | Entre PCMU, PCMA, G722, G729, opus (predeterminado PCMU, PCMA, G722) |
outbound_proxy, registrar | Vacíos |
Cada OPTIONS e INVITE hacia Microsoft lleva X-MS-SBC: MonoPbx/SBC/<version>. Los encabezados X-MS-* que Microsoft pone en las llamadas desde Teams los lee solo el SBC y nunca se reenvían a otro tramo. La base de datos también guarda las reglas (trunks_teams_direct_routing_check: TLS, SRTP obligatorio, un FQDN de SBC, autenticación entrante por IP).
Las llamadas entrantes desde Teams se admiten como cualquier llamada de troncal (dirección de origen en la lista de permitidos, el DID tomado del Request-URI) y las enruta el plan de marcación de la empresa; las llamadas a números de Teams son una ruta de salida del plan de marcación hacia el troncal de Teams. Un troncal de Teams pertenece a una empresa, como todo troncal.
Emparejamiento en 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"
Tras emparejar, el centro de administración de Teams muestra el SBC con TLS connectivity status: Active y SIP OPTIONS status: Active a los pocos minutos de que los OPTIONS de MonoPbx lleguen a Microsoft; en MonoPbx el estado del troncal pasa a saludable cuando Microsoft los responde.
Solución de problemas
| Síntoma | Revise |
|---|---|
| Estado de SIP OPTIONS "Warning" o "Inactive" en Teams | El troncal está habilitado, su chequeo de salud está activo y el dominio From es el FQDN emparejado; el puerto 5061 de salida está abierto |
| TLS connectivity "Inactive" | El certificado cubre el FQDN, es de una CA pública y su cadena está completa; el registro DNS apunta al borde |
| Las llamadas desde Teams se rechazan con 403 o no llegan | La dirección de origen está en inbound_cidrs; el puerto 5061 de entrada está abierto |
| Audio en un solo sentido o sin audio | SRTP es required; los rangos de medios están abiertos; vea calidad de audio |
Pruebas
- Pruebas unitarias y de validación:
cargo nextest run -p mpbx-trunks -p mpbx-b2bua -E 'test(teams)'(presets de tipo y validación, OPTIONS con Contact por FQDN yX-MS-SBC, comprobación de la oferta SRTP; una llamada B2BUA por un troncal de Teams con el Contact por FQDN yX-MS-SBC). - SIPp hace de proxy de Microsoft sobre TLS en Docker:
make teams-sipp(pbx/crates/trunks/sipp/run-teams.sh: OPTIONS, un INVITE con encabezadosX-MS-*y SRTP respondido con SRTP, ACK, BYE y un INVITE con RTP simple rechazado con 488). El cliente TLS propio de SIPp 3.7.3 falla el handshake, así que SIPp habla TCP contls_bridge.py, que abre una conexión TLS por cada conexión de SIPp hacia el SBC y verifica su certificado contra la CA de prueba del FQDN del SBC, como hace Microsoft. - Una prueba contra un tenant real de desarrollador de Microsoft 365 es tarea del propietario.