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 können, um jede anrufende Entität vom BroadWorks-Server anzurufen. Diese Funktion synchronisiert BroadWorks-Anrufinformationen, die nicht Teil der Benutzerbereitstellung im Webex-Verzeichnis waren.

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

• Reine BroadWorks-Calling-Benutzer (die nicht in Webex integriert sind)

• Anrufeinheiten ohne Benutzer (z. B. Konferenzraumtelefon, Faxgerät, Sammelanschlussnummer)

• BroadWorks-Telefonlisteneinträge

In der folgenden Tabelle werden BroadWorks-Anrufdatensätze zusammengefasst und gezeigt, wie sie zum Webex-Verzeichnis hinzugefügt werden.

Bedingungen der Verzeichnissynchronisierung

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

• Standardmäßig erfolgt die anfängliche Synchronisierung eine Woche nach der Aktivierung der Synchronisierung (die Uhrzeit, zu der die Synchronisierung gestartet wird, 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 die Verzeichnissynchronisierung wöchentlich für jeden Kunden ausgeführt. Jede Synchronisierung erfolgt eine Woche nach der letzten Synchronisierung, unabhängig davon, ob die letzte Synchronisierung manuell mit „Jetzt synchronisieren“ geplant oder ausgelöst wurde.

• Die maximale Anzahl simultaner Synchronisierungen pro BroadWorks-Cluster beträgt zwei: eine geplante Synchronisierung und eine On-Demand-Synchronisierung (über API oder Partner Hub GUI). Administratoren können jedoch nicht zwei On-Demand-Synchronisierungen gleichzeitig über dasselbe BroadWorks ausführen. Diese Einschränkung besteht unabhängig davon, ob die Synchronisierung über die API oder über die Option „Jetzt synchronisieren“ in Partner Hub initiiert wurde. Darüber hinaus plant Webex nicht, dass zwei geplante Synchronisierungen gleichzeitig von demselben BroadWorks aus ausgeführt werden.

• Wenn ein Synchronisierungsfehler auftritt, versucht Webex die Synchronisierung automatisch alle 24 Stunden bis zur nächsten geplanten Synchronisierung erneut.

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

• In Partner Hub können Sie Informationen zum Synchronisierungsstatus eines bestimmten Kunden anzeigen. Darüber hinaus können Sie detaillierte Informationen zur letzten Synchronisierung mit einem CSV-Datensatz exportieren. Der CSV-Datensatz bietet detailliertere Informationen als die Control Hub-Anzeige und kann bei der Fehlerbehebung, Analyse und Prüfung helfen.

• Webex speichert Benutzerkontakte in einem verschlüsselten Format. Nur der Benutzer, dem der Kontakt gehört, hat Zugriff auf den Entschlüsselungsschlüssel.

• Für Benutzer, die nur BroadWorks anrufen, und Entitäten, die keine Benutzer anrufen, synchronisiert diese Funktion die folgenden Telefonnummerntypen von BroadWorks:

  • Primäre Telefonnummer

  • Mobiltelefonnummer

  • Durchwahl

  Bei der Synchronisierung werden jedoch ausschließlich BroadWorks-anrufende Benutzer und Nicht-Benutzer-anrufende Entitäten von der Synchronisierung ausgeschlossen, wenn weder eine primäre Telefonnummer noch ein Anschluss vorhanden ist.

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

Maximale Anzahl der BroadWorks-Telefone und Kontakte

Die Verzeichnissynchronisierung 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 Kontakte der Organisation für seine Organisation zugreifen. Die maximale Anzahl beträgt bis zu 30000 Kontakte.

• Benutzerkontakte: Webex speichert diese Kontakte für einen Benutzer. Nur der Benutzer, dem der Kontakt gehört, kann auf den Kontakteintrag zugreifen. Die maximale Anzahl beträgt bis zu 2000 Kontakte (1500 synchronisierte Kontakte + 500 manuelle Eingabekontakte).

In der folgenden Tabelle werden die Webex-Kontakttypen mit der Kontaktquelle zugeordnet (synchronisiert von einer BroadWorks-Telefonliste oder manuell hinzugefügt):

Die folgenden Bedingungen gelten für den Umgang mit Kontaktmaximen bei der Verzeichnissynchronisierung:

• 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. Es gibt keine bestimmte Reihenfolge, die auf synchronisierte oder ausgelassene Kontakte angewendet wird.

• Wenn einer Ihrer Kunden die maximal zulässige Anzahl von Kontakten in beiden Kategorien überschreitet, empfehlen wir Ihnen, einen Fall bei Cisco zu melden, 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 fallen in die größere Benutzerkontaktkategorie in Webex, sind aber nicht in der Synchronisierung enthalten.

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

Aktualisierungen

Im Folgenden wird beschrieben, wie das Webex-Verzeichnis mit Aktualisierungen umgeht:

• 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, stellen die folgenden Bedingungen dar, wann die Aktualisierung in der Webex-App eines Benutzers angezeigt wird:

• Wenn es sich bei der Aktualisierung um einen reinen BroadWorks-anrufenden Benutzer oder eine nicht-Benutzer-anrufende Entität handelt, wird die Aktualisierung unmittelbar nach der nachfolgenden Verzeichnissynchronisierung in der Webex-App eines Benutzers angezeigt.

• Wenn die Aktualisierung auf einen Eintrag in der BroadWorks-Telefonliste erfolgt:

  • Für Benutzerkontakte – Aktualisierungen werden in der Webex-App des Benutzers unmittelbar nach der nachfolgenden Verzeichnissynchronisierung angezeigt.

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

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

Wir empfehlen die Verwendung der folgenden Einstellungen:

• Rate Limiting Values – Legen Sie die folgenden OverloadControl-Systemeigenschaften fest (_ XSP CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit: Legen Sie einen Nullwert fest.

  • globalDirectoryTransactionLimit: Legen Sie einen Nullwert fest.

  Es wird empfohlen, dass Sie userDirectoryTransactionLimit und globalDirectoryTransactionLimit auf einen Nullwert festlegen. Wenn Sie sich jedoch entscheiden, Werte zuzuweisen, muss jeder auf mindestens das Fünffache des Werts von TransaktionLimitPeriodSeconds (der 1 sein sollte) festgelegt werden.

• Transaktionsgrenzen – Legen Sie die folgenden Werte fest (XSP _ CLI/System/CommunicationUtility/DefaultSettings):

  • userTransactionLimit: Legen Sie mindestens 100 fest.

  • transactionLimitPeriodSecs: Legen Sie 1 fest.

• Paging-Werte – Legen Sie die Eigenschaften des Paging-Systems fest (_ XSP CLI/Applications/Xsi-Actions/Paging):

  • defaultPageSize – Auf 50 festlegen

  • VerfügbarUserMaxLimit – Auf 100 festlegen

• CTI-Schnittstelle – Stellen Sie sicher, dass Webex CA-Zertifikate in den Vertrauensspeicher der CTI-Schnittstelle hochgeladen und die Clientauthentifizierung auf der CTI-Schnittstelle aktiviert wird.

Außerdem empfehlen wir Ihnen, abhängig 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 die neue Vorlage erstellen. Für alle neuen Kundenorganisationen, die dieser Vorlage zugewiesen werden, ist die Verzeichnissynchronisierung aktiviert. Weitere Informationen finden Sie unter „Kundenvorlagen konfigurieren“ unter Konfigurieren Ihrer Partnerorganisation in Partner Hub im Lösungshandbuch für Webex für Cisco BroadWorks .

Nächste Schritte

Stellen Sie sicher, dass Ihre Benutzer 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 developer.webex.com verfügbar, mit denen Partneradministratoren die Einstellungen für die Verzeichnissynchronisierung 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 Enterprises gruppiert:

• BroadWorks-Unternehmen auflisten – Verwenden Sie diese API-Methode, um eine Liste der Unternehmen unter einem bestimmten Dienstleister und jedem Unternehmen id. Sie müssen die spEnterpriseId wie in der Bereitstellung zugewiesen.

• Verzeichnissynchronisierung für ein BroadWorks-Unternehmen aktualisieren – Geben Sie das Unternehmen ein id um den Verzeichnis-Syc-Status für dieses 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 auslösen möchten. id. Für die syncStatus, geben Sie die SYNC_NOW-Befehl aus.

• Verzeichnissynchronisierungsstatus für ein Unternehmen abrufen – Geben Sie das Unternehmen ein id und ausführen, um einen Status zu erhalten und trackingId der neuesten Synchronisierung. Sie können die trackingID um zusätzliche Analysen über Tools wie Kibana und Grafana auszuführen.

Darüber hinaus können Administratoren die API zum Auslösen der Verzeichnissynchronisierung für einen einzelnen Benutzer verwenden , um eine Verzeichnissynchronisierung bei Bedarf für einen einzelnen Benutzer auszulösen.

Detaillierte API-Dokumentation 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 https://developer.webex.com/docs/api/v1/broadworks-subscribers zu lesen.

Die folgenden Fehlercodes gelten für die Verzeichnissynchronisierung.

In der folgenden Tabelle sind die Aktualisierungen dieses Artikels zusammengefasst.