EasyUC pour Microsoft Teams

Créer et gérer un tenant Teams

Relier un tenant Microsoft Teams au SBC avec son propre nom d’hôte, son propre port TLS et son propre certificat.

EasyUC · Version 4.8.7

Dans EasyUC : EasyUC Teams → Teams → Teams Tenants → Add tenant

Les images proviennent du lab EasyUC. Les noms et valeurs sont des exemples. Toute différence de langue de l’interface est indiquée à côté de l’image.

À quoi cela sert

Un tenant dans EasyUC représente exactement un tenant Microsoft Teams, c’est-à-dire une organisation cliente dans Microsoft 365. Chaque tenant reçoit son propre nom d’hôte public, son propre port TLS et son propre certificat. Vous pouvez ainsi raccorder plusieurs clients par le même SBC sans que leurs trunks interfèrent.

La page du tenant est le point central pour tout le reste : certificat, accès Microsoft Graph, connexion à Teams PowerShell, trunk et routes vocales, utilisateurs, téléphones, plan de numérotation, historique des appels, enregistrements et captures.

Le nom d’hôte doit appartenir à un domaine validé dans le tenant Microsoft 365 du client. Microsoft refuse une passerelle PSTN sous un domaine étranger.

Prérequis

Module de licence teams. Sans ce module, l’espace de travail EasyUC Teams n’apparaît pas.
Rôle EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) avec les sous-droits TENANTS (ROLE_APP_TEAMS_TENANTS) pour la lecture et TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT) pour la modification.
Le SBC intégré est activé et dispose d’une adresse IP publique (chapitre « Activer le SBC Teams et définir les paramètres réseau »).
Un nom d’hôte complet pour le tenant, par exemple sbc.kunde.de, avec un enregistrement DNS A public qui pointe vers l’adresse IP publique du SBC.
Le domaine du nom d’hôte est validé dans le tenant Microsoft 365 du client. Pour sbc.kunde.de, kunde.de doit y être enregistré.
L’ID d’annuaire (tenant) du client dans Microsoft Entra, dès que vous souhaitez utiliser Graph ou la connexion d’application.

Pas à pas : créer un tenant

Sélectionnez l’espace de travail EasyUC Teams et ouvrez Teams → Teams Tenants.
Cliquez sur Add tenant. Le formulaire New Teams tenant s’ouvre.
Sous Customer name, saisissez un nom, par exemple Muster GmbH.
Sous SBC hostname for this tenant, saisissez le nom d’hôte complet, par exemple sbc.kunde.de. En dessous, EasyUC indique quel domaine doit être validé dans le tenant Teams et vers quelle adresse IP l’enregistrement A doit pointer.
Sous Directory (tenant) ID, saisissez le GUID du tenant Microsoft.
Laissez Route calls to vide. Le champ n’est plus utilisé pour le routage.
Cliquez sur Create. EasyUC attribue le prochain port TLS libre et ouvre la liste avec le nouveau tenant.
Cliquez sur la ligne du tenant. La page du tenant s’ouvre dans la section Settings.
Demandez ensuite le certificat (chapitre « Certificat SBC par tenant »).

Pas à pas : modifier les paramètres du tenant

Ouvrez Teams Tenants et cliquez sur le tenant.
Restez dans la section Settings de la barre du tenant, à gauche.
Modifiez Customer name, SBC hostname, Directory (tenant) ID ou TLS port.
Cochez ou décochez Trunk active et Save the SIP flow of every call.
Sous Keep call history (days), saisissez une valeur de 1 à 365.
Cliquez sur Save.
Si vous avez modifié le nom d’hôte ou le port TLS : demandez de nouveau le certificat et synchronisez le trunk dans Teams (Update routes).

Pas à pas : raccorder d’autres tenants ou supprimer un tenant

Pour un autre client, répétez la création avec le nom d’hôte de ce client, par exemple sbc.kunde-b.de. Le nouveau tenant reçoit le prochain port TLS libre.
Ouvrez le port TLS supplémentaire dans le pare-feu. La liste des tenants indique le port dans la colonne Hostname, après les deux-points.
All tenants dans la barre du tenant vous ramène à la liste.
Pour supprimer, cliquez sur l’icône de corbeille à la fin de la ligne dans la liste et confirmez l’invite „Tenant … löschen? Trunk, Zertifikat und Mitschnitt werden entfernt.“
Avant de supprimer, retirez le trunk dans Microsoft Teams avec Remove the trunk. La suppression dans EasyUC ne nettoie rien chez Microsoft.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Customer name	Nom d’affichage du tenant dans EasyUC. Obligatoire.
SBC hostname	Nom public complet par lequel Microsoft joint le trunk de ce tenant. Le certificat est émis pour ce nom. Une modification déclenche une nouvelle demande de certificat.
Directory (tenant) ID	GUID du tenant Microsoft. Facultatif à la création ; requis pour Microsoft Graph, la connexion d’application et la connexion Teams au poste opérateur.
TLS port	Port SIP de ce tenant. EasyUC l’attribue à la création. Chaque port n’est attribué qu’une seule fois.
Route calls to	Champ hérité. Il n’est plus utilisé pour le routage. Le numéro qui mène à tel script se définit dans le script.
Trunk active	Sans la coche, le tenant est désactivé. La liste affiche alors disabled, les appels n’arrivent pas et aucun certificat n’est renouvelé automatiquement.
Save the SIP flow of every call	Enregistre chaque message SIP d’un appel, hors OPTIONS. Chaque appel peut ensuite être ouvert sous forme de diagramme en échelle, en direct ou après coup. Par défaut : activé.
Keep call history (days)	1 à 365, 14 par défaut. Les appels et leur flux SIP sont supprimés après ce délai.
Scripts over this trunk	Liste de tous les scripts pour lesquels Reachable via MS Teams est activé avec ce tenant, avec numéro et état : Reachable, Script switched off, Number already used by another script ou Number invalid. Un clic sur la ligne ouvre le script.
Tenant bar	Sections du tenant : Settings, Presence sync, Presence Live, Show calls, Call history, SIP log, Users, Phones, Number plan, Recordings, Captures.
Header	Affiche le nom d’hôte avec le port, l’état du certificat, Last OPTIONS et les Calls en cours. Les boutons lancent la trace SIP, la capture réseau et l’enregistrement des appels.

Vérifier le résultat et circonscrire les erreurs

Succès : le tenant figure dans la liste avec son nom d’hôte et son port. Les colonnes Certificate et Trunk indiquent l’état, d’abord sans certificat et sans OPTIONS.
“The integrated SBC is not enabled yet.” Cliquez sur Set it up first et activez le SBC.
„Bitte den vollständigen Hostnamen des Tenants angeben, zum Beispiel sbc.kunde.de“ ou „Der Hostname ist ungültig. Erwartet wird ein vollständiger Name wie sbc.kunde.de“. Saisissez le nom complet, et non un label court.
„Die Verzeichnis-ID (Tenant-ID) muss eine GUID sein.“ Copiez l’ID depuis la vue d’ensemble de Microsoft Entra. Ne le confondez pas avec l’ID d’application.
„Der TLS-Port … ist bereits vergeben.“ Choisissez un autre port.
„Der TLS-Port … ist intern belegt (…). Bitte einen anderen Port wählen, üblich ist 5061.“ Le port appartient à un service interne.
„Die Aufbewahrung des Anrufverlaufs muss 1 bis 365 Tage betragen.“ Corrigez la valeur.
Le tenant reste sans trunk tant que le certificat manque. Le SBC n’ouvre le port TLS d’un tenant que lorsque l’adresse IP publique est renseignée, que le certificat est émis et que le tenant est actif.