Source: https://swgbar.com/ko/guides/zscaler-ssl-inspection-bypass-mac/
Language: ko

# Mac의 Zscaler SSL 검사: 도메인별 확인 및 우회 방법

Mac에서 Zscaler Client Connector가 HTTPS를 복호화하는지 확인하고, 변조 방지(Tamper Protection) 때문에 ZCC 종료가 실패하는 이유와 도메인별 우회·CLI CA 신뢰 설정을 비교하세요.

SWG bar · 업데이트 2026년 11월 19일

Mac에서 \*\*Zscaler(ZIA / Zscaler Client Connector)\*\*가 HTTPS 트래픽을 복호화하고 있는지 확인하려면 **SWG bar → 개요**를 열거나 `swgbar overview`를 실행해 **도메인 통신 가로채기 비율**이 `0%`를 넘는지, 그리고 **중간자 인증서** 아래에 **Zscaler Root CA** 또는 회사 중간 CA가 표시되는지 살펴보세요. 승인된 Mac에서 오류가 나는 단일 호스트 이름의 Zscaler SSL 검사를 우회하려면 **SWG bar → 도메인**에서 호스트 이름을 선택하고 **SWG 우회**를 켜면 됩니다(또는 `swgbar bypass enable <domain>` 실행).

웹에 올라온 대부분의 Zscaler 우회 가이드는 **Zscaler Admin Portal(ZIA)** 관리자 권한이 있다고 가정합니다. 하지만 Jamf, Kandji, Intune으로 관리되는 회사 MacBook에서는 개발자와 직원이 포털 권한이 없는 경우가 대부분이며, Zscaler의 **Z-Tunnel 2.0**(`NetworkExtension` / `utun` 터널)과 **Zscaler Root CA** 때문에 인증서 피닝 앱, `Homebrew`, `npm`, `git`, `Python`, `Docker`, `Claude Code`, `Cursor`가 자주 깨집니다.

## 1\. Mac에서 Zscaler가 HTTPS를 검사 중인지 확인하기

MDM이 macOS 키체인에 **Zscaler Root CA**를 미리 설치하고 신뢰하도록 구성하므로 Zscaler가 HTTPS Break-and-Inspect를 수행해도 Safari와 Chrome에는 정상 자물쇠가 뜹니다. 다음 두 방법 중 하나로 도메인별 복호화 여부를 확인하세요.

*   **SWG bar로 지속 확인**: macOS 14+(Apple Silicon)에 [SWG bar를 설치](<https://swgbar.com/ko/install/>)(14사용일 무료 체험)하고 대상 사이트에 접속한 뒤 **SWG bar → 도메인**이나 **인증서**(또는 `swgbar probe <domain>`)를 열어 `Zscaler Root CA`(또는 회사 Zscaler 중간 CA)에 의해 **확인됨**으로 가로채기되고 있는지, 아니면 **공개 신뢰 경로**로 통과하는지 확인합니다.
*   **터미널에서 단일 도메인 즉시 확인**:

```
openssl s_client -connect api.github.com:443 -servername api.github.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject
```

`issuer=`가 DigiCert, Let’s Encrypt, Google Trust Services 같은 공개 CA가 아니라 `Zscaler`나 조직의 Zscaler 중간 CA로 표시된다면 해당 호스트 이름에 Zscaler SSL 검사가 적용 중입니다. SHA-256 지문 교차 검증은 [OpenSSL 및 security verify-cert로 TLS 인증서 검증하기](<https://swgbar.com/ko/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)를 참고하세요.

## 2\. Zscaler Client Connector 로그아웃이나 데몬 언로드가 실패하는 이유

관리형 Mac에서 Zscaler를 전역으로 끄려는 시도는 대부분 실패하거나 역효과를 냅니다.

*   **변조 방지(Tamper Protection)**: 대부분의 기업 ZCC 앱 프로필은 로그아웃이나 Internet Security(`ZIA`) 비활성화 시 IT 일회용 비밀번호를 요구하며, `sudo launchctl bootout system /Library/LaunchDaemons/com.zscaler.*` 명령도 차단되거나 즉시 재실행됩니다.
*   **Z-Tunnel 2.0은 시스템 프록시 설정을 무시함**: macOS 시스템 설정에서 Wi-Fi HTTP/HTTPS 프록시 토글을 꺼도 Z-Tunnel 2.0 패킷 라우팅에는 영향이 없습니다.
*   **사내 리소스 접속 단절**: ZCC가 중지되면 ZPA(Zscaler Private Access) 사내 앱과 기기 보안 상태 검증이 필요한 기업 SSO(`Okta`, `Entra ID`)까지 중단됩니다.

## 3\. macOS에서 Zscaler SSL 검사를 처리하는 3가지 실전 방법

| 방법 | 제어 주체 | ZCC 및 기업 SSO 유지 | 최적 사용 사례 |
| --- | --- | --- | --- |
| **도메인별 SWG 우회(`SWG bar`)** | 로컬 Mac 사용자(승인된 네트워크) | 예 — 선택한 호스트 이름만 Mac의 물리적 `하드웨어` IPv4 인터페이스로 라우팅 | ZCC를 끄지 않고 피닝 앱·WebSocket·개발 API 문제를 즉시 해결할 때([Mac에서 SWG 우회하는 방법](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)) |
| **Zscaler 관리자 포털 예외(`Do Not Inspect` / 앱 프로필)** | 기업 IT / 보안 팀 | 예 | **Policy → SSL Inspection → Do Not Inspect** 또는 macOS **App Profiles → Hostname/IP Bypass**에서 전사 영구 예외 구성([SWG 우회와 TLS 예외 비교](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)) |
| **CLI 도구에 Zscaler Root CA 내보내기 및 신뢰 설정** | 로컬 개발자 | 예(트래픽은 계속 검사됨) | 복호화 라우팅 정책을 유지하면서 `git`, `npm`, `brew`, `Python`, `Claude Code`, `Cursor`의 `unable to get local issuer certificate` 오류를 해결할 때 |

## 4\. 도메인별 우회 활성화 또는 CLI용 Zscaler Root CA 구성

### 옵션 A: 승인된 네트워크에서 SWG bar로 도메인별 우회 켜기

1.  **SWG bar → 도메인**에서 문제가 발생하는 정확한 호스트 이름을 찾고(로그인·API·CDN 도메인은 별개의 호스트 이름입니다 — [멀티 도메인 SSO·API·CDN 우회 가이드](<https://swgbar.com/ko/guides/multi-domain-sso-api-cdn-swg-bypass/>) 참고) **SWG 우회** 옆 **켜기**를 클릭하거나 `swgbar bypass enable <domain>`을 실행합니다.
2.  **우회 중**이 표시되면 기존 풀 연결이 직접 `하드웨어` IPv4 경로로 다시 열리도록 브라우저 탭, IDE, CLI 세션을 재시작합니다.
3.  `swgbar probe <domain>`으로 원본 서버의 공개 인증서 체인이 반환되는지 확인합니다. 방화벽이 직접 아웃바운드 연결을 차단하는 경우 `swgbar bypass disable <domain>`을 실행해 즉시 일반 Zscaler 라우팅으로 복원하세요.

### 옵션 B: CLI 및 AI 도구가 Zscaler Root CA를 신뢰하도록 구성

트래픽이 Zscaler를 통해 계속 복호화되어야 한다면 키체인 접근에서 Zscaler Root CA PEM 번들을 내보내거나 IT에서 받은 뒤, SSL 검증을 끄는 대신 런타임 환경 변수를 설정하세요.

```
# Node.js, npm, Claude Code, Cursor
export NODE_EXTRA_CA_CERTS="$HOME/.certs/zscaler-root.pem"

# Python (pip, requests), OpenSSL, Homebrew curl
export SSL_CERT_FILE="$HOME/.certs/zscaler-root.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"
export CURL_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"

# Git
git config --global http.sslCAInfo "$HOME/.certs/zscaler-root.pem"
```

Homebrew, Docker Desktop, Python, Node.js, Claude Code, Cursor별 전체 설정 방법은 [Homebrew·Docker·Python·Node.js CA 신뢰 설정](<https://swgbar.com/ko/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)과 [Mac에서 Claude Code 및 Cursor 인증서 오류 해결](<https://swgbar.com/ko/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)을 참고하세요.

## 관련 가이드

*   [Mac에서 SWG 우회하는 방법 (원클릭 도메인 우회 및 CLI)](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)
*   [Mac에서 SSL 검사 우회하는 방법(기업 SWG 도메인별 해결책)](<https://swgbar.com/ko/guides/bypass-ssl-inspection-mac/>)
*   [macOS에서 HTTPS 및 TLS 검사 우회하는 방법(Break-and-Inspect 가이드)](<https://swgbar.com/ko/guides/bypass-https-tls-inspection-mac/>)
*   [Mac에서 기업 프록시 및 SWG SSL 검사 우회하는 방법](<https://swgbar.com/ko/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [내 Mac이 SWG에 의해 가로채기되고 있는지 확인하는 방법(HTTPS 및 SSL 검사)](<https://swgbar.com/ko/guides/detect-https-inspection/>)
*   [회사나 업무용 Mac이 HTTPS를 가로채고 있는지 확인하는 방법(SSL 검사)](<https://swgbar.com/ko/guides/check-if-work-mac-intercepting-https/>)
*   [Mac용 SSL 검사 체커: HTTPS 가로채기를 감지하는 메뉴 막대 도구](<https://swgbar.com/ko/guides/ssl-inspection-checker-mac/>)
*   [Mac의 Netskope SSL 검사: 복호화 확인 및 도메인별 우회](<https://swgbar.com/ko/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac의 Cloudflare WARP 및 Zero Trust TLS 검사: 감지 및 우회](<https://swgbar.com/ko/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar에서 HTTPS 검사의 ‘확인됨’과 ‘의심됨’ 분류 이해하기](<https://swgbar.com/ko/guides/confirmed-vs-suspected-https-inspection/>)
*   [SWG bar에서 중간자(MITM) 루트 인증서 및 발급자 확인하기](<https://swgbar.com/ko/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac의 기업용 SWG 및 MDM HTTPS 검사 원리](<https://swgbar.com/ko/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 우회와 TLS 검사 예외(Break-and-Inspect) 비교](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)
*   [Mac에서 멀티 도메인 웹 앱, SSO, CDN, API용 SWG 우회하기](<https://swgbar.com/ko/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Mac에서 SWG 우회 ‘복구 중’, ‘일시 중지’ 및 연결 오류 해결하기](<https://swgbar.com/ko/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS VPN 가상 인터페이스와 SWG HTTPS 검사 비교](<https://swgbar.com/ko/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [인증서 피닝 및 mTLS 앱이 SWG 검사 환경에서 실패하는 이유](<https://swgbar.com/ko/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Mac의 CLI 및 AI 도구에서 발생하는 SWG TLS/SSL 인증서 오류 해결](<https://swgbar.com/ko/guides/swg-tls-certificate-errors-macos/>)
*   [Mac의 SWG 환경에서 Homebrew, Docker, Python, Node.js CA 신뢰 구성](<https://swgbar.com/ko/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Mac에서 Claude Code 및 Cursor의 'unable to get local issuer certificate' 오류 해결(SWG 및 MCP)](<https://swgbar.com/ko/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Mac에서 openssl과 security verify-cert로 TLS 인증서 검증하기](<https://swgbar.com/ko/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 권한, 로컬 개인정보 보호 및 TLS 프로브 제한](<https://swgbar.com/ko/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar의 HTTPS 검사 원리](<https://swgbar.com/ko/how-it-works/>)
*   [Mac용 SWG bar 다운로드 및 설치(macOS 14+)](<https://swgbar.com/ko/install/>)
*   [SSL 및 HTTPS 검사를 감지하는 Chrome 확장 프로그램(SWG bar 연동)](<https://swgbar.com/ko/chrome-extension/>)
*   [SWG bar CLI 가이드](<https://swgbar.com/ko/cli/>)
*   [SWG bar MCP 가이드](<https://swgbar.com/ko/mcp/>)
*   [SWG bar 릴리스 정보](<https://swgbar.com/ko/releases/>)
*   [SWG bar 소개](<https://swgbar.com/ko/about/>)
