> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/verkada-cameras/ko/installation/camera-deployment/troubleshoot-command-display-issues-with-zscaler-internet-access.md).

# Zscaler Internet Access와의 Command 표시 문제 해결

이 문서는 Zscaler Internet Access(ZIA)를 사용할 때 Verkada Command 접근, 카메라 썸네일 로드 또는 기타 Command 콘텐츠 표시 문제를 해결하는 방법을 설명합니다.

***

## 1. 호스팅된 PAC 파일 생성

Verkada Command 및 관련 서비스에 대한 ZIA 트래픽 검사를 우회하는 사용자 지정 PAC 파일을 만듭니다.

{% stepper %}
{% step %}
ZIA Experience Center에 로그인합니다.
{% endstep %}

{% step %}
다음으로 이동: **Infrastructure > Internet & SaaS > Traffic Forwarding > Hosted PAC Files**.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2FvqVyxQix8h3i0OWWT7kl%2F2026-06-03_18-51-31.jpeg?alt=media&amp;token=d8c7e80b-d0ef-4214-9089-1a89f8d00fe2" alt=""></div>
{% endstep %}

{% step %}
기존 PAC 파일을 만들거나 편집한 후 FindProxyForURL 함수에 다음을 추가합니다:

```javascript
// --- VERKADA 우회 시작 ---
if (
    // Verkada 핵심 도메인
    dnsDomainIs(host, "verkada.com") || 
    shExpMatch(host, "*.verkada.com") || 
    dnsDomainIs(host, "vkda.co") || 
    shExpMatch(host, "*.vkda.co") || 
    shExpMatch(host, "*.verkada-lan.com") ||

    // LiveKit 및 비디오 스트리밍 서비스
    shExpMatch(host, "*.livekit.cloud") ||
    shExpMatch(host, "*.kinesisvideo.*.amazonaws.com") ||
    shExpMatch(host, "verkada-vinter-audio-files-prod1.s3.amazonaws.com") ||
    shExpMatch(host, "*.verkada-vinter-audio-files-prod1.s3.amazonaws.com") ||

    // Mapbox 서비스
    dnsDomainIs(host, "mapbox.com") ||
    shExpMatch(host, "*.mapbox.com") ||
    shExpMatch(host, "*.tiles.mapbox.com") ||

    // 지원 및 모니터링 서비스
    shExpMatch(host, "*.intercomcdn.com") ||
    shExpMatch(host, "*.intercom.io") ||
    shExpMatch(host, "*.browser-intake-datadoghq.com") ||
    shExpMatch(host, "*.twilio.com") ||
    shExpMatch(host, "*.verkada-command.endpoint.csper.io")
) {
    /* Z-Tunnel 2.0을 사용하는 경우 "DIRECT"를 "${ZAPP_TUNNEL2_BYPASS}"로 바꾸세요 */
    return "DIRECT";
}
// --- VERKADA 우회 끝 ---
```

{% endstep %}

{% step %}
PAC 파일을 저장하고 구성을 적용합니다.
{% endstep %}

{% step %}
방금 편집한 PAC 파일의 URL을 PAC 파일 목록에서 복사합니다. 나중 단계에서 필요합니다.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fl2Bje6SU9Z0kKyH0gHTP%2F2026-06-03_18-57-33.jpeg?alt=media&amp;token=bf0dd87d-0f8f-4abb-a8c7-2cb52cb6d989" alt=""></div>
{% endstep %}
{% endstepper %}

***

## 2. PAC 파일을 Client Connector 프로필에 적용

{% stepper %}
{% step %}
다음으로 이동: **Infrastructure > Connectors > Platform Settings > 운영 체제**.

아래 예시는 Windows를 사용하지만, 다른 운영 체제에서도 단계는 비슷합니다.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2FqNBL6sl86mz8gZTQVUte%2F2026-06-03_19-04-04%20(1).jpeg?alt=media&amp;token=d90af9b8-7283-41b6-857c-99f9b4628403" alt=""></div>
{% endstep %}

{% step %}
활성 프로필의 PAC 파일 URL을 추가합니다.

1. 아래 **트래픽 스티어링**, 호스팅된 PAC 파일의 URL을 **Custom PAC URL** 필드에 붙여넣습니다.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2FwDL3JSMrWXmy5qBb61Yn%2F2026-06-03_19-11-43.jpeg?alt=media&amp;token=5b123230-8dd4-4c98-a53a-4e499621541a" alt=""></div>

2. 프로필을 저장합니다.
3. 필요에 따라 추가 프로필이나 운영 체제에 대해 이 단계를 반복합니다.
   {% endstep %}
   {% endstepper %}

***

## 3. 구성 활성화

{% stepper %}
{% step %}
Zscaler Experience Center 오른쪽 상단에서 클라우드 아이콘을 클릭합니다 <img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2FHGCJkGzZyCBhnVO6CsL3%2FScreenshot%202026-06-22%20at%2012.46.08%E2%80%AFPM.png?alt=media&amp;token=af062993-917d-45e5-bb50-cc7c74b4cea2" alt="" data-size="line">.
{% endstep %}

{% step %}
안내에 따라 구성 변경 사항을 활성화합니다.
{% endstep %}
{% endstepper %}

### Z-Tunnel 2.0 구성

배포에서 Z-Tunnel 2.0을 사용하는 경우 아래의 추가 구성을 완료합니다.

{% stepper %}
{% step %}
다음으로 이동: **Infrastructure > Connectors > Forwarding Profile for Platforms**.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2F17dEJuHnsUEAyMjo41Gb%2F2026-06-03_19-04-04.jpeg?alt=media&amp;token=6667c066-b019-4176-ad8c-f85d4e50cdb4" alt=""></div>
{% endstep %}

{% step %}
Verkada 관리자가 사용하는 전달 프로필을 편집하거나 복제합니다.
{% endstep %}

{% step %}
아래 **ZIA > 신뢰된 네트워크에서의 전달 프로필 작업**:

* 설정 **신뢰된 네트워크** 로 **터널**.
* 설정 **터널 버전 선택** 로 **Z-Tunnel 2.0**.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2FqOmMEY07NZJmoQerWd7Z%2Funknown.jpeg?alt=media&amp;token=11f48c2b-7bf3-415e-8427-ccbcf8294617" alt="" height="379" width="495"></div>
{% endstep %}

{% step %}
확장 **고급 Z-Tunnel 2.0 구성**.

1. 사용 **웹 트래픽을 Zscaler Client Connector 수신 프록시로 리디렉션**.
2. 선택 **프록시된 웹 트래픽에 Z-Tunnel 2.0 사용**.

<div align="left" data-with-frame="true"><img src="https://1726484256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fr0gg5640FxwNB8Gg82AC%2Funknown.jpeg?alt=media&amp;token=7b8f7f63-e593-4834-8e30-0505fa8d109c" alt=""></div>
{% endstep %}

{% step %}
확장 **시스템 프록시 설정 구성**.

1. 사용 **PAC URL 위치**.
2. 유입 **Custom PAC URL**, 이전에 만든 호스팅된 PAC 파일의 URL을 입력합니다.
   {% endstep %}

{% step %}
다음에 대해 3-5단계를 반복합니다:

* **비신뢰 네트워크**
* **VPN-신뢰 네트워크** (해당하는 경우)

{% hint style="warning" %}
또는 다음을 선택합니다: **신뢰된 네트워크와 동일**이 옵션을 사용하기 전에 환경별 설정에 영향을 줄 수 있으므로 Zscaler 구성을 검토하세요. 확실하지 않으면 Zscaler 담당자나 Zscaler 지원팀에 문의하세요.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## 4. 구성 확인

{% stepper %}
{% step %}
Command 표시 문제가 발생하는 워크스테이션에서 Zscaler Client Connector를 엽니다.
{% endstep %}

{% step %}
왼쪽 탐색에서 다음을 클릭합니다 **더보기** (<i class="fa-ellipsis">:ellipsis:</i>).
{% endstep %}

{% step %}
아래 **정보**, 다음을 선택합니다:

* **앱 업데이트**
* **정책 업데이트**
  {% endstep %}

{% step %}
브라우저를 새로고침하고 Command가 올바르게 로드되는지 확인합니다.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Z-Tunnel 2.0으로 우회 구성을 설정하는 방법에 대한 자세한 내용은 다음을 참조하세요. [Zscaler 문서](https://help.zscaler.com/zscaler-client-connector/best-practices-adding-bypasses-z-tunnel-2.0).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.verkada.com/verkada-cameras/ko/installation/camera-deployment/troubleshoot-command-display-issues-with-zscaler-internet-access.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.