워터 마크
2021년 3월 29일 | 명이 봄 | 명이 이 정보가 유용하다고 평가했습니다.

Webex for BroadWorks 문제 해결 안내서

Webex for BroadWorks의 문제 해결 조언 - "사용 방법" 주제, 로그 파일 목록 및 사용 정보, 특정 문제 조사를 위한 팁 포함.

Webex for BroadWorks 문제 해결

Webex for BroadWorks 문제 해결

Webex for BroadWorks 문제 해결

이 문서는 자신 및 고객을 지원하고 있는 서비스 제공자 조직의 기술 인력들을 위한 것입니다. 저희는 여러분이 일반적인 문제 해결, 로그 읽기 및 구독자 사례 처리에 어느 정도 친숙하기를 기대합니다.

이 문서는 3개의 주요 부분으로 나뉘어 있습니다.

  • 리소스 - 도구 목록, 읽기 자료, 로그 및 사용자가 필요할 수 있는 연락처 목록입니다.
  • 프로세스 - 고객 문제를 해결하는 동안 취할 수 있는 몇 가지 조치를 설명합니다.
  • 구체적인 문제 - 발생할 수 있는 문제, 이를 발견하는 방법 및 해결할 수 있는 방법들을 범주화하여 나열합니다.

변경 이력

날짜

변경

섹션

2020년 12월 8일

문서 업데이트. Webex Teams를 Webex(앱)로 리브랜딩.

최종 사용자 오류 코드 추가

구체적인 문제

2020년 11월 3일

통화 설정 웹뷰 추가

구체적인 문제

2020년 10월 22일

새로운 문서 소개

워터 마크
2021년 3월 29일| 명이 봄 | 명이 이 정보가 유용하다고 평가했습니다.

리소스

Webex for BroadWorks 문제 해결 리소스

연락처


2020년 10월부터 당사는 BroadSoft 고객 지원을 Cisco CX 지원 프로세스 및 도구로 마이그레이션하고 있습니다. 이는 Webex for BroadWorks 파트너들이 사례 관리를 위해 Xchange를 사용하는 것에서 SCM(Support Case Manager)를 사용하는 것으로 이동해야 함을 의미합니다.

마이그레이션은 2020년 말까지 약 3개월 정도 진행될 것으로 예상합니다. BroadWorks/UCaaS TAC 팀은 귀사가 마이그레이션할 때 BroadSoft Jira 대신 CSOne / Lightning에서 사례 지원을 시작할 것입니다. 마이그레이션 기간 중에는 두 시스템 모두의 사례를 참조해야 할 수도 있습니다.

자세한 내용은 레거시 BroadSoft 지원 전환을 참조하십시오.

유용한 로그 파일

로그 이름 소스 문제 해결에 유용함
PSLog 응용프로그램 서버 플로우 쓰루 프로비저닝
tomcat access_log XSP Webex 앱 로그인
XsiActionsLog XSP Webex IDP 프록시와의 Webex 앱 로그인 상호 작용, 장치 프로필 쿼리를 위한 클라이언트 상호 작용
authenticationService 로그 XSP Webex 앱 로그인(토큰 유효성 검증 및 발급)
XSLog XSP?

푸시 알림의 모바일 구독

전화 시그널링

Webex 앱 시작 로그

Windows: \Users\{username}\AppData\Local\CiscoSpark\current_log.txt

Mac:

/Users/{username}/Library/Logs/SparkMacDesktop/current_log

모바일: 로그 보내기 사용

시작(시퀀스)

사용자의 자격 확인

BroadWorks에 연결하기 위한 BWC 라이브러리 초기화

getUserProfile & JwT 토큰 가져오기 로깅

BroadWorks 통화 Webex 앱 로그

클라이언트

Windows: \Users\{username}\AppData\Local\CiscoSpark\bwc\current_log.txt

Mac:

/Users/{username}/Library/Logs/SparkMacDesktop/bwc/current_log

모바일: 로그 보내기 사용

등록 및 통화에 대한 모든 SIP 트래픽

BWKS 백엔드에 대한 영구 활성 트래픽

시그널링이 필요한 통화 중 기능(보류/재시도, 전송 등)

미디어(Webex Media Engine) 로그

클라이언트

Windows:

\Users\{username}\AppData\Local\CiscoSpark\media\*.log

Mac:

/Users/{username}/Library/Logs/SparkMacDesktop/media/

모바일: 로그 보내기 사용

모든 미디어 로깅

통화를 위해 협상된 코덱

통화 중 기능

읽기 자료 목록

워터 마크
2021년 3월 29일| 명이 봄 | 명이 이 정보가 유용하다고 평가했습니다.

프로세스

Webex for BroadWorks 문제 해결 프로세스

문제 보고

문제 해결 지침을 수행한 후, 문제가 발견된 위치를 합리적으로 파악해야 합니다.

1

문제와 관련된 시스템에서 최대한 많은 정보를 수집합니다.

2

적절한 Cisco 팀으로 연락하여 사례를 접수시킵니다(연락처 섹션 참조).

수집할 클라이언트 정보

사례를 접수시키거나 문제를 보고해야 한다고 판단되면 사용자와 함께 문제를 해결하는 동안 다음 정보를 수집하십시오.

  • 사용자 식별자: CI 이메일 주소 또는 사용자 UUID(이것은 Webex 식별자이지만 사용자의 BroadWorks 식별자도 확보하면 도움이 될 것입니다.)

  • 조직 식별자

  • 문제가 발생한 대략적인 시간대

  • 클라이언트 플랫폼 및 버전

  • 클라이언트에서 로그 보내기 또는 수집

  • 클라이언트에 표시된 경우, 추적 ID 기록

헬프 데스크에서 사용자 세부 정보 확인

1

https://admin.webex.com/helpdesk에 로그인합니다.

2

사용자를 검색한 후 클릭합니다. 그러면 사용자 요약 화면이 열립니다.

3

자세한 사용자 이름 구성을 확인하려면 사용자 이름을 클릭합니다.

이 보기에서 볼 수 있는 유용한 정보는 사용자의 UUID, 공통 아이덴티티(CI) 클러스터, Webex 앱 클러스터, 통화 행동, BroadWorks 계정 GUID 등입니다.

4

다른 도구에서 이 정보를 사용하려면 복사를 클릭하거나 Cisco 사례에 첨부합니다.

헬프 데스크에서 고객 조직 보기

1

https://admin.webex.com/helpdesk에 로그인합니다.

2

고객 조직 이름을 검색한 후 클릭합니다.

3

고객 포털 보기가 표시될 때까지 아래로 스크롤하고, 고객 이름 보기를 클릭하여 사용자 및 구성이 포함된 고객 조직의 읽기 전용 보기를 조회합니다.

Partner Hub에서 사용자 로그 검색

데스크탑 및 모바일 클라이언트 문제를 해결할 때 파트너(및 TAC)가 클라이언트 로그를 볼 수 있는 것이 중요합니다.

1

사용자에게 로그를 보내도록 요청합니다.

2

사용자에게 통화 환경 내보내기를 실시하여 ced.dat 파일을 보내 달라고 요청합니다.

3

Partner Hub 또는 헬프 데스크에서 클라이언트 로그를 받습니다(아래 참조).

Partner Hub 옵션:

  1. Partner Hub에 로그인하고 사용자의 고객 조직을 찾습니다.

  2. 문제 해결을 선택합니다.

  3. 로그를 선택합니다.

  4. (이메일로) 사용자를 검색합니다.

  5. 클라이언트 로그를 조회하고 zip 파일로 다운로드합니다.

헬프 데스크 옵션:

  1. 헬프 데스크에 로그인합니다.

  2. 조직을 검색합니다.

  3. 조직을 클릭합니다(요약 화면이 열림).

  4. 아래로 스크롤하여 고객 보기를 클릭합니다.

  5. 문제 해결을 선택합니다.

  6. 로그를 선택합니다.

  7. (이메일로) 사용자를 검색합니다.

  8. 클라이언트 로그를 조회하고 zip 파일로 다운로드합니다.

클라이언트 버전을 찾는 방법

1

다음 링크를 사용자와 공유합니다. https://help.webex.com/njpf8r5.

2

사용자에게 버전 번호를 보내 달라고 요청합니다.

통화 서비스를 위한 클라이언트 확인

1

Webex 클라이언트에 로그인합니다.

2

통화 옵션 아이콘(위에 기어가 있는 수화기)이 사이드바에 있는지 확인합니다.

아이콘이 없으면 아직 사용자가 Control Hub에서 통화 서비스에 대해 활성화되지 않았을 수 있습니다.

3

설정/기본 설정 메뉴를 열고 전화 서비스 섹션으로 이동합니다. 로그인된 SSO 세션 상태가 보여야 합니다.

(Webex Calling 등 다른 전화 서비스가 표시되면 사용자가 Webex for BroadWorks를 사용하지 않는 것입니다.)

이 검증은 다음을 의미합니다.

  • 클라이언트가 필요한 Webex 마이크로 서비스를 성공적으로 통과했습니다.
  • 사용자가 성공적으로 인증했습니다.
  • 클라이언트에게 BroadWorks 시스템에서 장기 JSON 웹 토큰이 발급되었습니다.
  • 클라이언트가 장치 프로필을 검색하고 BroadWorks에 등록했습니다.

클라이언트 로그 또는 피드백 받기

  • Webex 데스크탑 클라이언트에서 특정한 클라이언트 로그를 찾거나 사용자에게 로그를 보내도록 요청하려면 리소스 섹션을 참조하십시오.

  • 모바일 클라이언트의 사용자에게 로그를 보내 달라고 요청한 후, Partner Hub 또는 헬프 데스크를 통해 이를 받을 수 있습니다.


로그 보내기는 비대화형 작업입니다. 그러나 사용자가 피드백을 보내면 이는 Cisco Webex 앱 개발팀으로 보내집니다. 나중에 Cisco에 확인하려면 사용자의 피드백 번호를 기록해 두십시오. 예:

통화 환경 데이터 받기

Webex 클라이언트 로그는 개인 식별 정보를 제거하기 위해 충분히 편집됩니다. 문제가 발견된 동일한 세션에 있는 클라이언트에서 통화 환경 데이터를 내보내야 합니다.

1

클라이언트에서 프로필 사진을 클릭한 후, 도움말 > 통화 환경 데이터 내보내기를 클릭합니다.

2

그 사용자의 통화 문제를 해결하기 위해 결과 파일 ced.dat를 저장합니다.

중요: 클라이언트에서 로그아웃하거나 클라이언트를 다시 시작하면 내부 캐시가 지워집니다. 그 후, ced.dat를 내보내면 내보낸 데이터는 캐시 전에 보내진 로그와 일치하지 않을 것입니다.

Webex 데이터베이스 초기화

1

클라이언트에서 도움말 > 상태 점검기를 클릭합니다.

2

데이터베이스 초기화를 선택합니다.

그러면 클라이언트의 완전한 초기화가 트리거되고, Webex 앱 로그인 화면이 로드됩니다.

Webex가 BroadWorks에 등록해야 하는지 확인

Webex 앱은 다음 정보를 확인하여 BroadWorks에 등록할지를 결정합니다.

  • broadworks-connector에 대한 사용자 자격

  • 조직 및 사용자의 통화 행동

사용자의 통화 행동 및 커넥터 자격 확인

  1. 파트너 관리자 자격 증명으로 헬프 데스크(https://admin.webex.com/helpdesk)에 로그인합니다.

  2. 사용자를 검색합니다.

  3. 사용자를 클릭하고 통화 행동 항목을 확인합니다. 이는 "Webex의 Calling"이어야 합니다.

  4. 사용자 이름을 클릭하여 사용자 세부 정보 화면을 엽니다.

  5. 아래로 스크롤하여 자격 섹션을 찾고, broadworks-connector가 포함되었는지 확인합니다.


    Webex for BroadWorks를 사용하려는 사용자는 bc-sp-standard 자격을 갖고 있지 않아야 합니다. 이는 "Webex Calling(Broadcloud)"에 대한 자격으로, Cisco가 관리하는 클라우드 통화 서비스를 통해 이루어지는 Webex 앱 통화입니다.

조직의 통화 행동 확인

  1. 파트너 관리자 자격 증명으로 헬프 데스크(https://admin.webex.com/helpdesk)에 로그인합니다.

  2. 조직을 검색합니다.

  3. 조직을 클릭하고, 통화 행동 항목을 확인합니다. 이는 Webex의 Calling"이어야 합니다.

사용자 프로비저닝 문제에 대한 PSLog 분석

응용프로그램 서버의 PSLog를 사용하여 프로비저닝 브리지에 대한 HTTP POST 요청과 Webex의 응답을 확인합니다.

정확한 작동 사례에서 이 응답은 200 OK이며,몇 분 후 사용자(및 첫 번째 고객인 경우, 새로운 고객 조직)가 Webex에서 만들어지는 것을 볼 수 있습니다.

POST에 보이는 이메일 주소를 헬프 데스크에서 검색하여 이것을 확인할 수 있습니다.

시작하기 전에

테스트 사용자를 사용한 플로우 쓰루 프로비저닝 시도 중에 응용프로그램 서버에서 PSLog를 수집합니다.

1

먼저 확인할 것은 HTTP 응답 코드입니다.

  • 200 OK 이외의 어떤 것도 사용자 프로비저닝 실패입니다.

  • 구독자 프로필에 대한 어떤 것이 프로비저닝 브리지 상류의 Webex 서비스에서 작동하지 않는 경우, 200 OK가 여전히 오류를 나타낼 수도 있습니다.

  • 400에는 메시지 노드가 응답에 들어 있을 수 있습니다. 프로비저닝 브리지가 subscriberProfile에서 무언가를 처리하지 못했습니다. 구독자 세부 정보에 어떤 문제가 있거나 템플릿에 있는 설정과 호환되지 않을 수 있습니다.

  • 401은 AS에 입력된 프로비저닝 자격 증명이 Partner Hub의 템플릿에 입력된 것과 일치하지 않음을 의미합니다.

  • 403은 응용프로그램 서버에서 어떤 것이 잘못 구성되었음을 나타낼 수 있습니다. 요청의 대상을 확인합니다. 이는 IP 주소가 아니고 Partner Hub의 템플릿에서 볼 수 있는 프로비저닝 브리지 URL이어야 합니다.

  • 409는 제공된 subscriberProfile과 기존 Webex 데이터 간의 충돌을 나타냅니다. 그 이메일 주소를 가진 기존의 사용자가 있는 것일 수 있습니다. 응답의 메시지를 확인하십시오.

2

또한 원래의 HTTP POST에서 프로비저닝 실패의 원인일 수 있는 모든 의심되는 값을 확인할 수도 있습니다.

POST에는 subscriberProfile XML 구조가 포함되어 있습니다. 이 안에서 확인할 수 있는 유용한 노드는 다음과 같습니다.

  • bwuserid: BroadWorks에서 구독자를 프로필을 편집해야 하는 경우, 이를 사용하여 찾으십시오.

  • group: 템플릿이 "서비스 제공자 모드"인 경우, 이는 소문자로 표기되며, Partner Hub에서 보이는 고객 조직의 이름이 됩니다.

  • 서비스제공자: 템플릿이 "기업 모드"인 경우, 이것은 소문자로 표기되며, Partner Hub에서 보이는 고객 조직의 이름이 됩니다.

  • 기본 전화번호: 반드시 존재해야 합니다. 이것이 없으면 프로비저닝이 실패합니다.

  • 이메일: Webex에서 사용자 ID가 됩니다. 유효하고 Webex에 고유해야 하며, 그렇지 않으면 프로비저닝이 실패합니다.


 

services 항목은 무시하십시오. 이것은 AS가 만들며, Webex는 이를 수락하지만 사용하지 않습니다.

구독자 로그인 문제를 해결하기 위한 XSP 로그 분석

이 흐름은 BroadWorks 인증 모드를 설명합니다. Partner Hub에서 BroadWorks 템플릿의 인증 모드를 볼 수 있습니다. 의 https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726고객 템플릿 구성을 참조하십시오.

다음의 래더 다이어그램은 사용자가 Webex 앱에서 BroadWorks 인증을 수행할 때 사용자, 클라이언트, Webex 서비스 및 BroadWorks 시스템 간의 상호 작용을 보여줍니다. 또한 Webex와 XSP 간의 연결은 MTLS에 의해 보호됩니다.

다음은 성공적인 로그인에 대해 로그를 조사할 때 볼 수 있는 정보에 대한 설명입니다.

그림 1. BroadWorks 인증 및 장치 구성

사용자가 클라이언트와 상호 작용하고, 클라이언트는 Webex 서비스와 상호 작용합니다.

  • 사용자는 이메일 주소를 Webex 앱에 제공합니다(다이어그램에서 1).

  • CI는 (UAP를 통해) BroadWorks 비밀번호를 입력하도록 이 사용자를 리디렉션하는 것을 알고 있습니다(다이어그램의 2).

  • IDP 프록시는 XSP의 Xsi 인터페이스로 프로파일 얻기 요청을 제출합니다.

tomcat access_log에서:

  • Webex에서 Xsi-Actions 인터페이스 쪽으로 구독자 프로필에 대한 GET 요청을 검색합니다(다이어그램의 2.1). 이것은 Webex 사용자 ID를 갖고 있습니다. 예:

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

XsiActionsLog에서:

  • Webex의 프로필 GET 요청을 검색합니다(다이어그램의 2.1). 이것은 Webex 사용자 ID를 갖고 있습니다. 예:

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

    헤더에는 인증이 포함되어 있습니다. Basicuser-agent: broadworksTeamsClient

  • 그 후, XSP는 BroadWorks에 대해 OCI-P 기본 인증을 수행하고(Xsi를 통해 기본 인증을 수행하는 다른 응용프로그램과 같이 AuthenticationVerifyRequest 및 AuthenticationVerifyResponse), UserGetRequest 및 ServiceProviderGetRequest로 구독자 정보도 수집합니다.

  • Webex에 대한 Xsi 응답에는 XML 프로필 블록 (BroadWorks 포함) userId 및 기타 세부 정보가 포함되어 있습니다(다이어그램의 2.2).

클라이언트 및 Webex 서비스 상호 작용:

  • IDP 프록시가 BroadWorks에서 받은 사용자 프로필을 대조하고, SAML 어설션(assertion)을 클라이언트로 발급합니다(다이어그램의 2.3).

  • 클라이언트는 SAML 어설션을 CI 토큰과 교환합니다(다이어그램의 3).

  • 클라이언트는 로그인한 사용자가 broadworks-connector 자격이 있는지 확인합니다(다이어그램의 4). 헬프 데스크에서 사용자 자격을 확인할 수 있습니다.

  • 클라이언트는 CI 토큰을 사용하여 IDP 프록시로 JSON 웹 토큰(JWT)을 요청합니다(다이어그램의 5).

  • IDP 프록시는 CI에서 CI 토큰의 유효성을 검증합니다.

  • IDP 프록시는 인증 서비스로 JWT를 요청합니다.

authenticationService 로그에서:

  • Webex의 토큰 요청을 검색합니다(다이어그램의 5.2). 예:

    GET /authService/token

    이는 http_bw_userid 헤더 및 다른 것을 갖고 있습니다.

  • XSP는 OCI-P UserGetLoginInfoRequest를 수행하여 제공된 사용자 ID가 BroadWorks 사용자와 일치하는지 검증합니다(다이어그램의 5.3). AuthService는 mTLS 연결을 통해 Webex와 트러스트를 설정했으므로 LLT를 발급할 수 있습니다.

  • LongLivedTokenManager의 응답을 검색합니다(다이어그램의 5.4) - 토큰 생성됨, 대상: bwksUserId@example.com, 발급자: BroadWorks ...

    StatusCode=200 이것을 trackingid: CLIENT… 헤더를 사용하여 원래의 요청과 연결시킬 수 있습니다.

XsiActionsLog에서:

  • 이제 클라이언트는 Xsi-Actions 인터페이스에서 장기 토큰을 제시하여 장치 프로필을 얻을 수 있습니다(다이어그램의 6). 예:

    GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device

    헤더 인증 사용: 베어러 토큰user-agent: WebexTeams(변형/버전)

  • Xsi-Actions 인터페이스는 authservice(루프백 인터페이스에 있도록 구성됨)에 토큰을 포스트(POST)합니다. 예: 127.0.0.1:80 POST http://127.0.0.1:80/authService/token

    이것을 trackingid: CLIENT... 헤더(GET의 경우) 및 X-BROADSOFT-CORRELATION-ID : CLIENT... 헤더(POST의 경우)와 연관시킬 수 있습니다.

authenticationService 로그에서:

  • Xsi로부터 POST 수신(루프백)

  • StatusCode=200을 다시 Xsi로 보냄.

  • 그리고 본문에 "token" JSON 블록이 있는 토큰 유효성 검증 응답.

  • 다음을 사용하여 trackingid 연관됨: 클라이언트...

XsiActionsLog에서:

  • authservice에서 200 OK를 받음. 클라이언트의 토큰이 검증되었으며, Xsi-Actions 응용프로그램은 이제 UserPrimaryAndSCADeviceGetListRequest를 위한 OCI-P 요청을 보냅니다.

  • OCI-P UserPrimaryAndSCADeviceGetListResponse(accessDeviceTable XML 구조 포함)를 받습니다.

  • OCI-P 응답은 AccessDevices XML 구조를 포함하여 클라이언트에 대한 Xsi 응답으로 인코딩됩니다. 이는 deviceTypes(예: Business Communicator – PC) 및 클라이언트가 장치 구성 파일을 검색할 수 있는 URL을 갖고 있습니다.

클라이언트는 정상적으로 계속합니다.

  • 장치 항목을 선택하고, DMS와 상호 작용하여 장치 프로필을 받습니다(다이어그램의 6).

  • DMS의 구성에서 검색한 SBC를 통해 BroadWorks에 등록합니다(다이어그램의 7).

워터 마크
2021년 3월 29일| 명이 봄 | 명이 이 정보가 유용하다고 평가했습니다.

구체적인 문제

Webex for BroadWorks 문제 해결 관련 문제

Partner Hub 문제

관리자가 고객 조직을 볼 수 없음

Webex에서 파트너 조직의 관리자는 전체 관리자 역할을 수행합니다. 이 역할은 관리자가 자신 및 다른 사용자에게 관리 권한을 지정하는 것을 포함하여 파트너 조직을 관리하는 데 사용됩니다. 고객 조직을 관리하려는 관리자는 자신(또는 다른 사용자)에게 영업 전체 관리자 역할 또는 영업 관리자 역할을 부여해야 합니다. https://help.webex.com/fs78p5을(를) 참조하십시오.

사용자 프로비저닝 문제

특정 기업 / 고객에 관한 통합 IM&P 오류

다양한 클라우드 협업 서비스(예: UC-One SaaS 및 Webex for BroadWorks 등)를 사용하는 기업들이 혼합되어 있는 경우, 기업 단위로 프로비저닝 어댑터를 수정하도록 선택할 수 있습니다.

통합 IM&P에 대해 구성된 것(보다 구체적인 설정이 존재하지 않는 한, 기업의 기본값)을 확인하려면 AS_CLI/Interface/Messaging> get을 실행하십시오. 특정 기업의 프로비저닝 파라미터에서 기업을 열고 서비스 > 통합 IM&P로 이동하십시오.

해당 기업의 통합 IM&P 구성이 Partner Hub의 고객 템플릿에 표시되는 것과 일치하는지 확인합니다. 다음 설정은 반드시 일치해야 합니다. 그렇지 않으면 기업의 모든 사용자에서 프로비저닝이 실패합니다.

BroadWorks 기업 통합 IM&P 설정

Partner Hub 고객 템플릿 설정

메시징 서버 URL

프로비저닝 URL

메시징 서버 사용자 이름

프로비저닝 계정 이름

메시징 서버 비밀번호

프로비저닝 계정 비밀번호, 비밀번호 확인

특정 사용자에서의 통합 IM&P 오류

이는 플로우 쓰루 프로비저닝을 사용하고 있으며, 일부/대부분의 사용자에서 프로비저닝이 작동하고 있는 것으로 가정하는 경우에 적용됩니다(그러므로 구성 문제를 배제할 수 있음).

BroadWorks에서 "[오류 18215] 메시징 서버에서 프로비저닝 오류" 및 "[오류 18211] 메시징 서버와의 통신 오류"와 같은 통합 IM&P 오류가 발생하는 경우, 다음과 같은 잠재적 원인을 조사해야 합니다.

  • 사용자의 이메일 주소가 이미 CI에 존재할 수 있습니다. 사용자의 이메일 주소가 이미 있는 경우, 헬프 데스크에서 사용자를 검색하십시오. 사용자가 조직에 존재하지만 그의 데이터를 헬프 데스크에서 보는 것이 허용되지 않을 수도 있기 때문에 이것이 반드시 확정적인 것은 아닙니다.

  • 사용자가 통합 IM&P 서비스를 지정하기 전에 독립적으로 Webex에 가입했습니다. 이런 경우, 한 가지 옵션은 사용자가 그의 무료 계정을 삭제하게 한 후 그 사용자가 현재 프로비저닝하는 고객 조직의 일부가 될 수 있도록 하는 것입니다. 지침은 https://help.webex.com/5m4i4y에 있습니다.

  • 사용자에게 프로필에 지정된 기본 전화번호가 없습니다(모든 Webex for BroadWorks 구독자는 기본 DID가 있어야 함). AS에서 PSLog 분석에 대한 주제를 참조하십시오.

프로비저닝 브리지로부터의 응답에서 사용자 프로비저닝 실패

사용자가 Control Hub에 나타나지 않는 경우, 통합 IM&P를 지정한 지 몇 분 내에 프로비저닝 브리지 서비스의 응답 코드를 살펴보십시오. PSLog를 실행하여 HTTP 응답 코드를 살펴보십시오.

200 OK

200 OK 응답은 사용자가 성공적으로 프로비저닝되었음을 의미하지 않습니다. 이는 프로비저닝 서비스가 요청을 수신하고, 해당 사용자 만들기 요청을 상류의 서비스에 성공적으로 제출했다는 의미입니다.

프로비저닝 트랜잭션은 설계상 비동기적입니다. 사용자 만들기 프로세스는 몇 분 정도 소요될 수 있는데, 성능상의 이유로 저희는 동일한 사용자를 만들기 위한 요청을 여러 개 받는 것을 원치 않으므로 이 서비스는 200 OK로 응답합니다.

그러나 200 OK 응답 이후에 사용자가 고객 조직에 나타나지 않는다면 그것은 프로비저닝 서비스 상류의 Webex 서비스에서 사용자 만들기가 실패한 것임을 나타낼 수 있습니다.

200 OK 응답을 받은 프로비저닝 실패는 보고해야 합니다.

400 잘못된 요청

프로비저닝 서비스에서 이 응답을 유발할 수 있는 잠재적인 문제에 대한 보다 자세한 설명이 있는 HTTP 응답을 확인하십시오. <message> 노드의 일부 예:

  • "BroadWorks 이메일을 레거시 프로비저닝 API를 사용하여 신뢰할 수 없습니다."

    사용자 프로비저닝 요청 실패와 관련된 이메일 주소가 유효하지 않거나 잘못 입력되었으나 관리자가 그 이메일 주소를 신뢰할 수 있다고 템플릿에서 어설션(assert)했습니다. BroadWorks의 사용자 프로필, 특히 이메일 ID를 확인합니다.

  • "고객 조직을 데이터베이스에서 찾을 수 없으며, 새로운 조직 플래그도 활성화되지 않았습니다."

    이 실패한 프로비저닝 요청은 Webex에서 새로운 고객 조직을 만들어야 하지만 새 고객 조직을 만들지 못하도록 템플릿이 구성되었습니다. 새 조직을 허용하려면 Webex에 있는 기존의 고객과 일치하지 않는 이메일 도메인일 경우, Partner Hub에서 템플릿을 다시 구성하고 프로비저닝 요청을 다시 테스트할 수 있습니다. 그러나 이 사용자에 대해 새로운 조직이 만들어지는 것을 예상하지 않았다면 이메일 주소가 잘못 입력되었을 것입니다(특히 도메인 부분). BroadWorks에서 사용자의 이메일 ID를 확인합니다.

403 금지됨

프로비저닝 요청이 성공할 가능성이 없습니다. 이런 경우, 요청 및 응답을 조사해야 합니다. 예를 들어, 조직에 대해 적절한 프로비저닝 브리지 URL 대신 IP 주소가 프로비저닝 요청의 대상으로 보인다면(솔루션 안내서에서 방화벽 구성 주제 참조) 이것은 응용프로그램 서버에 필요한 패치(ap373197)가 없음을 나타내는 것일 수 있습니다.

필요한 모든 패치가 응용프로그램 서버에 적용되고, 성공적인 플로우 쓰루 프로비저닝을 위한 관련 구성을 완료했는지 확인합니다.

409 충돌

요청에 있는 이메일 주소와 일치하는 기존의 사용자가 Webex에 있기 때문에 프로비저닝 요청을 진행할 수 없습니다.

사용자가 이미 CI에 있음

구독자 이메일을 HTTP POST 요청에서 제거하고 헬프 데스크에서 검색합니다.

권한이 없으면 해당 사용자를 보지 못할 수 있지만 그 사용자가 '무료' 조직(예: "소비자")에 있다면 볼 수도 있습니다.

그 사용자에게 무료 계정을 삭제하도록 요구하거나 다른 이메일 주소를 사용하여 계정을 프로비저닝할 수 있습니다. https://help.webex.com/ndta402을(를) 참조하십시오.

사용자 로그인 문제

사용자 활성화 포털이 로드되지 않음

정상적인 Webex for BroadWorks 로그인 흐름에는 사용자가 비밀번호를 입력하는 사용자 활성화 포털이 포함됩니다. 가끔 사용자가 Webex 앱 로그인 화면에서 이메일 주소를 제공한 후에 이 포털이 로드되지 않을 때가 있습니다.

이 문제는 클라이언트 측 또는 서비스 측에서 발생할 수 있습니다. 클라이언트 측에서는 일반적으로 클라이언트의 고유 브라우저가 서비스와 어떤 식으로든 호환되지 않아서 발생합니다.

통합 인증 실패

  • BroadWorks에서 사용자에게 Webex 앱을 위한 장치 유형이 지정되었는지 확인합니다(솔루션 안내서의 장치 프로필(환경 준비 섹션) 참조).

  • 사용자가 정확한 비밀번호를 사용하고 있는지 확인합니다. 사용자의 고객 조직(Partner Hub 내)을 프로비저닝하는 데 사용한 템플릿이 BroadWorks 인증으로 구성된 경우, 사용자는 그의 BroadWorks "웹 액세스" 비밀번호를 입력해야 합니다.

통화 구성 및 등록 문제

사용자가 Webex에서 프로비저닝되고 Webex 앱에 성공적으로 로그인하면 앱이 BroadWorks에 등록됩니다. 다음은 예상 등록 순서 및 성공적인 등록 결과의 표시입니다(Webex 앱에서 볼 수 있음).

예상 등록 순서

  1. 클라이언트는 XSI를 호출하여 장치 관리 토큰 및 DMS로의 URL을 얻습니다.

  2. 클라이언트는 1단계의 토큰을 제시하여 DMS로 장치 프로필을 요청합니다.

  3. 클라이언트는 장치 프로필을 읽고 SIP 자격 증명, 주소 및 포트를 검색합니다.

  4. 클라이언트는 3단계의 정보를 사용하여 SIP REGISTER를 SBC로 보냅니다.

  5. SBC는 SIP REGISTER를 AS로 보냅니다(SBC는 SIP 사용자를 이미 알지 못하는 경우, NS에서 검색을 수행하여 AS를 찾을 수 있음).

예상되는 성공적인 클라이언트 등록의 표시

Webex 인터페이스에 통화 옵션 아이콘이 나타납니다.

Webex 앱 전화 서비스 탭(예: Windows의 설정 > 전화 서비스, Mac의 기본 설정 > 전화 서비스)에서 "SSO 세션: 로그인되었습니다"라는 메시지는 앱이 (이 경우는 BroadWorks에) 성공적으로 등록되었음을 의미합니다.

클라이언트에 통화 아이콘이 없음

대부분의 경우, 이는 사용자가 정확한 라이센스/자격을 갖고 있지 않다는 의미입니다.

클라이언트가 전화 서비스 탭을 표시하지만 SSO 세션은 없음

이것은 등록 실패입니다. Webex 앱 클라이언트가 BroadWorks에 등록되지 않는 데는 여러 가지 이유가 있습니다.

동일한 클라이언트에서 여러 차례 통화 서비스 테스트

이 문제는 클라이언트가 여러 개의 통화 백엔드를 변경하기 때문에 발생할 수 있습니다. 이는 (동일한) Webex 앱 클라이언트를 통해 제공되는 다양한 통화 서비스의 시험 중에 발생할 가능성이 가장 큽니다. 클라이언트 데이터베이스(링크)를 재설정하여 이 문제를 해결할 수 있습니다.

인증 서비스의 잘못된 구성

솔루션 안내서에서 인증 서비스를 호스팅하는 XSP를 확인합니다(Webex for BroadWorks XSP의 서비스 구성 참조). 구체적으로:

  • RSA 키(한 XSP에서 생성하는 것)는 모든 XSP에 복사됩니다.

  • 인증 서비스 URL이 모든 XSP의 웹 컨테이너에 제공되고, Partner Hub의 클러스터에 정확하게 입력되었습니다.

  • 인증서에 의해 외부 인증이 구성됩니다.

    XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication>get
            
            allowUserApp = false
            allowClientApp = true
  • MTLS를 사용할 때 Webex 클라이언트 인증서를 XSP에 업로드해야 합니다(Partner Hub의 BroadWorks 설정 페이지에서 인증서를 얻을 수 있음).

BroadWorks 태그의 잘못된 구성

Webex 앱에 필요한 BroadWorks 태그를 구성했으며(솔루션 안내서에서 Webex에 필요한 BroadWorks 태그 섹션 참조), 충돌 또는 정확하지 않은 값이 있지 않은지 확인합니다.

특히 %SBC_ADDRESS_WXT% 태그는 Webex 앱 클라이언트를 위한 SIP registrar를 향한 SBC가 되어야 합니다.

성공적인 SSO 연결 후 데스크탑 클라이언트가 전화 서비스 연결을 끊음

이 문제는 동일한 사용자가 동일한 플랫폼 유형의 여러 클라이언트에 로그인함으로써 발생할 수 있습니다. 예를 들어, 사용자가 Windows에서 Webex 앱에 로그인한 후 다른 Windows 머신에서 Webex 앱에 로그인하는 경우, 한 머신에는 한 개의 활성 SSO 세션만 있습니다. 이는 설계에 의해 의도된 것입니다.

이 문제를 반드시 해결해야 하는 경우, BroadWorks가 동일한 장치 유형의 여러 인스턴스를 사용하도록 구성할 수 있지만 고유한 SIP 주소가 있어야 합니다. 이 구성은 Webex for BroadWorks의 범위를 벗어납니다.

데스크탑 장치가 사용자에 대해 프로비저닝되지 않음

다음의 서명을 클라이언트(\bwc\) 로그에서 볼 수 있습니다.

<Error> [0x70000476b000] BroadWorksConfigDownloader.cpp:106 onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - 장치 프로필 'Business Communicator - PC'를 찾을 수 없습니다.

통화 설정 웹뷰 문제

자기 관리 버튼/링크가 Webex 앱에 표시되지 않음

이 문제의 다른 증상은 버튼/링크가 표시되지만 그것을 클릭하면 외부 브라우저가 열리는 것입니다.

  • 필요한 클라이언트 구성 템플릿이 배포되었고, CSW 태그가 적절하게 설정되었는지 확인합니다(통화 설정 웹뷰 섹션(Webex for BroadWorks 솔루션 안내서) 참조).

  • Webex 앱이 BroadWorks에서 통화를 위해 등록되었는지 확인합니다.

  • Webex 앱이 CSWV를 지원하는 최신 버전인지 확인합니다.

자기 관리 버튼/링크를 클릭한 후 빈 페이지 또는 오류

일반적으로 Webex 앱의 이 동작은 BroadWorks XSP에서 CSWV 응용프로그램의 구성 또는 배포 문제를 나타냅니다.

CSWV 로그, 액세스 로그, config-wxt.xml 저장소 및 템플릿 파일을 포함하여 추가 조사를 위한 세부 정보를 수집한 후 사례를 보고하십시오.

최종 사용자 오류 코드

다음 표는 클라이언트 사용자 활성화 포털에 표시될 수 있는 최종 사용자 오류 코드를 요약한 것입니다.


이것은 오류 코드의 전체 목록이 아닙니다. 이 표는 현재 Webex 앱이 사용자에게 명확한 지침을 제공하지 않는 기존의 오류 코드만 제공합니다.
표 1. 최종 사용자 오류 코드

오류 코드

오류 메시지

200010

broadworks 사용자가 인증되지 않았기 때문에 자격 증명의 유효성을 검증하지 못함

200018

사용자가 잠겨 있어서 자격 증명의 유효성을 검증하지 못함

200019

셀프 활성화를 위한 사용자 추가 실패로 자격 증명의 유효성을 검증하지 못함

200022

사용자가 인증되지 않은 상태이기 때문에 이메일을 보내지 못함

200026

PartnerOrgUUID : {partnerOrgUUID} , BroadoworksUUID : {broadworksUUID} , ConfigSetUUID : {configSetUUID}에서 사전 점검 실패 또는 보류 중인 사용자의 부정확한 상태로 인해 이메일의 유효성을 검증하지 못함

200039

EmailId가 다른 조직에서 이미 사용 중이므로 이메일의 유효성을 검증하지 못함

200040

configSet이 customerConfig의 configSet과 일치하지 않으므로 이메일의 유효성 검증하지 못함

200041

사용자에게 이미 다른 충돌하는 서비스에 대한 자격이 있어서 자격이 충돌하므로 이메일의 유효성을 검증하지 못함

200042

이메일이 이미 다른 Broadworks UserId와 연결되어 있어서 이메일 유효성을 검증하지 못함

200043

사용자 고객 구성 매핑이 정확하지 않아서 이메일의 유효성을 검증하지 못함

200044

UserId가 이 Broadworks 클러스터에서 이미 사용 중이어서 이메일의 유효성을 검증하지 못함

200045

사용자가 이미 다른 조직에 속해 있어서 셀프 활성화를 통해 사용자를 추가하지 못함

200046

동일한 Broadworks 클러스터에 동일한 Broadworks UserId를 가진 여러 명의 보류 중인 사용자가 존재하여 셀프 활성화를 통해 사용자를 추가하지 못함

200047

UserId가 이 Broadworks 클러스터에서 이미 사용 중이어서 셀프 활성화를 통해 사용자를 추가하지 못함

200048

이메일 주소가 다른 BroadWorks UserId로 이미 프로비저닝되었으므로 셀프 활성화를 통해 사용자를 추가하지 못함

200049

UserId가 이 Broadworks 클러스터에서 이미 사용 중이어서 셀프 활성화를 통해 사용자를 추가하지 못함

200050

ProvisioningID가 구독자의 기업의 예상 provisioningID와 일치하지 않아서 셀프 활성화를 통해 사용자를 추가하지 못함

200051

이 요청에서 지정된 spEnterpriseId가 이 BroadWorks 클러스터에서 이미 프로비저닝된 서비스 제공자 또는 기업과 충돌하기 때문에 셀프 활성화를 통해 사용자를 추가하지 못함

이 문서가 도움이 되었습니까?

관련 문서

최근에 확인함

×