Administration

Endbenutzer-Einrichtung: Live-Log und Sync ans externe Tool

Kommunikation mit dem externen Bestellwerkzeug mitlesen und den Konfigurationsbestand dorthin übertragen.

EasyUC · Version 4.8.7

In EasyUC: EasyUC Cisco → Verwaltung → CUCM & Bereitstellung → Endbenutzer-Einrichtung → Config Clusters → Live-Log / Sync ans externe Tool

Wozu dient das

Die Endbenutzer-Einrichtung arbeitet mit einem externen Werkzeug zusammen, das Telefonie bestellt. Zwei Hilfen machen diese Kopplung nachvollziehbar. Das Live-Log zeigt alles, was das externe Tool an EasyUC sendet, was EasyUC daraus macht, und jede Antwort, die an das Tool zurückgeht. Sie sehen einen Auftrag vom Eingang über die Verarbeitung bis zur Rückmeldung.

Der Sync ans externe Tool geht in die andere Richtung. EasyUC prüft jeden CUCM-Cluster der Endbenutzer-Einrichtung: welcher Benutzer auf welchem Cluster eine Konfiguration (Jabber, Tischtelefon, Device Profile) hat und zu welchem Standort und welcher Firma sie gehört. Dieses Inventar sendet EasyUC als JSON in Batches an eine von Ihnen eingetragene Adresse. So kennt das externe Werkzeug den Bestand, bevor es Bestellungen auslöst. Im CUCM wird dabei nur gelesen.

Voraussetzungen

Rolle ROLE_APP_ADMIN. Nur mit dieser Rolle zeigt die Oberfläche das Menü Verwaltung.
Das Modul cucm ist freigeschaltet. Ohne dieses Modul sperrt die Oberfläche die Seite.
Mindestens ein Cluster ist unter Config Clusters konfiguriert.
Für den Sync: Adresse des externen Werkzeugs, die JSON per HTTPS annimmt, und die dort verlangte Authentifizierung.
Das EasyUC-System erreicht diese Adresse im Netz.

Schritt für Schritt: Live-Log lesen

Wählen Sie in der Kopfzeile den Arbeitsbereich EasyUC Cisco.
Öffnen Sie Verwaltung → CUCM & Bereitstellung → Endbenutzer-Einrichtung → Config Clusters.
Klicken Sie oben auf Live-Log. Die Seite Externes Tool: Live-Log & Sync öffnet sich.
Lassen Sie die Anzeige auf Live stehen, um neue Einträge sofort zu sehen, oder halten Sie sie mit Pause an.
Grenzen Sie mit den Filtern ein: Richtung (Eingehend, EasyUC, Ausgehend), Kanal (Public API, Task, Webhook, Sync), Status (Erfolgreich, Warnung, Fehler, Info), Request-ID und Suchtext.
Klicken Sie auf einen Eintrag. Die Detailansicht zeigt die gesendeten Daten, die Antwort, den Abschnitt Was EasyUC gemacht hat und die Header.
Klicken Sie auf die Request-ID eines Eintrags, um unter Verlauf dieser Bestellung alle Schritte dieses Auftrags zu sehen.
Mit Ältere Einträge laden blättern Sie zurück, mit Ansicht leeren räumen Sie die Anzeige auf.

Schritt für Schritt: Sync-Ziel einrichten und testen

Klicken Sie auf der Seite Externes Tool: Live-Log & Sync auf Sync ans externe Tool.
Setzen Sie im Abschnitt Externes Tool (Sync-Ziel) den Haken Sync-Ziel aktiv.
Tragen Sie die URL des externen Tools ein.
Wählen Sie unter Authentifizierung Keine, Basic Auth oder Bearer Token und tragen Sie Benutzername und Passwort bzw. Token ein.
Tragen Sie Benutzer pro Batch ein.
Lassen Sie TLS-Zertifikat prüfen gesetzt und entscheiden Sie über Auch Benutzer ohne Konfiguration senden.
Klicken Sie auf Speichern.
Klicken Sie auf Verbindung testen. Die Seite meldet Verbindung funktioniert oder Verbindung fehlgeschlagen mit HTTP-Status und Dauer.

Schritt für Schritt: Sync starten

Klicken Sie im Abschnitt CUCM-Enduser-Konfigurationen synchronisieren zuerst auf Probelauf (nur Inventar erstellen).
Verfolgen Sie den Lauf unter Sync-Läufe. Je Cluster zeigt die Seite den Fortschritt und danach die Zähler für Benutzer, Konfigurationen, Jabber, Tischtelefone und Device Profiles.
Klicken Sie am Lauf auf Inventar herunterladen (JSON) und prüfen Sie die Datei.
Klicken Sie auf Alle CUCM-Enduser-Konfigurationen ans externe Tool senden für den vollständigen Bestand oder auf Nur Benutzerbasis senden für die Benutzer ohne Konfigurationen.
Prüfen Sie am Lauf den Zähler Batches gesendet und im Live-Log mit dem Kanal Sync die einzelnen Übertragungen.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Sync-Ziel aktiv	Schaltet die Übertragung ein. Standard: aus. Ohne aktives Ziel erstellt ein Sync nur das Inventar zum Herunterladen.
URL des externen Tools	Adresse, an die EasyUC das Inventar sendet. Die Nachrichten tragen den Typ `easyuc.enduser_config_sync`.
Authentifizierung	Keine (Vorgabe), Basic Auth mit Benutzername und Passwort oder Bearer Token. Ein gespeichertes Geheimnis wird nicht angezeigt. Das Feld zeigt dann unverändert.
Benutzer pro Batch	Anzahl Benutzer je Nachricht. Vorgabe 250, erlaubt 10 bis 2000.
TLS-Zertifikat prüfen	Vorgabe: an. EasyUC prüft das Zertifikat des Ziels.
Auch Benutzer ohne Konfiguration senden	Vorgabe: an. Überträgt auch Benutzer, die auf keinem Cluster ein Gerät haben.
Probelauf	Erstellt das Inventar, ohne etwas zu senden.
Zähler am Lauf	Benutzer, mit Konfiguration, Konfigurationen, Jabber, Tischtelefone, Device Profiles, bei Bedarf ohne Standortzuordnung und Batches gesendet.

Ergebnis prüfen und Fehler eingrenzen

Ein erfolgreicher Verbindungstest zeigt Verbindung funktioniert mit HTTP-Status und Laufzeit in Millisekunden.
Unter Sync-Läufe steht je Lauf Nummer, Status, Art, Zeitpunkt und auslösender Benutzer. Ein Probelauf ist als solcher gekennzeichnet.
Zähler ohne Standortzuordnung größer null: Diese Konfigurationen passen zu keinem Standort der Endbenutzer-Einrichtung. Ergänzen Sie die Standortzuordnung unter Config Clusters.
Ein Cluster ist rot markiert: EasyUC konnte ihn nicht lesen. Die Fehlermeldung steht daneben. Prüfen Sie die CUCM-Verbindung.
Verbindung fehlgeschlagen: Prüfen Sie Adresse, Erreichbarkeit, Zertifikat und Authentifizierung. Der angezeigte HTTP-Status grenzt die Ursache ein.
Das Live-Log bleibt leer und zeigt Noch keine Kommunikation: Das externe Werkzeug hat noch keinen Request gesendet oder die Filter sind zu eng.
Antworten auf Bestellungen gehen über den Webhook des Enduser-Tasks an das Werkzeug zurück. Sie erscheinen im Live-Log unter dem Kanal Webhook.