Cara Melewati Proxy Perusahaan & Inspeksi SSL SWG di Mac
Mengapa mematikan Proxy Pengaturan Sistem macOS atau menjalankan networksetup gagal menghadapi proxy SWG transparan, serta cara bypass per domain atau memperbaiki error sertifikat CLI.
SWG bar · Diperbarui
Jika mematikan sakelar proxy Wi-Fi di Pengaturan Sistem → Jaringan → Proxy—atau menambahkan domain lewat networksetup -setproxybypassdomains—tetap meninggalkan Mac Anda di balik inspeksi SSL proxy perusahaan, berarti perangkat Anda menggunakan agen Secure Web Gateway (SWG) transparan (NetworkExtension atau terowongan utun) alih-alih proxy HTTP eksplisit biasa. Untuk melewati inspeksi SWG bagi nama host tertentu di Mac yang berwenang, buka SWG bar → Domain, pilih nama host, lalu aktifkan Lewati SWG (atau jalankan swgbar bypass enable <domain>).
Sebagian besar panduan proxy macOS mencampuradukkan dua arsitektur perusahaan yang sepenuhnya berbeda: proxy eksplisit / file PAC lawas dan agen SWG transparan modern (seperti Cisco Umbrella / Cisco Secure Client, Broadcom Cloud SWG, Zscaler, Netskope, atau Cloudflare Gateway). Mengetahui arsitektur mana yang dipakai Mac Anda langsung menjelaskan mengapa perubahan proxy standar tidak berdampak apa-apa—dan perbaikan mana yang benar-benar bekerja.
1. Periksa apakah Mac Anda memakai proxy eksplisit atau SWG transparan
Jalankan dua pemeriksaan cepat untuk melihat bagaimana lalu lintas diarahkan di macOS:
- Periksa pengaturan proxy sistem eksplisit:
scutil --proxy
Cari HTTPEnable : 1, HTTPSEnable : 1, atau ProxyAutoConfigURLString (URL .pac). 2. Periksa intersepsi sertifikat HTTPS sebenarnya: Buka SWG bar → Ringkasan (atau jalankan swgbar overview / swgbar domains list --status confirmed).
- Jika
scutil --proxykosong, tetapi SWG bar melaporkan Rasio inspeksi domain >0%(dengan domain Terkonfirmasi atau Terindikasi serta Sertifikat perantara (MITM)), Mac Anda berada di balik agen SWG transparan (NetworkExtension/utun) yang menangkap paket di bawah pengaturan Proxy Sistem macOS. - Jika
scutil --proxymencantumkan proxy/PAC perusahaan dan SWG bar menampilkan CA akar MITM perusahaan, lalu lintas dirutekan melalui proxy intersepsi eksplisit/PAC.
2. Proxy eksplisit vs. proxy SWG transparan di macOS
| Arsitektur | Lokasi macOS mengintersepsi lalu lintas | Apakah Pengaturan Sistem → Proxy / networksetup melewatinya? |
Solusi yang berfungsi pada Mac berwenang |
|---|---|---|---|
| Proxy HTTP/HTTPS eksplisit atau PAC (tidak terkelola) | Kolom proxy Konfigurasi Sistem macOS | Ya, jika tidak dikunci oleh MDM (Lewati pengaturan proxy untuk host & domain ini) |
Daftar Bypass Proxy macOS, atau verifikasi perutean per domain |
Proxy eksplisit terkunci MDM atau SWG transparan (NetworkExtension / utun) |
Filter soket & IP kernel / NetworkExtension di bawah sakelar proxy browser | Tidak — pengaturan dikunci, ditimpa, atau sepenuhnya diabaikan oleh terowongan SWG | Bypass IPv4 fisik Perangkat keras per domain melalui SWG bar (Cara melewati SWG di Mac), pengecualian gateway TI External Domains / Do Not Decrypt, atau konfigurasi bundel CA CLI |
3. Lewati inspeksi SSL proxy SWG untuk domain tertentu di macOS
Saat aplikasi web, endpoint API, atau klien desktop dengan certificate pinning gagal di balik proxy SWG perusahaan pada jaringan yang Anda kelola atau izinkan untuk dikonfigurasi:
- Pasang dan buka SWG bar (macOS 14+ pada Apple silicon, uji coba gratis 14 hari penggunaan) lalu ulangi permintaan agar nama host persisnya muncul di Domain.
- Buka detail nama host dan klik Aktifkan bypass untuk domain ini pada baris Lewati SWG—atau jalankan:
swgbar bypass enable <domain>
swgbar bypass status
- Tunggu hingga muncul Bypass aktif, lalu muat ulang halaman web atau mulai ulang terminal/klien desktop agar soket keep-alive yang ada dibuka ulang melalui antarmuka IPv4 fisik
Perangkat kerasMac Anda (en0/en7). - Verifikasi dengan
swgbar probe <domain>bahwa rantai sertifikat publik server asal disajikan dengan bersih. Perhatikan bahwa jika suatu aplikasi menetapkan pengaturan proxy eksplisitnya sendiri (misalnyaHTTP_PROXY/HTTPS_PROXYdi~/.zshrc,~/.npmrc, atau~/.gitconfig), hapus variabel proxy tersebut untuk host itu agar aplikasi tidak memaksa lalu lintas kembali ke port proxy eksplisit.
4. Saat Anda tidak dapat melewati proxy: pengecualian TI & bundel CA CLI
Jika firewall perusahaan memblokir semua lalu lintas IPv4 keluar langsung yang tidak melewati proxy SWG (perimeter fail-closed):
- Nonaktifkan bypass per domain (
swgbar bypass disable <domain>) agar nama host segera kembali ke perutean proxy normal. - Konfigurasikan alat CLI agar memercayai CA proxy perusahaan: Arahkan
git,curl,npm,Python,Homebrew,Claude Code, danCursorke file PEM CA perusahaan yang diekspor (SSL_CERT_FILE,NODE_EXTRA_CA_CERTS,REQUESTS_CA_BUNDLE,git http.sslCAInfo) alih-alih mematikan verifikasi SSL secara tidak aman. Lihat Atasi error sertifikat TLS & SSL SWG di CLI dan alat AI. - Ajukan bypass gateway / pengecualian dekripsi ke tim TI: Berikan kepada tim TI nama host persis yang gagal (termasuk domain login dan CDN) beserta bukti sertifikat dari SWG bar agar mereka dapat menambahkan aturan terpusat Do Not Decrypt atau External Domains List. Bandingkan kedua lapisan tersebut dalam Bypass SWG vs. pengecualian inspeksi TLS.