Bu makalede, Cisco Webex için Webex'te Directory Sync'in nasıl dağıtılacağı açıklanmaktadır. Makale, ortak kuruluşlardaki Servis Sağlayıcı yöneticilerine yöneliktir.
Dizin Senkronizasyonuna Genel Bakış
Dizin eşitleme, Cisco BroadWorks kullanıcıları için Webex Webex Webex dizinini kullanabilmesini sağlar. Bu özellik, kullanıcı temel hazırlığının bir parçası olmayan BroadWorks arama bilgilerini Webex dizinine eşitler.
Cisco BroadWorks kullanıcı yetkilendirmesi için Webex , Cisco BroadWorks kullanıcıları için Webex ( birincil telefon numarası, cep telefonu numarası , dahili hat) için arama ayrıntılarıyla Webex dizinini günceller, ancak harici arama kayıtlarını atlar. Ancak, Dizin eşitleme açık olduğunda, özellik ayrıca aşağıdaki çağrı kayıtlarını Webex dizinine eşitler.
Yalnızca BroadWorks arayan kullanıcılar ( Webex katılmamış)
Kullanıcı olmayan arama varlıkları (ör. konferans odası telefonu, faks makinesi, arama cevaplama grubu numarası)
BroadWorks Telefon Listesi girişleri
Aşağıdaki tablo, BroadWorks arama kayıtlarını özetler ve bunların Webex dizinine nasıl eklendiklerini gösterir.
BroadWorks Arama Kayıtları |
Açıklama |
Webex Dizinine eklendi... |
---|---|---|
Cisco BroadWorks kullanıcıları için Webex |
Kullanıcılar, Cisco BroadWorks için Webex için etkinleştirildi |
Kullanıcı sağlama (örneğin, akış sağlama) |
Yalnızca BroadWorks arayan kullanıcılar |
olan kullanıcıları aramak değil Webex katıldı |
dizin senkronizasyonu |
Kullanıcı olmayan arama varlıkları |
Örneğin, bir konferans odası telefonu, faks makinesi, Hunt grup numarası |
dizin senkronizasyonu |
BroadWorks telefon listeleri |
BroadWorks telefon listesi girişleri:
|
Dizin senkronizasyonu (telefon listesi senkronizasyonu) |
Kullanıcı yetkilendirmesi hakkında daha fazla ayrıntı için bkz. Cisco BroadWorks Çözüm Kılavuzu için Webex .
|
Dizin Eşitleme Koşulları
İş ortağı yöneticileri, özelliği iş ortağı düzeyinde etkinleştirmelidir. İş ortağı yöneticileri, tek bir işlemde birden çok müşteri kuruluşu için özelliği açabilir veya kapatabilir.
Varsayılan olarak, ilk eşitleme, eşitlemenin etkinleştirilmesinden bir hafta sonra gerçekleşir (senkronizasyonu başlatmak için seçilen zaman rastgeledir). Ancak, müşteri kuruluşları, Şimdi Senkronize Et bir haftalık bekleme süresini atlama ve belirli bir müşteri kuruluşu için anında eşitlemeyi tetikleme seçeneği.
Varsayılan olarak, dizin Senkronizasyonu her müşteri için haftalık olarak çalışır. Her senkronizasyon, son senkronizasyonun programlanmış veya manuel olarak tetiklenmiş olmasına bakılmaksızın, son senkronizasyondan bir hafta sonra gerçekleşir. Şimdi Senkronize Et .
BroadWorks kümesi başına maksimum sayı eşzamanlı eşitleme sayısı ikidir: bir planlanmış eşitleme ve bir isteğe bağlı eşitleme ( API veya Partner Hub GUI aracılığıyla). Ancak yöneticiler, aynı BroadWorks'ten aynı anda iki isteğe bağlı eşitleme çalıştıramaz. Bu kısıtlama, senkronizasyonun API aracılığıyla mı yoksa Şimdi Senkronize Et İş Ortağı Merkezi'ndeki seçenek. Ayrıca Webex , aynı BroadWorks'ten aynı anda çalışacak şekilde iki planlanmış eşitleme zamanlamaz.
Bir eşitleme hatası oluşursa Webex , bir sonraki zamanlanmış eşitlemeye kadar her 24 saatte bir eşitlemeyi otomatik olarak yeniden dener.
Senkronizasyon, telefon numarası olmayan kullanıcıları yok sayar.
Partner Hub'da, belirli bir müşteri için eşitleme durumu bilgilerini görüntüleyebilirsiniz. Ayrıca, son senkronizasyonla ilgili ayrıntılı bilgi bir CSV kaydına aktarabilirsiniz. CSV kaydı, Control Hub ekranından daha fazla ayrıntı sağlar ve sorun giderme, analiz ve denetimde yardımcı olabilir.
Webex , kullanıcı kişilerini şifrelenmiş bir biçimde saklar. Yalnızca kişinin sahibi olan kullanıcının şifre çözme anahtarına erişimi vardır.
Yalnızca BroadWorks arayan kullanıcılar ve kullanıcı olmayan arama varlıkları için bu özellik, BroadWorks'ten aşağıdaki telefon numarası türlerini eşitler:
Birincil Telefon Numarası
Cep Telefonu Numarası
Uzantı
Ancak senkronizasyon, birincil telefon numarası veya dahili numara yoksa, yalnızca BroadWorks arayan kullanıcıları ve kullanıcı olmayan arama varlıklarını senkronizasyondan hariç tutar.
BroadWorks Telefon Listesi ve Kişi Maksimumları
Dizin eşitleme, BroadWorks telefon listesi girişlerini Webex Kişileri ile de eşitler. Senkronize girişler aşağıdaki kişi türlerinden birine eklenir:
Kuruluş Kişileri— Webex , bu kişileri bir kuruluşa karşı depolar. Her kullanıcı, kendi kuruluşu için kuruluş kişilerine erişebilir. Maksimum 30000 kişiye kadar.
Kullanıcı Kişileri— Webex bu kişileri bir kullanıcıya karşı saklar. Kişi girişine yalnızca kişinin sahibi olan kullanıcı erişebilir. Maksimum 2000 kişidir (1500 eşitlenmiş kişi + 500 manuel giriş kişisi).
Webex Kişilerine yalnızca Telefon Listesi girişleri eklenir. Dizin eşitlemeye dahil olan yalnızca BroadWorks arayan kullanıcılar ve kullanıcı olmayan arama varlıkları, bir Webex kullanıcısı bunları Kişiler'e manuel olarak eklemediği sürece Kişiler'e eklenmez.
|
Aşağıdaki tablo, Webex kişi türlerini kişi kaynağıyla eşler (bir BroadWorks telefon listesinden eşitlenir veya manuel olarak eklenir):
Webex Kişi Türü |
İletişim Kaynağı |
Maksimum |
BroadWorks'ten senkronize edildi... |
Senkronizasyon için kullanılan API |
---|---|---|---|---|
Kuruluş kişileri |
dizin senkronizasyonu |
30000 kişi |
Kurumsal Ortak Telefon Listeleri |
|
Grup Ortak Telefon Listeleri (bir Servis Sağlayıcı grubu için)** |
|
|||
Kullanıcı kişileri |
dizin senkronizasyonu |
1500 kişi |
Kişisel Telefon Listeleri |
/directories/personal |
Kullanıcı tarafından manuel olarak eklendi |
500 kişi |
Yok |
Yok |
|
Grup kişileri |
dizin senkronizasyonu |
grup başına 30000 kişi |
Grup Ortak Telefon Listeleri (Kurumsal bir grup için)** |
/directories/groupcommon |
**Grup Ortak Telefon Listeleri girişleri, BroadWorks'ün Kurumsal Modda mı yoksa Servis Sağlayıcı modunda mı olduğuna bağlı olarak farklı şekilde eşitlenir. değeri
|
Directory Sync'in kişi maksimum değerlerini işleme şekliyle ilgili olarak aşağıdaki koşullar geçerlidir:
Bir kuruluş, eşitleme için izin verilen maksimum kişileri (grup başına 30000 kuruluş kişisi veya 30000 Grup ortak kişisi) aşarsa, dizin eşitleme, maksimum eşiğin üzerindeki girişleri hariç tutar. Senkronize edilen veya atlanan kişilere uygulanan belirli bir sıra yoktur.
Müşterilerinizden biri her iki kategoride de izin verilen maksimum kişi sayısını aşarsa, o organizasyonun dizin senkronizasyonundan hariç tutulması için Cisco bir dava açmanızı öneririz.
Manuel kişiler, bir kullanıcının Webex Uygulamasına manuel olarak eklediği kişilerdir. Bir kullanıcı en fazla 500 manuel kişi ekleyebilir. Manuel kişiler, Webex daha geniş Kullanıcı iletişim kategorisine girer, ancak eşitlemeye dahil edilmez.
Kuruluş ilgili kişileri (30000) ve grup ilgili kişileri (grup başına 30000) için toplam birleşik sınır 200000'dir.
Güncellemeler
Webex dizini güncellemeleri şu şekilde işler:
BroadWorks'te ilgili kişi adı değişirse mevcut ilgili kişi Webex dizininden silinir ve yeni bir ilgili kişi oluşturulur.
BroadWorks'te kişi numarası değişirse Webex Webex mevcut ilgili kişiyi yeni numarayla günceller.
Bir yönetici BroadWorks'te bir ilgili kişiyi güncelledikten sonra, güncelleme bir kullanıcının Webex Uygulamasında görüntülendiğinde aşağıdaki koşullar özetlenir:
Güncelleme, yalnızca BroadWorks arayan bir kullanıcıya veya kullanıcı olmayan bir çağrı varlığına yönelikse güncelleme, sonraki dizin senkronizasyonunun hemen ardından kullanıcının Webex Uygulamasında görüntülenir.
Güncelleme bir BroadWorks telefon listesi girişine yönelikse:
Kullanıcı kişileri için - Güncellemeler, sonraki dizin senkronizasyonunun hemen ardından kullanıcının Webex Uygulamasında görüntülenir.
Grup kişileri için - Güncellemeler, sonraki dizin senkronizasyonunun hemen ardından kullanıcıların Webex Uygulamasında görüntülenir.
Kuruluş kişileri için - Webex dizini sonraki dizin eşitlemesinde güncellenir, ancak kullanıcılar Webex Uygulamasını yeniden başlatana veya yerel 72 saatlik önbellek zamanlayıcısının süresi dolana kadar Webex Uygulamasındaki değişikliği görmez.
Cisco BroadWorks kullanıcı bilgileri için Webex güncellemeleri, sağlama süreçlerinin bir parçası olarak işlenir.
|
Control Hub, bir CSV dosyası aracılığıyla Control Hub'da kuruluş düzeyindeki kişileri ekleme veya düzenleme seçeneği içerir. İş ortağı yöneticileri ve Control Hub erişimi olan müşteri yöneticileri bu seçeneğe erişebilir. Ancak, kişilerin Control Hub aracılığıyla güncellenmesi Cisco BroadWorks için Webex tarafından desteklenmez. Control Hub'da uygulanan kişi güncellemeleri BroadWorks ile eşitlenmez ve masa telefonlarından dizin aramalarında kullanılamaz.
|
Dizin Senkronizasyonu Ön Koşulları
Aşağıdaki ayarları kullanmanızı öneririz:
Aşağıdaki örnekler, bir XSP sunucusu kullandığınızı varsaymaktadır. ADP sunucuları için değiştirin (XSP_ CLI) ile (ADP)_ CLI).
|
Hız Sınırlama Değerleri—Aşağıdaki OverloadControl sistem özelliklerini ayarlayın (XSP_ CLI/Uygulamalar/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit—Boş bir değere ayarlayın.
globalDirectoryTransactionLimit—Boş bir değere ayarlayın.
userDirectoryTransactionLimit ve globalDirectoryTransactionLimit'i boş bir değere ayarlamanız önerilir. Ancak, değer atamaya karar verirseniz, her biri işlemLimitPeriodSeconds değerinin en az beş katına ayarlanmalıdır (1 olmalıdır).İşlem Limitleri—Aşağıdaki değerleri ayarlayın (XSP_ CLI/Sistem/CommunicationUtility/DefaultSettings):
userTransactionLimit—En az 100 olarak ayarlayın.
işlemLimitPeriodSecs—1 olarak ayarlayın.
Çağrı Değerleri—Paging sistem özelliklerini ayarlayın (XSP_ CLI/Uygulamalar/Xsi-Actions/Paging):
defaultPageSize—50 olarak ayarlayın
kullanılabilirUserMaxLimit—100 olarak ayarlayın
CTI Arayüzü—Bu Webex CA sertifikalarını CTI arayüzü güven deposuna yüklediğinizden ve CTI arayüzünde istemci kimlik doğrulamasını etkinleştirdiğinizden emin olun.
Ayrıca, BroadWorks sürümünüze bağlı olarak, bu özelliği etkinleştirmeden önce BroadWorks dağıtımına aşağıdaki sistem yamalarını uygulamanızı öneririz:
R22 için:
AP.as.22.0.1123.ap368517
R23 için:
AP.as.23.0.1075.ap368517
R24 için: yama gerekmez
Dizin Eşitlemesini Etkinleştir (Yeni Şablon)
İş ortağı yöneticileri, yeni şablonu oluştururken bir müşteri şablonu için Dizin Senkronizasyonu'nu etkinleştirebilir. Bu şablona atanan tüm yeni müşteri kuruluşlarında dizin eşitlemesi etkinleştirilecektir. Ayrıntılar için, bkz. "Müşteri Şablonlarınızı Yapılandırın". İş Ortağı Kuruluşunuzu İş Ortağı Merkezinde Yapılandırın içinde Cisco BroadWorks için Webex Çözüm Kılavuzu .
Sonra ne yapmalı
Kullanıcılarınızın tıklamaları gerektiğini bildiklerinden emin olun. Kişiler Webex Uygulamasında özelliği açmak için Webex Uygulamasında en az bir kez sekmesine tıklayın. Bunun yalnızca bir kez tamamlanması gerekir.
Dizin Eşitlemesini Etkinleştir (Mevcut Şablon)
1 | Partner Hub'da oturum açın ve Ayarlar . |
||
2 | Kaydır BroadWorks Çağrısı ve tıklayın Şablonları Görüntüle . |
||
3 | Uygun müşteri şablonunu seçin ve BroadWorks Dizin Senkronizasyonu . |
||
4 | Bu şablonu kullanan yeni müşteri organizasyonları için dizin senkronizasyonunu varsayılan olarak etkinleştirmek için:
|
||
5 | Bu şablonu kullanan mevcut müşteri kuruluşları için dizin senkronizasyonunu etkinleştirmek için:
|
Sonraki işlemler
Kullanıcılarınızın tıklamaları gerektiğini bildiklerinden emin olun. Kişiler Webex Uygulamasında özelliği açmak için Webex Uygulamasında en az bir kez sekmesine tıklayın. Bunun yalnızca bir kez tamamlanması gerekir.
Anında Senkronizasyonu Tetikleyin
1 | Partner Hub'da oturum açın (http://admin.webex.com ) ve seçin Ayarlar . |
2 | Kaydır BroadWorks Çağrısı ve tıklayın Şablonları Görüntüle . |
3 | Uygun müşteri şablonunu seçin ve BroadWorks Dizin Senkronizasyonu . |
4 | tıklayın Müşterilerin senkronizasyon durumunun listesini göster . |
5 | Senkronize etmek istediğiniz müşteri organizasyonu için en sağdaki üç noktayı tıklayın ve Şimdi Senkronize Et . |
6 | tıklayın Yenile senkronizasyon sonuçlarını görmek için |
Senkronizasyon Kayıtlarını CSV Dışa Aktar
1 | Partner Hub'da oturum açın (http://admin.webex.com ) ve seçin Ayarlar . |
2 | Kaydır BroadWorks Çağrısı ve tıklayın Şablonları Görüntüle . |
3 | Uygun müşteri şablonunu seçin ve BroadWorks Dizin Senkronizasyonu . |
4 | tıklayın Müşterilerin senkronizasyon durumunun listesini göster . |
5 | Dışa aktarmaya dahil etmek istediğiniz her kuruluş için bitişik onay kutularını işaretleyin. |
6 | tıklayın Sonuçları dışa aktar . |
Dizin Senkronizasyonu için Genel API'ler
Genel API'ler şurada mevcuttur: geliştirici.webex.com iş ortağı yöneticilerinin yönettikleri müşteri kuruluşları için Dizin Senkronizasyonu ayarlarını güncellemelerine, anında bir senkronizasyonu tetiklemelerine veya senkronizasyon durumu bilgilerini almalarına olanak tanır. Dizin eşitleme yöntemleri altında gruplandırılmıştır. BroadWorks Şirketleri :
BroadWorks Enterprises Listeleme API bir Hizmet Sağlayıcı kapsamındaki işletmelerin ve her işletmenin
id
. girmelisinizspEnterpriseId
sağlamada atandığı gibi.Bir BroadWorks Enterprise için Directory Sync'i Güncelleme —İşletmeye girin
id
o kuruluş için dizin syc durumunu güncellemek, dizin senkronizasyonunu etkinleştirmek veya devre dışı bırakmak için.Bir Kuruluş için Dizin Eşitlemesini Tetikleyin —Belirli bir kuruluş için anında eşitlemeyi tetiklemek istiyorsanız bu API yöntemini kullanın
id
. içinsyncStatus
, girinSYNC_NOW
komut.Bir Kuruluş için Dizin Eşitleme Durumunu Alın —İşletmeye girin
id
ve bir durum almak için çalıştırın vetrackingId
en son senkronizasyon. kullanabilirsiniztrackingID
Kibana ve Grafana gibi araçlar aracılığıyla ek analizler çalıştırmak için.
Ayrıca, yöneticiler şunları kullanabilir: Tek Bir Kullanıcı için Dizin Senkronizasyonunu Tetikleyin Tek bir kullanıcı için isteğe bağlı dizin senkronizasyonunu tetikleyen API .
Ayrıntılı API belgeleri için bkz.https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .
API spesifikasyonunu okumak için şu adreste oturum aç açmanız gerekir:https://developer.webex.com/docs/api/v1/broadworks-subscribers .
API ile Birden Çok Kuruluşu Senkronize Et
|
1 | çalıştır BroadWorks Enterprises Listeleme Senkronize etmek istediğiniz kuruluşların bir listesini oluşturmak için API .
|
2 | çalıştır Bir Kuruluş için Dizin Eşitlemesini Tetikleyin Listedeki ilk kuruluştaki API . |
3 | Birkaç saniye bekleyin ve ardından Dizin Eşitleme Durumunu Al Senkronizasyon durumunu almak için API .
|
4 | Eşitleme tamamlandıktan sonra, listedeki bir sonraki kuruluşta 2 ila 4 arasındaki adımları tamamlayın. Tüm listeyi senkronize edene kadar bu adımları tekrarlayın. |
Dizin Senkronizasyonu için Hata Kodları
Aşağıdaki hata kodları, Dizin Senkronizasyonu için geçerlidir.
Hata Kodu |
Hata Mesajı |
---|---|
600000 |
Broadworks Harici Dizini Kullanıcı Senkronizasyonu beklenmedik hata. |
600001 |
BroadWorks Harici Dizini Kullanıcı Senkronizasyonu başarısız oldu. |
600002 |
BroadWorks Harici Dizini Kullanıcı Senkronizasyonunun tamamlanmadan sonlandırılması gerekti. |
600003 |
Broadworks Harici Dizin Kullanıcı Senkronizasyonu yalnızca kısmen başarılı oldu. Bazı Müşteri Kuruluşları senkronize edilemedi. |
600004 |
BroadWorks Harici Dizini Kullanıcı Senkronizasyonu ConfigSet için etkinleştirilmedi. |
600005 |
BroadWorks Harici Dizini Kullanıcı Senkronizasyonu ConfigSet için devam ediyor. |
600006 |
BroadWorks Harici Dizini Kullanıcı Senkronizasyonu iş parçacıkları meşgul veya kapatılıyor, bu nedenle daha fazla senkronizasyon isteği kabul edilmeyecek, daha sonra tekrar deneyin. |
600007 |
CustomerConfig’in Kimlik Kuruluşu bulunamadı. |
600008 |
CustomerConfig iş ortağı kuruluşunda bulunamadı |
600009 |
Broadworks Harici Dizin Kullanıcı Senkronizasyonu, CustomerConfig ile ilişkili Broadworks kümesi meşgul olduğundan çalıştırılamaz |
600010 |
CustomerConfig ile ilişkili BroadWorks kümesi olmadığı için BroadWorks Harici Dizini Kullanıcı Senkronizasyonu çalıştırılamıyor. |
600011 |
BroadWorks Harici Dizini Kullanıcı Senkronizasyonu CustomerConfig için etkinleştirilmedi. |
600012 |
Karma Dizin senkronizasyonu CustomerConfig için zaten etkinleştirildiğinden Broadworks Harici Dizini Kullanıcı Senkronizasyonu çalıştırılamıyor. |
600013 |
BroadWorks Harici Dizini Kullanıcı Senkronizasyonu, kullanıcıları ve makine hesaplarını kimlik deposuna ekleyemedi. |
600014 |
Broadworks kümesiyle bağlantı kurulmaya çalışılırken Broadworks Harici Dizini Kullanıcı Senkronizasyonu başarısız oldu. Broadworks'ten Hata - %s. |
600015 |
Broadworks Harici Dizini Kullanıcı Senkronizasyonu kimlik deposunda eşleşen kullanıcı bulamadı. |
600017 |
BroadWorks Telefon Listesi Senkronizasyonu, tüm kullanıcı ve kuruluş/kuruluş kişilerini senkronize edemedi. |
600018 |
BroadWorks Telefon Listesi Senkronizasyonu, kuruluştaki/kuruluştaki kullanıcılar için başarısız oldu. |
600019 |
BroadWorks Telefon Listesi Senkronizasyonu, kuruluş/kuruluş kişilerini senkronize edemedi. |
600020 |
BroadWorks Harici Dizin Kullanıcı Senkronizasyonu, CustomerConfig senkronizasyonu Sürüyor ederken devre dışı bırakılamaz. |
600022 |
BroadWorks Harici Dizin Tek Kullanıcı Senkronizasyonu, kuruluşun sağlanmış bir kullanıcısı olmadığı için mümkün değildir. |
600023 |
Kullanıcı zaten bu kuruluşta mevcut olduğundan BroadWorks Harici Dizin Tek Kullanıcı Senkronizasyonu mümkün değildir. |
600024 |
BroadWorks Harici Dizin Tek Kullanıcı Senkronizasyonu, BroadWorks'te eşleşen kullanıcı bulunamadığından mümkün değildir. |
600025 |
BroadWorks Harici Dizin Kullanıcı Senkronizasyonu, CI'deki kullanıcı hesabı güncelleyemedi. |
600026 |
BroadWorks Harici Dizin Kullanıcı Senkronizasyonu, CI'deki makine hesabını güncelleyemedi. |
600027 |
BroadWorks'te birden çok kullanıcı bulunduğundan BroadWorks Harici Dizin Tek Kullanıcı Senkronizasyonu mümkün değildir. |
600028 |
En az bir kuruluş dizini senkronizasyonunun tamamlanmış olması gerektiğinden BroadWorks Harici Dizin Tek Kullanıcı Senkronizasyonu mümkün değildir. |
600029 |
Kuruluşun sağlanmış bir kullanıcısı olmadığı için BroadWorks Harici Dizin Kullanıcı Senkronizasyonu başarısız oldu. |
Değişiklik Geçmişi
Aşağıdaki tablo, bu makaledeki güncellemeleri özetlemektedir.
Tarih |
Revizyon |
---|---|
14 Şubat 2023 |
güncellendi Dizin Senkronizasyonu Maksimumları ve Kaynak bölüm. |
10 Aralık 2022 |
Terim güncellendi Anında Eşitlemeyi Tamamlayın için Dizin Senkronizasyonunu Tetikle |
19 Temmuz 2022 |
Genel bakış bilgilerine ilişkin açıklamalar ve düzeltmeler:
|
09 Mayıs 2022 |
|
07 Nisan 2022 |
|
28 Mart 2022 Pazartesi |
|
24 Mart 2022 Perşembe |
Senkronize edilmiş telefon numarası türlerinin listesi eklendi Dizin Eşitleme Koşulları . Senkronizasyon artık cep telefonu numaralarını da içeriyor. |
16 Mart 2022 |
|
17 Aralık 2021 |
|
16 Aralık 2021 |
|
08 Aralık 2021 |
|