EasyUC para Microsoft Teams
Activar el SBC de Teams y definir los datos de red
Active el Session Border Controller integrado y defina la IP, los puertos y el método de certificado.
En EasyUC: EasyUC Teams → Teams → SBC Setup
Las imágenes proceden del laboratorio EasyUC. Los nombres y valores son ejemplos orientativos. Una diferencia de idioma de la interfaz se indica junto a cada imagen.
Para qué sirve
Microsoft Teams Direct Routing conecta un tenant de Teams con un Session Border Controller (SBC) mediante un trunk SIP. EasyUC incluye este SBC. Se ejecuta en el servidor EasyUC, acepta el trunk de Microsoft a través de TLS y entrega las llamadas a los scripts de EasyUC (ACD, IVR, consola de operador). No se necesita ninguna centralita adicional ni un SBC de terceros.
En esta página define lo que se aplica al SBC en su conjunto: la dirección pública a la que Microsoft se conecta, los puertos que utiliza y el método con el que EasyUC solicita certificados a Let’s Encrypt. Los nombres de host y los propios certificados pertenecen a cada tenant y se configuran allí.
La señalización hacia Microsoft se realiza únicamente a través de TLS, con verificación mutua de certificados. El audio circula cifrado únicamente como SRTP. No se utiliza media bypass. El SBC acepta conexiones únicamente de las redes de Microsoft.
Requisitos previos
- Módulo de licencia
teams. Sin este módulo no aparece el espacio de trabajo EasyUC Teams. - Rol EasyUC Teams (
ROLE_APP_TEAMS_WORKSPACE) con los subpermisos SBC (ROLE_APP_TEAMS_SBC) para leer y SBC bearbeiten (ROLE_APP_TEAMS_SBC_EDIT) para modificar. - Una dirección IPv4 pública a la que se pueda acceder al servidor EasyUC desde Internet. Detrás de un NAT 1:1 es la dirección externa.
- Reglas de firewall para el puerto TLS y el rango RTP. Los puertos exactos figuran en el capítulo “DNS, IP pública y firewall para el SBC”.
- Una dirección de correo electrónico para la cuenta de Let’s Encrypt. A ella se envían los avisos de caducidad.
Paso a paso: activar el SBC por primera vez
Paso a paso: modificar los ajustes más adelante
Campos y opciones
| Campo / acción | Significado y uso |
|---|---|
| Default domain (optional) | Sugerencia para el nombre de host de los tenants nuevos, por ejemplo sbc.example.com. Cada tenant puede utilizar su propio nombre de host en el dominio del cliente. |
| Public IP | Dirección a la que se conecta Microsoft. Obligatoria: sin ella, el SBC no se inicia. Se rechazan los rangos privados y reservados. |
| Media IP | Dirección local para RTP. Detrás de un NAT 1:1, introduzca aquí la dirección interna del servidor y la dirección externa en Public IP. |
| First TLS port | Valor inicial para la asignación de puertos, por defecto 5061. Cada tenant recibe el siguiente puerto libre. Los puertos 8021, 9060, 15060 y 15080 se utilizan internamente. |
| RTP from / RTP to | Rango UDP para el audio, por defecto 20000 a 20999, valor inicial mínimo 1024. El rango no debe solaparse con UDP 16384 a 19999 (puertos CTI del ACD) ni con 24000 a 24999 (entorno de ejecución de scripts para llamadas de Teams). |
| Contact e-mail | Dirección de la cuenta de Let’s Encrypt. Sin ella no se puede solicitar ningún certificado. |
| Environment | Production entrega un certificado de confianza pública. Staging solo sirve para hacer pruebas; Microsoft no acepta el trunk con él. En producción se aplican los límites de Let’s Encrypt: cinco certificados idénticos por semana y cinco validaciones fallidas por hora. |
| Validation | DNS-01 demuestra el nombre de host mediante un registro TXT; el puerto 80 permanece cerrado. HTTP-01 se puede seleccionar, pero esta versión solicita certificados únicamente mediante DNS-01. |
| DNS provider (optional) | Nombre del proveedor para la renovación automática. Está implementado cloudflare. Para otros proveedores sigue disponible el método manual. |
| DNS credentials (optional) | Para Cloudflare, una línea CF_API_TOKEN=…. Con credenciales, EasyUC define el registro TXT por sí mismo y renueva sin intervención. Sin ellas, la página del tenant muestra el registro para que usted lo cree. |
| Disable | Desactiva el SBC. Los ajustes de los tenants se conservan; después, los trunks quedan sin conexión. Antes aparece un aviso de confirmación. |
| Teams Tenants / Manage tenants | Abre la lista de tenants. |
Comprobar el resultado y acotar errores
- Éxito: el encabezado muestra SBC service con un número de versión y last seen con una hora actual. Debajo figuran el dominio predeterminado, el número de tenants, las llamadas en curso y la IP pública.
- “The SBC service has not reported in yet. Settings are stored and will be picked up as soon as it runs.” El servicio no está en ejecución o no puede acceder a la administración. Compruebe en EasyUC Manager que el módulo Teams está activado y que el servicio SBC está en ejecución. Sin señal de vida, el servicio se considera sin conexión transcurridos 90 segundos.
- Un mensaje indica que no hay IP pública almacenada y que el SBC no se inicia sin ella: introduzca la dirección en Edit.
- „Die öffentliche IP muss aus dem Internet erreichbar sein; … liegt in einem privaten oder reservierten Bereich.“ Ha introducido la dirección interna. La dirección externa corresponde a Public IP y la interna a Media IP.
- „Der RTP-Bereich … überschneidet sich mit …“ o „Der RTP-Bereich … enthält Port …“ Elija un rango fuera de los puertos indicados en el mensaje; lo habitual es de 20000 a 20999.
- „Für Let’s Encrypt wird eine gültige E-Mail-Adresse benötigt.“ Corrija el Contact e-mail.
- “Certificates from the staging environment are NOT publicly trusted. Microsoft will not accept the trunk with them.” Establezca Environment en producción y solicite de nuevo los certificados de los tenants.
- Un servicio SBC en ejecución no dice nada sobre un trunk concreto. Compruebe el certificado, el trunk y los OPTIONS por cada tenant.