Source: https://swgbar.com/id/guides/swg-tls-certificate-errors-macos/
Language: id

# Atasi error sertifikat TLS & SSL SWG di CLI dan alat AI di Mac

Atasi error CERTIFICATE\_VERIFY\_FAILED dan local issuer certificate pada git, npm, Python, Claude Code, serta Cursor di balik SWG pada macOS.

SWG bar · Diperbarui 18 November 2026

Saat Mac kantor berada di balik Secure Web Gateway (SWG) yang menjalankan **inspeksi HTTPS/SSL (break-and-inspect)**, Safari dan Chrome sering kali memuat situs web tanpa peringatan sementara alat Terminal dan agen pengodean AI gagal dengan error jabat tangan (_handshake_) TLS seperti `SSL: CERTIFICATE_VERIFY_FAILED`, `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`, atau `SSL certificate problem: unable to get local issuer certificate`.

Ketidakcocokan ini terjadi karena browser memeriksa **Rantai Kunci macOS (Keychain)**—tempat MDM dapat memasang CA akar inspeksi organisasi Anda—sedangkan banyak runtime baris perintah (`git`, `curl`, `Node.js`/`npm`, `Python`/`pip`) dan alat AI (`Claude Code`, `Cursor`, server MCP) memvalidasi sertifikat terhadap penyimpanan CA publik bawaan mereka sendiri.

## 1\. Pastikan nama host mana yang mengalami inspeksi HTTPS

Sebelum mengubah variabel lingkungan (_environment variables_) atau pengaturan jaringan, pastikan terlebih dahulu apakah rantai sertifikat endpoint yang gagal memang diganti di Mac Anda:

1.  [Pasang dan buka SWG bar](<https://swgbar.com/id/install/>) pada macOS 14 atau lebih baru (Apple silicon).
2.  Jalankan perintah yang gagal satu kali, lalu periksa **SWG bar → Domain**—atau uji langsung endpoint tersebut dari Terminal menggunakan [CLI](<https://swgbar.com/id/cli/>) bawaan:

```
/Applications/SWGBar.app/Contents/MacOS/swgbar probe registry.npmjs.org
/Applications/SWGBar.app/Contents/MacOS/swgbar domains detail registry.npmjs.org
```

3.  Periksa klasifikasi dan CA akarnya. Ingat bahwa antarmuka web, server autentikasi, registri paket, dan endpoint API LLM sering kali menggunakan nama host berbeda—satu subdomain bisa lewat tanpa disentuh sementara subdomain lain didekripsi.

Jika Anda menggunakan asisten yang kompatibel dengan MCP, Anda juga dapat menghubungkan [server MCP bawaan SWG bar](<https://swgbar.com/id/mcp/>) agar klien AI Anda dapat memeriksa domain yang diamati dan rantai sertifikat secara langsung.

## 2\. Pilih solusi yang tepat untuk lingkungan Anda

Setelah memastikan bahwa CA akar inspeksi menandatangani sertifikat nama host target, pilih salah satu dari tiga pendekatan berikut sesuai kebijakan jaringan dan kewenangan Anda:

| Pendekatan | Cara kerjanya | Paling tepat ketika |
| --- | --- | --- |
| **Konfigurasi kepercayaan CA untuk alat terkait** | Arahkan runtime (misalnya `NODE_EXTRA_CA_CERTS`, `SSL_CERT_FILE`, atau `REQUESTS_CA_BUNDLE`) ke bundel PEM hasil ekspor yang menyertakan CA akar perusahaan. | Kebijakan perusahaan mewajibkan perutean SWG terinspeksi dan Anda memercayai CA tersebut untuk alat spesifik itu. |
| **Ajukan pengecualian inspeksi TLS ke admin** | Tim TI mengecualikan nama host API atau registri dari dekripsi HTTPS pada gateway sambil tetap mempertahankan perutean melalui gateway. | Alat dengan penyematan sertifikat (_certificate pinning_) atau endpoint pengembang bersama tim gagal akibat _break-and-inspect_. |
| **Aktifkan bypass SWG per domain di SWG bar** | Merutekan nama host terpilih di macOS tanpa dekripsi HTTPS gateway melalui bar menu, CLI, atau MCP. | Anda mengelola jaringan atau berwenang menguji rute tanpa inspeksi untuk domain tertentu di Mac Anda. |

Baca [Bypass SWG vs. pengecualian inspeksi TLS](<https://swgbar.com/id/guides/swg-bypass-vs-tls-exception/>) untuk perbandingan arsitektur mendalam antara pengecualian di gateway dan perubahan rute.

## 3\. Lewati domain yang diinspeksi di macOS bila berwenang

Jika bypass per domain sesuai untuk jaringan Anda, aktifkan untuk nama host API atau registri yang tepat melalui bar menu (**SWG bar → Domain → Lewati SWG → Aktifkan bypass untuk domain ini**) atau dari Terminal:

```
/Applications/SWGBar.app/Contents/MacOS/swgbar bypass enable registry.npmjs.org
/Applications/SWGBar.app/Contents/MacOS/swgbar bypass status
```

Setelah status menampilkan **Bypass aktif**, mulai ulang perintah CLI, daemon latar belakang, atau host ekstensi IDE agar koneksi lama ditutup dan tersambung kembali melalui aturan baru. Ikuti [Cara melewati SWG di Mac](<https://swgbar.com/id/guides/how-to-bypass-swg/>) untuk persetujuan ekstensi jaringan macOS pertama kali, perilaku mulai ulang, dan cara menonaktifkan bypass setelah selesai.

## Perhatikan batas platform dan jaringan

*   **Cakupan per nama host**: Melewati `example.com` tidak otomatis mencakup `api.example.com` atau `auth.example.com`. Periksa setiap nama host yang dihubungi alat Anda.
*   **Persyaratan jaringan**: SWG bar 2.4.12 memerlukan macOS 14+ pada Apple silicon serta jalur IPv4 yang tersedia melalui antarmuka jaringan fisik. Jika firewall memblokir koneksi keluar langsung atau alat menerapkan proxy eksplisitnya sendiri, nonaktifkan aturan bypass dan gunakan pengecualian TLS administrator atau konfigurasi bundel CA.
*   **Verifikasi dengan bukti terbaru**: Jalankan pemeriksaan baru menggunakan [panduan inspeksi HTTPS & SSL](<https://swgbar.com/id/guides/detect-https-inspection/>) setelah melakukan perubahan apa pun, alih-alih mengandalkan hasil dalam cache.

## 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 Inspeksi HTTPS & TLS di macOS (Panduan Break-and-Inspect)](<https://swgbar.com/id/guides/bypass-https-tls-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/>)
*   [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/>)
