피드백을 보내 주셔서 감사합니다.
시스코 브로드웍스 XSP|ADPS용 웹엑스에서 서비스를 구성하세요
피드백이 있습니까?시스코 브로드웍스 XSP|ADPS용 웹엑스에서 서비스를 구성하세요
다른 XSP|ADP에서 NPS 응용 프로그램을 실행해야 해요. 해당 XSP|ADP의 요구 사항은 네트워크에서 통화 알림 구성에 설명되어 있어요.
XSP|ADP에 다음 애플리케이션/서비스가 필요해요.
|
서비스/애플리케이션 |
인증 필요해요 |
서비스/애플리케이션 목적 |
|---|---|---|
|
엑시-이벤트 |
TLS (서버가 클라이언트에 자체 인증) |
통화 제어, 서비스 알림 |
|
엑시액션스 |
TLS (서버가 클라이언트에 자체 인증) |
통화 제어, 액션 |
|
디바이스 관리 |
TLS (서버가 클라이언트에 자체 인증) |
통화 구성 다운로드 |
|
인증 서비스 |
TLS (서버가 클라이언트에 자체 인증) |
사용자 인증 |
|
컴퓨터 텔레포니 통합 |
mTL (클라이언트와 서버가 서로를 인증해요) |
텔레포니 프레즌스 |
|
통화 설정 웹뷰 애플리케이션 |
TLS (서버가 클라이언트에 자체 인증) |
Webex 앱 내 셀프 케어 포털에 사용자 통화 설정을 노출해요. |
이 섹션에서는 이러한 인터페이스에 TLS와 mTL의 필수 구성을 적용하는 방법을 설명하지만 XSP|ADP에 애플리케이션을 설치하려면 기존 문서를 참조해야 해요.
공동 거주 요건
-
인증 서비스는 Xsi 애플리케이션과 함께 있어야 해요. Xsi 애플리케이션은 서비스 인증을 위해 수명이 긴 토큰을 받아들여야 하기 때문이죠. 해당 토큰을 검증하려면 인증 서비스가 필요해요.
-
필요한 경우 인증 서비스와 Xsi를 같은 포트에서 실행할 수 있어요.
-
스케일에 필요한 다른 서비스/애플리케이션을 분리할 수 있어요 (예: 전용 장치 관리 XSP|ADP 팜).
-
Xsi, CTI, 인증 서비스, DMS 애플리케이션을 같은 곳에 배치할 수 있어요.
-
브로드웍스와 웹엑스 통합에 사용되는 다른 애플리케이션이나 서비스를 XSP|ADP에 설치하지 마세요.
-
NPS 애플리케이션을 다른 애플리케이션과 함께 배치하지 마세요.
엑시 인터페이스
Cisco BroadWorks 확장 서비스 인터페이스 구성 가이드에 설명된 대로 Xsi-Actions와 Xsi-Events 애플리케이션을 설치하고 구성하세요.
CTI 인터페이스에 사용되는 XSP|ADP에는 Xsi-Events 애플리케이션 인스턴스를 하나만 배포해야 해요.
브로드웍스와 웹엑스 통합에 사용되는 모든 Xsi-Events에는 애플리케이션/XSI-이벤트/일반 설정에 정의된 동일한 통화 제어 애플리케이션 이름이 있어야 해요. 예를 들자면:
ADP_CLI/어플리케이션/XSI-이벤트/일반 설정> 가져오기
콜컨트롤 애플리케이션 이름 = com.broadsoft.xsi-events
사용자가 Webex에 가입하면, Webex는 현재 상태 및 통화 기록에 대한 전화 통신 이벤트를 수신하기 위해 AS에서 사용자를 위한 구독을 생성해요. 구독은 CallControlApplicationName과 연결되어 있고 AS는 이 이름을 사용하여 어떤 Xsi-Events에 전화 통신 이벤트를 보낼지 알아요.
CallControl애플리케이션 이름을 변경하거나 모든 Xsi-Events 웹앱의 이름이 같지 않으면 구독 및 전화 통신 이벤트 기능에 영향을 미칠 수 있어요.
인증 서비스 구성하세요 (CI 토큰 검증 포함)
TLS와 함께 CI 토큰 검증을 사용하도록 인증 서비스를 구성하려면 이 절차를 사용하세요. R22 이상을 실행하고 시스템에서 지원하는 경우 이 인증 방법을 사용하는 것이 좋습니다.
상호 TLS (mTL) 도 인증 서비스의 대체 인증 방법으로 지원돼요 . 동일한 XSP|ADP 서버에서 실행하는 웹엑스 조직이 여러 개 있는 경우, CI 토큰 검증은 동일한 XSP|ADP 인증 서비스에 대한 다중 연결을 지원하지 않기 때문에 mTLS 인증을 사용해야 해요.
인증 서비스에 CI 토큰 검증 대신 mTL 인증을 구성하려면 서비스 구성 부록 (인증 서비스용 mTL 포함) 을 참조하세요.
현재 인증 서비스에 mTL을 사용하고 있다면 TLS와 함께 CI 토큰 검증을 사용하도록 재구성하는 것은 필수가 아니에요.
-
각 XSP|ADP 서버에 다음 패치를 설치하세요. 릴리스에 적합한 패치를 설치하세요.
-
R22의 경우:
-
R23의 경우:
-
R24의 경우—패치 필요 없어요
XSP에 대한 모든 참조에는 XSP 또는 ADP가 포함돼요.
-
-
각
XSP|ADP 서비스에 인증 서비스애플리케이션을 설치하세요.다음 명령을 실행하여 XSP|ADP의 인증 서비스 애플리케이션을 /AuthService 컨텍스트 경로에 활성화하세요.
XSP|ADP_CLI/유지 관리/관리 개체> 애플리케이션 인증 서비스 활성화 22.0_1.1123/인증 서비스인증 서비스를 XSP|ADP에 배포하려면 이 명령을 실행하세요.
XSP|ADP_CLI/유지 관리/객체 관리> 애플리케이션 배포 /인증 서비스브로드웍스 SW 관리자 /AuthService를 배포하는 중...
-
브로드웍스 빌드 2022.10부터 자바와 함께 제공되는 인증 기관이 자바의 새 버전으로 전환할 때 더 이상 브로드웍스 신뢰 저장소에 자동으로 포함되지 않아요. 인증 서비스가 액세스 토큰을 가져오기 위해 Webex에 TLS 연결을 열고, ID 브로커 및 Webex URL을 확인하려면 신뢰 저장소에 다음이 있어야 해요.
-
아이덴트러스트 커머셜 루트 CA 1
-
고 대디 루트 Certificate Authority - G2
다음 CLI에 이러한 인증서가 있는지 확인하세요.
ADP_CLI/시스템/SSL 일반 설정/트러스트/디폴트> 가져오기없으면 다음 명령을 실행하여 기본 자바 트러스트를 가져오세요.
ADP_CLI/시스템/SSL 일반 설정/트러스트/디폴트 > 자바 트러스트 가져오기또는 다음 명령으로 이러한 인증서를 수동으로 신뢰 앵커로 추가할 수 있어요.
ADP_CLI/시스템/SSL 일반 설정/트러스트/브로드웍스 > 업데이트 트러스트<alias><trustAnchorFile>ADP가 이전 릴리스에서 업그레이드되면 이전 릴리스의 인증 기관이 자동으로 새 릴리스로 가져오고 수동으로 제거하기 전까지 계속 가져오게 돼요.
인증 서비스 애플리케이션은 ADP_CLI/시스템/SSLCommonSettings/GeneralSettings의 피어 ID 유효성 확인 설정에서 제외되며 항상 피어 ID의 유효성을 검사해요. 이 설정에 대한 자세한 내용은 시스코 브로드웍스 X509 인증서 검증 FD를 참조하세요.
-
-
각 XSP|ADP 서버에서 다음 명령을 실행하여 ID 제공자를 구성하세요.
xsp|ADP_CLI/애플리케이션/인증 서비스/아이덴티티 프로바이더/시스코> get-
1단계부터 클라이언트 ID 클라이언트 ID 설정해요 -
활성화됨 TRUE로 설정했어요. -
클라이언트 시크릿 클라이언트-시크릿-프롬-스텝1로 설정해요 -
CI 응답 본문 최대 크기를 65536바이트로 설정해요 -
발급자 이름 설정<URL>-URL에 CI클러스터에 적용되는 발급자 이름 URL을 입력하세요. 다음 표 보세요. -
발급자 URL 설정 - URL에<URL>CI클러스터에 적용되는 발급자 URL을 입력하세요. 다음 표를 보세요. -
토큰을 FURL로 설정 - 팀<IdPProxy URL>클러스터에 적용되는 IdP 프록시 URL을 입력하세요. 다음 두 번째 표 보세요.
테이블 1이에요.발급자 이름 및 발급자 URL 설정 만약 CI 클러스터가... 발급자 이름과 발급자 URL을... 로 설정하세요. US-A
https://idbroker.webex.com/idbEU
https://idbroker-eu.webex.com/idbUS-B
https://idbroker-b-us.webex.com/idbCI 클러스터를 모르면 Control Hub 헬프 데스크 뷰의 고객 세부 정보에서 정보를 얻을 수 있어요.
테이블 2예요.토큰을 4로 설정했어요. 만약 팀즈 클러스터가... FURL의 토큰으로 설정해...(IdP 프록시 URL) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticateAFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticateAORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate-
팀 클러스터를 모르면 Control Hub의 헬프 데스크 뷰에 있는 고객 세부 정보에서 정보를 얻을 수 있어요.
-
테스트의 경우 URL의 "idp/authenticate" 부분을 "ping “으로 바꿔서 토큰인포URL이 유효한지 확인할 수 있어요.
-
-
다음 명령을 실행하여 Webex의 사용자 프로필에 있어야 하는 Webex 자격을 지정하세요.
XSP|ADP_CLI/애플리케이션/인증 서비스/ID 제공업체/Cisco/Scopes> 범위 설정 브로드웍스-커넥터:사용자 -
각 XSP|ADP 서버에서 다음 명령을 사용하여 Cisco 페더레이션용 ID 제공자를 구성하세요.
xsp|ADP_CLI/애플리케이션/인증 서비스/ID 제공업체/시스코/페더레이션> get-
FLURL로 설정했어요 https://cifls.webex.com/federation -
새로 고침 기간 (분) 으로 설정해요. 60이에요. -
새로고침 토큰 새로고침 토큰을 1단계부터 설정하세요.
-
-
다음 명령을 실행하여 FLS 구성이 작동하는지 확인하세요. 이 명령은 ID 제공자 목록을 반환해요.
xsp|ADP_CLI/애플리케이션/인증 서비스/아이덴티티 프로바이더/시스코/페더레이션/클러스터맵> 받기 -
각 XSP|ADP 서버에서 다음 명령을 사용하여 토큰 관리를 구성하세요.
-
XSP|ADP_CLI/애플리케이션/인증 서비스/토큰 관리 > -
세트 토큰은 어셔 브로드웍스예요 -
토큰 지속 시간을 720시간으로 설정했어요.
-
-
RSA 키 생성 및 공유. 한 XSP|ADP에서 키를 생성한 다음 다른 모든 XSP|ADP에 복사해야 해요. 다음 요인 때문이에요.
-
인증 서비스의 모든 인스턴스에서 토큰 암호화/암호 해독에 동일한 공개/개인 키 쌍을 사용해야 해요.
-
키 페어는 토큰 발행에 처음 필요할 때 인증 서비스에서 생성해요.
키를 순환하거나 키 길이를 변경하면 다음 구성을 반복하고 모든 XSP|ADP를 다시 시작해야 해요.
-
키 페어 생성에 사용할 XSP|ADP 하나를 선택해 주세요.
-
클라이언트 브라우저에서 다음 URL을 요청해서 클라이언트를 사용해 XSP|ADP에 암호화된 토큰을 요청하세요.
https://<XSP|ADP-IPAddress>/authService/token?키=베이스64URL (클라이언트 공개 키)(이렇게 하면 XSP|ADP에 개인/공개 키 쌍이 생성되지 않은 경우)
-
키 스토어 위치는 구성할 수 없어요. 키 내보내기:
XSP|ADP_CLI/애플리케이션/인증 서비스/키 관리 > 내보내기 키 -
내보낸 파일/var/Broadworks/TMP/AuthService.keys를 다른 XSP|ADP의 같은 위치에 복사하고 필요한 경우 이전 .keys파일을 덮어써요. -
다른 XSP|ADP에서 각각 키 가져오기:
XSP|ADP_CLI/애플리케이션/인증 서비스/키 관리 > 임포트키 /VAR/브로드웍스/TMP/AuthService.keys
-
-
웹 컨테이너에 인증 서비스 URL을 제공하세요. XSP|ADP의 웹 컨테이너에 토큰 유효성을 검사하려면 AuthService URL이 필요해요. 각 XSP|ADP에서:
-
인증 서비스 URL을 브로드웍스 커뮤니케이션즈 유틸리티의 외부 인증 서비스로 추가해요:
XSP|ADP_CLI/시스템/통신유틸리티/기본 설정/외부 인증/인증 서비스> URL 설정 http://127.0.0.1:80/authService -
컨테이너에 인증 서비스 URL을 추가하세요:
xsp|ADP_CLI/유지 보수/컨테이너 옵션> 추가 톰캣 BW.authService.authServiceURL http://127.0.0.1:80/authService이를 통해 Webex는 인증 서비스를 사용하여 자격 증명으로 제공된 토큰을 검증할 수 있어요.
-
get으로파라미터 확인해. -
XSP|ADP를 다시 시작해요.
-
인증 서비스에 대한 클라이언트 인증 요구 사항 제거 (R24만 해당)
R24에서 CI 토큰 검증으로 인증 서비스를 구성했다면 인증 서비스에 대한 클라이언트 인증 요구 사항도 제거해야 해요. 다음 CLI 명령 실행하세요.
ADP_CLI/Interface/HTTP/SSLCommonSettings/클라이언트 인증/웹앱> 인증 서비스 설정 클라이언트 인증 거짓이에요
HTTP 인터페이스에서 TLS와 암호 구성하기 (XSI 및 인증 서비스용)
인증 서비스, 엑시액션, 엑시이벤트 애플리케이션은 HTTP 서버 인터페이스를 사용해요 . 이러한 애플리케이션의 TLS 구성 가능 수준은 다음과 같아요.
가장 일반적 = 시스템 > 전송 > HTTP > HTTP 서버 인터페이스 = 가장 구체적이에요
다양한 SSL 설정을 보거나 수정하는 데 사용하는 CLI 컨텍스트는 다음과 같아요.
| 특이성 | CLI 컨텍스트 |
| 시스템 (글로벌) |
|
| 이 시스템의 전송 프로토콜 |
|
| 이 시스템의 HTTP예요 |
|
| 이 시스템의 특정 HTTP 서버 인터페이스 |
|
XSP|ADP에서 HTTP 서버 TLS 인터페이스 구성 읽는 중
-
XSP|ADP에 로그인하고 XSP|ADP_CLI/인터페이스/HTTP/HTTP 서버>로 이동하세요. -
get명령을 입력하고 결과를 읽어보세요. 인터페이스 (IP 주소) 와 각각에 대해 보안 여부와 클라이언트 인증 필요 여부를 확인해야 해요.
아파치 톰캣은 각 보안 인터페이스에 인증서를 요구해요. 필요한 경우 시스템에서 자체 서명된 인증서를 생성해요.
XSP|ADP_CLI/Interface/Http/HttpServer> get
HTTP 서버 인터페이스에 TLS 1.2 프로토콜 추가하기
Webex 클라우드와 상호 작용하는 HTTP 인터페이스는 TLSv1.2에 맞게 구성되어야 해요. 클라우드는 이전 버전의 TLS 프로토콜과 협상하지 않아요.
HTTP 서버 인터페이스에서 TLSv1.2 프로토콜을 구성하려면:
-
XSP|ADP에 로그인하고 XSP|ADP_CLI/인터페이스/HTTP/HTTP 서버/SSL설정/프로토콜로 이동하세요. -
get 443<interfaceIp>명령을 입력하면 이 인터페이스에서 이미 어떤 프로토콜이 사용되고 있는지 확인할 수 있어요. -
<interfaceIp>인터페이스에서 클라우드와 통신할 때
TLS 1.2를 사용할 수 있도록 하려면 add 443 TLSv1.2명령을 입력하세요.
HTTP 서버 인터페이스에서 TLS 암호 구성 편집하기
필수 암호를 구성하려면:
-
XSP|ADP에 로그인하고 XSP|ADP_CLI/인터페이스/HTTP/HTTP 서버/SSL설정/암호로 이동하세요. -
get 443<interfaceIp>명령을 입력하면 이 인터페이스에서 이미 어떤 암호가 사용되고 있는지 확인할 수 있어요. Cisco 권장 제품군 중 하나 이상이어야 해요 (개요 섹션의 XSP|ADP ID 및 보안 요구 사항 참조). -
<interfaceIp><cipherName>http 서버 인터페이스에 암호를 추가하려면
add 443명령을 입력하세요.XSP|ADP CLI에는 OpenSSL 사이퍼 스위트 이름이 아니라 IANA 표준 사이퍼 스위트 이름이 필요해요. 예를 들어
ECDHE-ECDSA-CHACHA20-POLY1305OpenSSL 암호를 HTTP 서버 인터페이스에 추가하려면 다음을 사용하세요.XSP|ADP_CLI/인터페이스/HTTP/HTTPSserver/SSLSettings/Ciphers>추가 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHA20_POLY1305어느 이름으로든 스위트를 찾으려면 https://ciphersuite.info/ 참조.
XSP|ADP, 애플리케이션 서버, 프로필 서버에서 장치 관리를 구성하세요
프로필 서버하고 XSP|ADP는 장치 관리에 필수예요. 브로드웍스 장치 관리 구성 가이드의 지침에 따라 구성해야 해요.
