EasyUC für Microsoft Teams

Teams-Tenant anlegen und verwalten

Einen Microsoft-Teams-Tenant mit eigenem Hostnamen, TLS-Port und Zertifikat an den SBC anbinden.

EasyUC · Version 4.8.7

In EasyUC: EasyUC Teams → Teams → Teams-Tenants → Tenant hinzufügen

Die Bilder stammen aus der EasyUC-Lab-Umgebung. Namen und Beispielwerte dienen der Orientierung. Eine abweichende Oberflächensprache ist am jeweiligen Bild angegeben.

Wozu dient das

Ein Tenant in EasyUC steht für genau einen Microsoft-Teams-Tenant, also für eine Kundenorganisation in Microsoft 365. Jeder Tenant bekommt einen eigenen öffentlichen Hostnamen, einen eigenen TLS-Port und ein eigenes Zertifikat. So lassen sich mehrere Kunden über denselben SBC anbinden, ohne dass sich ihre Trunks berühren.

Die Tenant-Seite ist der zentrale Ort für alles Weitere: Zertifikat, Microsoft-Graph-Zugang, Anmeldung an Teams PowerShell, Trunk und Rufregeln, Benutzer, Telefone, Nummernplan, Anrufverlauf, Aufnahmen und Mitschnitte.

Der Hostname muss zu einer Domain gehören, die im Microsoft-365-Tenant des Kunden verifiziert ist. Microsoft lehnt ein PSTN-Gateway unter einer fremden Domain ab.

Voraussetzungen

Lizenzmodul teams. Ohne dieses Modul erscheint der Workspace EasyUC Teams nicht.
Rolle EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) mit den Unterrechten TENANTS (ROLE_APP_TEAMS_TENANTS) zum Lesen und TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT) zum Ändern.
Der integrierte SBC ist eingeschaltet und hat eine öffentliche IP (Kapitel „Teams-SBC einschalten und Netzangaben festlegen“).
Ein vollständiger Hostname für den Tenant, zum Beispiel sbc.kunde.de, mit öffentlichem DNS-A-Record auf die öffentliche IP des SBC.
Die Domain des Hostnamens ist im Microsoft-365-Tenant des Kunden verifiziert. Für sbc.kunde.de muss kunde.de dort eingetragen sein.
Die Verzeichnis-ID (Tenant-ID) des Kunden aus Microsoft Entra, sobald Sie Graph oder die App-Anmeldung nutzen wollen.

Schritt für Schritt: Tenant anlegen

Wählen Sie den Workspace EasyUC Teams und öffnen Sie Teams → Teams-Tenants.
Klicken Sie Tenant hinzufügen. Das Formular Neuer Teams-Tenant öffnet sich.
Tragen Sie unter Kundenname einen Namen ein, zum Beispiel Muster GmbH.
Tragen Sie unter SBC-Hostname für diesen Tenant den vollständigen Hostnamen ein, zum Beispiel sbc.kunde.de. Darunter zeigt EasyUC, welche Domain im Teams-Tenant verifiziert sein muss und auf welche IP der A-Record zeigen muss.
Tragen Sie unter Verzeichnis-ID (Tenant-ID) die GUID des Microsoft-Tenants ein.
Lassen Sie Anrufe leiten an leer. Das Feld wird für das Routing nicht mehr verwendet.
Klicken Sie Erstellen. EasyUC vergibt den nächsten freien TLS-Port und öffnet die Liste mit dem neuen Tenant.
Klicken Sie auf die Zeile des Tenants. Die Tenant-Seite öffnet sich im Abschnitt Einstellungen.
Fordern Sie als Nächstes das Zertifikat an (Kapitel „SBC-Zertifikat je Tenant“).

Schritt für Schritt: Tenant-Einstellungen ändern

Öffnen Sie Teams-Tenants und klicken Sie auf den Tenant.
Bleiben Sie im Abschnitt Einstellungen der linken Tenant-Leiste.
Ändern Sie Kundenname, SBC-Hostname, Verzeichnis-ID (Tenant-ID) oder TLS-Port.
Setzen oder entfernen Sie die Haken Trunk aktiv und SIP-Verlauf jedes Anrufs speichern.
Tragen Sie unter Anrufverlauf aufbewahren (Tage) einen Wert von 1 bis 365 ein.
Klicken Sie Speichern.
Wenn Sie Hostname oder TLS-Port geändert haben: Fordern Sie das Zertifikat neu an und gleichen Sie den Trunk in Teams ab (Routen aktualisieren).

Schritt für Schritt: Weitere Tenants anbinden oder einen Tenant löschen

Für einen weiteren Kunden wiederholen Sie die Anlage mit dessen Hostnamen, zum Beispiel sbc.kunde-b.de. Der neue Tenant bekommt den nächsten freien TLS-Port.
Geben Sie den zusätzlichen TLS-Port in der Firewall frei. Den Port zeigt die Tenant-Liste in der Spalte Hostname hinter dem Doppelpunkt.
Über Alle Tenants in der Tenant-Leiste wechseln Sie zurück in die Liste.
Zum Löschen klicken Sie in der Liste am Ende der Zeile auf das Papierkorb-Symbol und bestätigen die Rückfrage „Tenant … löschen? Trunk, Zertifikat und Mitschnitt werden entfernt.“
Entfernen Sie vor dem Löschen den Trunk in Microsoft Teams über Trunk entfernen. Das Löschen in EasyUC räumt in Microsoft nichts ab.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Kundenname	Anzeigename des Tenants in EasyUC. Pflichtfeld.
SBC-Hostname	Vollständiger öffentlicher Name, unter dem Microsoft den Trunk dieses Tenants erreicht. Auf diesen Namen lautet das Zertifikat. Eine Änderung fordert ein neues Zertifikat an.
Verzeichnis-ID (Tenant-ID)	GUID des Microsoft-Tenants. Bei der Anlage optional, für Microsoft Graph, die App-Anmeldung und die Teams-Anmeldung am Vermittlungsplatz erforderlich.
TLS-Port	SIP-Port dieses Tenants. EasyUC vergibt ihn bei der Anlage. Jeder Port ist nur einmal vergeben.
Anrufe leiten an	Altes Feld. Es wird für das Routing nicht mehr verwendet. Welche Nummer in welches Script führt, legen Sie im Script fest.
Trunk aktiv	Ohne Haken ist der Tenant abgeschaltet. In der Liste steht dann deaktiviert, Anrufe kommen nicht an, und es wird kein Zertifikat automatisch erneuert.
SIP-Verlauf jedes Anrufs speichern	Speichert jede SIP-Nachricht eines Anrufs ohne OPTIONS. Damit lässt sich jeder Anruf live oder danach als Leiterdiagramm öffnen. Vorgabe: eingeschaltet.
Anrufverlauf aufbewahren (Tage)	1 bis 365, Vorgabe 14. Anrufe und ihr SIP-Verlauf werden nach dieser Zeit gelöscht.
Scripts über diesen Trunk	Liste aller Scripts, bei denen Über MS Teams erreichbar mit diesem Tenant eingeschaltet ist, mit Nummer und Status: Erreichbar, Script abgeschaltet, Nummer schon von einem anderen Script belegt oder Nummer ungültig. Ein Klick auf die Zeile öffnet das Script.
Tenant-Leiste	Abschnitte des Tenants: Einstellungen, Präsenz-Sync, Presence Live, Anrufe anzeigen, Anrufverlauf, SIP-Log, Benutzer, Telefone, Nummernplan, Aufnahmen, Mitschnitte.
Kopfzeile	Zeigt Hostname mit Port, Zertifikatszustand, Letztes OPTIONS und laufende Anrufe. Die Schaltflächen starten SIP-Mitschnitt, Netzwerk-Mitschnitt und Gesprächsaufzeichnung.

Ergebnis prüfen und Fehler eingrenzen

Erfolg: Der Tenant steht in der Liste mit Hostname und Port. Die Spalten Zertifikat und Trunk zeigen den Zustand, zunächst ohne Zertifikat und ohne OPTIONS.
„Der integrierte SBC ist noch nicht eingeschaltet.“ Klicken Sie Zuerst einrichten und schalten Sie den SBC ein.
„Bitte den vollständigen Hostnamen des Tenants angeben, zum Beispiel sbc.kunde.de“ oder „Der Hostname ist ungültig. Erwartet wird ein vollständiger Name wie sbc.kunde.de“. Tragen Sie den ganzen Namen ein, kein Kürzel.
„Die Verzeichnis-ID (Tenant-ID) muss eine GUID sein.“ Kopieren Sie die ID aus der Übersicht von Microsoft Entra. Verwechseln Sie sie nicht mit der Anwendungs-ID.
„Der TLS-Port … ist bereits vergeben.“ Wählen Sie einen anderen Port.
„Der TLS-Port … ist intern belegt (…). Bitte einen anderen Port wählen, üblich ist 5061.“ Der Port gehört zu einem internen Dienst.
„Die Aufbewahrung des Anrufverlaufs muss 1 bis 365 Tage betragen.“ Korrigieren Sie den Wert.
Der Tenant bleibt ohne Trunk, solange das Zertifikat fehlt. Der SBC öffnet den TLS-Port eines Tenants erst, wenn die öffentliche IP gepflegt, das Zertifikat ausgestellt und der Tenant aktiv ist.