Verzeichnissynchronisierung in Webex für Cisco BroadWorks

Die Verzeichnissynchronisierung stellt sicher, dass Webex für Cisco BroadWorks-Benutzer das Webex-Verzeichnis aus der Webex-App verwenden kann, um jede Anrufer-Entity vom BroadWorks-Server aufrufen zu können. Diese Funktion synchronisiert BroadWorks-Anrufinformationen, die nicht Teil der Benutzerbereitstellung im Webex-Verzeichnis waren.

Die Benutzerbereitstellung von Webex für Cisco BroadWorks aktualisiert das Webex-Verzeichnis mit Anrufdetails für Webex-Benutzer von Cisco BroadWorks (primäre Telefonnummer, Mobiltelefonnummer, Durchwahl), lässt jedoch externe Anrufdatensätze aus. Wenn jedoch die Verzeichnissynchronisierung ein aktivieren ist, synchronisiert die Funktion auch die folgenden Anrufdatensätze mit dem Webex-Verzeichnis.

• Nur-BroadWorks-Anrufende Benutzer (die nicht bei Webex integriert sind)

• Nichtbenutzeranrufer (z. B. Konferenzraum Telefon, Faxgerät, Telefonnummer Sammelanschluss)

• BroadWorks-Telefonlisteneinträge

Die folgende Tabelle fasst BroadWorks-Anrufdatensätze zusammen und zeigt, wie sie zum Webex-Verzeichnis hinzugefügt werden.

Verzeichnissynchronisierungsbedingungen

• Partneradministratoren müssen die Funktion auf Partnerebene aktivieren. Partneradministratoren können diese Funktion für mehrere Kundenorganisationen in einem einzigen Vorgang aktivieren oder deaktivieren.

• Standardmäßig erfolgt die erste Synchronisierung eine Woche nach der Aktivierung der Synchronisierung (die zeit, zu der die Synchronisierung gestartet werden soll, ist zufällig). Kundenorganisationen können jedoch die Option „Jetzt synchronisieren“ verwenden, um die einwöchige Wartezeit zu umgehen und eine sofortige Synchronisierung für eine bestimmte Kundenorganisation auszulösen.

• Standardmäßig wird Directory Sync für jeden Kunden wöchentlich ausgeführt. Jede Synchronisierung erfolgt eine Woche nach der letzten Synchronisierung, unabhängig davon, ob die letzte Synchronisierung mit "Jetzt synchronisieren" geplant oder ausgelöst wurde.

• Pro BroadWorks-Cluster sind maximal zwei Synchronisierungen gleichzeitig zulässig: eine geplante Synchronisierung und eine Bei-Bedarf-Synchronisierung (über API oder Partner Hub-GUI). Administratoren können jedoch nicht zwei on-Demand-Synchronisierungen gleichzeitig mit denselben BroadWorks ausführen. Diese Einschränkung besteht unabhängig davon, ob die Synchronisierung über die API oder die Option "Jetzt synchronisieren" im Partner Hub initiiert wurde. Außerdem werden von Webex nicht zwei geplante Synchronisierungen zur gleichzeitigen Ausführung von denselben BroadWorks geplant.

• Bei einem Synchronisierungsfehler wird die Synchronisierung von Webex automatisch alle 24 Stunden bis zur nächsten geplanten Synchronisierung erneut gestartet.

• Bei der Synchronisierung werden Benutzer ignoriert, die keine Telefonnummer haben.

• Im Partner Hub können Sie Synchronisierungsstatusinformationen für einen bestimmten Kunden anzeigen. Außerdem können Sie detaillierte Informationen zur letzten Synchronisierung in einen CSV-Datensatz exportieren. Der CSV-Datensatz bietet mehr Details als die Control Hub-Anzeige und kann bei der Fehlerbehebung, Analyse und Überwachung helfen.

• Webex speichert Nutzerkontakte in einem verschlüsselten Format. Nur der Benutzer, der der Kontakt ist, hat Zugriff auf den Entschlüsselungsschlüssel.

• Für Benutzer von BroadWorks nur anrufende Benutzer und Nicht-Benutzeranruf-Entitäten synchronisiert diese Funktion die folgenden Telefonnummerntypen von BroadWorks:

  • Primäre Telefonnummer

  • Telefonnummer (mobil)

  • Erweiterung

  Bei der Synchronisierung werden jedoch nur anrufende Benutzer von BroadWorks und Nichtbenutzeranrufer von der Synchronisierung ausgeschlossen, wenn weder eine primäre Telefonnummer noch eine Durchwahl vorhanden sind.

  Die Einstellung des Datenschutzdienstes auf BroadWorks-Benutzerebene wird nicht als Teil der Verzeichnissynchronisierung unterstützt.

BroadWorks-Telefonliste und Kontakt-Maximalwerte

Directory Sync synchronisiert auch BroadWorks-Telefonlisteneinträge mit Webex-Kontakten. Synchronisierte Einträge werden zu einem der folgenden Kontakttypen hinzugefügt:

• Organisationskontakte: Webex speichert diese Kontakte für eine Organisation. Jeder Benutzer kann auf die Organisationskontakte für seine Organisation zugreifen. Die maximale Anzahl beträgt 30000 Kontakte.

• Benutzerkontakte: Webex speichert diese Kontakte für einen Benutzer. Nur der Benutzer, der der Kontakt ist, kann auf den Kontakteintrag zugreifen. Die maximale Anzahl beträgt 2000 Kontakte (1500 synchronisierte Kontakte + 500 Kontakte für den manuellen Eintrag).

Die folgende Tabelle ordnet die Webex-Kontakttypen der Kontaktquelle zu (wird von einer BroadWorks-Telefonliste synchronisiert oder manuell hinzugefügt):

Die folgenden Bedingungen gelten für die Art und Weise, wie Directory Sync die Kontakthöchstwerte verarbeitet:

• Wenn eine Organisation die maximal zulässige Anzahl von Kontakten für die Synchronisierung überschreitet (30000 Organisationskontakte oder 30000 gemeinsame Gruppenkontakte pro Gruppe), schließt die Verzeichnissynchronisierung Einträge über dem maximalen Schwellenwert aus. Für synchronisierte oder ausgelassene Kontakte wurde keine spezielle Reihenfolge angewendet.

• Wenn einer Ihrer Kunden die maximal zulässige Anzahl an Kontakten in einer der Kategorien überschreitet, empfehlen wir Ihnen, bei Cisco einen Fall zu heben, damit diese Organisation von der Verzeichnissynchronisierung ausgeschlossen wird.

• Manuelle Kontakte sind Kontakte, die ein Benutzer manuell in der Webex-App hinzufügt. Ein Benutzer kann bis zu 500 manuelle Kontakte hinzufügen. Manuelle Kontakte gehören zu der größeren Kontaktkategorie für Benutzer bei Webex, sind jedoch nicht bei der Synchronisierung enthalten.

• Die Gesamtgrenze für Organisationskontakte (30000) und Gruppenkontakte (30000 pro Gruppe) beträgt 200000.

Aktualisierungen

Aktualisierungen werden im Webex-Verzeichnis behandelt:

• Wenn sich der Kontaktname in BroadWorks ändert, wird der vorhandene Kontakt aus dem Webex-Verzeichnis gelöscht und ein neuer Kontakt wird erstellt.

• Wenn sich die Kontaktnummer in BroadWorks ändert, aktualisiert Webex den vorhandenen Kontakt im Webex-Verzeichnis mit der neuen Nummer.

Nachdem ein Administrator einen Kontakt in BroadWorks aktualisiert hat, werden unter den folgenden Bedingungen beschrieben, wann die Aktualisierung in der Webex-App eines Benutzers angezeigt wird:

• Wenn die Aktualisierung auf einen Benutzer, der nur zu BroadWorks anruft, oder eine Anrufer-Entität ohne Benutzer ist, wird die Aktualisierung unmittelbar nach der folgenden Verzeichnissynchronisierung in der Webex-App eines Benutzers angezeigt.

• Wenn die Aktualisierung auf einen BroadWorks-Telefonlisteneintrag bedete:

  • Bei Benutzerkontakten– Aktualisierungen werden unmittelbar nach der folgenden Verzeichnissynchronisierung in der Webex-App des Benutzers angezeigt.

  • Bei Gruppenkontakten werden Aktualisierungen direkt nach der nachfolgenden Verzeichnissynchronisierung in der Webex-App des Benutzers angezeigt.

  • Für Unternehmenskontakte: Das Webex-Verzeichnis wird bei der folgenden Verzeichnissynchronisierung aktualisiert, aber die Benutzer sehen die Änderung in der Webex-App erst, wenn sie die Webex-App neu starten oder der lokale Cache-Timer für 72 Stunden abläuft.

Wir empfehlen die Verwendung der folgenden Einstellungen:

• Grenzwertbegrenzung: Legen Sie folgende ÜberlastungKontrollsystemeigenschaften fest (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit: auf null gesetzt.

  • globalDirectoryTransactionLimit: Auf null gesetzt.

  Es wird empfohlen, dass Sie userDirectoryTransactionLimit und globalDirectoryTransactionLimit auf einen Nullwert festlegen. Wenn Sie sich jedoch für die Zuweisung von Werten entscheiden, muss jeder auf mindestens das Fünffache des Werts der TransaktionLimitPeriodSeconds (der sollte 1) gesetzt werden.

• Transaktionslimit: Legen Sie die folgenden Werte fest (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • UserTransactionLimit : Auf mindestens 100 festgelegt.

  • transactionLimitPeriodSecs: auf 1 gesetzt.

• Pagingwerte: Legen Sie die Eigenschaften des Pagingsystems fest (XSP_CLI/Applications/Xsi-Actions/Paging):

  • defaultPageSize – auf 50 festlegen

  • availableUserMaxLimit: auf 100 gesetzt

• CTI-Schnittstelle: Stellen Sie sicher, dass die Webex-CA-Zertifikate in den Vertrauensspeicher der CTI-Schnittstelle hochgeladen und die Client-Authentifizierung auf der CTI-Oberfläche aktiviert wird.

Darüber hinaus empfehlen wir Ihnen in Abhängigkeit von Ihrer BroadWorks-Version, die folgenden System-Patches auf die BroadWorks-Bereitstellung anzuwenden, bevor Sie diese Funktion aktivieren:

• Für R22: AP.as.22.0.1123.ap368517

• Für R23: AP.as.23.0.1075.ap368517

• Für R24: Kein Patch erforderlich

Partneradministratoren können die Verzeichnissynchronisierung für eine Kundenvorlage aktivieren, während sie gleichzeitig eine neue Vorlage erstellen. Für alle neuen Kundenorganisationen, die dieser Vorlage zugewiesen werden, ist die Verzeichnissynchronisierung aktiviert. Weitere Informationen finden Sie unter "Konfigurieren Ihrer Kundenvorlagen" unter Konfigurieren Ihrer Partnerorganisation im Partner Hub im Lösungshandbuch für Webex für Cisco BroadWorks.

Nächste Schritte

Stellen Sie sicher , dass Ihre Benutzer wissen, dass sie mindestens einmal auf die Registerkarte Kontakte in der Webex-App klicken müssen, um die Funktion in der Webex-App zu aktivieren. Dies muss nur einmal abgeschlossen werden.

Öffentliche APIs sind auf dem developer.webex.com verfügbar, mit denen Partneradministratoren die Verzeichnissynchronisierungseinstellungen für die von ihnen verwalteten Kundenorganisationen aktualisieren, eine sofortige Synchronisierung auslösen oder Informationen zum Synchronisierungsstatus abrufen können. Die Verzeichnissynchronisierungsmethoden sind unter BroadWorks-Unternehmen gruppiert:

• BroadWorks-Unternehmen auflisten – Verwenden Sie diese API-Methode, um eine Liste der Unternehmen unter einem bestimmten Dienstleister und der ID des jeweiligen Unternehmens abzurufen . Sie müssen die spEnterpriseId wie in der Bereitstellung zugewiesen eingeben.

• Verzeichnissynchronisierung für ein BroadWorks-Unternehmen aktualisieren – Geben Sie die Unternehmens-ID ein, um den Verzeichnissyc-Status für das Unternehmen zu aktualisieren und die Verzeichnissynchronisierung zu aktivieren oder zu deaktivieren.

• Verzeichnissynchronisierung für ein Unternehmen auslösen – Verwenden Sie diese API-Methode, wenn Sie eine sofortige Synchronisierung für ein bestimmtes Unternehmen id auslösen möchten. Geben Sie für den syncStatus den Befehl SYNC _ NOW ein.

• Abrufen des Verzeichnissynchronisierungsstatus für ein Unternehmen – Geben Sie die Unternehmens-ID ein und führen Sie den Vorgang aus, um einen Status und eine trackingId der neuesten Synchronisierung zu erhalten. Sie können die TrackingID verwenden , um zusätzliche Analysen über Tools wie Kibana und Grafana auszuführen.

Darüber hinaus können Administratoren die Trigger Directory Sync für eine Single User API verwenden, um eine bei Bedarf angezeigte Verzeichnissynchronisierung für einen einzelnen Benutzer zu erstellen.

Detaillierte API-Dokumentationen finden Sie unter https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Sie müssen sich anmelden, um die API-Spezifikation unter zu lesen https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Die folgenden Fehlercodes gelten für die Verzeichnissynchronisierung.

Die folgende Tabelle fasst die Aktualisierungen dieses Artikels zusammen.