Inspeksi SSL Netskope di Mac: Cek Dekripsi & Bypass per Domain
Periksa apakah Netskope Client mendekripsi HTTPS di Mac Anda (CA *.goskope.com), bandingkan bypass per domain SWG bar vs. kebijakan Do Not Decrypt, dan atur nscacert_combined.pem.
SWG bar · Diperbarui
Untuk memeriksa apakah Netskope Client melakukan dekripsi SSL/TLS di Mac Anda, buka SWG bar → Ringkasan (atau jalankan swgbar overview) dan pastikan apakah Rasio inspeksi domain berada di atas 0% dengan sertifikat Netskope atau tenant *.goskope.com di bawah Sertifikat perantara (MITM). Untuk melewati inspeksi SSL Netskope bagi nama host tertentu di Mac yang berwenang, buka SWG bar → Domain, pilih nama host, lalu klik Aktifkan bypass untuk domain ini di samping Lewati SWG (atau jalankan swgbar bypass enable <domain>).
Netskope Secure Web Gateway banyak digunakan pada armada macOS perusahaan menggunakan klien pengarah berbasis NetworkExtension dan CA perantara khusus tenant. Karena CA akar Netskope didorong melalui MDM ke Rantai Kunci macOS, browser menampilkan indikator keamanan yang valid seperti biasa sementara runtime CLI (pip, npm, AWS CLI, git, Docker, Claude Code) dan aplikasi desktop dengan certificate pinning gagal dengan CERTIFICATE_VERIFY_FAILED atau UNABLE_TO_GET_ISSUER_CERT_LOCALLY.
1. Pastikan apakah Netskope mendekripsi suatu domain di Mac Anda
Periksa baik intersepsi seluruh sistem maupun masing-masing nama host:
- Visibilitas bar menu & Chrome dengan SWG bar: Pasang SWG bar (macOS 14+ Apple silicon, uji coba gratis 14 hari penggunaan) lalu jelajahi situs atau jalankan perintah yang gagal. Buka SWG bar → Domain atau jalankan
swgbar domains list --status confirmeduntuk melihat setiap nama host yang sertifikat TLS-nya ditandatangani ulang oleh CA tenant Netskope Anda (umumnya berformatca.<tenant>.goskope.comatau CA khusus perusahaan Anda). Pasangkan dengan ekstensi Chrome SWG bar gratis untuk melihat lencana status di bilah alat browser Anda. - Periksa sertifikat Netskope dan penerbit langsung di Terminal:
# Periksa apakah CA Netskope terpasang di System Keychain macOS
security find-certificate -c "Netskope" /Library/Keychains/System.keychain
# Periksa penerbit sertifikat langsung yang dikembalikan untuk nama host tertentu
openssl s_client -connect registry.npmjs.org:443 -servername registry.npmjs.org </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject
Ingat bahwa kebijakan Netskope sering mendekripsi sebagian domain SaaS atau layanan hosting kode sementara melewatkan domain lainnya tanpa perubahan; selalu uji nama host persis yang mengalami kegagalan.
2. Mengapa menutup Netskope Client biasanya tidak berhasil
Pada lingkungan terkelola dengan kebijakan perlindungan anti-perusakan Netskope Protect Client configuration and resources yang aktif, opsi Disable pada ikon bar menu Netskope dinonaktifkan atau dikunci dengan kata sandi, dan membongkar daemon secara paksa merusak perutean jaringan sistem. Menghapus kolom proxy Wi-Fi macOS juga tidak berdampak karena Netskope mengarahkan lalu lintas di lapisan NetworkExtension macOS.
3. Pilih solusi Netskope yang tepat di macOS
| Metode | Menghentikan dekripsi Netskope? | Memerlukan Admin Tenant Netskope? | Paling tepat ketika |
|---|---|---|---|
Bypass SWG per domain (SWG bar) |
Ya, untuk nama host terpilih lewat IPv4 Perangkat keras fisik |
Tidak (kontrol lokal di Mac yang berwenang) | Aplikasi pinning, WebSocket, atau endpoint pengembangan gagal di bawah dekripsi Netskope dan jalur IPv4 langsung tersedia (Cara melewati SWG di Mac) |
Pengecualian Tenant Netskope Do Not Decrypt / Certificate Pinned Apps |
Ya, terpusat di seluruh Mac terkelola | Ya (Policies → SSL Decryption → Do Not Decrypt atau Steering Configuration → Exceptions) | Aplikasi desktop pinning lintas organisasi atau endpoint pengembang bersama gagal di seluruh tim (Bypass SWG vs. pengecualian TLS) |
Bundel CA gabungan (nscacert_combined.pem) untuk alat CLI |
Tidak (lalu lintas tetap diinspeksi) | Tidak | Kebijakan mewajibkan perutean Netskope terdekripsi dan alat CLI/AI hanya perlu memercayai rantai CA Netskope |
4. Terapkan bypass per domain atau konfigurasikan kepercayaan CA CLI Netskope
Opsi A: Bypass per domain melalui SWG bar (bila berwenang)
- Buka SWG bar → Domain, pilih nama host persis yang diinspeksi (misalnya
api.anthropic.comataupypi.org), lalu klik Aktifkan bypass untuk domain ini di samping Lewati SWG—atau jalankanswgbar bypass enable <domain>. - Tunggu hingga muncul Bypass aktif, lalu mulai ulang tab browser, alat terminal, atau IDE Anda agar koneksi TLS/HTTP/3 yang ada di pool tersambung kembali melalui antarmuka IPv4 fisik
Perangkat keras. - Konfirmasi dengan
swgbar probe <domain>bahwa rantai sertifikat publik server asal kini disajikan. Untuk segera kembali ke semula, klik kontrol aktif atau jalankanswgbar bypass disable <domain>.
Opsi B: Buat bundel PEM gabungan untuk alat CLI di bawah Netskope
Jika lalu lintas harus tetap diinspeksi oleh Netskope, ekspor bundel PEM gabungan dari penyimpanan kepercayaan macOS Anda (atau gunakan bundel nscacert_combined.pem yang disediakan tim TI) lalu arahkan alat pengembang Anda ke file tersebut di ~/.zshrc:
security find-certificate -a -p \
/System/Library/Keychains/SystemRootCertificates.keychain \
/Library/Keychains/System.keychain > "$HOME/.certs/nscacert_combined.pem"
export NODE_EXTRA_CA_CERTS="$HOME/.certs/nscacert_combined.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
export SSL_CERT_FILE="$HOME/.certs/nscacert_combined.pem"
export AWS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
Lihat Atasi error sertifikat TLS & SSL SWG di CLI dan alat AI serta Kepercayaan CA Homebrew, Docker, Python, dan Node.js untuk pengaturan khusus tiap alat.