In diesem Artikel wird beschrieben, wie Sie Directory Sync in Webex für Cisco BroadWorks bereitstellen. Dieser Artikel richtet sich an Dienstanbieteradministratoren bei Partnerorganisationen.
Directory Sync – Übersicht
Die Verzeichnissynchronisierung stellt sicher, dass Benutzer von Webex für Cisco BroadWorks das Webex -Verzeichnis 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 (Haupttelefon , Mobiltelefonnummer, Anschluss ), aber externe Anrufdatensätze werden nicht berücksichtigt. Wenn die Verzeichnissynchronisierung jedoch aktiviert ist, synchronisiert die Funktion auch die folgenden Anrufdatensätze mit dem Webex Verzeichnis.
Nur-BroadWorks-Anrufbenutzer (die nicht in Webex integriert sind)
Nicht-Benutzer anrufende Entitäten (z. B. Konferenzraumtelefon, Faxgerät, Sammelanschlussgruppe )
Einträge in der BroadWorks-Telefonliste
Die folgende Tabelle fasst BroadWorks-Anrufdatensätze zusammen und zeigt, wie sie zum Webex Verzeichnis hinzugefügt werden.
BroadWorks-Anrufdatensätze |
Beschreibung |
Zum Webex Verzeichnis hinzugefügt über... |
---|---|---|
Webex für Cisco BroadWorks-Benutzer |
Benutzer sind für Webex für Cisco BroadWorks aktiviert |
Benutzerbereitstellung (z. B. Flowthrough-Bereitstellung) |
Nur BroadWorks-Anrufbenutzer |
Anrufende Benutzer, die nicht in Webex integriert |
Verzeichnissynchronisierung |
Anrufentitäten, die keine Benutzer sind |
z. B. Konferenzraumtelefon, Faxgerät, Sammelanschlussnummer |
Verzeichnissynchronisierung |
BroadWorks-Telefonlisten |
Einträge in der BroadWorks-Telefonliste:
|
Verzeichnissynchronisierung (Synchronisierung der Telefonliste) |
Weitere Informationen zur Benutzerbereitstellung finden Sie im Lösungsleitfaden Webex für Cisco BroadWorks .
|
Bedingungen für die 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 erste Synchronisierung eine Woche nach der Aktivierung der Synchronisierung (die ausgewählte Zeit zum Starten der Synchronisierung ist zufällig). Kundenorganisationen können jedoch die Jetzt synchronisieren Option zum Umgehen der einwöchigen Wartezeit und zum Auslösen einer sofortigen Synchronisierung für eine bestimmte Kundenorganisation.
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 geplant oder manuell mit ausgelöst wurde Jetzt synchronisieren .
Die maximale Anzahl gleichzeitiger Synchronisierungen pro BroadWorks-Cluster beträgt zwei: eine geplante Synchronisierung und eine bedarfsgesteuerte Synchronisierung (über API oder Partner Hub GUI). Administratoren können jedoch nicht zwei On-Demand-Synchronisierungen gleichzeitig von demselben BroadWorks ausführen. Diese Einschränkung gilt unabhängig davon, ob die Synchronisierung über die API oder über die initiiert wurde Jetzt synchronisieren im Partner-Hub. Darüber hinaus plant Webex nicht zwei geplante Synchronisierungen, die gleichzeitig von demselben BroadWorks ausgeführt werden.
Wenn eine Synchronisierung fehlschlägt, versucht Webex die Synchronisierung automatisch alle 24 Stunden bis zur nächsten geplanten Synchronisierung erneut.
Die Synchronisierung ignoriert Benutzer, die keine Telefonnummer haben.
Im Partner-Hub können Sie Informationen zum Synchronisierungsstatus für einen bestimmten Kunden anzeigen. Darüber hinaus 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 Benutzerkontakte in einem verschlüsselten Format. Nur der Benutzer, dem der Kontakt gehört, hat Zugriff auf den Entschlüsselungsschlüssel.
Für reine BroadWorks-Anrufbenutzer und Nichtbenutzer-Anrufentitäten synchronisiert diese Funktion die folgenden Telefonnummer von BroadWorks:
Primäre Telefonnummer
Telefonnummer (mobil)
Durchwahl
Die Synchronisierung schließt jedoch nur BroadWorks-anrufende Benutzer und nicht benutzereigene anrufende Entitäten von der Synchronisierung aus, wenn weder eine Haupttelefon noch ein Anschluss vorhanden ist.
BroadWorks-Telefonliste und Kontaktmaximale
Die Verzeichnissynchronisierung synchronisiert auch die Einträge in der BroadWorks-Telefonliste mit den Webex -Kontakten. Synchronisierte Einträge werden 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. Der Höchstwert 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. Das Maximum beträgt bis zu 2000 Kontakte (1500 synchronisierte Kontakte + 500 manuell eingegebene Kontakte).
Nur die Telefonlisteneinträge werden zu den Webex Kontakten hinzugefügt. Nur BroadWorks-anrufende Benutzer und andere anrufende Entitäten, die in der Verzeichnissynchronisierung enthalten sind, werden nicht zu den Kontakten hinzugefügt, es sei denn, ein Webex -Benutzer fügt sie manuell zu den Kontakten hinzu.
|
In der folgenden Tabelle werden die Webex -Kontakttypen der Kontaktquelle zugeordnet (über eine BroadWorks-Telefonliste synchronisiert oder manuell hinzugefügt):
Webex -Kontakttyp |
Kontaktquelle |
Höchstdauer |
Über BroadWorks synchronisiert... |
Für die Synchronisierung verwendete API |
---|---|---|---|---|
Organisationskontakte |
Verzeichnissynchronisierung |
30000 Kontakte |
Allgemeine Telefonlisten für Unternehmen |
|
Allgemeine Telefonlisten der Gruppe (für eine Service-Provider-Gruppe)** |
|
|||
Benutzerkontakte |
Verzeichnissynchronisierung |
1500 Kontakte |
Persönliche Telefonlisten |
/directories/personal |
Manuell vom Benutzer hinzugefügt |
500 Kontakte |
k. A. |
k. A. |
|
Kontakte gruppieren |
Verzeichnissynchronisierung |
30000 Kontakte pro Gruppe |
Allgemeine Telefonlisten der Gruppe (für eine Unternehmensgruppe)** |
/directories/groupcommon |
**Einträge in allgemeinen Telefonlisten für Gruppen werden unterschiedlich synchronisiert, je nachdem, ob sich BroadWorks im Unternehmensmodus oder im Serviceanbietermodus befindet. Der Wert von
|
Die folgenden Bedingungen gelten für die Verarbeitung von Kontaktmaximalen in Directory Sync:
Wenn eine Organisation die maximal zulässige Anzahl von Kontakten für die Synchronisierung überschreitet (30000 Organisationskontakte oder 30000 Gruppenkontakte pro Gruppe), werden bei der Verzeichnissynchronisierung Einträge über dem maximalen Schwellenwert ausgeschlossen. 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 einer der beiden Kategorien überschreitet, empfehlen wir Ihnen, einen Fall bei Cisco zu melden, um die Organisation von der Verzeichnissynchronisierung auszuschließen.
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 Kategorie Benutzerkontakte in Webex, sind jedoch nicht in der Synchronisierung enthalten.
Das kombinierte Gesamtlimit für Organisationskontakte (30000) und Gruppenkontakte (30000 pro Gruppe) beträgt 200000.
Aktualisierungen
Im Folgenden wird beschrieben, wie das Webex Verzeichnis Aktualisierungen behandelt:
Wenn sich der Name des Kontakts 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, gelten die folgenden Bedingungen, wenn die Aktualisierung in der Webex -App eines Benutzers angezeigt wird:
Wenn die Aktualisierung für einen anrufenden BroadWorks-Benutzer oder für eine anrufende Entität ohne Benutzer gilt, wird die Aktualisierung unmittelbar nach der nachfolgenden Verzeichnissynchronisierung in der Webex -App des Benutzers angezeigt.
Wenn die Aktualisierung einen Eintrag in der BroadWorks-Telefonliste betrifft:
Für Benutzerkontakte: Aktualisierungen werden in der Webex -App des Benutzers unmittelbar nach der nachfolgenden Verzeichnissynchronisierung angezeigt.
Für Gruppenkontakte: Aktualisierungen werden in der Webex -App des Benutzers unmittelbar nach der nachfolgenden Verzeichnissynchronisierung angezeigt.
Für Organisationskontakte: Das Webex -Verzeichnis wird bei der nachfolgenden Verzeichnissynchronisierung aktualisiert, aber die Benutzer sehen die Änderung in der Webex -App erst, wenn sie die Webex -App neu starten oder der lokale 72-Stunden-Cache-Timer abläuft.
Aktualisierungen der Benutzerinformationen von Webex für Cisco BroadWorks werden als Teil des Bereitstellungsprozesses gehandhabt.
|
Control Hub enthält eine Option zum Hinzufügen oder Bearbeiten von Kontakten auf Organisationsebene in Control Hub über eine CSV-Datei. Partneradministratoren und Kundenadministratoren mit Control Hub-Zugriff können auf diese Option zugreifen. Die Aktualisierung von Kontakten über Control Hub wird jedoch von Webex für Cisco BroadWorks nicht unterstützt. In Control Hub angewendete Kontaktaktualisierungen werden nicht mit BroadWorks synchronisiert und sind für Verzeichnissuchen von Schreibtischtelefonen nicht verfügbar.
|
Voraussetzungen für die Verzeichnissynchronisierung
Wir empfehlen Ihnen, die folgenden Einstellungen zu verwenden:
In den folgenden Beispielen wird davon ausgegangen, dass Sie einen XSP-Server verwenden. Für ADP-Server ersetzen Sie (XSP_ CLI) mit (ADP_ CLI).
|
Ratenbegrenzungswerte – Legen Sie die folgenden OverloadControl-Systemeigenschaften (XSP_ CLI/Applications/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit: auf einen Nullwert festlegen.
globalDirectoryTransactionLimit: auf einen Nullwert festlegen.
Es wird empfohlen, dass Sie userDirectoryTransactionLimit und globalDirectoryTransactionLimit auf Null setzen. Wenn Sie sich jedoch entscheiden, Werte zuzuweisen, muss jeder auf mindestens den fünffachen Wert von TransaktionLimitPeriodSeconds (dies sollte 1 sein) festgelegt werden.Transaktionslimits: Legen Sie die folgenden Werte fest (XSP_ CLI/System/CommunicationUtility/DefaultSettings):
userTransactionLimit: auf mindestens 100 festlegen.
TransaktionLimitPeriodSecs: auf 1 festlegen.
Paging-Werte: Legen Sie die Eigenschaften des Paging-Systems (XSP_ CLI/Applications/Xsi-Actions/Paging):
defaultPageSize: auf 50 setzen
availableUserMaxLimit: auf 100 . festlegen
CTI -Schnittstelle – Stellen Sie sicher, dass Sie die Webex -CA-Zertifikate in den Vertrauensspeicher der CTI -Schnittstelle hochladen und die Client-Authentifizierung auf der CTI -Schnittstelle aktivieren.
Abhängig von Ihrer BroadWorks-Version empfehlen wir außerdem, 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
Verzeichnissynchronisierung aktivieren (neue Vorlage)
Partneradministratoren können Directory Sync für eine Kundenvorlage aktivieren, während sie die neue Vorlage erstellen. Für alle neuen Kundenorganisationen, die dieser Vorlage zugewiesen werden, wird die Verzeichnissynchronisierung aktiviert. Weitere Informationen finden Sie unter „Konfigurieren Ihrer Kundenvorlagen“ in Konfigurieren Ihrer Partnerorganisation im Partner-Hub innerhalb der Lösungsleitfaden für Webex für Cisco BroadWorks .
Nächste Schritte
Stellen Sie sicher, dass Ihre Benutzer wissen, dass sie auf die Schaltfläche Kontakte in der Webex App mindestens einmal, um die Funktion in der Webex -App zu aktivieren. Dies muss nur einmal durchgeführt werden.
Verzeichnissynchronisierung aktivieren (vorhandene Vorlage)
1 | Melden Sie sich bei Partner Hub an und wählen Sie Einstellungen . |
||
2 | Scrollen Sie zu BroadWorks-Anrufe und klicken Sie auf Vorlagen anzeigen . |
||
3 | Wählen Sie die entsprechende Kundenvorlage aus und blättern Sie zu BroadWorks-Verzeichnissynchronisierung . |
||
4 | So aktivieren Sie die Verzeichnissynchronisierung standardmäßig für neue Kundenorganisationen, die diese Vorlage verwenden:
|
||
5 | So aktivieren Sie die Verzeichnissynchronisierung für bestehende Kundenorganisationen, die diese Vorlage verwenden:
|
Nächste Schritte
Stellen Sie sicher, dass Ihre Benutzer wissen, dass sie auf die Schaltfläche Kontakte in der Webex App mindestens einmal, um die Funktion in der Webex -App zu aktivieren. Dies muss nur einmal durchgeführt werden.
Sofortige Synchronisierung auslösen
1 | Melden Sie sich bei Partner Hub an (http://admin.webex.com ) und wählen Sie Einstellungen . |
2 | Scrollen Sie zu BroadWorks-Anrufe und klicken Sie auf Vorlagen anzeigen . |
3 | Wählen Sie die entsprechende Kundenvorlage aus und blättern Sie zu BroadWorks-Verzeichnissynchronisierung . |
4 | Klicken Sie auf Liste des Synchronisierungsstatus der Kunden anzeigen . |
5 | Klicken Sie für die Kundenorganisation, die Sie synchronisieren möchten, auf die drei Punkte ganz rechts und wählen Sie Jetzt synchronisieren . |
6 | Klicken Sie auf Aktualisieren um die Synchronisierungsergebnisse anzuzeigen. |
Synchronisierungsaufzeichnungen in CSV
1 | Melden Sie sich bei Partner Hub an (http://admin.webex.com ) und wählen Sie Einstellungen . |
2 | Scrollen Sie zu BroadWorks-Anrufe und klicken Sie auf Vorlagen anzeigen . |
3 | Wählen Sie die entsprechende Kundenvorlage aus und blättern Sie zu BroadWorks-Verzeichnissynchronisierung . |
4 | Klicken Sie auf Liste des Synchronisierungsstatus der Kunden anzeigen . |
5 | Aktivieren Sie die nebenstehenden Kontrollkästchen für jede Organisation, die Sie in den Export einbeziehen möchten. |
6 | Klicken Sie auf Ergebnisse exportieren . |
Öffentliche APIs für die Verzeichnissynchronisierung
Öffentliche APIs sind verfügbar auf developer.webex.com die es Partneradministratoren ermöglichen, die Directory Sync-Einstellungen für die von ihnen verwalteten Kundenorganisationen zu aktualisieren, um eine sofortige Synchronisierung auszulösen oder Informationen zum Synchronisierungsstatus zu erhalten. Die Verzeichnissynchronisierungsmethoden sind gruppiert unter BroadWorks-Unternehmen :
BroadWorks-Unternehmen auflisten – Verwenden Sie diese API -Methode, um eine Liste der Unternehmen unter einem bestimmten Dienstanbieter und jedem Unternehmen zu erhalten
id
. Geben Sie Folgendes ein:spEnterpriseId
wie bei der Bereitstellung zugewiesen.Directory Sync für ein BroadWorks-Unternehmen aktualisieren – Geben Sie das Unternehmen ein
id
um den Verzeichnissynchronisierungsstatus für das 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 eine sofortige Synchronisierung für ein bestimmtes Unternehmen auslösen möchten
id
. Für densyncStatus
, geben Sie denSYNC_NOW
Befehl.Directory Sync-Status für ein Unternehmen abrufen – Geben Sie das Unternehmen ein
id
und ausführen, um einen Status abzurufen undtrackingId
der letzten Synchronisierung. Sie können dentrackingID
um zusätzliche Analysen über Tools wie Kibana und Grafana auszuführen.
Darüber hinaus können Administratoren die Funktion Verzeichnissynchronisierung für einen einzelnen Benutzer auslösen API zum Auslösen einer bei Bedarf stattfindenden Verzeichnissynchronisierung für einen einzelnen Benutzer.
Eine detaillierte API Dokumentation finden Sie unterhttps://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .
Sie müssen sich anmelden, um die API Spezifikation zu lesen unterhttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Mehrere Unternehmen mit API
|
1 | Führen Sie das BroadWorks-Unternehmen auflisten API zum Generieren einer Liste der Unternehmen, die Sie synchronisieren möchten.
|
2 | Führen Sie das Directory Sync für ein Unternehmen auslösen API für das erste Unternehmen in der Liste. |
3 | Warten Sie einige Sekunden und führen Sie dann den Directory Sync-Status abrufen API zum Abrufen des Synchronisierungsstatus.
|
4 | Führen Sie nach Abschluss der Synchronisierung die Schritte 2 bis 4 für das nächste Unternehmen in der Liste aus. Wiederholen Sie diese Schritte, bis Sie die gesamte Liste synchronisiert haben. |
Fehlercodes für Directory Sync
Die folgenden Fehlercodes gelten für Directory Sync.
Fehlercode |
Fehlermeldung |
---|---|
600000 |
Unerwarteter Fehler bei Broadworks External Directory User Sync. |
600001 |
Fehler bei Broadworks External Directory User Sync. |
600002 |
Broadworks External Directory User Sync musste vorzeitig beendet werden. |
600003 |
Broadworks External Directory User Sync war nur teilweise erfolgreich. Manche Kundenorganisationen konnten nicht synchronisiert werden. |
600004 |
Broadworks External Directory User Sync ist für ConfigSet nicht aktiviert. |
600005 |
Broadworks External Directory User Sync wird für ConfigSet durchgeführt. |
600006 |
Broadworks External Directory User Sync-Threads sind beschäftigt oder werden heruntergefahren. Daher werden keine Synchronisierungsanforderungen mehr angenommen. Bitte versuchen Sie es später erneut. |
600001 |
Identity Org der CustomerConfig wurde nicht gefunden. |
600008 |
Die CustomerConfig wurde in der Partnerorg. nicht gefunden. |
600009 |
Broadworks External Directory User Sync kann nicht ausgeführt werden, da das der CustomerConfig zugeordnete Broadworks-Cluster ausgelastet ist |
600010 |
Broadworks External Directory User Sync kann nicht ausgeführt werden, weil kein Broadworks-Custer mit CustomerConfig verknüpft ist. |
600011 |
Broadworks External Directory User Sync ist für CustomerConfig nicht aktiviert. |
600012 |
Broadworks External Directory User Sync kann nicht ausgeführt werden, weil die Hybrid Directory-Synchronisierung für CustomerConfig bereits aktiviert ist. |
600013 |
Broadworks External Directory User Sync konnte Benutzer- und Gerätekonten nicht zum Identitätsspeicher hinzufügen. |
600014 |
Broadworks External Directory User Sync schlug beim Versuch fehl, eine Verbindung zum Broadworks-Cluster herzustellen. Fehler von BroadWorks – %s. |
600015 |
Broadworks External Directory User Sync konnte keinen übereinstimmenden Benutzer im Identitätsspeicher finden. |
600017 |
Bei der Synchronisierung der BroadWorks-Telefonliste konnten nicht alle Benutzer und Unternehmens-/Organisationskontakte synchronisiert werden. |
600018 |
Fehler bei der Synchronisierung der BroadWorks-Telefonliste für Benutzer im Unternehmen/der Organisation. |
600019 |
Unternehmens-/Organisationskontakte konnten bei der BroadWorks-Telefonlistensynchronisierung nicht synchronisiert werden. |
600020 |
BroadWorks External Directory User Sync kann nicht deaktiviert werden, da die CustomerConfig-Synchronisierung In Bearbeitung ist. |
600022 |
BroadWorks External Directory Single User Sync ist nicht möglich, da das Unternehmen keine bereitgestellten Benutzer hat. |
600023 |
BroadWorks External Directory Single User Sync ist nicht möglich, da der Benutzer bereits in dieser Organisation vorhanden ist. |
600024 |
BroadWorks External Directory Single User Sync ist nicht möglich, da kein übereinstimmender Benutzer in BroadWorks gefunden wurde. |
600025 |
BroadWorks External Directory User Sync konnte das Benutzerkonto in CI nicht aktualisieren. |
600026 |
BroadWorks External Directory User Sync konnte das Maschinenkonto in CI nicht aktualisieren. |
600027 |
BroadWorks External Directory Single User Sync ist nicht möglich, da mehrere Benutzer in BroadWorks gefunden wurden. |
600028 |
BroadWorks External Directory Single User Sync ist nicht möglich, da mindestens eine Unternehmensverzeichnis abgeschlossen sein sollte. |
600029 |
BroadWorks External Directory User Sync ist fehlgeschlagen, da das Unternehmen über keinen bereitgestellten Benutzer verfügt. |
Änderungsverlauf
In der folgenden Tabelle werden die Aktualisierungen zu diesem Artikel zusammengefasst.
Datum |
Revision |
---|---|
14. Februar 2023 |
Aktualisiert Maximalwerte und Quelle für die Verzeichnissynchronisierung Abschnitt. |
10. Dezember 2022 |
Begriff wurde aktualisiert Sofortige Synchronisierung abschließen an Verzeichnissynchronisierung auslösen |
19. Juli 2022 |
Klarstellungen und Korrekturen der Übersichtsinformationen:
|
09. Mai 2022 |
|
07. April 2022 |
|
28. März 2022 |
|
24. März 2022 |
Liste der synchronisierten Telefonnummer hinzugefügt zu Bedingungen für die Verzeichnissynchronisierung . Die Synchronisierung umfasst jetzt auch Mobiltelefon . |
16. März 2022 |
|
17. Dezember 2021 |
|
16. Dezember 2021 |
|
08. Dezember 2021 |
|