Saltar al contenido principal

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​

RequisitoPara 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 ContactEl dominio From del troncal (from_domain)
Un registro DNS A/AAAA de ese FQDN hacia la dirección pública del borde SIP de MonoPbxLos proxies de Microsoft se conectan al SBC por nombreSu 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 privadaEl 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 5061Solo SIP sobre TLSFirewall
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 MonoPbxFirewall, 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 vozMicrosoft 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:

CampoValor en un troncal de Teams
hostUn 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, porttls, 5061 (vacío)
from_domainEl 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.
srtprequired (SDES; el audio de Teams siempre va cifrado)
inbound_auth, inbound_cidrsip, 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_secs5 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.
codecsEntre PCMU, PCMA, G722, G729, opus (predeterminado PCMU, PCMA, G722)
outbound_proxy, registrarVací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íntomaRevise
Estado de SIP OPTIONS "Warning" o "Inactive" en TeamsEl 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 lleganLa dirección de origen está en inbound_cidrs; el puerto 5061 de entrada está abierto
Audio en un solo sentido o sin audioSRTP 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 y X-MS-SBC, comprobación de la oferta SRTP; una llamada B2BUA por un troncal de Teams con el Contact por FQDN y X-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 encabezados X-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 con tls_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.