공동 상주 요구 사항

• 이런 인터페이스는 서비스 허가를 위해 장기 토큰을 수락해야 하기 때문에 인증 서비스는 Xsi 응용프로그램과 공동 상주해야 합니다. 그런 토큰의 유효성을 검증하려면 인증 서비스가 필요합니다.

• 인증 서비스 및 Xsi는 필요한 경우, 동일한 포트에서 실행할 수 있습니다.

• 규모에 필요한 다른 서비스/응용프로그램을 구분할 수도 있습니다(예: 전용 장치 관리 XSP|ADP 팜).

• Xsi, CTI, 인증 서비스 및 DMS 응용프로그램을 코로케이션할 수 있습니다.

• BroadWorks와 Webex 통합에 사용되는 XSP|ADP에 다른 응용프로그램 또는 서비스를 설치하지 마십시오.

• NPS 응용프로그램을 다른 응용프로그램과 코로케이션하지 마십시오.

Xsi 인터페이스

Cisco BroadWorks Xtended 서비스 인터페이스 구성 안내서에 기술된 바와 같이 Xsi-Actions 및 Xsi-Events 응용프로그램을 설치하고 구성합니다.

CTI 인터페이스에 사용되는 XSP|ADP에 한 개의 Xsi-Events 응용프로그램만 배포되어야 합니다.

Broadworks를 Webex에 통합하기 위해 사용되는 모든 Xsi-Events에는 Applications/Xsi-Events/GeneralSettings 아래에 정의된 동일한 callControlApplicationName이 있어야 합니다. 예:

ADP_CLI/Applications/Xsi-Events/GeneralSettings> 가져오기

callControlApplicationName = com.broadsoft.xsi-events

사용자가 Webex에 등록되면 Webex는 프레즌스 및 통화 기록에 대한 텔레포니 이벤트를 수신하기 위해 AS에서 사용자에 대한 가입을 만듭니다. 가입은 callControlApplicationName과 연결되며, AS는 이를 사용하여 텔레포니 이벤트를 전송하는 Xsi-Events를 알 수 있습니다.

인증 서비스 구성 (CI 토큰 유효성 검증)

이 절차를 사용하여 TLS에서 CI 토큰 유효성 검증을 사용하도록 인증 서비스를 구성하십시오. R22 이상을 실행하고 있으며 시스템에서 지원하는 경우, 이 인증 방법이 권장됩니다.

1. Cisco BroadWorks용 Webex에 대한 OAuth 자격 증명 얻기.

2. 각 XSP|ADP 서버에 다음 패치를 설치합니다. 릴리즈에 적절한 패치를 설치하십시오.

   • R22:

     AP.platform.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap368601

   • R23:

     AP.xsp.23.0.1075.ap376509

     AP.platform.23.0.1075.ap376509

   • R24 — 패치 필요 없음.

   XSP에 대한 참조에는 XSP 또는 ADP가 포함됩니다.

3. 각 XSP ADP 서비스에 AuthenticationService| 응용프로그램을 설치합니다.

   1. 다음 명령어를 실행하여 XSP|ADP에서 /authService 컨텍스트 경로에 대한 AuthenticationService 응용프로그램을 활성화합니다.

      XSP|ADP_CLI/Maintenance/ManagedObjects> 애플리케이션 인증 서비스 22.0_1.1123/authService 활성화

   2. 이 명령어를 실행하여 XSP|ADP에 AuthenticationService를 배포합니다.

      XSP|ADP_CLI/Maintenance/ManagedObjects> 배포 응용프로그램 /authServiceBroadWorks SW 관리자 배포 /authServiceBroadWorks...

4. Broadworks 빌드 2022.10부터 Java와 함께 제공되는 인증 기관은 새로운 버전의 Java로 전환할 때 더 이상 BroadWorks 신뢰 저장소에 자동으로 포함되지 않습니다. AuthenticationService는 액세스 토큰을 가져오기 위해 Webex에 대한 TLS 연결을 열고, IDBroker 및 Webex URL의 유효성을 검증하려면 truststore에 다음 항목이 있어야 합니다.

   • IdenTrust Commercial Root CA 1

   • Go Daddy Root Certificate Authority - G2

   다음 CLI 아래에 해당 인증서가 존재하는지 확인합니다.

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> 가져오기

   존재하지 않는 경우 다음 명령을 실행하여 기본 Java 트러스트를 가져옵니다.

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> JavaCATrust 가져오기

   또는 다음 명령을 사용하여 이러한 인증서를 신뢰 앵커로 수동으로 추가할 수도 있습니다.

   ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust

   이전 릴리즈에서 ADP가 업그레이드된 경우 이전 릴리즈의 인증 기관은 새로운 릴리즈로 자동으로 가져오고 수동으로 제거될 때까지 계속 가져옵니다.

   AuthenticationService 응용프로그램은 ADP_CLI/System/SSLCommonSettings/GeneralSettings 아래에 있는 validatePeerIdentity 설정에서 제외되며, 항상 피어 ID의 유효성을 검증합니다. 이 설정에 대한 자세한 정보는 Cisco Broadworks X509 인증서 유효성 검증 FD 를 참조하십시오.

5. 각 XSP|ADP 서버에서 다음 명령어를 실행하여 ID 공급자를 구성합니다.

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get

   • set clientId client-Id-From-Step1

   • set enabled true

   • clientSecret 설정 client-Secret-From-Step1

   • set ciResponseBodyMaxSizeInBytes 65536

   • set issuerName —URL에 대해 CI 클러스터에 적용되는 IssuerName URL을 입력합니다. 다음 표를 참조하십시오.

   • set issuerUrl —URL에 대해 CI 클러스터에 적용되는 IssuerUrl을 입력합니다. 다음 표를 참조하십시오.

   • set tokenInfoUrl —Teams 클러스터에 적용되는 IdP 프록시 URL을 입력합니다. 다음 두 번째 표를 참조하십시오.

   표 1. issuerName 및 issuerURL 설정

   만약 CI 클러스터가...	issuerName 및 issuerURL을 다음으로 설정...
   US-A	https://idbroker.webex.com/idb
   EU	https://idbroker-eu.webex.com/idb
   US-B	https://idbroker-b-us.webex.com/idb
   CI 클러스터를 모르는 경우, Control Hub의 헬프 데스크 보기의 고객 세부 사항에서 정보를 확인할 수 있습니다.

   표 2. tokenInfoURL 설정

   만약 Teams 클러스터가...	tokenInfoURL을...(IdP 프록시 URL) 설정
   ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AFRA	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   Teams 클러스터를 모르는 경우, Control Hub의 헬프 데스크 보기의 고객 세부 사항에서 정보를 확인할 수 있습니다. 테스트를 위해 URL의 "idp/authenticate" 부분을 "ping"으로 교체하여 tokenInfoURL이 유효한지 확인할 수 있습니다.

6. 다음 명령어를 실행하여 Webex의 사용자 프로필에 표시되어야 하는 Webex 자격을 지정합니다.

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> 범위 broadworks-connector:user 설정

7. 각 XSP|ADP 서버에서 다음 명령어를 사용하여 Cisco 페더레이션에 대한 ID 공급자를 구성합니다.

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get

   • set flsUrl https://cifls.webex.com/federation

   • set refreshPeriodInMinutes 60

   • refreshToken 설정 새로 고침-Token-From-Step1

8. 다음 명령어를 실행하여 FLS 구성이 작동하고 있는지 검증하십시오. 이 명령어는 ID 공급자의 목록을 반환합니다.

   XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> 얻기

9. 각 XSP|ADP 서버에서 다음 명령어를 사용하여 토큰 관리를 구성합니다.

   • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

   • set tokenIssuer BroadWorks

   • set tokenDurationInHours 720

10. RSA 키를 생성하고 공유합니다. 한 개의 XSP|ADP에서 키를 생성한 후 다른 모든 XSP|ADP로 복사해야 합니다. 다음과 같은 이유 때문입니다.

    • 토큰 암호화/해독을 위해서는 인증 서비스의 모든 인스턴스에서 동일한 공개/비공개 키 쌍을 사용해야 합니다.

    • 키 쌍은 처음 토큰을 발급하도록 요구 받았을 때 인증 서비스에서 생성합니다.

    키를 순환하거나 키 길이를 변경하는 경우, 다음 구성을 반복하고 모든 XSP|ADP를 다시 시작해야 합니다.

    1. 키 쌍을 생성하기 위해 사용할 한 개의 XSP|ADP를 선택합니다.

    2. 클라이언트를 사용하여 클라이언트의 브라우저에서 다음 URL을 요청하여 해당 XSP|ADP에서 암호화된 토큰을 요청합니다.

       https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)

       (이는 아직 XSP|ADP에 비공개/공개 키 쌍이 없는 경우에 생성함)

    3. 키 저장소 위치는 구성할 수 없습니다. 키 내보내기:

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. 내보낸 파일 /var/broadworks/tmp/authService.keys 를 다른 XSP|ADP에 있는 동일한 위치로 복사하고, 필요한 경우 이전 .keys 파일을 덮어씁니다.

    5. 다른 각 XSP|ADP에서 키 가져오기:

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys

11. authService URL을 웹 컨테이너에 제공합니다. 토큰의 유효성을 검증할 수 있도록 XSP|ADP의 웹 컨테이너에 authService URL이 필요합니다. 각 XSP|ADP에서:

    1. 인증 서비스 URL을 BroadWorks Communications Utility의 외부 인증 서비스로 추가합니다.

       XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> 설정 url http://127.0.0.1:80/authService

    2. 인증 서비스 URL을 컨테이너에 추가합니다.

       XSP|ADP_CLI/Maintenance/ContainerOptions> 추가 tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService

       이렇게 하면 Webex는 인증 서비스를 사용하여 자격 증명으로 제공된 토큰의 유효성을 검증할 수 있습니다.

    3. get으로 파라미터를 점검합니다.

    4. XSP|ADP를 다시 시작합니다.