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

# 인증서 피닝 및 mTLS 앱이 SWG 검사 환경에서 실패하는 이유

MDM이 루트 CA를 신뢰하더라도 TLS 인증서 피닝이나 상호 TLS(mTLS)를 사용하는 앱이 macOS의 기업 SWG HTTPS Break-and-Inspect 환경에서 실패하는 이유를 알아보세요.

SWG bar · 업데이트 2026년 11월 18일

MDM으로 관리되는 Mac 사용자는 일반 웹사이트가 기업 보안 웹 게이트웨이(SWG) 뒤에서 아무 문제 없이 열리는 반면, 특정 데스크톱 앱, 보안 업데이터, 모바일 SDK 또는 개발자 API는 곧바로 TLS 핸드셰이크에 실패하는 현상을 자주 겪습니다. 대부분은 \*\*인증서 피닝(Certificate Pinning)\*\*이나 \*\*상호 TLS(mTLS)\*\*가 SWG의 **HTTPS/SSL Break-and-Inspect**와 충돌하기 때문입니다.

## MDM 루트 신뢰로 인증서 피닝을 해결할 수 없는 이유

일반적인 HTTPS 브라우징에서는 Safari와 Chrome이 MDM을 통해 배포된 기업 루트 CA를 포함하여 **macOS 키체인**에 있는 모든 유효한 인증서 체인을 신뢰합니다.

그러나 \*\*TLS 인증서 피닝(HPKP / SPKI 피닝)\*\*을 구현한 앱은 한 단계 더 나아가 예상되는 공개 키 해시(SPKI) 또는 리프/중간 인증서를 애플리케이션 바이너리 내부에 직접 내장합니다. 기업 SWG가 TLS를 종료하고 자체 기업 루트 CA로 인증서를 다시 서명하면 다음과 같은 일이 벌어집니다.

1.  macOS 키체인은 SWG 인증서가 유효하다고 판단합니다.
2.  피닝된 애플리케이션은 SWG 인증서의 공개 키 지문을 내장된 핀과 비교합니다.
3.  지문이 일치하지 않으므로 애플리케이션은 중간자 가로채기를 방지하기 위해 TLS 핸드셰이크를 즉시 중단합니다.

## Break-and-Inspect 중에 상호 TLS(mTLS)가 깨지는 이유

\*\*상호 TLS(mTLS)\*\*에서는 양측이 모두 인증합니다. 접근이 허용되기 전에 클라이언트가 원본 서버에 클라이언트 인증서를 제시해야 하며, 이는 금융권 API, B2B 엔드포인트, 제로 트러스트 API, 하드웨어 기반 개발자 서비스에서 흔히 쓰입니다.

SWG가 중간에서 HTTP 페이로드를 복호화하기 위해 TLS 연결을 종료하면, 원본 서버는 Mac의 클라이언트 TLS 핸드셰이크가 아니라 SWG의 연결만 보게 되므로 게이트웨이가 순수 암호화 패스스루(pass-through)로 동작하거나 해당 호스트를 제외하지 않는 한 종단 간 클라이언트 인증서 검증이 깨집니다.

## Mac에서 가로채기되는 호스트 이름 진단하기

IT 팀에 게이트웨이 규칙을 요청하거나 로컬 규칙을 구성하기 전에, 피닝 또는 mTLS 앱이 접속하는 정확한 호스트 이름을 먼저 식별하세요.

1.  [SWG bar](<https://swgbar.com/ko/install/>)를 열고 앱에서 연결 실패를 재현하세요.
2.  **SWG bar → 도메인**을 확인하거나 `swgbar domains list --status confirmed`를 실행하여 해당 앱이 연결하는 정확한 API, CDN 또는 업데이트 호스트 이름을 찾으세요.
3.  도메인 상세 정보와 **인증서** 탭을 열어 기업 SWG 루트 CA가 해당 호스트의 TLS를 종료하고 있는지 확인하세요.

![루트 CA와 연결된 도메인 수를 보여 주는 SWG bar 인증서 탭 예시 미리보기.](<https://swgbar.com/optimized/panel-native-certificates-four-tabs-720.webp>)

_앱의 API나 업데이트 호스트 이름이 SWG bar의 검사 CA 클러스터 아래에 표시되는지 확인하세요._

## 상황에 맞는 해결 방법 선택하기

*   **운영 / 관리형 기업 워크플로**: TLS 피닝을 깨뜨리지 않고 게이트웨이 라우팅을 유지하려면 IT 또는 보안 관리자에게 피닝 또는 mTLS 호스트 이름에 대한 \*\*TLS 검사 예외(복호화 제외 규칙)\*\*를 요청하세요. [SWG 우회와 TLS 검사 예외 비교](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)를 참고하세요.
*   **승인된 로컬 테스트 및 개발**: 직접 관리하거나 테스트 권한이 있는 네트워크에서는 **도메인** 화면이나 `swgbar bypass enable <domain>`으로 [도메인별 SWG 우회](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)를 사용하여 해당 호스트 이름만 게이트웨이 복호화 없이 연결할 수 있습니다.
*   **CLI 및 AI 런타임 CA 저장소 오류**: 엄격한 피닝 문제가 아니라 `git`, `npm`, `Python`, `Claude Code`, `Cursor`가 macOS 키체인을 무시해서 발생하는 문제라면 [Mac의 CLI 및 AI 도구에서 발생하는 SWG TLS/SSL 인증서 오류 해결](<https://swgbar.com/ko/guides/swg-tls-certificate-errors-macos/>)을 따르세요.

## 관련 가이드

*   [Mac에서 SWG 우회하는 방법 (원클릭 도메인 우회 및 CLI)](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)
*   [Mac에서 SSL 검사 우회하는 방법(기업 SWG 도메인별 해결책)](<https://swgbar.com/ko/guides/bypass-ssl-inspection-mac/>)
*   [macOS에서 HTTPS 및 TLS 검사 우회하는 방법(Break-and-Inspect 가이드)](<https://swgbar.com/ko/guides/bypass-https-tls-inspection-mac/>)
*   [Mac에서 기업 프록시 및 SWG SSL 검사 우회하는 방법](<https://swgbar.com/ko/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [내 Mac이 SWG에 의해 가로채기되고 있는지 확인하는 방법(HTTPS 및 SSL 검사)](<https://swgbar.com/ko/guides/detect-https-inspection/>)
*   [회사나 업무용 Mac이 HTTPS를 가로채고 있는지 확인하는 방법(SSL 검사)](<https://swgbar.com/ko/guides/check-if-work-mac-intercepting-https/>)
*   [Mac용 SSL 검사 체커: HTTPS 가로채기를 감지하는 메뉴 막대 도구](<https://swgbar.com/ko/guides/ssl-inspection-checker-mac/>)
*   [Mac의 Zscaler SSL 검사: 도메인별 확인 및 우회 방법](<https://swgbar.com/ko/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac의 Netskope SSL 검사: 복호화 확인 및 도메인별 우회](<https://swgbar.com/ko/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac의 Cloudflare WARP 및 Zero Trust TLS 검사: 감지 및 우회](<https://swgbar.com/ko/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar에서 HTTPS 검사의 ‘확인됨’과 ‘의심됨’ 분류 이해하기](<https://swgbar.com/ko/guides/confirmed-vs-suspected-https-inspection/>)
*   [SWG bar에서 중간자(MITM) 루트 인증서 및 발급자 확인하기](<https://swgbar.com/ko/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac의 기업용 SWG 및 MDM HTTPS 검사 원리](<https://swgbar.com/ko/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 우회와 TLS 검사 예외(Break-and-Inspect) 비교](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)
*   [Mac에서 멀티 도메인 웹 앱, SSO, CDN, API용 SWG 우회하기](<https://swgbar.com/ko/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Mac에서 SWG 우회 ‘복구 중’, ‘일시 중지’ 및 연결 오류 해결하기](<https://swgbar.com/ko/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS VPN 가상 인터페이스와 SWG HTTPS 검사 비교](<https://swgbar.com/ko/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Mac의 CLI 및 AI 도구에서 발생하는 SWG TLS/SSL 인증서 오류 해결](<https://swgbar.com/ko/guides/swg-tls-certificate-errors-macos/>)
*   [Mac의 SWG 환경에서 Homebrew, Docker, Python, Node.js CA 신뢰 구성](<https://swgbar.com/ko/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Mac에서 Claude Code 및 Cursor의 'unable to get local issuer certificate' 오류 해결(SWG 및 MCP)](<https://swgbar.com/ko/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Mac에서 openssl과 security verify-cert로 TLS 인증서 검증하기](<https://swgbar.com/ko/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 권한, 로컬 개인정보 보호 및 TLS 프로브 제한](<https://swgbar.com/ko/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar의 HTTPS 검사 원리](<https://swgbar.com/ko/how-it-works/>)
*   [Mac용 SWG bar 다운로드 및 설치(macOS 14+)](<https://swgbar.com/ko/install/>)
*   [SSL 및 HTTPS 검사를 감지하는 Chrome 확장 프로그램(SWG bar 연동)](<https://swgbar.com/ko/chrome-extension/>)
*   [SWG bar CLI 가이드](<https://swgbar.com/ko/cli/>)
*   [SWG bar MCP 가이드](<https://swgbar.com/ko/mcp/>)
*   [SWG bar 릴리스 정보](<https://swgbar.com/ko/releases/>)
*   [SWG bar 소개](<https://swgbar.com/ko/about/>)
