---
sourceDocument: Xanadu 대화형 인터페이스
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 대화형 인터페이스

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Portable 가상 에이전트 Web Client 구성

# Portable 가상 에이전트 Web Client 구성 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 2분

Portable Web Client는 타사 웹 페이지, 서비스 포털 또는 포털에서 UI 빌더 실행할 수 있는 채팅 위젯입니다.
Portable Web Client는 페이지에 채팅을 쉽게 추가할 가상 에이전트 수 있는 새로운 Seismic 구성요소입니다. 구성을 단순화하고 다음과 같은 기능을 제공합니다.

* 쉽게 구성 가능
* SSO(Single Sign-On) 인증 흐름 간소화
* 서비스 포털에 연결 에이전트 채팅
* 시스템 매개변수와 컨텍스트 변수는 이전과 동일하게 작동합니다.
{#use-portable-va-web-client__ul_pl5_ndk_ktb}

## 휴대용 가상 에이전트 웹 클라이언트 사용을 위한 전제조건 {#use-portable-va-web-client__section_q4m_3qp_r5b}

Portable Web Client는 인라인 프레임 요소(iframe)를 사용합니다. 외부 공급업체 웹 사이트는 인스턴스 ServiceNow® 와 동일한 상위 도메인에 있어야 합니다. 예를 들어 site1.company.com 와 site2.company.com 는 동일한 상위 도메인을 공유합니다. 인스턴스와 ServiceNow 공유되지 않는 하위 도메인에 웹 클라이언트를 포함하는 경우 URL은 사용자 지정 인스턴스 URL이어야 합니다. 브라우저 보안 강화로 인해 사용자 지정 URL을 사용하지 않으면 웹 클라이언트가 로드되지 않을 수 있습니다.  
시작하기 전에 다음을 수행합니다.

1. [인스턴스에서 사용자 지정 URL 플러그인(com.snc.customurl)을 활성화합니다.](https://www.servicenow.com/docs/access?context=activate-custom-url-plugin&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)
2. [이전에 구매하고 등록한 사용자 지정 URL을 인스턴스에 추가합니다.](https://www.servicenow.com/docs/access?context=configure-custom-url&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)
{#use-portable-va-web-client__ol_mtc_4kp_ktb}  
주:  
사용자 지정 URL 사용에 대한 자세한 내용은 [인스턴스에 사용자 지정 URL 연결을](https://www.servicenow.com/docs/access?context=custom-url&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 참조하세요.

## 휴대용 가상 에이전트 웹 클라이언트에서 SSO 인증 사용 {#use-portable-va-web-client__section_bbj_tsp_r5b}

가상 에이전트 클라이언트를 포함시킨 후 웹 클라이언트에서 SSO 인증을 선택적으로 트리거할 수 있지만 인스턴스가 외부 SSO 제공자를 사용하도록 설정된 경우에만 가능합니다. 또한 호스팅 사이트는 인스턴스와 동일한 SSO 제공자를 사용해야 합니다. SSO 제공자 설정에 대한 자세한 내용은 [외부 SSO(Single Sign-On)](https://www.servicenow.com/docs/access?context=c_MultipleProviderSingleSignOn&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)를 참조하십시오.

SSO 인증을 트리거하려면 인증 실행 조건을 정의하고 지정된 웹 클라이언트 페이지로 사용자를 리디렉션하는 JavaScript 스크립트를 만듭니다. 또한 시스템 속성에서 식별하여 이 스크립트에 전달할 수 있는 허용된 URL을 com.glide.cs.web_client_login_redirect_urls 지정합니다. 전체 리디렉션 URL 또는 URL의 호스트 부분(예: <kbd class="ph userinput">https://example.com</kbd>)을 지정합니다.  
이 절차를 수행하려면 다음 두 시스템 속성의 값을 설정해야 합니다.

* com.glide.cs.embed.csp_frame_ancestors
* com.glide.cs.embed.xframe_options (IE 11에만 해당)

{#use-portable-va-web-client__ul_awd_xsp_r5b}이러한 속성은 포함된 웹 클라이언트에 대한 보안 정책, 즉 웹 채팅 클라이언트를 포함하기 전에 iframe에서 브라우저가 iframe에서 HTML 콘텐츠를 가상 에이전트 렌더링하고 라이브 에이전트 보호하는 방법을 결정합니다. 지정하는 HTTP 헤더 지시문은 클릭재킹 시도를 완화하기 위해 특정 도메인에 페이지를 포함할 수 있는지 여부를 브라우저에 알려줍니다. 두 속성을 모두 설정하면 주요 브라우저와 Internet Explorer와 같은 이전 브라우저에 대한 보안 지시문이 있습니다.  
주:  
CMS(콘텐츠 관리 시스템) 애플리케이션을 사용하여 애플리케이션에 ServiceNow® 대한 Now Platform 사용자 지정 인터페이스를 만드는 경우 는 지원하지 않는다는 가상 에이전트점에 유의하십시오.
* **[휴대용 가상 에이전트 웹 클라이언트 구성](https://servicenow-prod.fluidtopics.net/DGRC4XhHfONJ4TN93EHG0A)**   
  외부 공급업체 웹 페이지에서 실행 가상 에이전트 되도록 휴대용 웹 클라이언트 채팅 위젯을 구성합니다.
* **[외부 공급업체 웹 사이트에 휴대용 가상 에이전트 웹 클라이언트 추가](https://servicenow-prod.fluidtopics.net/auTF1Q4nSj1wiSve0pDsOg)**   
  타사 웹 페이지에서 Portable Web Client 채팅 위젯을 가상 에이전트 사용하려면 웹 페이지에 필요한 코드를 추가하십시오.
* **[외부 웹 페이지에 웹 클라이언트 포함 가상 에이전트 (레거시 방법)](https://servicenow-prod.fluidtopics.net/LCPM5ZCMEoqOIcP7IGcD3w)**   
  인라인 프레임 요소(iframe) 가상 에이전트 를 사용하여 외부 웹 페이지에서 웹 클라이언트 인터페이스를 로드합니다. 웹 클라이언트를 사용 중이고 로그인하지 않은 게스트 사용자에 대해 SSO(Single Sign-On) 인증 프로세스가 자동으로 실행되도록 선택적으로 사용하도록 설정할 수도 있습니다.

**관련 태스크**   

* [휴대용 가상 에이전트 웹 클라이언트 구성](https://servicenow-prod.fluidtopics.net/DGRC4XhHfONJ4TN93EHG0A "외부 공급업체 웹 페이지에서 실행 가상 에이전트 되도록 휴대용 웹 클라이언트 채팅 위젯을 구성합니다.")
* [외부 공급업체 웹 사이트에 휴대용 가상 에이전트 웹 클라이언트 추가](https://servicenow-prod.fluidtopics.net/auTF1Q4nSj1wiSve0pDsOg "타사 웹 페이지에서 Portable Web Client 채팅 위젯을 가상 에이전트 사용하려면 웹 페이지에 필요한 코드를 추가하십시오.")