Inspeksi SSL Zscaler di Mac: Cara Memeriksa & Bypass per Domain
Periksa apakah Zscaler Client Connector mendekripsi HTTPS di Mac Anda, mengapa mematikan ZCC gagal saat Tamper Protection aktif, serta cara bypass per domain atau atur CA CLI.
SWG bar · Diperbarui
Untuk memeriksa apakah Zscaler (ZIA / Zscaler Client Connector) mendekripsi lalu lintas HTTPS di Mac Anda, buka SWG bar → Ringkasan (atau jalankan swgbar overview) dan cari Rasio inspeksi domain di atas 0% dengan Zscaler Root CA atau CA perantara perusahaan tercantum di bawah Sertifikat perantara (MITM). Untuk melewati inspeksi SSL Zscaler bagi satu nama host yang bermasalah di Mac yang berwenang, buka SWG bar → Domain, pilih nama host, lalu aktifkan Lewati SWG (atau jalankan swgbar bypass enable <domain>).
Sebagian besar panduan online untuk melewati Zscaler berasumsi Anda memiliki akses masuk ke Zscaler Admin Portal (ZIA). Pada MacBook perusahaan yang dikelola melalui Jamf, Kandji, atau Intune, pengembang dan karyawan jarang memiliki akses portal—sementara Z-Tunnel 2.0 (terowongan NetworkExtension / utun) dan Zscaler Root CA milik Zscaler sering merusak aplikasi dengan certificate pinning, Homebrew, npm, git, Python, Docker, Claude Code, dan Cursor.
1. Periksa apakah Zscaler sedang menginspeksi HTTPS di Mac Anda
Karena MDM memasang dan memercayai Zscaler Root CA secara bawaan di Rantai Kunci macOS, Safari dan Chrome tetap menampilkan ikon gembok normal meskipun Zscaler melakukan HTTPS break-and-inspect. Verifikasi dekripsi per domain dengan salah satu metode berikut:
- Pemeriksaan berkelanjutan dengan SWG bar: Pasang SWG bar (macOS 14+ Apple silicon, uji coba gratis 14 hari penggunaan) dan kunjungi situs target. Buka SWG bar → Domain atau Sertifikat—atau jalankan
swgbar probe <domain>—untuk melihat apakah domain tersebut Terkonfirmasi diintersepsi olehZscaler Root CA(atau CA perantara Zscaler perusahaan Anda) atau lewat melalui Jalur publik. - Pemeriksaan cepat satu domain di Terminal:
openssl s_client -connect api.github.com:443 -servername api.github.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject
Jika issuer= menampilkan Zscaler atau CA perantara Zscaler khusus organisasi Anda alih-alih CA publik (seperti DigiCert, Let’s Encrypt, atau Google Trust Services), berarti inspeksi SSL Zscaler aktif untuk nama host tersebut. Lihat Verifikasi sertifikat TLS dengan OpenSSL dan security verify-cert untuk mencocokkan sidik jari SHA-256.
2. Mengapa keluar atau membongkar Zscaler Client Connector gagal
Mencoba menonaktifkan Zscaler secara global di Mac terkelola hampir selalu berdampak buruk:
- Tamper Protection: Sebagian besar App Profile ZCC perusahaan memerlukan kata sandi sekali pakai dari TI untuk keluar atau menonaktifkan Internet Security (
ZIA), dan perintahsudo launchctl bootout system /Library/LaunchDaemons/com.zscaler.*diblokir atau langsung dihidupkan kembali. - Z-Tunnel 2.0 mengabaikan pengaturan Proxy Sistem: Mematikan sakelar proxy HTTP/HTTPS Wi-Fi di Pengaturan Sistem macOS tidak berpengaruh pada pengalihan paket Z-Tunnel 2.0.
- Akses perusahaan terputus: Bahkan jika ZCC berhenti, aplikasi internal ZPA (Zscaler Private Access) dan SSO berbasis postur perangkat (
Okta,Entra ID) akan berhenti bekerja.
3. Tiga cara praktis menangani inspeksi SSL Zscaler di macOS
| Pendekatan | Siapa yang mengontrol | ZCC & SSO perusahaan tetap berjalan? | Skenario terbaik |
|---|---|---|---|
Bypass SWG per domain (SWG bar) |
Pengguna Mac lokal (di jaringan berwenang) | Ya — merutekan hanya nama host terpilih lewat antarmuka IPv4 fisik Perangkat keras |
Solusi langsung tingkat nama host untuk aplikasi pinning, WebSockets, atau API pengembang yang gagal tanpa menonaktifkan ZCC (Cara melewati SWG di Mac) |
Pengecualian Zscaler Admin Portal (Do Not Inspect / App Profile) |
Tim TI / Keamanan perusahaan | Ya | Pengecualian permanen lintas organisasi di Policy → SSL Inspection → Do Not Inspect atau macOS App Profiles → Hostname/IP Bypass (Bypass SWG vs. pengecualian TLS) |
| Ekspor & percayai Zscaler Root CA di alat CLI | Pengembang lokal | Ya (lalu lintas tetap diinspeksi) | Kebijakan perusahaan mewajibkan perutean terdekripsi dan git, npm, brew, Python, Claude Code, atau Cursor gagal dengan unable to get local issuer certificate |
4. Aktifkan bypass per domain atau konfigurasikan Zscaler Root CA untuk alat CLI
Opsi A: Bypass per domain dengan SWG bar (bila berwenang)
- Buka SWG bar → Domain, temukan nama host persis yang gagal (ingat bahwa domain login, API, dan CDN adalah nama host terpisah—lihat bypass SSO, API, dan CDN multi-domain), lalu klik Aktifkan bypass untuk domain ini di samping Lewati SWG—atau jalankan
swgbar bypass enable <domain>. - Tunggu hingga muncul Bypass aktif, lalu mulai ulang tab browser, IDE, atau sesi CLI agar koneksi yang sudah terbuka tersambung ulang lewat rute IPv4
Perangkat keraslangsung. - Verifikasi dengan
swgbar probe <domain>bahwa rantai sertifikat publik server asal kini dikembalikan. Jika firewall memblokir koneksi keluar langsung, jalankanswgbar bypass disable <domain>untuk langsung mengembalikan perutean Zscaler normal.
Opsi B: Konfigurasikan CLI & alat AI agar memercayai Zscaler Root CA
Jika kebijakan jaringan mengharuskan lalu lintas tetap didekripsi oleh Zscaler, ekspor bundel PEM Zscaler Root CA Anda dari Akses Rantai Kunci (atau minta file PEM dari tim TI) lalu konfigurasikan runtime Anda alih-alih mematikan verifikasi 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"
Untuk panduan runtime lengkap yang mencakup Homebrew, Docker Desktop, Python, Node.js, Claude Code, dan Cursor, baca Konfigurasi kepercayaan CA untuk Homebrew, Docker, Python, dan Node.js serta Perbaiki error sertifikat Claude Code & Cursor di macOS.