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

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

SWG bar · 업데이트

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를 설치(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 인증서 검증하기를 참고하세요.

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 우회하는 방법)
Zscaler 관리자 포털 예외(Do Not Inspect / 앱 프로필) 기업 IT / 보안 팀 예 Policy → SSL Inspection → Do Not Inspect 또는 macOS App Profiles → Hostname/IP Bypass에서 전사 영구 예외 구성(SWG 우회와 TLS 예외 비교)
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 우회 가이드 참고) 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 신뢰 설정과 Mac에서 Claude Code 및 Cursor 인증서 오류 해결을 참고하세요.