Presence-Profil einrichten

Wozu dient das

Wer Cisco-Telefonie und Microsoft Teams nebeneinander nutzt, sieht in Teams nicht, dass ein Kollege gerade am Cisco-Telefon spricht, und in Jabber nicht, dass er in einer Teams-Besprechung sitzt. Der Arbeitsbereich Presence Sync gleicht diese Zustände ab.

Grundlage ist ein Presence-Profil je Kunde. Es enthält drei Dinge: den Zugang zu Microsoft Graph für den Tenant, den Zugang zur Cisco-Seite (CUCM mit IM and Presence für Jabber oder die Webex Cloud) und die Regel, woran EasyUC dieselbe Person in beiden Systemen erkennt. Ein Profil braucht keinen SBC, keinen SIP-Port und kein Zertifikat.

Ein neues Profil startet ausgeschaltet. Die Synchronisation aktivieren Sie anschließend auf der Seite Konfiguration. Bereits vorhandene Tenants aus EasyUC Teams erscheinen als Profile mit dem Kennzeichen Gemeinsam mit Teams-SBC und teilen sich den Graph-Zugang.

Voraussetzungen

Modul Presence Sync ist auf der Appliance aktiviert. Es läuft als eigener Dienst und setzt weder Teams-SBC noch ACD voraus.
Profile ansehen: ROLE_APP_PRESENCE_WORKSPACE und ROLE_APP_PRESENCE_TENANTS. Profile anlegen oder ändern: zusätzlich ROLE_APP_PRESENCE_TENANTS_EDIT. Cisco-Zugang und Benutzerzuordnung: zusätzlich ROLE_APP_PRESENCE_SYNC und zum Ändern ROLE_APP_PRESENCE_SYNC_EDIT. Administratoren (ROLE_APP_ADMIN, ROLE_OWNER, ROLE_ADMIN oder ROLE_SUPER_ADMIN) haben alle Rechte.
In Microsoft Entra: eine App-Registrierung mit Client-ID und Client-Secret. Anwendungsberechtigungen User.Read.All, Presence.Read.All und Presence.ReadWrite.All mit Administratorzustimmung für den Tenant.
Für Jabber im CUCM: ein AXL-Zugang zum Benutzerverzeichnis. Sie können eine vorhandene CUCM-Verbindung aus EasyUC übernehmen oder Adresse, Version und Benutzer direkt eintragen.
Für Jabber auf IM and Presence: die Adresse des Presence-Webservice, die Presence-Domain, ein Application User mit der Rolle Admin-3rd Party API und ein eigener Endbenutzer als Beobachter, der den Presence-Status der zugeordneten Jabber-Benutzer lesen darf.
Ein Feld, das in Microsoft und Cisco denselben Wert trägt, zum Beispiel E-Mail-Adresse oder Telefonnummer.
Für Webex gelten andere Voraussetzungen. Siehe das Kapitel zu Presence mit Cisco Webex.

Schritt für Schritt: Profil anlegen

Wählen Sie oben den Arbeitsbereich Presence Sync. Es öffnet sich die Liste Presence-Profile.
Klicken Sie auf Presence-Profil hinzufügen.
Schritt 1, Microsoft Teams verbinden: Tragen Sie Profilname, Microsoft-Tenant-ID, Microsoft-Graph-Client-ID und Microsoft-Graph-Client-Secret ein.

Originalansicht zur Anleitung Zu Schritt 3
Beim neuen Presence-Profil beginnen Sie mit den Microsoft-Verbindungsdaten und wählen anschließend die beteiligten Clients. Im Beispiel sind Tenant-ID, Client-ID und Secret leer. Zugangstests und Benutzerzuordnung folgen in den nächsten Schritten.

EasyUC · Lab-/Demoumgebung
Presence-Profil einrichten

Beginn des ungespeicherten Presence-Formulars mit Microsoft-Tenant, Graph-Zugang und Cisco-Client-Auswahl. Alle Zugangsfelder sind leer; es wurde weder ein Profil gespeichert noch eine Synchronisation aktiviert.
Schritt 2, Cisco-Umgebung verbinden: Wählen Sie CUCM / Jabber.
Wählen Sie Cisco-Zugang direkt einrichten und tragen Sie den Name der Cisco-Verbindung ein. Ist für diesen Client schon ein Zugang gespeichert, wählen Sie stattdessen Vorhandene Presence-Verbindung.
Wählen Sie unter CUCM-Benutzerverzeichnis eine vorhandene CUCM-Verbindung. Oder wählen Sie CUCM-Zugang direkt konfigurieren und tragen CUCM-AXL-Adresse, AXL-Version, AXL-Benutzer und AXL-Kennwort ein.
Tragen Sie unter Cisco IM and Presence die Presence-Webservice-Adresse, die Presence-Domain, Presence-Anwendungsbenutzer, Presence-Anwendungskennwort und den Presence-Beobachterbenutzer ein.
Schritt 3, Benutzer verknüpfen: Wählen Sie Kennzeichen vergleichen. Wählen Sie das Kennzeichen in Microsoft und das Kennzeichen in CUCM / Jabber, zum Beispiel E-Mail und CUCM Mail-ID.
Klicken Sie auf Einrichtung speichern. EasyUC speichert nacheinander Microsoft-Profil, Cisco-Verbindung und Benutzerzuordnung und meldet Profil, Cisco-Zugang und Benutzerzuordnung gespeichert. Die EasyUC-Synchronisation ist ausgeschaltet. Prüfe jetzt die Zugänge und die Zuordnung.

Schritt für Schritt: Zugänge und Zuordnung prüfen

Klicken Sie in Schritt 1 auf Microsoft Graph testen. Der Status wechselt auf Graph geprüft.
Klicken Sie in Schritt 2 auf Cisco-Verbindung testen. Das Ergebnis listet die einzelnen Prüfungen mit Name und Meldung.
Klicken Sie in Schritt 3 auf Zuordnung prüfen. Die Vorschau überträgt keine Presence-Stati.
Lesen Sie die Zähler Microsoft-Benutzer, Cisco-Benutzer, Eindeutig, Nicht gefunden, Mehrdeutig und Manuell.
Filtern Sie die Tabelle auf Nicht gefunden oder Mehrdeutig. Wählen Sie bei einzelnen Zeilen über Kandidaten manuell zuordnen … den passenden Cisco-Benutzer.
Ergänzen Sie Ausnahmen unter Manuelle Zuordnungen über Zuordnung ergänzen mit Microsoft-Benutzer-ID und Cisco-Benutzer-ID.
Klicken Sie erneut auf Einrichtung speichern.
Klicken Sie unten auf Synchronisation und Monitoring aktivieren, um zur Seite Konfiguration zu wechseln.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Profilname	Anzeigename des Profils, höchstens 190 Zeichen. Üblich ist der Kundenname.
Microsoft-Tenant-ID	Verzeichnis-ID des Microsoft-Tenants.
Microsoft-Graph-Client-ID / Client-Secret	Anmeldedaten der Entra-App. Gespeicherte Secrets werden nicht angezeigt. Leere Felder behalten den vorhandenen Wert.
CUCM / Jabber oder Cisco Webex	Client, den der Kunde verwendet. Der Client eines bestehenden Cisco-Zugangs lässt sich nicht nachträglich wechseln.
Name der Cisco-Verbindung	Name des gespeicherten Cisco-Zugangs, höchstens 190 Zeichen. Ein Zugang kann von mehreren Profilen verwendet werden. Änderungen gelten dann für alle.
CUCM-AXL-Adresse	HTTPS-Adresse der AXL-Schnittstelle. Sie muss auf `/axl/` enden, zum Beispiel `https://cucm-pub01.intern:8443/axl/`.
AXL-Version	Auswahl von 10.0 bis 15.0.
Presence-Webservice-Adresse	HTTPS-Adresse des Presence-Webservice auf IM and Presence, mit dem Pfad `/presence-service`.
Presence-Domain	Domain der Jabber-Adressen, zum Beispiel `example.com`.
Presence-Anwendungsbenutzer / -kennwort	CUCM Application User mit der Rolle `Admin-3rd Party API`.
Presence-Beobachterbenutzer	Endbenutzer mit Leseberechtigung für den Presence-Status der zugeordneten Jabber-Benutzer. Ohne ihn kann EasyUC den Jabber-Status nicht lesen.
Erweiterte Cisco-Einstellungen	Alternative Webservice-Adresse für einen zweiten IM-and-Presence-Knoten und Pfade zu CA-Zertifikaten auf dem EasyUC-Server für private Zertifikate.
Kennzeichen in Microsoft	E-Mail, User Principal Name, Geschäftliche Telefonnummer, Mobiltelefon, Entra-Objekt-ID, Mitarbeiter-ID, Lokaler Benutzername oder ein benutzerdefiniertes Attribut.
Kennzeichen in CUCM / Jabber	CUCM Mail-ID, CUCM Benutzer-ID, CUCM Telefonnummer, CUCM Directory URI oder CUCM Abteilung.
Groß- und Kleinschreibung unterscheiden	Standard: aus. Eingeschaltet müssen die Werte exakt übereinstimmen.
Manuelle Zuordnungen	Feste Paare aus Microsoft-Benutzer-ID und Cisco-Benutzer-ID. Jede ID darf nur einmal vorkommen.
Profil löschen	Nur bei eigenständigen Profilen. Löscht das Profil und beendet seine Synchronisation.

Ergebnis prüfen und Fehler eingrenzen

Erfolg: In der Profilliste steht Microsoft Graph · Bereit, der Cisco-Test ist grün und die Vorschau zeigt die erwartete Zahl unter Eindeutig.
Speichere das Profil vor dem Verbindungstest. und Speichere den Cisco-Zugang vor dem Verbindungstest. Tests arbeiten immer mit den gespeicherten Zugangsdaten.
Wähle eine vorhandene Verbindung oder gib einen Verbindungsnamen und gültige HTTPS-Adressen ohne eingebettete Zugangsdaten ein. Adressen müssen mit https:// beginnen und dürfen keinen Benutzer enthalten.
Die Prüfung ist unvollständig. Beachte die Hinweise; nicht geprüfte Benutzer gelten nicht als zugeordnet. Eines der Verzeichnisse konnte nicht vollständig gelesen werden.
Mehrdeutig: Derselbe Wert kommt bei mehreren Benutzern vor. Solche Treffer werden übersprungen. Feld wechseln oder manuell zuordnen.
Für die Cisco-Einrichtung benötigst du die Presence-Sync-Berechtigung. Es fehlt ROLE_APP_PRESENCE_SYNC.
Dieses Profil teilt seine Microsoft-Zugänge mit dem Teams SBC. Änderungen gelten für beide Bereiche und benötigen zusätzlich die Teams-Tenant-Bearbeitungsberechtigung.
Ein anderes aktives Presence-Profil verwendet bereits diese IM&P-Application-Session. Je IM-and-Presence-Anwendungsbenutzer kann nur ein aktives Profil veröffentlichen. Eigenen Application User verwenden oder das andere Profil deaktivieren.
Schlägt das Speichern nach dem ersten Teilschritt fehl, bleibt das Profil erhalten. Fehlende Angaben ergänzen und erneut speichern. Es entsteht kein zweites Profil.