디렉토리 동기화는 Cisco BroadWorks 사용자용 Webex가 Webex 앱에서 Webex 디렉토리를 사용하여 BroadWorks 서버에서 발신 엔터티에 전화할 수 있도록 합니다. 이 기능은 Webex 디렉토리에 사용자 프로비전의 일부가 아닌 BroadWorks 통화 정보를 동기화합니다.

Cisco BroadWorks 사용자 프로비전용 Webex는 Cisco BroadWorks 사용자(기본 전화 번호, 모바일 전화 번호, 내선)에 대한 Webex의 통화 세부 사항으로 Webex 디렉토리를 업데이트하지만, 외부 통화 기록은 생략합니다. 단, 디렉토리 동기화가 사용 중일 때 해당 기능은 다음 통화 기록을 Webex 디렉토리와 동기화합니다.

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

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

• BroadWorks 전화 목록 항목

다음 표는 BroadWorks 통화 기록을 요약하고 Webex 디렉토리에 추가된 방법을 보여줍니다.

디렉터리 동기화 조건

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

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

• 기본적으로 디렉터리 동기화는 각 고객에 대해 매주 실행됩니다. 각 동기화는 마지막 동기화가 지금 동기화로 수동으로 예약 또는 실행된지 여부와 관계없이 마지막 동기화 후 한 주에 실행됩니다.

• BroadWorks 클러스터당 동시 동기화의 최대 수는 두 개입니다. (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 를 입력하여 해당 기업에 대한 디렉터리 시스템 상태를 업데이트하고, 디렉터리 동기화를 활성화하거나 비활성화합니다.

• 기업에 대해 디렉터리 동기화 트리거—지정된 기업 id에 대해 즉시 동기화를 트리거하려면 이 API 방법을 사용합니다. 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 사양을 읽어보려면 로그인해야 합니다.

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

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