Cisco BroadWorks용 Webex에서 디렉터리 동기화

디렉터리 동기화를 사용하면 Cisco BroadWorks용 Webex 사용자가 Webex 앱에서 Webex 디렉터리를 사용하여 BroadWorks 서버의 모든 통화 엔터티에 전화할 수 있습니다. 이 기능은 Webex 디렉터리에 사용자 프로비저닝의 일부가 아닌 BroadWorks 통화 정보를 동기화합니다.

Cisco BroadWorks용 Webex 사용자 프로비저닝은 Cisco BroadWorks용 Webex 사용자에 대한 통화 세부 정보(기본 전화 번호, 휴대폰 번호, 내선 번호)로 Webex 디렉터리를 업데이트하지만 외부 통화 기록은 생략합니다. 단, 디렉터리 동기화가 켜져 있으면 해당 기능은 다음 통화 레코드를 Webex 디렉터리에 동기화합니다.

• BroadWorks 전용 통화 사용자(Webex에 등록되지 않은 사용자)

• 비사용자 통화 엔티티(예: 회의실 전화, 팩스, 헌트 그룹 번호)

• BroadWorks 전화 목록 항목

다음 표는 BroadWorks 통화 레코드를 요약하고 Webex 디렉터리에 추가되는 방법을 보여줍니다.

디렉터리 동기화 조건

• 파트너 관리자는 파트너 수준에서 기능을 활성화해야 합니다. 파트너 관리자는 한 번의 작업으로 여러 고객 조직에 대해 해당 기능을 켜거나 끌 수 있습니다.

• 기본적으로 첫 번째 동기화는 동기화를 활성화한 지 일주일 후에 실행됩니다(동기화 시작에 선택된 시간은 임의적임). 단, 고객 조직은 지금 동기화 옵션을 사용하여 1주 대기 기간을 생략하고 특정 고객 조직에 대해 즉시 동기화를 트리거할 수 있습니다.

• 기본적으로 디렉터리 동기화는 각 고객에 대해 매주 실행됩니다. 각 동기화는 마지막 동기화가 예약되었는지 또는 지금 동기화를 사용하여 수동으로 트리거되었는지 여부와 관계없이 마지막 동기화 후 1주일 후에 발생합니다.

• BroadWorks 클러스터당 동시 동기화의 최대 수는 2개입니다. 한 개의 예약된 동기화 및 한 개의 주문형 동기화(API 또는 Partner Hub GUI를 통해). 단, 관리자는 동일한 BroadWorks에서 동시에 두 개의 주문형 동기화를 실행할 수 없습니다. 이 제한은 API를 통해 동기화를 시작했는지 또는 Partner Hub의 지금 동기화 옵션을 통해 시작했는지 여부에 관계 없이 존재합니다. 또한, Webex는 동일한 BroadWorks에서 동시에 실행되도록 예약된 두 개의 동기화를 예약하지 않습니다.

• 동기화 오류가 발생하는 경우, Webex는 다음 예약된 동기화까지 24시간마다 자동으로 동기화를 다시 시도합니다.

• 동기화는 전화 번호가 없는 사용자를 무시합니다.

• Partner Hub에서 특정 고객의 동기화 상태 정보를 확인할 수 있습니다. 또한 마지막 동기화에 대한 자세한 정보를 CSV 기록으로 내보낼 수도 있습니다. CSV 레코드는 Control Hub 디스플레이보다 자세한 내용을 제공하며, 문제 해결, 분석 및 감사에 도움이 될 수 있습니다.

• Webex는 사용자 연락처를 암호화된 형식으로 저장합니다. 연락처를 소유한 사용자만 암호 해독 키에 액세스할 수 있습니다.

• BroadWorks 전용 통화 사용자 및 비-사용자 통화 엔터티에 대해 이 기능은 BroadWorks에서 다음 전화 번호 유형을 동기화합니다.

  • 기본 전화번호

  • 모바일 전화 번호

  • 내선 번호

  그러나 동기화는 기본 전화 번호 또는 내선 번호가 없는 경우 동기화에서 BroadWorks 전용 통화 사용자 및 비-사용자 통화 엔터티를 제외합니다.

  BroadWorks 사용자 수준의 프라이버시 서비스 설정은 디렉터리 동기화의 일부로 지원되지 않습니다.

BroadWorks 전화 목록 및 연락처 최대값

디렉터리 동기화는 BroadWorks 전화 목록 항목을 Webex 연락처에 동기화합니다. 동기화된 항목은 다음 연락처 유형 중 하나에 추가됩니다.

• 조직 연락처—Webex는 해당 연락처를 조직에 저장합니다. 각 사용자는 조직의 조직 연락처에 액세스할 수 있습니다. 최대 연락처는 30000개입니다.

• 사용자 연락처—Webex는 해당 연락처를 사용자에 대해 저장합니다. 연락처를 소유하고 있는 사용자만 연락처 항목에 액세스할 수 있습니다. 최대값은 최대 2000개의 연락처(동기화된 연락처 1500개 + 수동 입력 연락처 500개)입니다.

다음 표는 연락처 소스에 대해 Webex 연락처 유형을 매핑합니다(BroadWorks 전화 목록에서 동기화되거나 수동으로 추가됨).

디렉터리 동기화가 연락처 최댓값을 처리하는 방법에 대해 다음 조건이 적용됩니다.

• 조직이 동기화에 대해 허용되는 최대 연락처(그룹당 30000 조직 연락처 또는 30000 그룹 공통 연락처)를 초과하는 경우 디렉터리 동기화는 최대 임계값 이상의 항목을 제외합니다. 동기화된 연락처 또는 생략된 연락처에 적용되는 특정 순서는 없습니다.

• 고객 중 한 명이 두 카테고리에서 허용되는 최대 연락처 수를 초과하는 경우, 해당 조직이 디렉터리 동기화에서 제외되도록 Cisco에서 사례를 제기할 것을 권장합니다.

• 수동 연락처는 Webex 앱에서 사용자가 수동으로 추가하는 연락처입니다. 사용자는 최대 500명의 수동 연락처를 추가할 수 있습니다. 수동 연락처는 Webex의 더 큰 사용자 연락처 카테고리에 속하지만 동기화에 포함되지 않습니다.

• 조직 연락처(30000) 및 그룹 연락처(그룹당 30000)에 대한 전체 결합 제한은 200000입니다.

업데이트

Webex 디렉터리에서 업데이트를 처리하는 방법은 다음과 같습니다.

• BroadWorks에서 연락처 이름이 변경되는 경우, 기존의 연락처는 Webex 디렉터리에서 삭제되고 새로운 연락처가 생성됩니다.

• BroadWorks에서 연락처 번호가 변경되는 경우, Webex는 Webex 디렉터리에 있는 기존의 연락처를 새로운 번호로 업데이트합니다.

관리자가 BroadWorks에서 연락처를 업데이트하면 사용자의 Webex 앱에 업데이트가 표시될 때 다음 조건이 요약됩니다.

• 업데이트가 BroadWorks 전용 통화 사용자 또는 비-사용자 통화 엔터티인 경우, 업데이트는 다음 디렉터리 동기화 직후 사용자의 Webex 앱에 표시됩니다.

• 업데이트가 BroadWorks 전화 목록 항목인 경우:

  • 사용자 연락처의 경우—업데이트는 다음 디렉터리 동기화 직후 사용자의 Webex 앱에 표시됩니다.

  • 그룹 연락처의 경우 - 업데이트는 다음 디렉터리 동기화 직후 사용자 Webex 앱에 표시됩니다.

  • 조직 연락처의 경우—Webex 디렉터리는 후속 디렉터리 동기화에서 업데이트되지만, 사용자는 Webex 앱을 다시 시작하거나 로컬 72시간 캐시 타이머가 만료될 때까지 Webex 앱에서 변경 사항을 확인할 수 없습니다.

다음 설정을 사용할 것을 권장합니다.

• 속도 제한 값—다음 OverloadControl 시스템 속성(XSP_CLI/Applications/Xsi-Actions/OverloadControl)을 설정합니다.

  • userDirectoryTransactionLimit—널(null) 값으로 설정합니다.

  • globalDirectoryTransactionLimit—널(null) 값으로 설정합니다.

  userDirectoryTransactionLimit 및 globalDirectoryTransactionLimit를 null 값으로 설정하는 것이 좋습니다. 단, 값을 지정하기로 결정하는 경우, 각 값은 transactionLimitPeriodSeconds(1로 지정됨)의 값보다 최소한 5배 크게 설정되어야 합니다.

• 거래 제한—다음 값(XSP_CLI/System/CommunicationUtility/DefaultSettings)을 설정합니다.

  • userTransactionLimit—최소 100으로 설정합니다.

  • transactionLimitPeriodSecs—1로 설정합니다.

• 호출 값—호출 시스템 등록 정보(XSP_CLI/Applications/Xsi-Actions/Paging)를 설정합니다.

  • defaultPageSize—50으로 설정합니다.

  • availableUserMaxLimit—100으로 설정합니다.

• CTI 인터페이스—해당 Webex CA 인증서를 CTI 인터페이스 트러스트 저장소로 업로드하고 CTI 인터페이스에서 클라이언트 인증을 활성화하십시오.

또한 BroadWorks 릴리즈에 따라 이 기능을 활성화하기 전에 다음 시스템 패치를 BroadWorks 배포에 적용할 것을 권장합니다.

• R22: AP.as.22.0.1123.ap368517

• R23: AP.as.23.0.1075.ap368517

• R24: 패치가 필요하지 않음

파트너 관리자는 새로운 템플릿을 만드는 동안 고객 템플릿에 대해 디렉터리 동기화를 활성화할 수 있습니다. 해당 템플릿에 지정된 새로운 고객 조직에는 디렉터리 동기화가 활성화됩니다. 자세한 내용은 Cisco BroadWorks용 Webex의 솔루션 안내서 내에 있는 Partner Hub에서 파트너 조직 구성에서 "고객 템플릿 구성"을 참조하십시오.

다음에 수행할 작업

Webex 앱에서 기능을 켜려면 사용자가 최소한 한 번 Webex 앱에서 연락처 탭을 클릭해야 함을 알립니다. 이는 한 번만 완료해야 합니다.

파트너 관리자가 관리하는 고객 조직에 대해 디렉터리 동기화 설정을 업데이트하고, 즉시 동기화를 시작하거나 동기화 상태 정보를 얻을 수 있는 공용 API를 developer.webex.com에서 사용할 수 있습니다. 디렉터리 동기화 방법은 BroadWorks Enterprises에서 그룹화됩니다.

• BroadWorks 기업 나열—이 API 방법을 사용하여 특정 서비스 공급자 아래에 있는 기업의 목록 및 각 기업의 정보를 확인합니다. id. 프로비저닝에서 spEnterpriseId 을(를) 지정됨으로 입력해야 합니다.

• BroadWorks 기업에 대해 디렉터리 동기화 업데이트—기업 id 을(를) 입력하여 해당 기업에 대한 디렉터리 동기화 상태를 업데이트하고, 디렉터리 동기화를 활성화하거나 비활성화합니다.

• 기업에 대해 디렉터리 동기화 트리거—특정 기업에 대해 즉시 동기화를 트리거하고자 하는 경우에 이 API 방법을 사용합니다. id. 에 대하여 syncStatus 에 대해 SYNC_NOW 명령어를 입력합니다.

• 기업에 대한 디렉터리 동기화 상태 확인—기업 id 을(를) 입력하고 실행하여 상태 및 trackingId 최신 동기화를 확인합니다. 귀하는 trackingID 을(를) 사용하여 Kibana 및 Grafana 등의 도구를 통해 추가 분석을 실행할 수 있습니다.

또한 관리자는 단일 사용자 API에 대해 트리거 디렉터리 동기화를 사용하여 단일 사용자에 대해 주문형 디렉터리 동기화를 트리거할 수 있습니다.

자세한 API 문서에 대해서는 https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide을(를) 참조하십시오.

https://developer.webex.com/docs/api/v1/broadworks-subscribers의 API 사양을 읽어보려면 로그인해야 합니다.

다음 오류 코드는 디렉터리 동기화에 적용됩니다.

다음 표는 이 문서에 대한 업데이트를 요약합니다.