디렉토리 동기화는 시스코 브로드웍스용 웹엑스 사용자가 웹엑스 앱의 웹엑스 디렉터리를 사용하여 브로드웍스 서버의 모든 발신 엔티티에게 전화를 걸 수 있게 해줘요. 이 기능은 사용자 프로비저닝의 일부가 아닌 브로드웍스 통화 정보를 Webex 디렉터리에 동기화해요.

Cisco BroadWorks용 Webex 사용자 프로비저닝은 Cisco BroadWorks 사용자를 위한 Webex 통화 세부 정보 (기본 전화 번호, 휴대폰 번호, 내선 번호) 로 Webex 디렉터리를 업데이트하지만 외부 통화 기록은 생략해요. 하지만 디렉토리 동기화가 켜져 있을 때, 이 기능은 다음 통화 기록도 Webex 디렉터리에 동기화해요.

• 브로드웍스에서만 전화를 거는 사용자들 (웹엑스에 온보딩하지 않은 사람들)

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

• 브로드웍스 전화번호 목록 항목

다음 표는 브로드웍스 통화 기록을 요약하고 Webex 디렉터리에 추가되는 방법을 보여줍니다.

디렉토리 동기화 조건

• 파트너 관리자가 파트너 수준에서 기능을 활성화해야 해요. 파트너 관리자는 한 번에 여러 고객 조직의 기능을 켜거나 끌 수 있어요.

• 기본적으로 초기 동기화는 동기화 활성화 후 1주일 후에 이루어져요 (동기화 시작 시간은 무작위로 선택). 하지만 고객 조직은 지금 동기화 옵션을 사용하여 1주일의 대기 기간을 건너뛰고 특정 고객 조직에 대해 즉시 동기화를 트리거할 수 있어요.

• 기본적으로 디렉토리 동기화는 고객별로 매주 실행돼요. 마지막 동기화가 예약되었는지 아니면 지금 동기화를 통해 수동으로 트리거되었든 상관없이 각 동기화는 마지막 동기화 후 1주일 후에 일어나요.

• 브로드웍스 클러스터당 최대 동시 동기화 수는 2개예요. 하나는 예약 동기이고 다른 하나는 온디맨드 동기화 (API 또는 파트너 허브 GUI를 통해) 예요. 하지만 관리자는 동일한 브로드웍스에서 두 개의 온디맨드 동기화를 동시에 실행할 수 없어요. 이 제한은 동기화가 API를 통해 시작되었는지 아니면 파트너 허브의 Sync Now 옵션을 통해 시작되었는지에 관계없이 존재해요. 게다가 웹엑스는 동일한 브로드웍스에서 두 개의 스케줄링된 동기화를 동시에 실행하도록 예약하지 않아요.

• 동기화 실패가 발생하면, Webex는 다음 예약된 동기화까지 24시간마다 자동으로 동기화를 다시 시도해요.

• 동기화는 전화번호 없는 사용자는 무시해요.

• 파트너 허브에서 특정 고객의 동기화 상태 정보를 볼 수 있어요. 또한 마지막 동기화에 대한 세부 정보를 CSV 레코드로 내보낼 수 있어요. CSV 레코드는 Control Hub 디스플레이보다 더 자세한 정보를 제공하며 문제 해결, 분석, 감사에 도움이 될 수 있어요.

• 웹엑스는 사용자 연락처를 암호화된 형식으로 저장해요. 연락처 소유한 사용자만 암호 해독 키에 접근할 수 있어요.

• 브로드웍스 전용 통화 사용자와 비 사용자 통화 엔티티의 경우, 이 기능은 브로드웍스의 다음 전화번호 유형을 동기화해요.

  • 기본 전화번호

  • 핸드폰 번호

  • 익스텐션

  하지만 동기화는 기본 전화번호나 내선 번호가 없는 경우 브로드웍스 전용 통화 사용자와 비사용자 발신 엔티티를 동기화에서 제외해요.

  브로드웍스 사용자 수준 개인 정보 보호 서비스 설정은 디렉토리 동기화의 일부로 지원되지 않아요.

브로드웍스 전화 목록과 최대 연락처

디렉토리 동기화는 브로드웍스 전화 목록 항목을 웹엑스 연락처와도 동기화해요. 동기화된 항목이 다음 연락처 유형 중 하나에 추가돼요.

• 조직 연락처—Webex는 조직에 대해 이러한 연락처를 저장해요. 각 사용자가 조직의 조직 연락처에 액세스할 수 있어요. 최대 연락처 30000개예요.

• 사용자 연락처—Webex는 사용자에 대해 이러한 연락처를 저장해요. 연락처 소유한 사용자만 연락처 항목에 접근할 수 있어요. 최대 연락처 2000개 (동기화된 연락처 1500개+수동 입력 연락처 500개) 까지입니다.

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

디렉토리 동기화가 최대 연락처 수를 처리하는 방식에는 다음 조건이 적용돼요.

• 조직이 동기화에 허용된 최대 연락처 수 (그룹당 조직 연락처 30000명 또는 그룹 공통 연락처 30000명) 를 초과하면 디렉토리 동기화는 최대 임계값을 초과하는 항목을 제외해요. 동기화되거나 누락된 연락처에는 특별한 순서가 적용되지 않아요.

• 고객 중 한 명이 어느 카테고리에서든 최대 허용 연락처 수를 초과하면 Cisco에 해당 조직을 디렉토리 동기화에서 제외하도록 사례를 제기하는 것이 좋아요.

• 수동 연락처는 사용자가 Webex 앱에서 수동으로 추가하는 연락처예요. 사용자가 수동 연락처 최대 500개까지 추가할 수 있어요. 수동 연락처는 Webex의 더 큰 사용자 연락처 범주에 속하지만 동기화에는 포함되지 않아요.

• 조직 연락처 (30000명) 하고 그룹 연락처 (그룹당 30,000명) 의 전체 합계 한도는 200000명이에요.

업데이트

다음은 Webex 디렉터리가 업데이트를 처리하는 방식이에요.

• BroadWorks에서 연락처 이름이 변경되면, 기존 연락처가 Webex 디렉터리에서 삭제되고 새 연락처가 생성돼요.

• 브로드웍스에서 연락처 번호가 변경되면, 웹엑스는 웹엑스 디렉터리의 기존 연락처를 새 번호로 업데이트해요.

관리자가 BroadWorks에서 연락처를 업데이트한 후, 다음 조건은 업데이트가 사용자의 Webex 앱에 표시되는 시기를 간략하게 설명합니다.

• 브로드웍스 전용 통화 사용자 또는 비 사용자 호출 엔티티에 대한 업데이트인 경우, 후속 디렉터리 동기화 후 즉시 사용자의 Webex 앱에 업데이트가 표시돼요.

• 브로드웍스 전화 목록 항목을 업데이트하는 경우:

  • 사용자 연락처용—후속 디렉터리 동기화 후 즉시 사용자의 Webex 앱에 업데이트가 표시돼요.

  • 그룹 연락처의 경우 - 후속 디렉터리 동기화 후 즉시 사용자 Webex 앱에 업데이트가 표시돼요.

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

다음 설정을 사용하는 것이 좋아요.

• 속도 제한 값 - 다음 과부하 제어 시스템 속성 (XSP_CLI/응용 프로그램/XSI-ACTIONS/오버로드 제어) 을 설정하세요.

  • 사용자 디렉토리 거래 한도—null로 설정됐어요.

  • 글로벌 디렉토리 거래 한도—null로 설정됐어요.

  사용자 디렉토리 트랜잭션 한도 및 글로벌 디렉토리 트랜잭션 제한을 null로 설정하는 것이 좋아요. 하지만 값을 할당하려면 각 값을 TransactionLimitPeriodSeconds (1이어야 함) 값의 다섯 배 이상으로 설정해야 해요.

• 거래 한도 - 다음 값을 설정하세요 (XSP_CLI/시스템/통신 유틸리티/기본 설정).

  • 사용자 거래 한도—최소 100으로 설정됐어요.

  • 거래 제한 기간 초 — 1로 설정됐어요.

• 페이징 값 - 페이징 시스템 속성 (XSP_CLI/응용 프로그램/XSI-ACTIONS/페이징) 을 설정하세요.

  • 기본 페이지 크기 - 50으로 설정돼요

  • 사용 가능한 사용자 최대 제한 - 100으로 설정됐어요

• CTI 인터페이스—CTI 인터페이스 신뢰 저장소에 Webex CA 인증서를 업로드하고 CTI 인터페이스에서 클라이언트 인증을 활성화해야 해요.

또한 브로드웍스 릴리스에 따라 이 기능을 활성화하기 전에 다음 시스템 패치를 BroadWorks 배포에 적용하는 것이 좋습니다.

• R22용: AP.AS.22.0.1123.AP368517용

• R23용: AP.AS.23.0.1075.AP368517용

• R24의 경우: 패치 필요 없어요

파트너 관리자가 새 템플릿을 만드는 동안 고객 템플릿에 디렉토리 동기화를 활성화할 수 있어요. 그 템플릿에 새로 배정되는 모든 고객 조직에는 디렉토리 동기화가 활성화돼요. 자세한 내용은 Cisco BroadWorks용 Webex용 솔루션 가이드 내의 파트너 허브에서 파트너 조직 구성의 “온보딩 템플릿 구성”을 참조하십시오.

다음에 뭘 해야 돼요

Webex 앱에서 기능을 켜려면 Webex 앱에서 연락처 탭을 한 번 이상 클릭해야 한다는 것을 사용자가 알고 있는지 확인하십시오. 한 번만 완료하면 돼요.

공개 API는 developer.webex.com에서 사용할 수 있어요. 파트너 관리자는 이를 통해 자신이 관리하는 고객 조직의 디렉토리 동기화 설정을 업데이트하거나, 즉시 동기화를 트리거하거나, 동기화 상태 정보를 얻을 수 있어요. 디렉토리 동기화 방법은 브로드웍스 엔터프라이즈 아래에 그룹화되어 있어요.

• 브로드웍스 엔터프라이즈 나열 - 특정 서비스 제공자에 속한 기업의 목록과 각 기업의 ID를 얻으려면 이 API 방법을 사용하세요. 프로비져닝에 할당된 SP엔터프라이즈 ID를 입력해야 해요.

• BroadWorks Enterprise의 디렉토리 동기화 업데이트 - 해당 기업의 디렉토리 동기화 상태를 업데이트하여 디렉토리 동기화를 활성화 또는 비활성화하려면 엔터프라이즈 ID를 입력하세요.

• 엔터프라이즈용 디렉터리 동기화 트리거 - 주어진 엔터프라이즈 ID에 대해 즉시 동기화를 트리거하려면 이 API 방법을 사용하세요. 동기화 상태의 경우 SYNC_NOW 명령을 입력하세요.

• 기업의 디렉토리 동기화 상태 가져오기 - 최신 동기화 상태 및 추적 ID를 가져오려면 엔터프라이즈 ID를 입력하고 실행하세요. 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 사양을 읽으려면 로그인해야 해요.

다음 오류 코드가 디렉토리 동기화에 적용돼요.

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