기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # VDI 환경에서 Amazon Connect 사용 가상 데스크탑 인프라(VDI) 환경은 솔루션에 또 하나의 복잡성을 추가해 최적화를 위해 별도의 POC 노력과 성능 테스트가 필요합니다. 연락처 제어판(CCP)은 다른 모든 WebRTC 기반 브라우저 애플리케이션과 마찬가지로 씩, 씬 및 제로 클라이언트 VDI 환경에서 작동할 수 있으며, 그 구성/지원/최적화는 VDI 지원 팀에서 가장 잘 처리할 수 있습니다. 다음은 VDI 기반 고객에게 유용한 고려 사항 및 모범 사례의 모음입니다. ## 분할 CCP 모델 사용 VDI에서 실행되는 미디어리스 CCP와 로컬 PC에서 미디어를 전달하는 CCP가 있는 분할 CCP 모델을 사용하는 것이 좋습니다. Amazon Connect Streams API를 통해 사용자 지정 CCP를 구축하여 애플리케이션 데이터 및 통화 신호 전송을 위한 미디어 없는 CCP를 생성할 수 있습니다. 이렇게 하면 미디어가 표준 CCP를 사용하여 로컬 데스크톱으로 전송되고 데이터 및 통화 제어가 미디어리스 CCP와의 원격 연결로 전송됩니다. streams API에 대한 자세한 내용은 GitHub 리포지토리([https://github.com/aws/amazon-connect-streams](https://github.com/aws/amazon-connect-streams))를 참조하세요. **참고** **Firefox 사용자:** 분할 모드에서 VDI를 사용하는 경우 VDI 외부에서 CCP에 Firefox 브라우저를 사용할 수 없습니다. CCP는 Firefox 마이크 사용 지침을 준수하며 CCP 탭이 포커스 상태일 때만 사용자의 마이크에 연결할 수 있는 액세스 권한이 있습니다. 다음 다이어그램은 에이전트 워크스테이션이 로컬 브라우저와 가상 데스크톱으로 구성된 방법을 보여 줍니다. WebRTC를 통해 Amazon Connect에 연결하고 VDI 연결을 통해 기업 가상 인프라에 연결합니다. ![\[에이전트 워크스테이션, 가상 데스크톱, 기업 가상 인프라 및 Amazon Connect.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/use-split-ccp.png) ## 클라우드 데스크톱 Citrix, Amazon WorkSpaces 또는 Omnissa 클라우드 데스크톱을 사용하는 경우 사용자 지정 CCP와 같은 기존 에이전트 사용자 인터페이스를 업데이트하거나 새로 만들어 오디오 처리를 에이전트의 로컬 디바이스로 오프로드하고 오디오를 Amazon Connect로 자동으로 리디렉션할 수 있습니다. 이렇게 하면 에이전트 경험이 더욱 간소화되고 네트워크 연결이 원활하지 않은 상황에서도 오디오 품질이 향상됩니다. 시작하려면 [Amazon Connect 오픈 소스 라이브러리](https://github.com/amazon-connect/amazon-connect-streams)를 사용하여 사용자 지정 CCP와 같은 기존 에이전트 사용자 인터페이스를 업데이트하거나 새로 만들 수 있습니다. ## VDI 환경을 설계할 때 고려해야 할 사항 + **에이전트 위치** - 이상적으로는 에이전트가 CCP를 사용하는 위치와 VDI 호스트 위치 사이에 홉이 가능한 한 적어 왕복 시간이 최소화되어야 합니다. + **VDI 솔루션의 호스트 위치** - VDI 호스트 위치는 에이전트와 동일한 네트워크 세그먼트에 위치하며 내부 리소스와 에지 라우터 모두에서 홉이 최대한 적게 발생하는 것이 좋습니다. 또한 WebRTC 및 Amazon EC2 범위 엔드포인트까지 왕복 시간이 최소화되는 것이 좋습니다. + **네트워크** - 트래픽이 엔드포인트 사이에서 통과하는 각 홉은 장애 가능성을 높이고 대기 시간이 발생할 가능성을 추가합니다. VDI 환경은 기본 라우팅이 최적화되지 않았거나 파이프가 충분히 빠르거나 넓지 않은 경우 통화 품질 문제에 특히 취약합니다. Direct Connect 는 엣지 라우터에서 로의 통화 품질을 개선할 수 있지만 내부 라우팅 문제는 해결하지 AWS않습니다. 프라이빗 LAN/WAN을 업그레이드 또는 최적화하거나 외부 디바이스로 리디렉션해 오디오 문제를 우회해야 할 수 있습니다. 대부분의 시나리오에서, 이러한 조치가 필요하다면 CCP만 문제가 발생하는 애플리케이션은 아닙니다. + **전용 리소스** - 사용 가능한 에이전트 리소스가 백업 및 대용량 파일 전송과 같은 활동에 의해 영향을 받지 않도록 네트워크 및 데스크톱 수준의 전용 리소스가 권장됩니다. 리소스 경합을 방지하는 한 방법은 다른 방식으로 리소스를 사용하는 비즈니스 유닛과 리소스를 공유하는 대신 환경을 비슷하게 사용할 Amazon Connect 사용자로 데스크톱 액세스를 제한하는 것입니다. + **원격 연결을 통해 소프트폰 사용** - VDI 환경에서는 오디오 품질에 악영향을 초래할 수 있습니다. **작은 정보** 에이전트가 원격 엔드포인트에 연결하고 해당 환경에서 업무를 수행할 경우 오디오를 외부 E.164 엔드포인트로 재라우팅하거나 로컬 디바이스를 통해 미디어를 연결한 후 원격 연결을 통해 신호를 전송하는 것이 좋습니다. # Citrix 클라우드 데스크톱을 위한 Amazon Connect 오디오 최적화 Amazon Connect를 사용하면 에이전트가 Citrix 가상 데스크톱 인프라 (VDI) 환경을 사용할 때 고품질 음성 경험을 더 쉽게 제공할 수 있습니다. 에이전트는 Citrix Workspaces와 같은 Citrix 원격 데스크톱 애플리케이션을 활용하여 오디오 처리를 에이전트의 로컬 디바이스로 오프로드하고 오디오를 Amazon Connect로 자동으로 리디렉션할 수 있습니다. 따라서 네트워크 연결이 원활하지 않을 때도 오디오 품질이 개선됩니다. 시작하려면 [Amazon Connect open source libraries](https://github.com/amazon-connect/amazon-connect-streams)를 사용하여 사용자 지정 Contact Control Panel(CCP)과 같은 기존 에이전트 사용자 인터페이스를 업데이트하거나 새로 만들 수 있습니다. ## 시스템 요구 사항 이 섹션에서는 Amazon Connect와 함께 Citrix United Communications SDK를 사용하기 위한 시스템 요구 사항을 설명합니다. + **Citrix Workspace 애플리케이션 버전** [이 설명서](https://community.citrix.com/tech-zone/learn/tech-briefs/ucssdk/)에 설명된 대로 Citrix Workspace 애플리케이션의 최신 버전을 사용하는 것이 좋습니다. 그러나 최소한 CWA 2305 이상을 사용해야 합니다. + **Citrix 서버 버전** Citrix VDA(가상 전송 에이전트) 버전은 2203 LTSR 이상인 것이 좋습니다. + **Citrix 서버 설정** Citrix UC SDK는 기본적으로 사용이 지원되지 않으므로 시스템 관리자는 다음과 같이 허용 목록 레지스트리 항목을 추가해야 합니다. + **키 경로:** `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\WebSocketService` + **키 이름:** `ProcessWhitelist` + **키 유형:** `REG_MULTI_SZ` + **키 값:** + `Chrome.exe` + `msedge.exe` 레지스트리가 성공적으로 구성된 후 **작업 관리자**를 사용하여 `CitrixHdxWebSocketService`를 다시 시작하여 설정을 완료하세요. ![\[Windows의 작업 관리자를 사용하여 CitrixHdxWebSocketService를 다시 시작합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-setup.png) + **네트워킹/방화벽 구성** + **Citrix 서버 구성** 관리자는 Citrix 서버가 다음 다이어그램에 언급된 도메인에 대한 Amazon Connect TCP/443 트래픽에 액세스할 수 있도록 허용해야 합니다. 자세한 내용은 [네트워크 설정](ccp-networking.md) 단원을 참조하십시오. + **에이전트 시스템 구성** 이 솔루션을 사용하려면 에이전트의 씬 클라이언트와 Amazon Connect 간의 미디어 연결이 필요합니다. 에이전트의 시스템과 Amazon Connect의 소프트폰 미디어 UDP 포트 3478 간의 트래픽을 허용하려면 [네트워크 설정](ccp-networking.md) 섹션을 참조하세요. ![\[Citrix 서버 및 에이전트 시스템 방화벽 설정.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-firewall.png) + **지원되지 않는 CCP 배포** + 네이티브 CCP ## 통화 중에 씬 클라이언트와 Amazon Connect 간의 미디어 흐름 확인 + **작업 관리자(Windows)를 사용하여 확인** 에이전트의 씬 클라이언트에서 **작업 관리자**를 시작하고 HDX 서비스가 실행 중인지 확인합니다. 실행 중이면 미디어가 예상대로 리디렉션되고 있음을 의미합니다. ![\[Windows에서 작업 관리자 사용.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/using-ccp-vdi-citrix-confirm-media-flow-windows.png) # Amazon WorkSpaces 클라우드 데스크톱용 Amazon Connect 오디오 최적화 Amazon Connect는 Amazon WorkSpaces가상 데스크톱 인프라(VDI) 환경 내에서 운영되는 에이전트에 대한 고품질 음성 경험 제공을 간소화합니다. 에이전트는 WebRTC 리디렉션 기능과 함께 Amazon WorkSpaces를 활용하여 Amazon Connect 오디오 처리를 로컬 디바이스로 리디렉션할 수 있습니다. 이 접근 방식을 사용하면 까다로운 네트워크 조건에서도 오디오 품질이 향상됩니다. 이 기능을 활용하려면 다음을 수행해야 합니다. + 사용자 지정 연락 제어판(CCP)과 같은 기존 에이전트 사용자 인터페이스를 업데이트하거나 새로 생성하려면 [Amazon Connect 오픈 소스 라이브러리](https://github.com/amazon-connect/amazon-connect-streams)를 사용합니다. + WebRTC 리디렉션을 활성화하도록 Amazon WorkSpaces를 구성합니다. ## 시스템 요구 사항 이 섹션에서는 Amazon Connect with WorkSpaces WebRTC 리디렉션을 사용하기 위한 시스템 요구 사항을 설명합니다. + **WorkSpaces 프로토콜** WorkSpaces는 Amazon DCV를 사용해야 합니다. 자세한 내용은 [Amazon DCV란 무엇입니까?](https://docs.aws.amazon.com/dcv/latest/adminguide/what-is-dcv.html) 섹션을 참조하세요. + **클라이언트 버전** 사용자는 WorkSpaces Web Access 또는 WorkSpaces Windows 클라이언트 버전 5.21.0 이상을 사용해야 합니다. [설정 및 설치](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html#windows_setup) 지침을 완료합니다. + **그룹 정책** WebRTC 리디렉션은 DCV 그룹 정책에서 활성화해야 합니다. [DCV에 대한 그룹 정책 설정 관리](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#gp_configurations_dcv) 주제에서 **DCV에서 WebRTC 리디렉션 활성화 또는 비활성화**라는 제목의 축소된 섹션을 열고 해당 지침을 완료합니다. + **네트워킹/방화벽 구성** + **Workspace VDI 구성** 관리자는 Workspaces가 다음 다이어그램에 언급된 도메인에 대한 Amazon Connect TCP/443 트래픽에 액세스할 수 있도록 허용해야 합니다. 자세한 내용은 [네트워크 설정](ccp-networking.md) 단원을 참조하십시오. + **에이전트 시스템 구성** 이 솔루션을 사용하려면 에이전트 씬 클라이언트와 Amazon Connect 간의 미디어 연결이 필요합니다. 에이전트의 시스템과 Amazon Connect의 소프트폰 미디어 UDP 포트 3478 간의 트래픽을 허용하려면 [네트워크 설정](ccp-networking.md) 섹션을 참조하세요. ![\[Workspace VDI 및 에이전트 시스템 방화벽을 설정합니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/vdi-workspaces.png) + **지원되지 않는 CCP 배포** + 네이티브 CCP ## 통화 중에 에이전트 머신과 Amazon Connect 간의 미디어 흐름 확인 + DCV WebRTC 브라우저 확장이 활성화되어 있고 준비 상태인지 확인합니다. # Omnissa 클라우드 데스크톱을 위한 Amazon Connect 오디오 최적화 Amazon Connect를 사용하면 에이전트가 Omnissa 가상 데스크톱 인프라(VDI) 환경을 사용할 때 고품질 음성 경험을 더 쉽게 제공할 수 있습니다. 에이전트는 Omnissa Horizon 클라이언트와 같은 Omnissa 원격 데스크톱 애플리케이션을 활용하여 오디오 처리를 에이전트의 로컬 디바이스로 오프로드하고 오디오를 Amazon Connect로 자동으로 리디렉션할 수 있습니다. 따라서 네트워크 연결이 원활하지 않을 때도 오디오 품질이 개선됩니다. 시작하려면 [Amazon Connect open source libraries](https://github.com/amazon-connect/amazon-connect-streams)를 사용하여 사용자 지정 Contact Control Panel(CCP)과 같은 기존 에이전트 사용자 인터페이스를 업데이트하거나 새로 만들 수 있습니다. ## 시스템 요구 사항 이 섹션에서는 Amazon Connect와 함께 Omnissa Horizon SDK를 사용하기 위한 시스템 요구 사항을 설명합니다. + **Omnissa Horizon 클라이언트 버전** + 최소 필수 버전: 에이전트와 클라이언트 모두에 대해 8.15.0(Horizon 2503) + Omnissa는 현재 이 기능에 대해 Windows를 실행하는 에이전트 워크스테이션만 지원합니다. + 최신 Omnissa 클라이언트 다운로드 **중요** 2503 릴리스는 ICE 재시작 기능을 지원하는 첫 번째 버전이 됩니다. 이전 버전에서는 이 기능을 지원하지 않습니다. Omnissa Horizon 클라이언트 버전 2503은 [Omnissa Customer Connect](https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/8)를 통해 사용할 수 있습니다. Customer Connect에서 최신 버전을 확인합니다. + **Omnissa 확장 및 SDK 요구 사항** + Horizon WebRTC 웹 앱은 확장 및 SDK 8.15.0 이상을 모두 지원합니다. + 이 브라우저 확장은 Horizon Agent 내에서 WebRTC SDK에 대한 웹 앱 지원을 활성화하며 [여기](https://chromewebstore.google.com/detail/horizon-webrtc-web-app-su/emildoafpcgihdmhphelfhghioccllfi?pli=1)의 Chrome Store에서 다운로드할 수 있습니다. + **브라우저 지원(최신 3개 버전) ** + Google Chrome + Microsoft Edge(Chromium) + **Omnissa 서버 설정**: Omnissa Horizon SDK는 기본적으로 활성화되어 있지 않습니다. 시스템 관리자는 Omnissa Horizon 에이전트 가상 머신 내에서 (가급적 레지스트리 편집기(regedit)를 통해) 다음 레지스트리 설정을 구성해야 합니다. + **레지스트리 편집기 열기** + Windows의 경우: + **Windows \$1 R**을 누릅니다. + **regedit**을 입력하고 **Enter** 키를 누릅니다. + 다음 레지스트리 경로를 생성/이동합니다. ``` Key Path: Computer\HKLM\SOFTWARE\Policies\Omnissa\Horizon\WebRTCRedirSDKWebApp Key Names and Values: chrome_enabled (REG_DWORD) = 1 edge_chrome_enabled (REG_DWORD) = 1 enabled (REG_DWORD) = 1 ``` ``` Key Path: Computer\HKLM\SOFTWARE\Policies\Omnissa\Horizon\WebRTCRedirSDKWebApp\UrlAllowList Key Name: https://*.connect.aws/* Key Name: https://*.connect.aws.a2z.com/* Key Type: REG_SZ ``` Omnissa 에이전트 설치 후 html5server.exe 및 wsnm.exe 프로세스는 SDK 활성화 상태에 관계없이 항상 태스크 관리자에서 실행됩니다. 다음 이미지는 태스크 관리자에서 실행되는 html5server.exe 프로세스를 보여 줍니다. ![\[태스크 관리자, html5server.exe 프로세스가 실행 중입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/omnissa-1.png) 다음 이미지는 태스크 관리자에서 실행되는 wsnm.exe 프로세스를 보여 줍니다. ![\[태스크 관리자, wsnm.exe 프로세스가 실행 중입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/omnissa-2.png) + **문제 해결** + Omnissa 로그 파일은 다음에서 찾을 수 있습니다. ` %tmp%\omnissa-{username}\horizon-html5Client-{pid}.log` **참고** `{pid}`는 태스크 관리자에서 찾을 수 있는 Horizon 클라이언트 'horizon-protocol.exe' 프로세스 ID를 나타냅니다. + 향상된 로깅을 위한 레지스트리 설정 문제 해결을 위해 세부 로깅을 활성화하려면 다음 레지스트리 항목을 추가합니다. ``` HKEY_LOCAL_MACHINE\SOFTWARE\Omnissa\Horizon\Html5mmr: - "html5mmr.log.noThrottle" = dword:00000001 ``` ``` HKEY_LOCAL_MACHINE\SOFTWARE\Omnissa\Horizon\Html5mmr\WebrtcRedir: - "html5mmr.log.webrtc.allowFullText" = dword:00000001 - "html5mmr.log.webrtc.allowThrottle" = dword:00000000 - "html5mmr.log.webrtc.sharedlib.internal" = dword:00000001 - "html5mmr.log.webrtc.sharedlib.network" = dword:00000001 - "html5mmr.log.webrtc.sharedlib.media" = dword:00000001 - "html5mmr.log.webrtc.shim.logToConsole" = dword:00000001 - "html5mmr.log.webrtc.sharedlib.signal" = dword:00000001 - "html5mmr.log.noThrottle" = dword:00000001 - "html5mmr.log.webrtc.tracelevel" = dword:00000001 ``` 이러한 레지스트리 설정을 사용하면 세부 로깅을 활성화하여 Omnissa VDI 통합 문제를 진단하는 데 도움이 될 수 있습니다. + **네트워킹/방화벽 구성** + **Omnissa VDI 구성** 관리자는 Omnissa 서버가 다음 다이어그램에 언급된 도메인에 대한 Amazon Connect TCP/443 트래픽에 액세스할 수 있도록 허용해야 합니다. 이 설정에 대해서는 [네트워크 설정](ccp-networking.md) 주제를 참조하세요. + **에이전트 워크스테이션 구성** 이 솔루션을 사용하려면 에이전트 씬 클라이언트와 Amazon Connect 간의 미디어 연결이 필요합니다. 에이전트의 시스템과 Amazon Connect의 소프트폰 미디어 UDP 포트 3478 간의 트래픽을 허용하려면 [네트워크 설정](ccp-networking.md) 섹션을 참조하세요. 다음 다이어그램은 UDP 포트 3478의 사용을 보여 줍니다. ![\[UDP 포트 3478 사용을 보여 주는 다이어그램입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/omnissa-3.png) ## 사용자 지정 CCP에서 필요한 코드 변경 Omnissa VDI 환경에서 오디오 최적화를 활성화하려면 다음과 같은 변경 사항으로 사용자 지정 CCP를 구성해야 합니다. 1. CCP 초기화 전에 다음 코드 조각을 추가합니다. CCP의 창 식별을 관리하는 데 도움이 되며, 특히 에이전트가 여러 창을 열었을 때 중요합니다. 활성 CCP 창을 식별하는 데 도움이 되는 타임스탬프와 '활성 소프트폰 탭' 마커를 추가합니다. ``` const ACTIVE_SOFTPHONE_TAB = "Active Softphone Tab"; window.addEventListener('message', (event) => { if (event.data.type === 'get_horizon_window_title') { let title = document.title; const currentTime = new Date(); if (!title.endsWith(ACTIVE_SOFTPHONE_TAB)) { title += ` ${currentTime.getHours()}${currentTime.getMinutes()}${currentTime.getSeconds()} ` + ACTIVE_SOFTPHONE_TAB; document.title += ` ${currentTime.getHours()}${currentTime.getMinutes()}${currentTime.getSeconds()} ` + ACTIVE_SOFTPHONE_TAB; } event.source.postMessage( { type: 'horizon_window_title_response', title: title, source: 'parent' }, event.origin ); } }); ``` 1. initCCP 구성에 VDI 플랫폼 파라미터를 추가합니다. 오디오 리디렉션을 활성화하기 위한 것입니다. ``` softphone: { allowFramedSoftphone: true, VDIPlatform: "OMNISSA" } ``` **중요** `VDIPlatform: "OMNISSA"`를 설정하면 Omnissa 오디오 최적화에 실패할 경우 CCP가 표준 웹 브라우저 오디오로 폴백되지 않습니다. 이는 다음을 의미합니다. 에이전트가 Omnissa VM 외부의 CCP에 액세스하는 경우 통화가 실패합니다. CCP 개발자는 이 파라미터를 설정하기 전에 CCP가 Omnissa VM 내에서 실행 중인지 확인해야 합니다. **구현 옵션**: Omnissa 및 비 Omnissa 액세스에 대해 별도의 URL 경로를 사용합니다. URL 파라미터를 사용하여 환경을 결정합니다. API를 구현하여 사용자 컨텍스트에 따라 올바른 구성을 결정합니다. ## 통화 중에 씬 클라이언트와 Amazon Connect 간의 미디어 흐름을 확인하는 방법 1. Omnissa Horizon WebRTC 브라우저 확장이 활성화되어 있고 준비 상태인지 확인합니다. 1. 브라우저 도구 모음에서 확장 아이콘을 확인합니다. 1. 파란색 아이콘은 준비 상태와 적절한 기능을 나타냅니다. 1. 회색 아이콘은 준비되지 않음 상태 및 잠재적 문제를 나타냅니다. 다음 이미지는 Omnissa Horizon WebRTC 브라우저 확장이 활성화되고 준비 상태일 때의 모습을 보여 줍니다. ![\[활성화된 경우의 Omnissa Horizon WebRTC 브라우저 확장입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/omnissa-4.png) 1. 프로세스 상태 확인: 1. 태스크 관리자를 엽니다. 1. html5server.exe 및 wsnm.exe 프로세스가 실행 중인지 확인합니다. 1. 통화 중에 이러한 프로세스가 계속 실행되고 있는지 확인합니다. 두 프로세스 중 하나가 충돌하면 VDI 기능이 실패합니다. 1. 오디오 흐름 테스트: 1. 테스트 통화 수행 1. VM의 브라우저에서 마이크 액세스를 비활성화하여 오디오 최적화 확인 - 오디오가 로컬에서 처리되므로 통화가 계속 작동해야 함 1. 오디오 지연 시간 또는 품질 문제가 있는지 확인. 1. Wireshark를 사용하여 다음을 확인합니다. Wireshark는 무료 오픈 소스 네트워크 패킷 분석기입니다. 자세한 내용은 Wireshark [웹사이트](https://www.wireshark.org/)를 참조하세요. 1. [여기](https://www.wireshark.org/download.html)에서 Wireshark를 다운로드합니다. 1. Wireshark를 설치한 후 씬 클라이언트에서 Wireshark를 열고 로컬 네트워크 모니터링을 시작합니다. 1. 통화에 연결하고 상단의 필터 표시줄에 다음 필터를 입력합니다. ``` (udp.srcport == 3478 or udp.dstport == 3478) and ((ip.dst_host = "15.193.6.0/24")) ``` 1. 에이전트의 시스템과 Amazon Connect 간의 미디어 패킷 흐름을 볼 수 있는지 확인합니다. 1. 패킷이 표시되지 않는 경우: + 네트워크 연결 및 방화벽 규칙을 확인합니다. + 오디오 최적화 설정을 확인합니다. **참고** 위에 표시된 IP 범위는 미국 동부(버지니아 북부) AWS 리전에 대한 것입니다. 다른 리전의 IP 범위는 [네트워크 설정](ccp-networking.md) 섹션을 참조하세요. 다음 이미지는 해당 IP 범위를 보여 줍니다. ![\[활성화된 경우의 Omnissa Horizon WebRTC 브라우저 확장입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/omnissa-5.png) 1. 콘솔 로깅 1. Windows의 경우: 브라우저 개발자 도구(F12)를 엽니다. 1. Omnissa 초기화를 확인하는 WebRTC 관련 메시지인 R`TC.js is using OmnissaVDIStrategy`를 찾습니다. 다음은 확인 메시지의 예제입니다. ``` { "component": "softphone", "level": "LOG", "text": " RTC.js is using OmnissaVDIStrategy", "time": "2025-04-03T20:47:40.460Z", "exception": null, "objects": [], "line": 64, "agentResourceId": "20c6b5a3-259e-4e18-a8a7-b962d54a6344", "loggerId": "1743713238678-pz6yp1q4n9s", "contextLayer": "CRM" }, ``` ## 제한 사항 다음 CCP 구성은 지원되지 않습니다. + 네이티브 CCP: 네이티브 CCP에 대한 오디오 최적화는 지원되지 않습니다. 미디어는 동일한 방식을 사용하여 처리된 통화에 대해 VM 내의 브라우저를 통해 계속 흐름을 진행합니다. + Salesforce CTI 어댑터: VDI 플랫폼 감지를 지원하지 않으므로 클라이언트 측 오디오 처리를 최적화하는 대신 VM의 브라우저를 통해 미디어 라우팅이 이루어집니다. # 에이전트 워크스페이스를 사용하여 Citrix, Amazon WorkSpaces 및 Omnissa 클라우드 데스크톱용 오디오 최적화 Amazon Connect 에이전트 워크스페이스를 사용하여 Amazon WorkSpaces, Citrix 및 Omnissa Virtual Desktop Infrastructure(VDI) 환경에서 고품질 음성 경험 제공을 간소화할 수 있습니다. Amazon Connect는 [Amazon WorkSpaces](using-ccp-vdi-workspaces.md), [Citrix](using-ccp-vdi-citrix-step-by-step.md) 및 [Omnissa](using-ccp-vdi-omnissa-step-by-step.md) 클라우드 데스크톱에 대한 오디오 최적화를 지원합니다. 이 최적화는 에이전트의 로컬 데스크톱에서 Amazon Connect로 미디어를 리디렉션합니다. 네트워크 홉을 줄여 에이전트 경험을 간소화하고 오디오 품질을 개선합니다. 에이전트는 에이전트 Workspace에서 이러한 오디오 최적화를 활용할 수 있습니다. ## 중요한 참고 사항 + SSO가 아닌 사용자의 경우 에이전트가 Amazon Connect 관리자 웹 사이트에서 에이전트 워크스페이스로 이동하는 경우 URL에 이미 추가된 참조자에 대한 쿼리 파라미터가 있습니다. URL 형식은 `https://your-instance-url/agent-app-v2?referrer=admin`입니다. VDI 플랫폼 쿼리 파라미터를 구성하려면 URL에서 참조자 파라미터를 제거합니다(예: 메모장을 사용하여 URL을 편집할 수 있음). VDI 플랫폼 파라미터를 URL의 `/agent-app-v2` 경로에 직접 추가합니다. + VDI 환경 내에서 오디오 최적화를 위해 항상 에이전트 Workspace에 북마크된 URL을 사용합니다. + 실제 VDI 환경 내에서 에이전트 Workspace를 사용하지 않는 경우 VDI 쿼리 파라미터를 추가하지 마세요. + 에이전트는 VDI 환경 내에서 진행 중인 연락처 동안 하나의 미디어 디바이스를 사용하는 것이 좋습니다. 미디어 디바이스 정보는 연락처 시작 시 릴레이되므로 에이전트가 진행 중인 연락처 중에 미디어 디바이스를 전환하려는 경우 업데이트된 디바이스의 오디오에 액세스할 수 없습니다. ## 에이전트 워크스페이스에서 오디오 최적화를 사용하는 방법 에이전트 워크스페이스에서 오디오 최적화를 사용하려면 URL에 에이전트 워크스페이스가 사용되는 VDI 환경의 값이 포함된 쿼리 파라미터가 있어야 합니다. 이 프로세스는 특정 VDI 환경에서 에이전트가 사용 중인 로컬 디바이스로의 통화에 대해 WebRTC 리디렉션을 수행하도록 연락 제어판(CCP)에 신호를 보냅니다. VDI 환경에 쿼리 파라미터를 사용하려면 다음 단계를 완료하세요. ### SSO 기반 로그인 없이 사용 1. Amazon Connect 에이전트 워크스페이스로 이동하여 에이전트 워크스페이스의 URL을 메모장에 복사합니다. 1. 키 `VDIPlatform` 및 해당 VDI 환경과 동일한 값을 사용하여 쿼리 파라미터를 추가합니다. 예제: 1. Citrix 클라우드 데스크톱의 경우 쿼리 파라미터의 값은 `CITRIX`입니다. 다음 코드는 전체 URL의 예제를 보여 줍니다. + `https://your-instance-url/agent-app-v2?VDIPlatform=CITRIX` 1. Amazon WorkSpaces 클라우드 데스크톱의 경우 쿼리 파라미터 값은 `AWS_WORKSPACE`입니다. 다음 코드는 전체 URL의 예제를 보여 줍니다. + `https://your-instance-url/agent-app-v2?VDIPlatform=AWS_WORKSPACE` 1. Omnissa 클라우드 데스크톱의 경우 쿼리 파라미터의 값은 `OMNISSA`입니다. 다음 코드는 전체 URL의 예제를 보여 줍니다. + `https://your-instance-url/agent-app-v2?VDIPlatform=OMNISSA` 1. URL을 복사하여 에이전트의 브라우저에 붙여넣습니다. 1. 모든 에이전트에 대해 이 URL을 북마크하는 것이 좋습니다. 이렇게 하면 에이전트가 북마크된 링크를 클릭하기만 하면 나중에 쉽게 액세스할 수 있습니다. ### SSO 기반 로그인과 함께 사용 1. SSO를 사용하여 Amazon Connect 에이전트 워크스페이스에 직접 로그인하는 경우 SSO 설정의 릴레이 상태 URL을 변경하여 VDI 쿼리 파라미터를 추가해야 합니다. 이렇게 하려면 다음 단계를 완료하세요. 1. ID 제공업체(IdP)의 릴레이 상태에서 에이전트 Workspace에 액세스하는 데 사용하는 릴레이 상태를 복사하여 붙여넣습니다. 1. [릴레이 상태 URL 예제](configure-saml.md#destination-relay)를 참조하세요. 예제에서는 ``%2Fagent-app-v2``가 대상입니다. 1. 적절한 값이 있는 `VDIPlatform` 파라미터를 이 릴레이 상태에 추가합니다. 위 링크의 예제를 사용하면 Amazon Connect 에이전트 Workspace의 전체 릴레이 상태 URL은 다음과 같습니다. 1. Citrix Desktop의 경우 `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=CITRIX` 1. Amazon WorkSpaces의 경우 `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=AWS_WORKSPACE` 1. Omnissa의 경우 `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=OMNISSA` 1. 릴레이 상태 URL`VDIPlatform`에서를 설정하면 사용 중인 특정 VDI 환경에 대한 에이전트 워크스페이스의 오디오 최적화가 자동으로 설정됩니다. 1. IdP에서 로그인하고 ``VDIPlatform``이 쿼리 파라미터로 존재하는지 확인합니다.