EasyUC
Deutsch
Aurora

Design auswählen

4.8.7

EasyUC für Microsoft Teams

Graph-Zugang und Teams-Admin-Anmeldung

Die App-Registrierung für Microsoft Graph hinterlegen und EasyUC an Teams PowerShell anmelden.

EasyUC · Version 4.8.7

In EasyUC: EasyUC Teams → Teams → Teams-Tenants → Tenant → Einstellungen → Microsoft Graph / Trunk in Teams einrichten

Wozu dient das

EasyUC spricht auf zwei Wegen mit Microsoft. Über Microsoft Graph liest es Benutzer, Anwesenheit und Teams-Telefone. Über Teams PowerShell richtet es den Trunk, die Rufregeln und die Rufnummernzuweisungen ein. Beide Wege brauchen eine Berechtigung im Microsoft-Tenant des Kunden.

Für Graph registrieren Sie im Tenant des Kunden eine Anwendung und hinterlegen deren Anwendungs-ID und geheimen Clientschlüssel in EasyUC. Dieselbe App-Registrierung kann auch die Anmeldung an Teams PowerShell übernehmen. EasyUC meldet sich dann vor jeder Aktion selbst an, und das Speichern eines Scripts setzt die Route in Teams ohne Zutun.

Ohne App-Registrierung bleibt die Gerätecode-Anmeldung: Ein Teams-Administrator bestätigt die Anmeldung im Browser. Diese Sitzung läuft nach etwa einer Stunde ab. Benutzername und Passwort eines Administrators speichert EasyUC nie.

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 Tenant ist angelegt und die Verzeichnis-ID (Tenant-ID) ist eingetragen.
  • Ein Konto mit dem Recht, im Microsoft-Tenant des Kunden App-Registrierungen anzulegen und Administratorzustimmung zu erteilen.
  • Für die Gerätecode-Anmeldung: ein Konto mit der Rolle Teams-Administrator.
  • Der PowerShell-Dienst von EasyUC läuft. Die Tenant-Seite zeigt das unter Trunk in Teams einrichten.

Schritt für Schritt: App-Registrierung in Microsoft Entra vorbereiten

  1. Melden Sie sich im Microsoft Entra Admin Center des Kunden an und legen Sie unter den App-Registrierungen eine neue Anwendung an, zum Beispiel mit dem Namen EasyUC.
  2. Notieren Sie die Verzeichnis-ID (Tenant-ID) und die Anwendungs-ID (Client-ID). Beide sind GUIDs, verwechseln Sie sie nicht.
  3. Erteilen Sie der Anwendung die Microsoft-Graph-Anwendungsberechtigungen User.Read.All (Benutzer), Presence.Read.All (Anwesenheit) und TeamworkDevice.Read.All (Teams-Telefone).
  4. Wenn Sie den Präsenz-Sync nutzen wollen, ergänzen Sie Presence.ReadWrite.All.
  5. Wenn sich EasyUC selbst an Teams PowerShell anmelden soll, ergänzen Sie die Anwendungsberechtigung Organization.Read.All.
  6. Erteilen Sie für alle Berechtigungen die Administratorzustimmung.
  7. Für die App-Anmeldung an Teams PowerShell weisen Sie der Anwendung zusätzlich die Verzeichnisrolle Teams-Administrator zu. Tragen Sie für die „Skype and Teams Tenant Admin API“ keine API-Berechtigung ein.
  8. Erstellen Sie einen geheimen Clientschlüssel und kopieren Sie seinen Wert. Notieren Sie das Ablaufdatum.

Schritt für Schritt: Graph-Zugang in EasyUC hinterlegen und prüfen

  1. Öffnen Sie Teams-Tenants, klicken Sie auf den Tenant und bleiben Sie im Abschnitt Einstellungen.
  2. Prüfen Sie oben die Verzeichnis-ID (Tenant-ID).
  3. Gehen Sie zum Kasten Microsoft Graph (Benutzerimport und Anwesenheit).
  4. Tragen Sie die Anwendungs-ID (Client-ID) ein.
  5. Tragen Sie unter Geheimer Clientschlüssel den Wert des Schlüssels ein.
  6. Klicken Sie Speichern.
  7. Klicken Sie Zugangsdaten prüfen. Bei Erfolg steht dort „Verbindung steht. Beispielbenutzer: …“ und im Kopf des Kastens Geprüft.

Schritt für Schritt: Mit der App-Registrierung an Teams PowerShell anmelden

  1. Gehen Sie auf der Tenant-Seite im Abschnitt Einstellungen zum Kasten Trunk in Teams einrichten.
  2. Prüfen Sie die Zeile PowerShell-Dienst erreichbar. Dahinter stehen die Versionen des Moduls MicrosoftTeams und von PowerShell.
  3. Steht dort „Eine App-Registrierung ist hinterlegt: EasyUC meldet sich vor jeder Aktion selbst an (App-Anmeldung, unbeaufsichtigt).“, müssen Sie nichts weiter tun. Die Statuspille zeigt Meldet sich selbst an.
  4. Zum Testen klicken Sie Mit App-Registrierung anmelden.
  5. Klicken Sie Verbindung prüfen. Bei Erfolg steht dort Angemeldet mit App-Anmeldung (unbeaufsichtigt).

Schritt für Schritt: Mit einem Teams-Administrator per Gerätecode anmelden

  1. Klicken Sie im Kasten Trunk in Teams einrichten auf Mit Teams-Admin anmelden.
  2. EasyUC zeigt einen Code und eine Adresse. Klicken Sie Code kopieren.
  3. Klicken Sie Anmeldeseite öffnen, melden Sie sich als Teams-Administrator an und geben Sie den Code ein.
  4. Lassen Sie die Tenant-Seite offen. Sie fragt alle drei Sekunden nach, höchstens fünf Minuten lang.
  5. Nach der Bestätigung steht dort Angemeldet mit Gerätecode (läuft ab), dem Konto und der Ablaufzeit.
  6. Erledigen Sie Trunk, Rufregeln und Rufnummernzuweisungen innerhalb der Sitzung. Mit Abmelden beenden Sie sie vorzeitig.

Felder und Optionen

Feld / AktionBedeutung und Verwendung
Anwendungs-ID (Client-ID)GUID der App-Registrierung im Tenant des Kunden.
Geheimer ClientschlüsselWert des Clientschlüssels. Ist einer hinterlegt, zeigt das Feld „hinterlegt – leer lassen, um ihn zu behalten“. Der Schlüssel wird nie angezeigt.
Hinterlegten Schlüssel entfernenMarkiert den gespeicherten Schlüssel zum Löschen. Er wird beim nächsten Speichern entfernt.
Zugangsdaten prüfenLiest testweise Benutzer aus dem Verzeichnis und speichert das Ergebnis mit Zeitpunkt. Zustände im Kopf: Geprüft, Abgelehnt, Noch nicht geprüft, Zugangsdaten fehlen.
Mit App-Registrierung anmeldenAnmeldung an Teams PowerShell mit Anwendungs-ID und Clientschlüssel. Erscheint nur, wenn beides hinterlegt ist. Läuft praktisch nicht ab.
Mit Teams-Admin anmeldenGerätecode-Anmeldung eines Administrators. Läuft nach etwa einer Stunde ab.
Verbindung prüfenLiest den Anmeldezustand neu.
AbmeldenBeendet die Sitzung an Teams PowerShell. Der Trunk bleibt davon unberührt.
StatuspilleAngemeldet, Meldet sich selbst an, Wartet auf Bestätigung, Nicht angemeldet, Anmeldung abgelaufen oder Dienst nicht erreichbar.

Ergebnis prüfen und Fehler eingrenzen

  • Erfolg Graph: Der Abschnitt Benutzer des Tenants zeigt die Benutzer des Verzeichnisses, der Abschnitt Telefone das Inventar.
  • Erfolg PowerShell: Im Kasten Trunk in Teams einrichten sind Was passieren würde und Routen aktualisieren bedienbar, und der Abschnitt Nummernplan lädt Rufnummern.
  • „Es sind noch keine vollständigen Graph-Zugangsdaten hinterlegt (Verzeichnis-ID, Anwendungs-ID und Secret).“ Eine der drei Angaben fehlt. Speichern Sie vor dem Prüfen.
  • „Die Verzeichnis-ID (Tenant-ID) oben wird ebenfalls benötigt.“ Tragen Sie die GUID in den Tenant-Einstellungen ein.
  • Zustand Abgelehnt: Prüfen Sie Clientschlüssel und Ablaufdatum, die Anwendungsberechtigungen und die Administratorzustimmung im richtigen Tenant.
  • „Verbindung steht, das Verzeichnis liefert aber keine Benutzer.“ Die Anmeldung gelingt, User.Read.All fehlt oder hat keine Zustimmung.
  • „Der PowerShell-Dienst ist nicht erreichbar - ohne ihn kann der Trunk nur von Hand in Teams angelegt werden.“ Prüfen Sie im EasyUC Manager, ob der PowerShell-Dienst des Teams-Moduls läuft.
  • „Die Gerätecode-Anmeldung ist abgelaufen“ Melden Sie sich neu an oder hinterlegen Sie eine App-Registrierung.
  • „Die Anmeldung wurde nicht bestaetigt. Bitte erneut starten.“ Die fünf Minuten sind verstrichen. Starten Sie die Anmeldung neu.
  • „Die Anmeldung steht, aber dem Konto fehlen die Rechte. Der App-Registrierung muss die Verzeichnisrolle „Teams-Administrator“ zugewiesen sein.“ Weisen Sie die Rolle in Microsoft Entra zu.
  • Ein erfolgreicher Graph-Test beweist keine Rechte für Teams PowerShell und umgekehrt. Prüfen Sie beide Wege getrennt.

Weiterlesen