Source: https://swgbar.com/id/guides/bypass-https-tls-inspection-mac/
Language: id

# Cara Melewati Inspeksi HTTPS & TLS di macOS (Panduan Break-and-Inspect)

Lewati dekripsi break-and-inspect HTTPS dan TLS di macOS per domain dengan SWG bar: bagaimana pengakhiran TLS mengganggu HTTP/2, QUIC, dan pinning, serta verifikasi CLI.

SWG bar · Diperbarui 19 November 2026

Untuk melewati **inspeksi HTTPS atau TLS (break-and-inspect)** bagi domain tertentu di macOS tanpa menonaktifkan klien keamanan secara global, buka **SWG bar → Domain**, pilih nama host, lalu aktifkan **Lewati SWG** (atau jalankan `swgbar bypass enable <domain>`). Tunggu hingga baris menampilkan **Bypass aktif**, kemudian mulai ulang tab browser, IDE, atau sesi CLI agar jabat tangan TLS baru terbentuk melalui antarmuka IPv4 fisik `Perangkat keras` Mac Anda.

Secure Web Gateway (SWG) perusahaan dan firewall generasi baru menginspeksi lalu lintas HTTPS dengan bertindak sebagai perantara tepercaya (_man-in-the-middle_): perangkat ini mengakhiri jabat tangan TLS 1.2/1.3 keluar dari Mac Anda, memeriksa payload HTTP yang telah didekripsi, lalu mengenkripsi ulang lalu lintas ke server asal. Meskipun browser secara diam-diam menerima CA akar gateway yang dipasang via MDM, protokol modern dan klien pengembang yang ketat sering gagal akibat penandatanganan ulang TLS.

## Apa yang sebenarnya terganggu oleh HTTPS / TLS break-and-inspect di Mac

Bahkan ketika Mac Anda memercayai sertifikat akar perusahaan di Rantai Kunci, pengakhiran TLS di jalur lalu lintas mengganggu empat alur kerja umum macOS:

1.  **Certificate pinning dan mutual TLS (mTLS)**: Aplikasi yang mengunci kunci publik server asal atau menyajikan sertifikat klien langsung membatalkan jabat tangan begitu gateway menggantinya dengan sertifikat akhir miliknya sendiri. Lihat [Certificate pinning dan mTLS di bawah inspeksi SWG](<https://swgbar.com/id/guides/certificate-pinning-mtls-swg-inspection-macos/>).
2.  **HTTP/3 (QUIC) serta aliran HTTP/2 atau WebSocket berumur panjang**: Gateway yang menurunkan versi atau memproksi koneksi TLS sering memutus aliran UDP QUIC, membuat respons streaming LLM macet, atau mereset kanal IDE/WebSocket yang persisten.
3.  **Penyimpanan CA independen di CLI dan runtime bahasa**: Runtime seperti `Node.js`, `Python`, `Git`, `Homebrew`, `Docker`, `Claude Code`, dan `Cursor` membawa penyimpanan CA akar bawaan sehingga gagal dengan `CERTIFICATE_VERIFY_FAILED` atau `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`.
4.  **API pengembang yang sensitif terhadap latensi**: Mengarahkan setiap jabat tangan TLS melalui PoP SWG cloud yang jauh menambah waktu bolak-balik pada pemasangan paket, `git fetch`, dan pelengkapan kode waktu nyata.

## Bypass TLS per domain vs. pengaturan proxy lokal dan pengecualian gateway

| Aspek | Bypass per domain (`SWG bar`) | Pengecualian inspeksi TLS admin (`Do Not Decrypt`) | Pengeditan proxy lokal (`Pengaturan Sistem → Proxy`) |
| --- | --- | --- | --- |
| **Lapisan** | Perutean IPv4 fisik tingkat nama host melalui macOS NetworkExtension | Kebijakan dekripsi SWG / firewall terpusat | Hanya kolom proxy HTTP/HTTPS eksplisit milik OS |
| **Berfungsi pada SWG transparan?** | Ya, bila jalur IPv4 fisik dapat dijangkau | Ya (dikonfigurasi oleh tim TI) | Tidak — diabaikan atau ditimpa oleh agen `utun` / SWG transparan |
| **Memerlukan konsol admin TI?** | Tidak (kontrol lokal di Mac yang berwenang) | Ya (portal admin Zscaler, Netskope, Cloudflare, Palo Alto) | Tidak |
| **Menjaga postur perangkat / SSO?** | Ya — agen endpoint perusahaan tetap berjalan | Ya | Sering merusak perutean PAC perusahaan |

Untuk pembahasan arsitektur mendalam yang membandingkan perubahan rute dengan pengecualian dekripsi gateway, baca [Bypass SWG vs. pengecualian inspeksi TLS](<https://swgbar.com/id/guides/swg-bypass-vs-tls-exception/>).

## Lewati inspeksi HTTPS & TLS untuk satu domain di macOS

1.  **Identifikasi setiap nama host yang diinspeksi**: Buka **SWG bar → Domain** atau jalankan `swgbar domains list --status confirmed` melalui [CLI](<https://swgbar.com/id/cli/>). Ingat bahwa `example.com`, `auth.example.com`, dan `api.example.com` adalah nama host yang terpisah.
2.  **Aktifkan bypass per domain**: Klik **Aktifkan bypass untuk domain ini** pada baris **Lewati SWG** domain tersebut, atau jalankan:

```
swgbar bypass enable api.example.com
swgbar bypass status
```

3.  **Tutup koneksi TLS dan HTTP/3 dalam pool**: Menyegarkan satu tab browser saja bisa tetap memakai ulang soket HTTP/2 atau QUIC yang sudah terbuka di jalur inspeksi. Bypass native SWG bar menurunkan HTTP/3 ke HTTPS di atas TCP pada koneksi baru, jadi muat ulang tab atau tutup lalu buka kembali aplikasi target setelah **Bypass aktif** muncul.
4.  **Verifikasi rantai sertifikat terbaru**: Jalankan `swgbar probe api.example.com` (atau `openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null`) untuk memastikan penerbit publik server asal kini dikembalikan.

Jika muncul **Memulihkan…** atau **Bypass dijeda** alih-alih **Bypass aktif**, periksa [Atasi status Memulihkan…, Bypass dijeda, dan status bypass di macOS](<https://swgbar.com/id/guides/troubleshoot-swg-bypass-recovering-paused-macos/>).

## Nonaktifkan bypass atau beralih ke kepercayaan CA bila diperlukan

Klik kembali kontrol **Lewati SWG** yang aktif—atau jalankan `swgbar bypass disable <domain>`—untuk segera mengembalikan nama host ke perutean gateway standar. Keluar dari SWG bar juga langsung menghentikan bypass aktif sembari tetap mengingat pilihan nama host Anda untuk peluncuran berikutnya.

Jika jaringan Anda memblokir lalu lintas IPv4 keluar langsung pada tingkat firewall, nonaktifkan bypass dan gunakan [perbaikan kepercayaan CA untuk CLI & alat AI](<https://swgbar.com/id/guides/swg-tls-certificate-errors-macos/>) atau ajukan aturan **Do Not Decrypt** kepada administrator untuk nama host yang tepat.

## Baca juga

*   [Cara Melewati SWG di Mac (Bypass per Domain Satu Klik & CLI)](<https://swgbar.com/id/guides/how-to-bypass-swg/>)
*   [Cara Melewati Inspeksi SSL di Mac (SWG Perusahaan & Bypass per Domain)](<https://swgbar.com/id/guides/bypass-ssl-inspection-mac/>)
*   [Cara Melewati Proxy Perusahaan & Inspeksi SSL SWG di Mac](<https://swgbar.com/id/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Cara mengetahui apakah Mac Anda diintersepsi oleh SWG (inspeksi HTTPS & SSL)](<https://swgbar.com/id/guides/detect-https-inspection/>)
*   [Cara Mengecek Apakah Perusahaan atau Mac Kantor Mengintersepsi HTTPS (Inspeksi SSL)](<https://swgbar.com/id/guides/check-if-work-mac-intercepting-https/>)
*   [Pemeriksa Inspeksi SSL untuk Mac: Aplikasi Bar Menu Pendeteksi Intersepsi HTTPS](<https://swgbar.com/id/guides/ssl-inspection-checker-mac/>)
*   [Inspeksi SSL Zscaler di Mac: Cara Memeriksa & Bypass per Domain](<https://swgbar.com/id/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Inspeksi SSL Netskope di Mac: Cek Dekripsi & Bypass per Domain](<https://swgbar.com/id/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Inspeksi TLS Cloudflare WARP & Zero Trust di Mac: Deteksi & Bypass](<https://swgbar.com/id/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Inspeksi HTTPS Terkonfirmasi vs. Terindikasi di SWG bar](<https://swgbar.com/id/guides/confirmed-vs-suspected-https-inspection/>)
*   [Periksa sertifikat akar MITM & penerbitnya di SWG bar](<https://swgbar.com/id/guides/inspect-mitm-root-certificates-macos/>)
*   [Inspeksi HTTPS SWG perusahaan & MDM di Mac](<https://swgbar.com/id/guides/enterprise-swg-https-inspection-macos/>)
*   [Bypass SWG vs. pengecualian inspeksi TLS (break-and-inspect)](<https://swgbar.com/id/guides/swg-bypass-vs-tls-exception/>)
*   [Lewati SWG untuk aplikasi web multi-domain, SSO, CDN & API di Mac](<https://swgbar.com/id/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Atasi status Memulihkan…, Bypass dijeda & error koneksi di Mac](<https://swgbar.com/id/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Antarmuka virtual VPN macOS vs. inspeksi HTTPS SWG](<https://swgbar.com/id/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Mengapa aplikasi certificate-pinned & mTLS gagal di bawah inspeksi SWG](<https://swgbar.com/id/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Atasi error sertifikat TLS & SSL SWG di CLI dan alat AI di Mac](<https://swgbar.com/id/guides/swg-tls-certificate-errors-macos/>)
*   [Kepercayaan CA Homebrew, Docker, Python & Node.js di balik SWG di Mac](<https://swgbar.com/id/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Atasi Error 'unable to get local issuer certificate' Claude Code & Cursor di Mac (SWG & MCP)](<https://swgbar.com/id/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Verifikasi sertifikat TLS dengan openssl & security verify-cert di Mac](<https://swgbar.com/id/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Izin SWG bar, privasi lokal & batas pemeriksaan TLS](<https://swgbar.com/id/guides/macos-network-extension-privacy-probe-limits/>)
*   [Cara SWG bar memeriksa inspeksi HTTPS](<https://swgbar.com/id/how-it-works/>)
*   [Unduh & pasang SWG bar untuk Mac (macOS 14+)](<https://swgbar.com/id/install/>)
*   [Ekstensi Chrome untuk Mendeteksi Inspeksi SSL & HTTPS (Pendamping SWG bar)](<https://swgbar.com/id/chrome-extension/>)
*   [Panduan SWG bar CLI](<https://swgbar.com/id/cli/>)
*   [Panduan SWG bar MCP](<https://swgbar.com/id/mcp/>)
*   [Informasi rilis SWG bar](<https://swgbar.com/id/releases/>)
*   [Tentang SWG bar](<https://swgbar.com/id/about/>)
