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

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 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.

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.
  • Pengujian & pengembangan lokal yang berwenang: Pada jaringan yang Anda kelola atau diizinkan untuk diuji, gunakan bypass SWG per domain 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.