Kepercayaan CA Homebrew, Docker, Python & Node.js di balik SWG di Mac

Mengapa Homebrew, Docker Desktop, Node.js, Python, git, dan curl menolak sertifikat TLS yang ditandatangani SWG di macOS—serta cara mengonfigurasi bundel CA vs. bypass SWG.

SWG bar · Diperbarui

Pada Mac perusahaan di balik HTTPS break-and-inspect, setiap runtime pengembang memvalidasi sertifikat TLS secara berbeda. Sementara Safari dan Chrome berkonsultasi ke Rantai Kunci macOS (Keychain), alat CLI dan kontainer sering memakai bundel CA mereka sendiri—menyebabkan kegagalan build mendadak di berbagai manajer paket dan SDK.

Mengapa alat pengembang Mac gagal secara selektif

Alat / Runtime Penyimpanan kepercayaan default di macOS Variabel lingkungan atau pengaturan umum
Node.js / npm / yarn / pnpm Bundel CA Mozilla bawaan hasil kompilasi NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem
Python / pip / uv / requests Bundel certifi atau jalur CA OpenSSL SSL_CERT_FILE / REQUESTS_CA_BUNDLE
git OpenSSL atau Secure Transport tergantung build git config --global http.sslCAInfo /path/to/corp-ca.pem
curl / Homebrew (brew) macOS Secure Transport atau bundel CA OpenSSL HOMEBREW_CURLRC / CURL_CA_BUNDLE (periksa curl --version)
Docker Desktop / Kontainer VM Linux & /etc/ssl/certs image (bukan Keychain macOS) Tambahkan CA perusahaan ke penyimpanan kepercayaan VM / image Docker

1. Identifikasi nama host registri atau API mana yang diintersepsi

Sebelum mengubah profil shell atau build kontainer, pastikan terlebih dahulu nama host eksternal mana yang mengalami inspeksi SSL, alih-alih gagal akibat blokir DNS atau firewall:

swgbar domains list --status confirmed
swgbar probe registry.npmjs.org
swgbar probe pypi.org
swgbar probe ghcr.io

Perlu diingat bahwa manajer paket sering mengalihkan unduhan ke beberapa host berbeda (misalnya formulae.brew.sh → ghcr.io, atau github.com → objects.githubusercontent.com). Lihat Lewati SWG untuk aplikasi web multi-domain, SSO, CDN & API.

2. Pilih antara konfigurasi bundel CA, pengecualian TLS, atau bypass SWG

  • Tambahkan PEM CA akar perusahaan: Ketika kebijakan perusahaan mengharuskan seluruh lalu lintas melalui dekripsi SWG, ekspor CA akar persis yang teridentifikasi di SWG bar → Sertifikat lalu konfigurasikan NODE_EXTRA_CA_CERTS, SSL_CERT_FILE, REQUESTS_CA_BUNDLE, atau http.sslCAInfo sesuai panduan keamanan TI Anda. Jangan pernah menonaktifkan verifikasi TLS (NODE_TLS_REJECT_UNAUTHORIZED=0 atau sslVerify=false).
  • Ajukan pengecualian inspeksi TLS ke tim TI: Disarankan untuk registri bersama, image dasar Docker, atau alat dengan certificate pinning ketat di mana menjaga bundel CA kustom di CI dan mesin lokal rentan bermasalah.
  • Gunakan bypass SWG per domain pada jaringan yang berwenang: Ketika Anda mengelola atau diizinkan untuk melewati host tertentu di Mac Anda, aktifkan Lewati SWG di SWG bar (atau swgbar bypass enable <domain>) lalu mulai ulang proses CLI tersebut.

Bandingkan alur kerja sebelum mengubah default sistem

Untuk langkah demi langkah pemulihan CERTIFICATE_VERIFY_FAILED, baca Atasi error sertifikat TLS & SSL SWG di CLI dan alat AI di Mac. Untuk membandingkan aturan perutean lokal dengan pengecualian kebijakan gateway, tinjau Bypass SWG vs. pengecualian inspeksi TLS.