EasyUC para Microsoft Teams

Crear y gestionar un tenant de Teams

Conecte un tenant de Microsoft Teams con el SBC mediante un nombre de host, un puerto TLS y un certificado propios.

EasyUC · Versión 4.8.7

En EasyUC: EasyUC Teams → Teams → Teams Tenants → Add tenant

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

Un tenant en EasyUC representa exactamente un tenant de Microsoft Teams, es decir, una organización cliente en Microsoft 365. Cada tenant recibe su propio nombre de host público, su propio puerto TLS y su propio certificado. Así puede conectar varios clientes a través del mismo SBC sin que sus trunks interfieran entre sí.

La página del tenant es el lugar central para todo lo demás: certificado, acceso a Microsoft Graph, inicio de sesión en Teams PowerShell, trunk y rutas de voz, usuarios, teléfonos, plan de numeración, historial de llamadas, grabaciones y capturas.

El nombre de host debe pertenecer a un dominio verificado en el tenant de Microsoft 365 del cliente. Microsoft rechaza un gateway PSTN bajo un dominio ajeno.

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 TENANTS (ROLE_APP_TEAMS_TENANTS) para leer y TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT) para modificar.
El SBC integrado está activado y tiene una IP pública (capítulo “Activar el SBC de Teams y definir los datos de red”).
Un nombre de host completo para el tenant, por ejemplo sbc.kunde.de, con un registro DNS A público que apunte a la IP pública del SBC.
El dominio del nombre de host está verificado en el tenant de Microsoft 365 del cliente. Para sbc.kunde.de, debe estar registrado allí kunde.de.
El ID de directorio (tenant) del cliente de Microsoft Entra, en cuanto desee utilizar Graph o el inicio de sesión de la aplicación.

Paso a paso: crear un tenant

Seleccione el espacio de trabajo EasyUC Teams y abra Teams → Teams Tenants.
Haga clic en Add tenant. Se abre el formulario New Teams tenant.
En Customer name, introduzca un nombre, por ejemplo Muster GmbH.
En SBC hostname for this tenant, introduzca el nombre de host completo, por ejemplo sbc.kunde.de. Debajo, EasyUC muestra qué dominio debe estar verificado en el tenant de Teams y a qué IP debe apuntar el registro A.
En Directory (tenant) ID, introduzca el GUID del tenant de Microsoft.
Deje Route calls to vacío. El campo ya no se utiliza para el enrutamiento.
Haga clic en Create. EasyUC asigna el siguiente puerto TLS libre y abre la lista con el tenant nuevo.
Haga clic en la fila del tenant. Se abre la página del tenant en la sección Settings.
A continuación, solicite el certificado (capítulo “Certificado del SBC por tenant”).

Paso a paso: modificar los ajustes del tenant

Abra Teams Tenants y haga clic en el tenant.
Permanezca en la sección Settings de la barra del tenant a la izquierda.
Modifique Customer name, SBC hostname, Directory (tenant) ID o TLS port.
Marque o desmarque Trunk active y Save the SIP flow of every call.
En Keep call history (days), introduzca un valor de 1 a 365.
Haga clic en Save.
Si ha cambiado el nombre de host o el puerto TLS: solicite de nuevo el certificado y sincronice el trunk en Teams (Update routes).

Paso a paso: conectar más tenants o eliminar un tenant

Para otro cliente, repita la creación con el nombre de host de ese cliente, por ejemplo sbc.kunde-b.de. El nuevo tenant recibe el siguiente puerto TLS libre.
Abra en el firewall el puerto TLS adicional. La lista de tenants muestra el puerto en la columna Hostname, después de los dos puntos.
All tenants en la barra del tenant le lleva de nuevo a la lista.
Para eliminar, haga clic en el icono de la papelera al final de la fila en la lista y confirme el aviso „Tenant … löschen? Trunk, Zertifikat und Mitschnitt werden entfernt.“
Antes de eliminar, quite el trunk en Microsoft Teams con Remove the trunk. Eliminar en EasyUC no limpia nada en Microsoft.

Campos y opciones

Campos y opciones
Campo / acción	Significado y uso
Customer name	Nombre visible del tenant en EasyUC. Obligatorio.
SBC hostname	Nombre público completo con el que Microsoft accede al trunk de este tenant. El certificado se emite para este nombre. Un cambio solicita un certificado nuevo.
Directory (tenant) ID	GUID del tenant de Microsoft. Opcional al crear; necesario para Microsoft Graph, el inicio de sesión de la aplicación y el inicio de sesión de Teams en la consola de operador.
TLS port	Puerto SIP de este tenant. EasyUC lo asigna al crear. Cada puerto se asigna una sola vez.
Route calls to	Campo heredado. Ya no se utiliza para el enrutamiento. Qué número conduce a qué script se define en el script.
Trunk active	Sin la marca, el tenant está desactivado. La lista muestra entonces disabled, las llamadas no llegan y ningún certificado se renueva automáticamente.
Save the SIP flow of every call	Almacena cada mensaje SIP de una llamada, excepto OPTIONS. Cada llamada puede abrirse después como diagrama de escalera, en directo o a posteriori. Por defecto: activado.
Keep call history (days)	De 1 a 365, por defecto 14. Las llamadas y su flujo SIP se eliminan transcurrido este tiempo.
Scripts over this trunk	Lista de todos los scripts para los que Reachable via MS Teams está activado con este tenant, con número y estado: Reachable, Script switched off, Number already used by another script o Number invalid. Al hacer clic en la fila se abre el script.
Tenant bar	Secciones del tenant: Settings, Presence sync, Presence Live, Show calls, Call history, SIP log, Users, Phones, Number plan, Recordings, Captures.
Header	Muestra el nombre de host con el puerto, el estado del certificado, Last OPTIONS y las Calls en curso. Los botones inician el seguimiento SIP, la captura de red y la grabación de llamadas.

Comprobar el resultado y acotar errores

Éxito: el tenant figura en la lista con nombre de host y puerto. Las columnas Certificate y Trunk muestran el estado, al principio sin certificado y sin OPTIONS.
“The integrated SBC is not enabled yet.” Haga clic en Set it up first y active el SBC.
„Bitte den vollständigen Hostnamen des Tenants angeben, zum Beispiel sbc.kunde.de“ o „Der Hostname ist ungültig. Erwartet wird ein vollständiger Name wie sbc.kunde.de“. Introduzca el nombre completo, no una etiqueta corta.
„Die Verzeichnis-ID (Tenant-ID) muss eine GUID sein.“ Copie el ID de la vista general de Microsoft Entra. No lo confunda con el ID de aplicación.
„Der TLS-Port … ist bereits vergeben.“ Elija otro puerto.
„Der TLS-Port … ist intern belegt (…). Bitte einen anderen Port wählen, üblich ist 5061.“ El puerto pertenece a un servicio interno.
„Die Aufbewahrung des Anrufverlaufs muss 1 bis 365 Tage betragen.“ Corrija el valor.
El tenant permanece sin trunk mientras falte el certificado. El SBC abre el puerto TLS de un tenant únicamente cuando la IP pública está definida, el certificado está emitido y el tenant está activo.