EasyUC
4.8.7

EasyUC für Cisco

Presence Sync von Anfang bis Ende

Durchgehende Checkliste von der Entra-App über Profil, Zuordnung und Trockenlauf bis zur Kontrolle in Presence Live.

EasyUC · Version 4.8.7

In EasyUC: Manager → Module → Presence Sync; Presence Sync → Presence-Profile

Wozu dient das

Diese Checkliste führt in einer festen Reihenfolge durch die gesamte Einrichtung der Jabber-Variante: Vorbereitung bei Microsoft und Cisco, Modul aktivieren, Profil anlegen, Zuordnung prüfen, Trockenlauf, scharf schalten und Kontrolle im Protokoll. Jeder Block endet mit einer Prüfung. Gehen Sie erst weiter, wenn sie bestanden ist.

Die Einzelheiten zu Feldern und Meldungen stehen in den verlinkten Kapiteln. Für die Webex App gilt ein eigener Ablauf im Kapitel zu Presence mit Cisco Webex.

Voraussetzungen

  • Zugang zum EasyUC Manager, um das Modul Presence Sync einzuschalten.
  • Ein EasyUC-Konto mit den Rechten ROLE_APP_PRESENCE_WORKSPACE, ROLE_APP_PRESENCE_TENANTS_EDIT und ROLE_APP_PRESENCE_SYNC_EDIT oder ein Administratorkonto.
  • In Microsoft Entra das Recht, App-Registrierungen anzulegen und die Administratorzustimmung für Anwendungsberechtigungen zu erteilen.
  • Im CUCM das Recht, einen Application User und einen Endbenutzer anzulegen und Rollen zu vergeben.
  • Eine CUCM-Verbindung in EasyUC, deren Anrufüberwachung alle Geräte erfasst.
  • Zwei Testbenutzer, die in Microsoft und im CUCM vorhanden sind und ein gemeinsames Kennzeichen tragen, zum Beispiel dieselbe E-Mail-Adresse.
  • Die Appliance erreicht graph.microsoft.com und login.microsoftonline.com über HTTPS sowie den Presence-Webservice von IM and Presence.

Schritt für Schritt: Microsoft Entra vorbereiten

  1. Öffnen Sie das Microsoft Entra Admin Center und legen Sie unter den App-Registrierungen eine neue Registrierung an, zum Beispiel mit dem Namen „EasyUC Presence“.
  2. Notieren Sie die Verzeichnis-ID (Tenant-ID) und die Anwendungs-ID (Client-ID).
  3. Legen Sie einen geheimen Clientschlüssel an und notieren Sie seinen Wert und sein Ablaufdatum.
  4. Fügen Sie unter den API-Berechtigungen für Microsoft Graph die Anwendungsberechtigungen User.Read.All, Presence.Read.All und Presence.ReadWrite.All hinzu.
  5. Erteilen Sie die Administratorzustimmung für den Tenant.
  6. Prüfung: Alle drei Berechtigungen zeigen den Status „gewährt“.

Schritt für Schritt: Cisco-Seite vorbereiten

  1. Prüfen Sie in EasyUC an der CUCM-Verbindung, dass die Anrufüberwachung eingeschaltet ist und alle Geräte beobachtet. Das beschreibt das Kapitel zur Anrufüberwachung der CUCM-Verbindung.
  2. Legen Sie im CUCM einen Application User für den Presence-Webservice an und geben Sie ihm die Rolle Admin-3rd Party API.
  3. Legen Sie einen eigenen Endbenutzer als Beobachter an, der den Presence-Status der betroffenen Jabber-Benutzer sehen darf. Verwenden Sie dafür kein persönliches Konto.
  4. Notieren Sie die Adresse des Presence-Webservice auf IM and Presence (HTTPS mit dem Pfad /presence-service) und die Presence-Domain der Jabber-Adressen.
  5. Verwendet IM and Presence ein Zertifikat einer internen Zertifizierungsstelle, halten Sie deren CA-Zertifikat für den EasyUC-Server bereit.
  6. Prüfung: Der Presence-Webservice ist von der Appliance aus über HTTPS erreichbar.

Schritt für Schritt: Modul aktivieren und Profil anlegen

  1. Öffnen Sie den EasyUC Manager und schalten Sie unter Module das Modul Presence Sync ein. Der Manager startet den Presence-Dienst.
  2. Warten Sie, bis der Manager den Dienst als bereit anzeigt.
  3. Melden Sie sich an EasyUC an und wählen Sie oben den Arbeitsbereich Presence Sync.
  4. Klicken Sie auf Presence-Profil hinzufügen und tragen Sie in Schritt 1 Profilname, Tenant-ID, Client-ID und Client-Secret ein.
  5. Wählen Sie in Schritt 2 CUCM / Jabber und tragen Sie den Cisco-Zugang ein: CUCM-Benutzerverzeichnis und die Angaben zu Cisco IM and Presence.
  6. Wählen Sie in Schritt 3 Kennzeichen vergleichen und die beiden Felder, die in Microsoft und im CUCM denselben Wert tragen.
  7. Klicken Sie auf Einrichtung speichern.
  8. Prüfung: Microsoft Graph testen zeigt Graph geprüft, und Cisco-Verbindung testen meldet keine Fehler.

Schritt für Schritt: Zuordnung prüfen

  1. Klicken Sie in Schritt 3 des Profils auf Zuordnung prüfen.
  2. Vergleichen Sie Microsoft-Benutzer und Cisco-Benutzer mit den erwarteten Zahlen.
  3. Filtern Sie auf Nicht gefunden. Fehlt das Kennzeichen bei diesen Benutzern in einem der Verzeichnisse, pflegen Sie es dort nach.
  4. Filtern Sie auf Mehrdeutig. Bereinigen Sie doppelte Werte im Verzeichnis oder ordnen Sie einzelne Benutzer über Kandidaten manuell zuordnen … zu.
  5. Suchen Sie Ihre beiden Testbenutzer. Beide müssen Eindeutig oder Manuell zeigen.
  6. Klicken Sie auf Einrichtung speichern.
  7. Prüfung: Die Zahl unter Eindeutig entspricht der Zahl der Benutzer, die am Abgleich teilnehmen sollen.

Schritt für Schritt: Trockenlauf und scharf schalten

  1. Öffnen Sie am Profil die Seite Konfiguration.
  2. Schalten Sie zunächst nur CUCM-Anrufstatus → Teams ein und wählen Sie die CUCM-Verbindung.
  3. Lassen Sie Intervall (Sekunden) auf 10 und den Hauptschalter Präsenz-Sync aktivieren aus. Klicken Sie auf Speichern.
  4. Führen Sie mit einem Testbenutzer ein Gespräch am Cisco-Telefon und klicken Sie währenddessen auf Trockenlauf.
  5. Lesen Sie die Trockenlauf-Vorschau: Aktive Anrufe zeigt mindestens 1, Geplante Änderungen nennt den Testbenutzer, Konflikte ist 0.
  6. Schalten Sie Präsenz-Sync aktivieren ein und klicken Sie auf Speichern.
  7. Prüfung: Der Laufzeitstatus wechselt auf Synchronisation aktiv, und Letzte Prüfung ist wenige Sekunden alt.

Schritt für Schritt: In Presence Live kontrollieren

  1. Öffnen Sie Presence Live.
  2. Führen Sie mit dem Testbenutzer erneut ein Gespräch am Cisco-Telefon.
  3. Beobachten Sie den Statusverlauf. Innerhalb des Intervalls erscheint ein Eintrag der Richtung Cisco CUCM → Teams mit dem Quellstatus Im Gespräch und dem Ergebnis Erfolgreich.
  4. Prüfen Sie im Teams-Client eines Kollegen, dass der Testbenutzer „In einem Anruf“ zeigt.
  5. Beenden Sie das Gespräch. Im Statusverlauf erscheint ein Eintrag mit der Aktion Freigeben, und Teams zeigt wieder den eigenen Status des Benutzers.
  6. Schalten Sie bei Bedarf weitere Richtungen ein, jeweils einzeln, und wiederholen Sie Trockenlauf und Kontrolle.
  7. Prüfung: Der Zähler Fehler über dem Statusverlauf bleibt 0.

Felder und Optionen: Was Sie am Ende notiert haben sollten

Felder und Optionen: Was Sie am Ende notiert haben sollten
Feld / AktionBedeutung und Verwendung
Tenant-ID und Client-IDKennungen der Entra-App. Das Client-Secret zeigt EasyUC nach dem Speichern nicht mehr an.
Ablaufdatum des Client-SecretsLäuft es ab, schlägt der Graph-Zugang fehl. Tragen Sie rechtzeitig ein neues Secret im Profil ein.
Application User und BeobachterNamen der beiden Cisco-Konten und wer sie verwaltet.
Gewählte KennzeichenFeld in Microsoft und Feld im CUCM, über die zugeordnet wird.
Eingeschaltete Richtungen und IntervallStand der Konfigurationsseite nach der Abnahme.
Manuelle ZuordnungenListe der Ausnahmen mit Begründung, damit sie bei Änderungen im Verzeichnis überprüft werden können.

Ergebnis prüfen und Fehler eingrenzen

  • Abnahme bestanden: Für beide Testbenutzer erscheinen Gesprächsbeginn und Gesprächsende in Presence Live, Teams zeigt den Status innerhalb des Intervalls, und nach dem Gesprächsende steht wieder der eigene Status.
  • Prüfen Sie zusätzlich: Neustart des Teams-Clients während eines Gesprächs, zwei Gespräche nacheinander, ein Benutzer mit „Nicht stören“ in Teams. Der letzte Fall muss als übersprungen im Protokoll stehen.
  • Der Trockenlauf zeigt Aktive Anrufe 0 trotz Gespräch: Die Anrufüberwachung der CUCM-Verbindung erfasst das Gerät nicht. Prüfen Sie die Live Calls der Verbindung.
  • Der Testbenutzer fehlt unter Geplante Änderungen: Er ist nicht eindeutig zugeordnet, oder seine Leitung ist eine gemeinsam genutzte Leitung.
  • Der Laufzeitstatus bleibt auf Erster Abgleich ausstehend: Der Presence-Dienst läuft nicht. Prüfen Sie ihn im Manager.
  • Weitere Meldungen und ihre Abhilfe stehen im Kapitel zu den Fehlerbildern.

Weiterlesen