Source: https://swgbar.com/id/guides/certificate-pinning-mtls-swg-inspection-macos/
Language: id

# Mengapa aplikasi certificate-pinned & mTLS gagal di bawah inspeksi SWG

Pahami mengapa aplikasi dengan penyematan sertifikat TLS (certificate pinning) atau mutual TLS (mTLS) gagal di balik break-and-inspect HTTPS SWG perusahaan di macOS meski MDM memercayai CA akar.

SWG bar · Diperbarui 18 November 2026

Karyawan dengan Mac terkelola MDM sering mendapati situs web biasa berjalan lancar di balik Secure Web Gateway (SWG) perusahaan, sedangkan aplikasi desktop tertentu, pembaru keamanan, SDK seluler, atau API pengembang langsung gagal saat jabat tangan (_handshake_) TLS. Dalam kebanyakan kasus, penyebabnya adalah **penyematan sertifikat (_certificate pinning_)** atau **mutual TLS (mTLS)** yang berbenturan dengan **HTTPS/SSL break-and-inspect** SWG.

## Mengapa kepercayaan akar MDM tidak dapat memperbaiki certificate pinning

Saat penjelajahan HTTPS normal, Safari dan Chrome memercayai rantai sertifikat valid mana pun yang berakar pada otoritas di dalam **Rantai Kunci macOS (Keychain)**—termasuk CA akar perusahaan yang dikirim melalui MDM.

Aplikasi yang menerapkan **penyematan sertifikat TLS (pinning HPKP / SPKI)** melangkah lebih jauh: aplikasi menanamkan hash kunci publik yang diharapkan (SPKI) atau sertifikat daun/perantara langsung di dalam biner aplikasi. Ketika SWG perusahaan mengakhiri TLS dan menandatangani ulang sertifikat dengan CA akar perusahaannya sendiri:

1.  Keychain macOS menyatakan sertifikat SWG valid.
2.  Aplikasi dengan _pinning_ membandingkan sidik jari kunci publik sertifikat SWG dengan pin bawaannya.
3.  Sidik jarinya tidak cocok—sehingga aplikasi segera membatalkan jabat tangan TLS untuk melindungi diri dari intersepsi _man-in-the-middle_.

## Mengapa mutual TLS (mTLS) rusak saat break-and-inspect

Dengan **mutual TLS (mTLS)**, kedua pihak saling mengautentikasi: klien menyajikan sertifikat klien ke server asal sebelum akses diberikan (umum pada API perbankan, endpoint B2B, API zero-trust, dan layanan pengembang berbasis perangkat keras).

Jika SWG berada di tengah dan mengakhiri koneksi TLS untuk mendekripsi payload HTTP, server asal melihat koneksi milik SWG alih-alih jabat tangan TLS klien Mac Anda—yang merusak validasi sertifikat klien ujung-ke-ujung kecuali gateway bertindak murni sebagai penerusan terenkripsi (_pass-through_) atau dikecualikan untuk host tersebut.

## Diagnosis nama host mana yang diintersepsi di Mac Anda

Sebelum meminta aturan gateway ke tim TI atau mengonfigurasi aturan lokal, identifikasi nama host persis yang dihubungi oleh aplikasi ber-_pinning_ atau mTLS tersebut:

1.  Buka [SWG bar](<https://swgbar.com/id/install/>) dan reproduksi kegagalan koneksi di aplikasi Anda.
2.  Periksa **SWG bar → Domain** (atau jalankan `swgbar domains list --status confirmed`) untuk menemukan nama host API, CDN, atau pembaruan persis yang dihubungi aplikasi tersebut.
3.  Periksa detail domain dan tab **Sertifikat** untuk memastikan apakah CA akar SWG perusahaan mengakhiri TLS bagi host tersebut.

![Tab Sertifikat SWG bar yang menampilkan CA akar dan jumlah domain terkait; pratinjau ilustratif.](<https://swgbar.com/optimized/panel-native-certificates-four-tabs-720.webp>)

_Pastikan apakah nama host API atau pembaruan aplikasi Anda muncul di bawah kluster CA inspeksi di SWG bar._

## Pilih penyelesaian yang sesuai

*   **Alur kerja perusahaan terkelola / produksi**: Ajukan **pengecualian inspeksi TLS (aturan jangan-dekripsi)** yang terarah kepada administrator TI atau keamanan Anda untuk nama host ber-_pinning_ atau mTLS agar perutean gateway tetap utuh tanpa merusak _pinning_ TLS. Lihat [Bypass SWG vs. pengecualian inspeksi TLS](<https://swgbar.com/id/guides/swg-bypass-vs-tls-exception/>).
*   **Pengujian & pengembangan lokal yang berwenang**: Pada jaringan yang Anda kelola atau diizinkan untuk diuji, gunakan [bypass SWG per domain](<https://swgbar.com/id/guides/how-to-bypass-swg/>) dari **Domain** atau `swgbar bypass enable <domain>` agar nama host spesifik tersebut terhubung tanpa dekripsi gateway.
*   **Error penyimpanan CA runtime CLI & AI**: Jika kegagalan bukan karena _pinning_ ketat, melainkan karena `git`, `npm`, `Python`, `Claude Code`, atau `Cursor` mengabaikan Keychain macOS, ikuti [Atasi error sertifikat TLS & SSL SWG di CLI dan alat AI di Mac](<https://swgbar.com/id/guides/swg-tls-certificate-errors-macos/>).

## 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/>)
*   [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/>)
