Directory Sync – Übersicht

Die Verzeichnissynchronisierung stellt sicher, dass Webex für Cisco BroadWorks-Benutzer das Webex-Verzeichnis verwenden kann, um jede Anrufer-Entity vom BroadWorks-Server auf anrufen zu können. Wenn diese Funktion aktiviert ist, wird das vollständige Anrufverzeichnis des BroadWorks-Servers mit dem Webex-Verzeichnis synchronisiert. Benutzer können über die Webex-App auf das Verzeichnis zugreifen und über den BroadWorks-Server einen Anruf an jede anrufperson starten.

Die Verzeichnissynchronisierung beinhaltet die Synchronisierung sowohl der Benutzeranrufinformationen als auch der Telefonlisten. Synchronisierte Telefonlistendatensätze werden in einen von zwei Kontakttypen innerhalb des Webex-Verzeichnisses geschrieben:

  • Organisationskontakte: Diese Kontakte werden für eine Organisation gespeichert und stehen jedem Benutzer in der Organisation zur Verfügung.

  • Benutzerkontakte: Diese Kontakte werden für einen Benutzer gespeichert und sind nur für den Benutzer verfügbar, der der Kontakt besitzt.


Webex für Cisco BroadWorks-Bereitstellung umfasst eine Standardsynchronisierung von Messaging-Benutzern und deren zugehörigen Anrufinformationen vom BroadWorks-Server in das Webex-Verzeichnis. Bei der Standardbereitstellungssynchronisierung werden Jedoch Nicht-Messaging-Benutzer und Nicht-Nutzer-Einheiten ausgelassen (z. B. Konferenzraum Telefon, Faxgerät oder Sammelanschluss Nummer). Durch aktivieren der Verzeichnissynchronisierung wird sichergestellt, dass alle Anrufer zum Webex-Verzeichnis hinzugefügt werden.

Verzeichnissynchronisierungsbedingungen

  • Partneradministratoren müssen diese 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 die Option "Jetzt synchronisieren" jedoch verwenden, um die Wartezeit von einer Woche zu umgehen und eine sofortige Synchronisierung für eine bestimmte Kundenorganisation zu vervollständigen.

  • 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 diese Synchronisierung mit Jetzt synchronisieren geplant oder ausgelöstwurde.

  • Bei einem Synchronisierungsfehler wird die Synchronisierung 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 ist detaillierter als die Control Hub-Anzeige und kann bei der Fehlerbehebung, Analyse und Überwachung helfen.

  • Benutzerkontakte werden in einem verschlüsselten Format gespeichert, und nur der Benutzer, der der Kontakt besitzt, hat Zugriff auf den Entschlüsselungsschlüssel.

  • Mit dieser Funktion werden die folgenden Telefonlistentypen vom BroadWorks-Server synchronisiert:

    • Allgemeine Unternehmenstelefonlisten

    • Gemeinsame Gruppen-Telefonlisten

    • Persönliche Telefonlisten

Directory Sync und Kontakt-Maximalwerte

Im Folgenden wird die maximale Anzahl von Kontakten aufgeführt, die durch die Verzeichnissynchronisierung für jeden Webex-Kontakttyp zulässig ist:

  • 500 Kontakte der Organisation

  • 500 Benutzerkontakte – Für einen Benutzer umfasst die maximale Anzahl synchronisierter Benutzerkontakte und manuelle Kontakte (Kontakte, die der Benutzer manuell über die Webex-App hinzufügt)

Es gelten folgende Bedingungen:

  • Wenn eine Organisation mehr als 500 Kontakte in einer der Kategorien hat, werden Einträge über dem Grenzwert von 500 von der Synchronisierung ausgeschlossen. Für synchronisierte oder ausgelassene Kontakte wird keine spezielle Reihenfolge angewendet.

  • Wenn ein Benutzer Kontakte manuell auf der Webex-App hinzufügt, wird die maximale Kontaktzahl des Benutzers durch Subtracting der manuellen Kontakte von synchronisierten Benutzerkontakten bestimmt. Wenn ein Benutzer beispielsweise 100 Kontakte manuell zur Webex-App hinzufügt, können mit der Verzeichnissynchronisierung bis zu 400 Benutzerkontakte aus BroadWorks für diesen Benutzer synchronisiert werden.

  • Wenn eines Ihrer Kundenorganisationen über mehr als 500 Kontakte in einer der beiden Kategorien verfügt, empfehlen wir, bei Cisco einen Fall zu erstellen, damit diese Organisation von der Verzeichnissynchronisierung ausgeschlossen wird.

Die folgende Tabelle ordnet die Webex-Kontakttypen der BroadWorks-Telefonliste zu, aus der die Datensätze synchronisiert werden:

Tabelle 1: Directory Sync Kontakttypen und Synchronisierungsquelle

Webex-Kontakttyp

Aus BroadWorks synchronisiert...

API wird für die Synchronisierung verwendet

Organisationskontakte

Allgemeine Unternehmenstelefonlisten

/directories/enterprisecommon

Allgemeine Gruppen-Telefonlisten (während Dienstleister)**

/directories/groupcommon

Benutzerkontakte

Allgemeine Gruppentelefonlisten (im Enterprise-Modus)**

/directories/groupcommon

Persönliche Telefonlisten

/directories/personal


**Allgemeine Gruppen-Telefonlisten werden je nachdem, ob sich BroadWorks im Enterprise-Modus oder im unternehmensweiten Dienstleister befindet, unterschiedlich synchronisiert. Der Wert der isBroadWorksEnterprise Parameter (wahr oder falsch) legt fest, wie die Liste synchronisiert wird:

  • True – Als Organisationskontakt synchronisieren

  • False – Als Benutzerkontakt synchronisieren

Aktualisierungen

Nachdem ein Kontakt in BroadWorks aktualisiert wurde, wird der folgende Überblick darüber angezeigt, wann die Aktualisierung in der Webex-App eines Benutzers angezeigt wird:

  • Die Kontaktaktualisierungen der Organisation werden in der Webex-App angezeigt, nachdem der Benutzer die App neu gestartet hat bzw. nachdem der lokale 72-Stunden-Cache-Timer der App abgelaufen ist.

  • Aktualisierungen der Benutzerkontakte werden für diesen Benutzer sofort in der Webex-App angezeigt.

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, wird der vorhandene Kontakt im Webex-Verzeichnis mit der neuen Nummer aktualisiert.

Voraussetzungen für die Verzeichnissynchronisierung

Anforderungen zum Umschalten

Die folgenden Umschaltschalter sind für diese Funktion vorhanden. Wenden Sie sich an Ihren Webex-Mitarbeiter für Cisco BroadWorks, um diese Informationen zu setzen.

Umschaltfunktion

Angewendet auf...

Beschreibung

webex-for-broadworks-phone-list-sync

Partner

Obligatorische Umschalt umschalten. Aktiviert die Synchronisierung der Telefonliste für alle Kundenorganisationen unter diesem Partner.

Muss aktiviert sein.

webex-for-broadworks-phone-list-sync-disable

Kundenorganisation

Optionale Umschalt umschalten. Deaktiviert die Telefonlistensynchronisierung für eine bestimmte Organisation, auch wenn die Funktion auf Partnerebene und in der Kundenvorlage aktiviert ist.

Wenden Sie diese Option nur an, wenn Sie die Telefonlistensynchronisierung für eine bestimmte Kundenorganisation deaktivieren möchten. Andernfalls können Sie dies deaktiviert lassen.


 
Diese Umschaltschaltung sollte beispielsweise auf Organisationen angewendet werden, die mehr als 500 Kontakte benötigen.

hidden-personal-contacts-enabled-ga

Benutzer

Optionale Umschalt umschalten. Blendet persönliche Kontakte aus den Von diesem Benutzer durchgeführten Verzeichnissuchen aus.

hidden-org-contacts-enabled-ga

Benutzer

Optionale Umschalt umschalten. Ausblenden von Organisationskontakten aus Verzeichnissuchen, die von diesem Benutzer durchgeführt wurden.

Vorkonfigurierungsanforderungen

Wir empfehlen die Verwendung der folgenden Einstellungen:


Bei den folgenden Beispielen wird davon ausgegangen, dass Sie einen XSP-Server verwenden. Ersetzen Sie bei ADP-Servern (XSP_CLI) durch (ADP_CLI).
  • 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:


Eine vollständige Liste der Patch-Anforderungen, die die Mindestanforderung für Webex für Cisco BroadWorks bilden, finden Sie unter BroadWorks-Softwareanforderungen im Lösungshandbuch fürWebex für Cisco BroadWorks.

Verzeichnissynchronisierung aktivieren (neue Vorlage)

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.

Verzeichnissynchronisierung aktivieren (vorhandene Vorlage)

Partneradministratoren können die folgenden Schritte ausführen, um die Verzeichnissynchronisierung in einer vorhandenen Kundenvorlage zu aktivieren, um die Funktion für die Kundenorganisationen zu aktivieren, die diese Vorlage verwenden.

1

Melden Sie sich bei Partner Hub an und wählen Sie Einstellungenaus.

2

Blättern Sie zu BroadWorks Calling und klicken Sie auf Vorlagen anzeigen .

3

Wählen Sie die entsprechende Kundenvorlage aus und blättern Sie zu BroadWorks Directory Sync.

4

So aktivieren Sie die Verzeichnissynchronisierung standardmäßig für neue Kundenverzeichnisse, die diese Vorlage verwenden:

  1. Legen Sie die Option BroadWorks-Verzeichnis - und Telefonlistensynchronisierung für alle neuen Kundenorganisationen aktivieren auf Ein fest.

  2. Klicken Sie auf Speichern.

5

So aktivieren Sie die Verzeichnissynchronisierung für bestehende Kundenorganisationen, die diese Vorlage verwenden:

  1. Klicken Sie auf Liste der Kunden anzeigen Synchronisierungsstatus.

  2. Aktivieren Sie die benachbarten Kontrollkästchen für jede Organisation, für die Sie die Funktion aktivieren möchten.

  3. Klicken Sie auf Synchronisierung aktivieren.


 

Wenn Sie die Verzeichnissynchronisierung deaktivieren möchten, gehen Sie folgendermaßen vor:

  • Legen Sie in Schritt 4a die Option Telefonverzeichnissynchronisierung für alle neuen Kundenorganisationen aktivieren auf Aus fest, um die Verzeichnissynchronisierung für neue Kundenorganisationen, die diese Vorlage verwenden, standardmäßig zu deaktivieren.

  • Klicken Sie in Schritt 5c auf Sync deaktivieren, um die Funktion für vorhandene Organisationen zu deaktivieren.

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.

Sofortige Synchronisierung abschließen

Mit der Option Jetzt synchronisieren können Partneradministratoren für eine bestimmte Kundenorganisation eine Bei-Bedarf-Synchronisierung abschließen. Diese Option kann nur für einzelne Kundenorganisationen ausgewählt werden. Für die Option "Jetzt synchronisieren" gibt es keine Massenoption.

1

Melden Sie sich bei Partner Hubhttp://admin.webex.com() an und wählen Sie Einstellungenaus.

2

Blättern Sie zu BroadWorks Calling und klicken Sie auf Vorlagen anzeigen .

3

Wählen Sie die entsprechende Kundenvorlage aus und blättern Sie zu BroadWorks Directory Sync.

4

Klicken Sie auf Liste der Kunden anzeigen Synchronisierungsstatus.

5

Klicken Sie für die Kundenorganisation, die Sie synchronisieren möchten, auf die drei Punkte ganz rechts und wählen Sie Jetzt synchronisierenaus.

6

Klicken Sie auf Aktualisieren, um die Synchronisierungsergebnisse zu sehen.

Synchronisierungsdatensätze in CSV exportieren

Partneradministratoren können detaillierte Informationen zur letzten Synchronisierung in eine CSV-Datei exportieren. Die CSV-Datei enthält eine detailliertere Ansicht des Synchronisierungsdatensatz als die Control Hub-GUI und kann bei der Fehlerbehebung und Analyse helfen.

1

Melden Sie sich bei Partner Hubhttp://admin.webex.com() an und wählen Sie Einstellungenaus.

2

Blättern Sie zu BroadWorks Calling und klicken Sie auf Vorlagen anzeigen .

3

Wählen Sie die entsprechende Kundenvorlage aus und blättern Sie zu BroadWorks Directory Sync.

4

Klicken Sie auf Liste der Kunden anzeigen Synchronisierungsstatus.

5

Aktivieren Sie die benachbarten Kontrollkästchen für jede Organisation, die Sie in den Export mit einfingen möchten.

6

Klicken Sie auf Ergebnisse exportieren.

Öffentliche APIs für die Verzeichnissynchronisierung

Ö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 Enterprises unter gruppiert. Es gibt vier APIs:

  • BroadWorks-Unternehmen auflisten : Verwenden Sie diese API-Methode, um eine Liste der Unternehmen unter einer bestimmten Dienstleister und den einzelnenUnternehmen zu erhalten. id definiert. Sie müssen den spEnterpriseId wie bei der Bereitstellung zugewiesen.

  • Aktualisieren der Verzeichnissynchronisierung für eine BroadWorks-Enterprise– 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.

  • Directory Sync für ein Unternehmen auslösen – Verwenden Sie diese API-Methode, wenn Sie für ein bestimmtes Unternehmen einesofortige Synchronisierung auslösen möchten. id definiert. Für die syncStatus, geben Sie die SYNC_NOW Befehl.

  • Verzeichnissynchronisierungsstatus für ein Unternehmen erhalten– Geben Sie das Unternehmen ein id und ausführen, um einen Status zu erhalten und trackingId der neuesten Synchronisierung. Sie können den trackingID um weitere Analysen über Tools wie Kibana und Kryptoana 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 https://developer.webex.com/docs/api/v1/broadworks-subscriberslesen.

Mehrere Unternehmen mit API synchronisieren

Führen Sie dieses Verfahren aus, um die Verzeichnissynchronisierung für mehrere Unternehmen mithilfe der öffentlichen APIs zu vervollständigen.

  • Mit der Verzeichnissynchronisierung können Sie nur einzelne Unternehmen gleichzeitig synchronisieren. Wenn Sie versuchen, mehr als ein Unternehmen zu synchronisieren, wird die Fehlermeldung 429 angezeigt.

  • Die Zeit, die für die Synchronisierung für ein einzelnes Unternehmen benötigt wird, hängt von der Größe des Unternehmens ab.

1

Führen Sie die List BroadWorks Enterprises API aus, um eine Liste der Unternehmen zu generieren, die Sie synchronisieren möchten.

  1. Legen Sie StartMit auf die erste Zeichenfolge des Identifikator des Unternehmens oder Dienstanbieters fest.

  2. Auf Ausführen.

2

Führen Sie die Trigger Directory Sync für eine Unternehmens-API im ersten Unternehmen in der Liste aus.

  1. Geben Sie die Unternehmens-IDein.

  2. SyncStatus festlegen auf SYNC_NOW

  3. Auf Ausführen.

    Für das Unternehmen wird eine sofortige Synchronisierung ausgelöst. Diese Synchronisierung gilt für die Anzahl von 1 Synchronisierungen pro Instanz.
3

Warten Sie einige Sekunden und führen Sie die API Verzeichnissynchronisierungsstatus abrufen aus, um den Synchronisierungsstatus zu erhalten.

  1. Geben Sie die Unternehmens-ID ein

  2. Auf Ausführen.

4

Führen Sie nach Abschluss der Synchronisierung die Schritte 2 bis 4 im nächsten Unternehmen in der Liste durch. Wiederholen Sie diese Schritte, bis Sie die gesamte Liste synchronisiert haben.

Fehlercodes für die Verzeichnissynchronisierung

Die folgenden Fehlercodes gelten für die Verzeichnissynchronisierung.

Fehlercode

Fehlermeldung

600000

Unerwarteter Fehler bei der externen Benutzersynchronisierung in Broadworks.

600001

Broadworks External Directory User Sync fehlgeschlagen.

600002

Broadworks External Directory User Sync musste vor Abschluss beendet werden.

600003

Broadworks External Directory User Sync nur teilweise erfolgreich. Einige Kundenorganisationen konnten nicht synchronisiert werden.

600004

Broadworks External Directory User Sync ist für die ConfigSet nicht aktiviert.

600005

Broadworks External Directory User Sync läuft für die ConfigSet.

600006

Broadworks External Directory User Sync-Threads sind ausgelastet oder werden heruntergefahren und akzeptieren daher keine weitere Sync-Anfrage. Versuchen Sie es später erneut.

600007

Die Identitäts-Organisation von CustomerConfig wurde nicht gefunden.

600008

Die Kundenkonfiguration wurde in der Partner-Organisation nicht gefunden.

600009

Broadworks External Directory User Sync kann nicht ausgeführt werden, da das zur CustomerConfig zugeordnete Broadworks-Cluster ausgelastet ist.

600010

Broadworks External Directory User Sync kann nicht ausgeführt werden, da kein Broadworks-Cluster zur CustomerConfig zugeordnet ist.

600011

Broadworks External Directory User Sync ist für CustomerConfig nicht aktiviert.

600012

Externe Benutzersynchronisierung von Broadworks kann nicht ausgeführt werden, da die Hybrid-Verzeichnissynchronisierung bereits für CustomerConfig aktiviert ist.

600013

Broadworks External Directory User Sync konnte Benutzer und Computerkonten nicht zum Identitätsspeicher hinzufügen.

600014

Broadworks External Directory User Sync ist beim Versuch, eine Verbindung mit dem Broadworks-Cluster herzustellen, fehlgeschlagen. Fehler von Broadworks - %s.

600015

Broadworks External Directory User Sync hat keinen passenden Benutzer im Identity Store finden.

600017

BroadWorks Phone List Sync konnte nicht alle Benutzer- und Unternehmens-/Organisationskontakte synchronisieren.

600018

BroadWorks Phone List Sync ist für Benutzer im Unternehmen/in der Organisation fehlgeschlagen.

600019

BroadWorks Phone List Sync konnte keine Unternehmens-/Organisationskontakte synchronisieren.