디렉터리 동기화 개요

디렉터리 동기화는 Cisco BroadWorks용 Webex 사용자가 Webex 디렉터리를 사용하여 BroadWorks 서버에서 모든 통화 엔터티에 전화할 수 있게 합니다. 이 기능이 활성화되면 BroadWorks 서버의 전체 통화 디렉터리는 Webex 디렉터리에 동기화됩니다. 사용자는 Webex 앱에서 디렉터리에 액세스하고 BroadWorks 서버에서 통화 엔터티로 전화를 걸 수 있습니다.

디렉터리 동기화에는 전화 목록 및 사용자 통화 정보 모두에 대한 동기화가 포함됩니다. 동기화된 전화 목록 레코드는 Webex 디렉터리 내에서 두 개의 연락처 유형 중 하나에 작성됩니다.

  • 조직 연락처—해당 연락처는 조직에 대해 저장되고 조직에 있는 모든 사용자가 사용할 수 있습니다.

  • 사용자 연락처—해당 연락처는 사용자에 대해 저장되고 연락처를 소유하고 있는 사용자만 사용할 수 있습니다.


Cisco BroadWorks용 Webex 프로비저닝에는 메시징 사용자 및 연계된 통화 정보가 BroadWorks 서버에서 Webex 디렉터리로 기본 동기화되는 작업이 포함됩니다. 단, 기본 프로비저닝 동기화는 메시징이 활성화되지 않은 사용자 및 비-사용자 엔터티(예: 회의실 전화, 팩스 또는 헌트 그룹 번호)를 생략합니다. 디렉터리 동기화를 켜면 모든 통화 엔터티가 Webex 디렉터리에 추가되게 합니다.

디렉터리 동기화 조건

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

  • 기본적으로 첫 번째 동기화는 동기화를 활성화한 지 일주일 후에 실행됩니다(동기화 시작에 선택된 시간은 임의적임). 단, 고객 조직은 지금 동기화 옵션을 사용하여 한 주의 대기 기간을 바이패스하고 해당하는 고객 조직에 대해 즉시 동기화를 완료할 수 있습니다.

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

  • 동기화에 실패하면 다음 동기화 예약 시점까지 24시간마다 동기화가 자동으로 다시 시도됩니다.

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

  • Partner Hub에서 특정 고객의 동기화 상태 정보를 확인할 수 있습니다. 또한 마지막 동기화에 대한 자세한 정보를 CSV 기록으로 내보낼 수도 있습니다. CSV 기록은 Control Hub 표시보다 더욱 자세하게 나타나며, 문제 해결하기, 분석 및 감사 작업에 대해 지원할 수 있습니다.

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

  • 이 기능은 BroadWorks 서버에서 다음 전화 목록 유형을 동기화합니다.

    • 기업 공통 전화 목록

    • 그룹 공통 전화 목록

    • 개인 전화 목록

디렉터리 동기화 및 연락처 최댓값

다음은 각 Webex 연락처 유형에 대해 디렉터리 동기화가 허용하는 최대 연락처 수입니다.

  • 500 조직 연락처

  • 500 사용자 연락처—사용자의 경우 최댓값에는 동기화된 사용자 연락처 및 수동 연락처(사용자가 Webex 앱을 통해 수동으로 추가하는 연락처)가 포함됩니다.

다음 조건이 적용됩니다.

  • 조직에 한 카테고리에서 500개 이상의 연락처가 포함되는 경우, 동기화는 500-제한 임계값 이상의 항목을 제외합니다. 동기화 또는 생략된 연락처에 적용되는 특별한 순서는 없습니다.

  • 사용자가 Webex 앱에서 수동으로 연락처를 추가하는 경우, 사용자 연락처의 최댓값은 동기화된 사용자 연락처에서 수동 연락처를 빼는 방법으로 결정됩니다. 예를 들어, 사용자가 Webex 앱에서 수동으로 100개의 연락처를 추가하는 경우, 디렉터리 동기화는 해당 사용자에 대해 BroadWorks에서 최대 400개의 사용자 연락처가 동기화될 수 있게 허용합니다.

  • 고객 조직에 한 카테고리에서 500개 이상의 연락처가 포함되는 경우, Cisco에 사례를 제출하여 해당 조직을 디렉터리 동기화에서 제외할 것을 요청하는 것이 좋습니다.

다음 표는 Webex 연락처 유형을 기록이 동기화되는 BroadWorks 전화 목록으로 매핑합니다.

표 1. 디렉터리 동기화 연락처 유형 및 동기화 소스

Webex 연락처 유형

BroadWorks에서 동기화됨...

동기화에 사용된 API

조직 연락처

기업 공통 전화 목록

/directories/enterprisecommon

그룹 공통 전화 목록 (서비스 공급자 모드인 동안)**

/directories/groupcommon

사용자 연락처

그룹 공통 전화 목록 (기업 모드인 동안)**

/directories/groupcommon

개인 전화 목록

/directories/personal


**그룹 공통 전화 목록은 BroadWorks가 기업 모드 또는 서비스 공급자 모드인지 여부에 따라 다르게 동기화됩니다. isBroadWorksEnterprise 파라미터의 값(true 또는 false)은 목록이 동기화되는 방법을 결정합니다.

  • True—조직 연락처로 동기화

  • False—사용자 연락처로 동기화

업데이트

BroadWorks에서 연락처가 업데이트된 후 사용자의 Webex 앱에 업데이트가 표시될 때 다음 안내를 제공합니다.

  • 사용자가 앱을 다시 시작하거나 앱의 로컬 72시간 캐시 타이머가 만료되면 Webex 앱에 조직 연락처 업데이트가 표시됩니다.

  • 사용자 연락처 업데이트는 해당 사용자에 대해 즉시 Webex 앱에 표시됩니다.

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

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

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

디렉터리 동기화 전제 조건

토글 요구 사항

이 기능에 대해 다음 기능 토글이 존재합니다. Cisco BroadWorks용 Webex 담당자에게 연락하여 해당 기능을 설정하도록 확인합니다.

기능 토글

적용됨...

설명

webex-for-broadworks-phone-list-sync

파트너

필수 토글. 이 파트너 아래에 있는 모든 고객 조직에 대해 전화 목록 동기화를 활성화합니다.

활성화됨이어야 합니다.

webex-for-broadworks-phone-list-sync-disable

고객 조직

선택 사항 토글. 파트너 수준 및 고객 템플릿에 해당 기능이 활성화된 경우에도 특정 조직에 대한 전화 목록 동기화를 비활성화합니다.

특정 고객 조직에 대해 전화 목록 동기화를 비활성화하려는 경우만 이 토글을 적용합니다. 그렇지 않으면, 해당 기능을 비활성화된 채로 남겨둘 수 있습니다.


 
예를 들어, 이 토글을 500개 이상의 연락처를 요구하는 조직에 적용해야 합니다.

hidden-personal-contacts-enabled-ga

사용자

선택 사항 토글. 이 사용자가 완료한 디렉터리 검색에서 개인 연락처를 숨깁니다.

hidden-org-contacts-enabled-ga

사용자

선택 사항 토글. 이 사용자가 완료한 디렉터리 검색에서 조직 연락처를 숨깁니다.

미리 구성 요구 사항

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


아래 예에서는 XSP 서버를 사용하고 있다고 가정합니다. ADP 서버의 경우, (XSP_CLI)를 (ADP_CLI)로 교체합니다.
  • 속도 제한 값—다음 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 배포에 적용할 것을 권장합니다.


Cisco BroadWorks용 Webex의 최소 요구 사항을 구성하는 패치 요구 사항의 전체 목록을 확인하려면 BroadWorks 소프트웨어 요구 사항Cisco BroadWorks용 Webex의 솔루션 안내서를 참조하십시오.

디렉터리 동기화 활성화 (새 템플릿)

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

다음에 수행할 작업

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

디렉터리 동기화 활성화 (기존의 템플릿)

파트너 관리자는 템플릿을 사용하는 고객 조직에 대해 기능을 활성화하기 위해 기존의 고객 템플릿 내에서 다음 단계를 완료하여 디렉터리 동기화를 켤 수 있습니다.

1

Partner Hub에 로그인하고 설정을 선택합니다.

2

BroadWorks 통화로 스크롤하고 템플릿 보기를 클릭합니다.

3

적합한 고객 템플릿을 선택하고 BroadWorks 디렉터리 동기화까지 스크롤합니다.

4

이 템플릿을 사용하는 새로운 고객 조직에 대해 기본적으로 디렉터리 동기화를 활성화하려면:

  1. 새로운 모든 고객 조직에 대해 BroadWorks 디렉터리 및 전화 목록 동기화 활성화 토글을 켜짐으로 설정합니다.

  2. 저장을 클릭합니다.

5

이 템플릿을 사용하는 기존의 고객 조직에 대해 디렉터리 동기화를 활성화하려면:

  1. 고객 동기화 상태의 목록 표시를 클릭합니다.

  2. 해당 기능을 켜고자 하는 각 조직의 옆에 있는 체크 박스를 체크합니다.

  3. 동기화 활성화를 클릭합니다.


 

디렉터리 동기화를 비활성화하려는 경우, 상단의 절차를 따르십시오.

  • 4a 단계에서 이 템플릿을 사용하는 새로운 고객 조직에 대해 기본값으로 디렉터리 동기화를 비활성화하려면 새로운 모든 고객 조직에 대해 전화 디렉터리 동기화 활성화 토글을 꺼짐으로 설정합니다.

  • 5c 단계에서 동기화 비활성화를 클릭하여 기존의 조직에 대해 해당 기능을 끕니다.

다음에 수행할 작업

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

즉시 동기화 완료

지금 동기화 옵션은 파트너가 특정 고객 조직에 대해 주문형 동기화를 완료할 수 있게 합니다. 이 옵션은 개별 고객 조직에 대해서만 선택할 수 있습니다. 지금 동기화에 대한 일괄 옵션은 제공되지 않습니다.

1

Partner Hub(http://admin.webex.com)에 로그인하고 설정을 선택합니다.

2

BroadWorks 통화로 스크롤하고 템플릿 보기를 클릭합니다.

3

적합한 고객 템플릿을 선택하고 BroadWorks 디렉터리 동기화까지 스크롤합니다.

4

고객 동기화 상태의 목록 표시를 클릭합니다.

5

동기화하고자 하는 고객 조직에 대해 오른쪽에 있는 세 개의 점을 클릭하고 지금 동기화를 선택합니다.

6

새로 고침을 클릭하여 동기화 결과를 확인합니다.

동기화 기록을 CSV로 내보내기

파트너 관리자는 마지막 동기화에 대한 자세한 정보를 CSV 파일로 내보낼 수 있습니다. CSV 파일에는 Control Hub GUI보다 더욱 자세한 동기화 기록의 화면이 포함되며, 문제 해결하기 및 분석에 대해 지원할 수 있습니다.

1

Partner Hub(http://admin.webex.com)에 로그인하고 설정을 선택합니다.

2

BroadWorks 통화로 스크롤하고 템플릿 보기를 클릭합니다.

3

적합한 고객 템플릿을 선택하고 BroadWorks 디렉터리 동기화까지 스크롤합니다.

4

고객 동기화 상태의 목록 표시를 클릭합니다.

5

내보내기에 포함하고자 하는 각 조직의 옆에 있는 체크 박스를 체크합니다.

6

결과 내보내기를 클릭합니다.

디렉터리 동기화를 위한 공용 API

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

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

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

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

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

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

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

API로 다수의 기업 동기화

공용 API를 사용하여 여러 기업에 대해 디렉터리 동기화를 완료하려면 이 절차를 완료하십시오.

  • 디렉터리 동기화를 통해 한 번에 한 개의 기업만 동기화할 수 있습니다. 한 개보다 많은 기업을 동기화하려고 시도하는 경우, 429 오류를 수신합니다.

  • 한 기업의 동기화를 완료하는 데 소요되는 시간은 기업의 크기에 따라 다양합니다.

1

List BroadWorks Enterprises API를 실행하여 동기화하고자 하는 기업의 목록을 생성합니다.

  1. startWith를 기업이나 서비스 공급자 식별자의 시작 문자열로 설정합니다.

  2. 클릭 하십시오. 실행.

2

목록의 첫 번째 기업에서 기업용 디렉터리 동기화 트리거 API를 실행합니다.

  1. 기업 id를 입력합니다.

  2. syncStatusSYNC_NOW

  3. 클릭 하십시오. 실행.

    기업에 대해 즉시 동기화가 트리거됩니다. 이 동기화는 인스턴스 제한에 대해 한 개의 동기화로 계산됩니다.
3

몇 초 동안 기다린 후에 디렉터리 동기화 상태 확인 API를 실행하여 동기화 상태를 확인합니다.

  1. 기업 id를 입력합니다.

  2. 클릭 하십시오. 실행.

4

동기화를 마친 후 다음 기업에 대해 목록에 있는 2부터 4단계를 완료합니다. 전체 목록을 동기화할 때까지 해당 단계를 반복합니다.

디렉터리 동기화에 대한 오류 코드

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

오류 코드

오류 메시지

600000

Broadworks 외부 디렉터리 사용자 동기화에서 예기치 않은 오류가 발생했습니다.

600001

Broadworks 외부 디렉터리 사용자 동기화에 실패했습니다.

600002

완료하기 전에 Broadworks 외부 디렉터리 사용자 동기화가 종료되어야 합니다.

600003

Broadworks 외부 디렉터리 사용자 동기화가 부분적으로만 성공했습니다. 일부 고객 조직은 동기화되지 못했습니다.

600004

ConfigSet에 대해 Broadworks 외부 디렉터리 사용자 동기화가 활성화되지 않았습니다.

600005

ConfigSet에 대해 Broadworks 외부 디렉터리 사용자 동기화가 진행 중입니다.

600006

Broadworks 외부 디렉터리 사용자 동기화 스레드가 사용 중이거나 종료 중이기 때문에 추가 동기화 요청을 수락하지 않습니다. 나중에 다시 시도하십시오.

600007

CustomerConfig의 아이덴티티 조직을 찾을 수 없습니다.

600008

CustomerConfig를 파트너 조직에서 찾을 수 없습니다.

600009

Broadworks 외부 디렉터리 사용자 동기화를 실행할 수 없습니다. CustomerConfig에 연계된 Broadworks 클러스터가 사용 중입니다.

600010

Broadworks 외부 디렉터리 사용자 동기화를 실행할 수 없습니다. CustomerConfig에 연계된 broadworks 클러스터가 없습니다.

600011

CustomerConfig에 대해 Broadworks 외부 디렉터리 사용자 동기화가 활성화되지 않았습니다.

600012

Broadworks 외부 디렉터리 사용자 동기화를 실행할 수 없습니다. CustomerConfig에 대해 하이브리드 디렉터리 동기화가 이미 활성화되었습니다.

600013

사용자 및 머신 계정을 아이덴티티 스토어에 추가하기 위한 Broadworks 외부 디렉터리 사용자 동기화가 실패했습니다.

600014

Broadworks 클러스터에 연결하려고 시도하는 동안 Broadworks 외부 디렉터리 사용자 동기화가 실패했습니다. Broadworks의 오류 - %s.

600015

Broadworks 외부 디렉터리 사용자 동기화에서 아이덴티티 스토어에 있는 일치하는 사용자를 찾지 못했습니다.

600017

모든 사용자 및 기업/조직 연락처를 동기화하기 위한 BroadWorks 전화 목록 동기화에 실패했습니다.

600018

기업/조직에 있는 사용자에 대한 BroadWorks 전화 목록 동기화에 실패했습니다.

600019

기업/조직 연락처를 동기화하기 위한 BroadWorks 전화 목록 동기화에 실패했습니다.