- Ana Sayfa
- /
- Makale
Cisco BroadWorks için Webex'te Dizin Eşitleme
Bu makalede, Cisco BroadWorks için Webex'te Dizin Senkronizasyonunun nasıl dağıtılacağı anlatılmaktadır. Bu makale, iş ortağı kuruluşlarındaki Hizmet Sağlayıcı yöneticileri için tasarlanmıştır.
Dizin Senkronizasyonuna Genel Bakış
Dizin senkronizasyonu, Cisco BroadWorks için Webex kullanıcılarının BroadWorks sunucusundan herhangi bir çağrı kuruluşunu aramak için Webex Uygulamasından Webex dizinini kullanabilmesini sağlar. Bu özellik, Webex dizinine kullanıcı sağlamanın bir parçası olmayan BroadWorks çağrı bilgilerini senkronize eder.
Webex for Cisco BroadWorks kullanıcı sağlama işlemi, Webex dizinini Cisco BroadWorks kullanıcıları için Webex (birincil telefon numarası, cep telefonu numarası, dahili numara) için çağrı ayrıntılarıyla günceller ancak harici çağrı kayıtlarını almaz. Bununla birlikte, Dizin senkronizasyonu açık olduğunda özellik aşağıdaki çağrı kayıtlarını Webex dizinine de eşitler.
Yalnızca BroadWorks çağrı kullanıcıları (Webex’e dahil olmayan)
Kullanıcı olmayan çağrı varlıkları (ör. konferans odası telefonu, faks makinesi, çağrı yakalama grubu numarası)
BroadWorks Telefon Listesi girişleri
Aşağıdaki tabloda, BroadWorks çağrı kayıtları özetlenmekte ve bunların Webex dizinine nasıl eklendiği gösterilmektedir.
BroadWorks Çağrı Kayıtları | Açıklama | Şuradan Webex Dizinine eklendi... |
---|---|---|
Cisco BroadWorks kullanıcıları için Webex | Kullanıcılar, Cisco BroadWorks için Webex etkinleştirildi | Kullanıcı sağlama (örn. akış sağlama) |
Yalnızca BroadWorks çağrı kullanıcıları | Webex’e kayıtlı olmayan çağrı kullanıcıları | Dizin senkronizasyonu |
Kullanıcı olmayan çağrı varlıkları | Örneğin bir konferans odası telefonu, faks makinesi, Çağrı yakalama grubu numarası | Dizin senkronizasyonu |
BroadWorks telefon listeleri | BroadWorks telefon listesi girişleri:
| Dizin senkronizasyonu (telefon listesi senkronizasyonu) |
Dizin Senkronizasyonu Koşulları
Iş ortağı yöneticilerinin özelliği iş ortağı düzeyinde etkinleştirmesi gerekir. Iş ortağı yöneticileri, tek bir işlemde birden fazla 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 (eşitlemeyi başlatmak için seçilen zaman rassaldır). Ancak, müşteri kuruluşları bir haftalık bekleme süresini atlamak ve belirli bir müşteri kuruluşu için anında senkronizasyonu tetiklemek için Şimdi Senkronize Et seçeneğini kullanabilir.
Varsayılan olarak, dizin Senkronizasyonu her müşteri için haftalık olarak çalışır. Her senkronizasyon, son senkronizasyonun planlanmasından veya Şimdi Senkronize Et ile manuel olarak tetiklenmesinden bağımsız olarak, son senkronizasyondan bir hafta sonra gerçekleşir.
BroadWorks kümesi başına maksimum eşzamanlı eşitleme sayısı ikidir: bir planlanmış senkronizasyon ve isteğe bağlı senkronizasyon (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 veya Partner Hub'daki Şimdi Senkronize Et seçeneği aracılığıyla başlatılıp başlatılmadığına bakılmaksızın mevcuttur. Ayrıca Webex, aynı BroadWorks’ten aynı anda çalışacak iki planlanmış senkronizasyon planlamaz.
Senkronizasyon hatası oluşursa, Webex zamanlanan senkronizasyona kadar her 24 saatte bir senkronizasyonu otomatik olarak yeniden dener.
Senkronizasyon, telefon numarası olmayan kullanıcıları yoksayar.
Partner Hub'da, belirli bir müşteri için senkronizasyon durumu bilgilerini görüntüleyebilirsiniz. Ayrıca, son senkronizasyonla ilgili ayrıntılı bilgileri 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 şifreli bir biçimde saklar. Yalnızca kişinin sahibi olan kullanıcı şifre çözme anahtarına erişebilir.
Bu özellik, yalnızca BroadWorks çağrı kullanıcıları ve kullanıcı olmayan çağrı varlıkları için 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ını ve kullanıcı olmayan çağrı varlıklarını senkronizasyondan hariç tutar.
BroadWorks kullanıcı düzeyinde gizlilik hizmeti ayarı, dizin senkronizasyonunun bir parçası olarak desteklenmez.
BroadWorks Telefon Listesi ve Iletişim Maksimumları
Dizin senkronizasyonu, BroadWorks telefon listesi girişlerini Webex Kişileriyle 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 bir kullanıcı, kuruluşunun kuruluş kişilerine erişebilir. Maksimum 30.000 kişi olabilir.
Kullanıcı Kişileri—Webex, bu kişileri bir kullanıcıya karşı saklar. Yalnızca kişinin sahibi olan kullanıcı kişi girişine erişebilir. En fazla 2000 kişi (1500 senkronize kişi + 500 manuel giriş kişisi) olabilir.
Aşağıdaki tablo, Webex kişi türlerini iletişim kaynağıyla eşleştirir (bir BroadWorks telefon listesinden senkronize edilir veya manuel olarak eklenir):
Webex Kişi Türü | Iletişim Kaynağı | Maksimum | BroadWorks üzerinden eşitlendi... | Senkronizasyon için kullanılan API |
---|---|---|---|---|
Kuruluş kişileri | Dizin senkronizasyonu | 30000 kişi | Ortak Kurumsal Telefon Listeleri |
|
Ortak Grup Telefon Listeleri (bir Hizmet 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 | |
Kişileri grup | Dizin senkronizasyonu | Grup başına 30000 kişi | Ortak Grup Telefon Listeleri (bir Kurumsal grup için)** | /directories/groupcommon |
**Ortak Grup Telefon Listeleri girişleri, BroadWorks'ün Kuruluş Modunda veya Hizmet Sağlayıcısı modunda olup olmadığına bağlı olarak farklı şekilde eşitlenir. Bunun değeri isBroadWorksEnterprise
parametre (doğru veya yanlış) listenin nasıl senkronize edildiğini belirler:
Doğru—Grup kişisi olarak senkronize et
Yanlış—Kuruluş kişisi olarak senkronize et
Dizin Senkronizasyonunun iletişim maksimumlarını nasıl işlediğine ilişkin aşağıdaki koşullar geçerlidir:
Bir kuruluş senkronizasyon için izin verilen maksimum kişileri (grup başına 30000 kuruluş kişisi veya 30000 Grup ortak kişisi) aşarsa dizin senkronizasyonu maksimum eşiğin üzerindeki girişleri hariç tutar. Senkronize edilen veya atlanılan kişilere belirli bir sipariş uygulanmaz.
Müşterilerinizden biri her iki kategoride de izin verilen maksimum kişi sayısını aşarsa söz konusu kuruluşun dizin senkronizasyonundan hariç tutulması için Cisco'da vaka oluşturmanızı öneririz.
Manuel kişiler, bir kullanıcının Webex Uygulamasına manuel olarak eklediği kişilerdir. Bir kullanıcı 500'e kadar manuel kişi ekleyebilir. Manuel kişiler, Webex’teki daha büyük Kullanıcı iletişim bilgileri kategorisine girer ancak senkronizasyona dahil edilmez.
Kuruluş kişileri (30.000) ve grup kişileri (grup başına 30.000) için toplam birleşik sınır 200.000'dir.
Güncellemeler
Webex dizini güncellemeleri aşağıdaki şekilde işler:
BroadWorks'te kişi adı değişirse mevcut kişi Webex dizininden silinir ve yeni bir kişi oluşturulur.
BroadWorks'te kişi numarası değişirse Webex, Webex dizinindeki mevcut kişiyi yeni numarayla günceller.
Bir yönetici BroadWorks'te bir iletişim kaydını güncelledikten sonra, güncelleme kullanıcının Webex Uygulamasında görüntülendiğinde aşağıdaki koşullar özetlenir:
Güncelleme yalnızca BroadWorks kullanan bir çağrı kullanıcısına veya kullanıcı olmayan bir çağrı kuruluşuna ise, 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 ise:
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, kullanıcıların Webex Uygulamasında sonraki dizin senkronizasyonunun hemen ardından görüntülenir.
Kuruluş kişileri için: Webex dizini sonraki dizin senkronizasyonunda güncellenir, ancak kullanıcılar Webex Uygulamasını yeniden başlatana veya 72 saatlik yerel önbellek zamanlayıcısının süresi dolana kadar Webex Uygulamasındaki değişikliği görmeyecektir.
Dizin Senkronizasyonu Ön Koşulları
Aşağıdaki ayarları kullanmanızı öneririz:
Hız Sınırlama Değerleri—Aşağıdaki OverloadControl sistem özelliklerini ayarlayın (XSP_CLI/Applications/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit—Boş bir değer olarak ayarlayın.
globalDirectoryTransactionLimit—Boş bir değer olarak ayarlayın.
userDirectoryTransactionLimit ve globalDirectoryTransactionLimit değerini boş bir değer olarak ayarlamanız önerilir. Ancak, değer atamaya karar verirseniz her biri transactionLimitPeriodSeconds değerinin en az beş katı (1 olmalıdır) olarak ayarlanmalıdır.Işlem Sınırları—Aşağıdaki değerleri ayarlayın (XSP_CLI/System/CommunicationUtility/DefaultSettings):
userTransactionLimit—En az 100 olarak ayarlayın.
transactionLimitPeriodSecs—1 olarak ayarlayın.
Çağrı Değerleri—Çağrı sistemi özelliklerini ayarlayın (XSP_CLI/Applications/Xsi-Actions/Paging):
defaultPageSize—50 olarak ayarlayın
availableUserMaxLimit—100 olarak ayarlayın
CTI Arabirimi—Bu Webex CA sertifikalarını CTI arabirimi 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 aşağıdaki sistem yamalarını BroadWorks dağıtımına 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 gerekli değil
Dizin Senkronizasyonunu Etkinleştir (Yeni Şablon)
Iş ortağı yöneticileri, yeni şablonu oluştururken müşteri şablonu için Dizin Senkronizasyonunu etkinleştirebilir. Bu şablona atanan tüm yeni müşteri kuruluşlarında dizin senkronizasyonu etkinleştirilir. Ayrıntılar için bkz. “Müşteri Şablonlarınızı Yapılandırma” Partner Hub’da Iş Ortağı Kuruluşunuzu Yapılandırma içinde Cisco BroadWorks için Webex Çözüm Kılavuzu.
Bundan sonra ne olacak?
Kullanıcılarınızın, Webex Uygulamasında özelliği açmak için Webex Uygulamasındaki Kişiler sekmesine en az bir kez tıklamaları gerektiğini bildiğinden emin olun. Bu sadece bir kez doldurulması gerekir.
Dizin Senkronizasyonunu Etkinleştir (Mevcut Şablon)
1 | Partner Hub'da oturum açın ve Ayarlar'ı seçin. |
2 | BroadWorks Calling'e gidin ve Şablonları Görüntüle'ye tıklayın. |
3 | Uygun müşteri şablonunu seçin ve BroadWorks Dizin Senkronizasyonu'na kaydırın. |
4 | Bu şablonu kullanan yeni müşteri kuruluşları için varsayılan olarak dizin senkronizasyonunu etkinleştirmek için: |
5 | Bu şablonu kullanan mevcut müşteri kuruluşları için dizin senkronizasyonunu etkinleştirmek üzere: Dizin senkronizasyonunu devre dışı bırakmak istiyorsanız yukarıdaki prosedürü uygulayın ve:
|
Sonraki işlemler
Kullanıcılarınızın, Webex Uygulamasında özelliği açmak için Webex Uygulamasındaki Kişiler sekmesine en az bir kez tıklamaları gerektiğini bildiğinden emin olun. Bu sadece bir kez doldurulması gerekir.
Anında Senkronizasyonu Tetikleyin
1 | Partner Hub'da oturum açın ( http://admin.webex.com) ve Ayarlar'ı seçin. |
2 | BroadWorks Calling'e gidin ve Şablonları Görüntüle'ye tıklayın. |
3 | Uygun müşteri şablonunu seçin ve BroadWorks Dizin Senkronizasyonu'na kaydırın. |
4 | Müşteri senkronizasyon durumu listesini göster seçeneğine tıklayın. |
5 | Senkronize etmek istediğiniz müşteri kuruluşu için en sağdaki üç noktaya tıklayın ve Şimdi Senkronize Et'i seçin. |
6 | Senkronizasyon sonuçlarını görmek için Yenile düğmesine tıklayın. |
Senkronizasyon Kayıtlarını CSV’ye Dışa Aktar
1 | Partner Hub'da oturum açın ( http://admin.webex.com) ve Ayarlar'ı seçin. |
2 | BroadWorks Calling'e gidin ve Şablonları Görüntüle'ye tıklayın. |
3 | Uygun müşteri şablonunu seçin ve BroadWorks Dizin Senkronizasyonu'na kaydırın. |
4 | Müşteri senkronizasyon durumu listesini göster seçeneğine tıklayın. |
5 | Dışa aktarmaya dahil etmek istediğiniz her kuruluş için yanındaki onay kutularını işaretleyin. |
6 | Export results düğmesine tıklayın. |
Dizin Senkronizasyonu için Genel API'ler
developer.webex.com adresinde, iş ortağı yöneticilerinin yönettikleri müşteri kuruluşları için Dizin Senkronizasyonu ayarlarını güncellemesine, anında senkronizasyonu tetiklemesine veya senkronizasyon durumu bilgisi almasına olanak tanıyan genel API'ler mevcuttur. Dizin senkronizasyon yöntemleri BroadWorks Enterprises altında gruplandırılır:
BroadWorks Işletmelerini Listele—Belirli bir Hizmet Sağlayıcısı ve her bir işletmenin altında işletmelerin listesini almak için bu API yöntemini kullanın
id
. Şunu girmelisiniz:spEnterpriseId
sağlamada atandığı gibi.BroadWorks Kurumsal için Dizin Senkronizasyonunu Güncelleme—Kuruluşu girin
id
bu kuruluşun dizin syc durumunu güncellemek, dizin senkronizasyonunu etkinleştirmek veya devre dışı bırakmak için.Bir Kuruluş için Dizin Senkronizasyonunu Tetikleyin—Belirli bir kuruluş için anında senkronizasyonu tetiklemek istiyorsanız bu API yöntemini kullanın
id
. Şunlar için:syncStatus
, girişSYNC_NOW
komutunu verin.Bir Kuruluşun Dizin Senkronizasyon Durumu Alma—Kuruluşu girin
id
ve bir statü elde etmek için koşturuptrackingId
arasında en son senkronizasyonu seçin. Aşağıdaki kodu kullanabilirsiniz:trackingID
Kibana ve Grafana gibi araçlar aracılığıyla ek analizleri çalıştırmak için.
Ayrıca yöneticiler, tek bir kullanıcı için talep üzerine dizin senkronizasyonunu tetiklemek için Tek Kullanıcı API'si için Dizin Senkronizasyonunu Tetikle'yi kullanabilir.
Ayrıntılı API belgeleri için bkz. https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
https://developer.webex.com/docs/api/v1/broadworks-subscribers adresindeki API spesifikasyonunu okumak için oturum açmanız gereklidir.
Birden Fazla Kuruluşu API ile Eşitleme
Dizin senkronizasyonu, isteğe bağlı senkronizasyon yoluyla bir Broadworks kümesinden aynı anda yalnızca tek bir kuruluşu senkronize etmenize olanak tanır. Birden fazla kuruluşu senkronize etmeye çalışırsanız 429 hatası alırsınız
Tek bir kuruluş için bir senkronizasyonu tetiklemek için gereken süre, kuruluşun boyutuna bağlı olarak değişir.
1 | Senkronize etmek istediğiniz kuruluşların listesini oluşturmak için List BroadWorks Enterprises API'sini çalıştırın. |
2 | Listedeki ilk kuruluşta bir Kurumsal API için Tetikleyici Dizin Senkronizasyonunu çalıştırın. |
3 | Senkronizasyon durumunu almak için birkaç saniye bekleyin ve ardından Get Directory Sync Status API’sini çalıştırın. |
4 | Senkronizasyon tamamlandıktan sonra, listedeki bir sonraki kuruluştaki 2 ila 4 arasındaki adımları tamamlayın. Tüm listeyi eşitleyene kadar bu adımları tekrarlayın. |
Dizin Senkronizasyonu Için Hata Kodları
Dizin Senkronizasyonu için aşağıdaki hata kodları geçerlidir.
Hata Kodu | Hata Mesajı |
---|---|
600000'nın | Broadworks Harici Dizini Kullanıcı Senkronizasyonu beklenmedik hata. |
600001'nın sohbeti | BroadWorks Harici Dizini Kullanıcı Senkronizasyonu başarısız oldu. |
600002'nın sohbeti | 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 izleme | BroadWorks Harici Dizini Kullanıcı Senkronizasyonu ConfigSet için etkinleştirilmedi. |
600005 izleme | BroadWorks Harici Dizini Kullanıcı Senkronizasyonu ConfigSet için devam ediyor. |
600006 izleme | 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 izleme | CustomerConfig’in Kimlik Kuruluşu bulunamadı. |
600008 izleme | CustomerConfig iş ortağı kuruluşunda bulunamadı |
600009 izleme | CustomerConfig ile ilişkili Broadworks kümesi meşgul olduğundan Broadworks Harici Dizini Kullanıcı Senkronizasyonu çalıştırılamıyor |
600010 izleme | CustomerConfig ile ilişkili BroadWorks kümesi olmadığı için BroadWorks Harici Dizini Kullanıcı Senkronizasyonu çalıştırılamıyor. |
600011 izleme | BroadWorks Harici Dizini Kullanıcı Senkronizasyonu CustomerConfig için etkinleştirilmedi. |
600012 izleme | Karma Dizin senkronizasyonu CustomerConfig için zaten etkinleştirildiğinden Broadworks Harici Dizini Kullanıcı Senkronizasyonu çalıştırılamıyor. |
600013 izleme | BroadWorks Harici Dizini Kullanıcı Senkronizasyonu, kullanıcıları ve makine hesaplarını kimlik deposuna ekleyemedi. |
600014 izleme | 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 izleme | Broadworks Harici Dizini Kullanıcı Senkronizasyonu kimlik deposunda eşleşen kullanıcı bulamadı. |
600017 izleme | BroadWorks Telefon Listesi Senkronizasyonu, tüm kullanıcı ve kuruluş/kuruluş kişileri senkronize edilemedi. |
600018 izleme | Kuruluştaki/kuruluştaki kullanıcılar için BroadWorks Telefon Listesi Senkronizasyonu başarısız oldu. |
600019 izleme | BroadWorks Telefon Listesi Senkronizasyonu, kuruluş/kuruluş kişileri senkronize edilemedi. |
600020 izleme | CustomerConfig senkronizasyonu devam ettiği için BroadWorks Harici Dizini Kullanıcı Senkronizasyonu devre dışı bırakılamıyor. |
600022 izleme | Işletmede sağlanan bir kullanıcı olmadığından BroadWorks Harici Dizini Tek Kullanıcı Senkronizasyonu mümkün değil. |
600023 izleme | Kullanıcı bu kuruluşta zaten mevcut olduğu için BroadWorks Harici Dizini Tek Kullanıcı Senkronizasyonu mümkün değildir. |
600024 izleme | BroadWorks'te eşleşen kullanıcı bulunmadığı için BroadWorks Harici Dizini Tek Kullanıcı Senkronizasyonu mümkün değildir. |
600025 izleme | BroadWorks Harici Dizini Kullanıcı Senkronizasyonu, CI’da kullanıcı hesabını güncelleyemedi. |
600026 izleme | BroadWorks Harici Dizini Kullanıcı Senkronizasyonu, CI'daki makine hesabı güncellenemedi. |
600027 izleme | BroadWorks'te birden fazla kullanıcı bulunduğu için BroadWorks Harici Dizini Tek Kullanıcı Senkronizasyonu mümkün değildir. |
600028 izleme | En az bir kurumsal dizin senkronizasyonunun tamamlanması gerektiğinden BroadWorks Harici Dizini Tek Kullanıcı Senkronizasyonu mümkün değildir. |
600029 izleme | BroadWorks Harici Dizin Kullanıcı Senkronizasyonu, kuruluş için sağlanmış kullanıcı bulunmadığından başarısız oldu. |
Geçmişi Değiştir
Aşağıdaki tabloda, bu makaledeki güncellemeler özetlenmektedir.
Tarih | Revizyon |
---|---|
14 Şubat 2023 | Dizin Senkronizasyonu Maksimumları ve Kaynak bölümü güncellendi. |
10 Aralık 2022 | Anında Senkronizasyonu Tamamla terimi Dizin Senkronizasyonunu Tetiklemek için güncellendi |
19 Temmuz 2022 Salı | Genel bakış bilgilerine ilişkin açıklamalar ve düzeltmeler:
|
09 Mayıs 2022 |
|
07 Nisan 2022 Salı |
|
28 Mart 2022 Pazartesi |
|
24 Mart 2022 Perşembe | Dizin Senkronizasyon Koşullarına eşitlenmiş telefon numarası türlerinin listesi eklendi. Senkronizasyon artık cep telefonu numaralarını içeriyor. |
16 Mart 2022 Salı |
|
17 Aralık 2021 |
|
16 Aralık 2021 |
|
08 Aralık 2021 |
|