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 - the device profile 'Business Communicator - PC' is not found.

통화 설정 웹뷰 문제

자기 관리 버튼/링크가 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 클러스터에서 이미 프로비저닝된 서비스 제공자 또는 기업과 충돌하기 때문에 셀프 활성화를 통해 사용자를 추가하지 못함