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

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

SWG bar · 업데이트

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를 열고 앱에서 연결 실패를 재현하세요.
  2. SWG bar → 도메인을 확인하거나 swgbar domains list --status confirmed를 실행하여 해당 앱이 연결하는 정확한 API, CDN 또는 업데이트 호스트 이름을 찾으세요.
  3. 도메인 상세 정보와 인증서 탭을 열어 기업 SWG 루트 CA가 해당 호스트의 TLS를 종료하고 있는지 확인하세요.
루트 CA와 연결된 도메인 수를 보여 주는 SWG bar 인증서 탭 예시 미리보기.

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

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

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