macOS에서 HTTPS 및 TLS 검사 우회하는 방법(Break-and-Inspect 가이드)

SWG bar로 macOS에서 도메인별 HTTPS/TLS Break-and-Inspect 복호화 우회: TLS 종료가 HTTP/2, QUIC, 인증서 피닝을 깨뜨리는 원인과 CLI 검증 방법.

SWG bar · 업데이트

보안 클라이언트를 전역으로 끄지 않고 macOS에서 특정 도메인의 **HTTPS 또는 TLS 검사(Break-and-Inspect)**를 우회하려면 SWG bar → 도메인을 열어 호스트 이름을 선택하고 SWG 우회를 활성화하세요(또는 swgbar bypass enable <domain> 실행). 해당 행에 우회 중이 표시된 뒤 브라우저 탭, IDE, CLI 세션을 다시 시작하면 Mac의 물리적 하드웨어 IPv4 인터페이스를 통해 새 TLS 핸드셰이크가 맺어집니다.

기업 보안 웹 게이트웨이(SWG)와 차세대 방화벽은 신뢰된 중간자(MITM)로 동작해 Mac의 아웃바운드 TLS 1.2/1.3 핸드셰이크를 종료하고 복호화된 HTTP 페이로드를 검사한 뒤 원본 서버로 다시 암호화합니다. 브라우저는 MDM으로 설치된 기업 루트 CA를 조용히 신뢰하지만 최신 프로토콜과 엄격한 개발 클라이언트는 TLS 재서명 과정에서 자주 오류를 일으킵니다.

HTTPS / TLS Break-and-Inspect가 Mac에서 깨뜨리는 4가지 영역

macOS 키체인이 기업 루트 인증서를 신뢰하더라도 인라인 TLS 종료는 다음 4가지 macOS 워크플로를 방해합니다.

  1. 인증서 피닝(Certificate Pinning)과 상호 TLS(mTLS): 원본 서버의 공개 키를 고정하거나 클라이언트 인증서를 제시하는 앱은 게이트웨이가 리프 인증서를 교체하는 즉시 핸드셰이크를 중단합니다. 자세한 내용은 SWG 검사 환경의 인증서 피닝 및 mTLS를 참고하세요.
  2. HTTP/3(QUIC) 및 장기 HTTP/2·WebSocket 스트림: TLS 연결을 다운그레이드하거나 프록시하는 게이트웨이는 UDP QUIC 스트림을 끊거나, 스트리밍 LLM 응답을 지연시키거나, 지속적인 IDE/WebSocket 채널을 재설정합니다.
  3. 독립 CA 저장소를 쓰는 CLI와 언어 런타임: Node.js, Python, Git, Homebrew, Docker, Claude Code, Cursor 같은 도구는 자체 공개 루트 CA 번들을 사용하여 CERTIFICATE_VERIFY_FAILED 또는 UNABLE_TO_GET_ISSUER_CERT_LOCALLY 오류를 냅니다.
  4. 지연에 민감한 개발자 API: 모든 TLS 핸드셰이크가 원격 클라우드 SWG PoP를 경유하면 패키지 설치, git fetch, 실시간 코드 자동 완성의 왕복 지연이 크게 늘어납니다.

도메인별 TLS 우회 vs. 로컬 프록시 설정 및 게이트웨이 예외

항목 도메인별 우회(SWG bar) 관리자 TLS 검사 예외(Do Not Decrypt) 로컬 프록시 편집(시스템 설정 → 프록시)
적용 계층 macOS NetworkExtension 기반 호스트별 물리 IPv4 라우팅 중앙 SWG/방화벽 복호화 정책 명시적 OS HTTP/HTTPS 프록시 필드만 해당
투명 SWG에서 작동 여부 예(물리 IPv4 경로 도달 가능 시) 예(IT 관리자 구성) 아니요 — utun/투명 SWG 에이전트가 무시하거나 덮어씀
IT 관리 콘솔 필요 여부 아니요(승인된 Mac에서 로컬 제어) 예(Zscaler, Netskope, Cloudflare, Palo Alto 포털) 아니요
기기 보안 상태 및 SSO 유지 예 — 기업 에이전트가 계속 실행됨 예 기업 PAC 라우팅을 깨뜨리는 경우가 많음

라우팅 변경과 게이트웨이 복호화 제외 정책의 구조적 차이는 SWG 우회와 TLS 검사 예외 비교에서 확인하세요.

macOS에서 도메인의 HTTPS 및 TLS 검사 우회하기

  1. 검사 대상 호스트 이름 모두 식별: SWG bar → 도메인을 열거나 CLI에서 swgbar domains list --status confirmed를 실행합니다. example.com, auth.example.com, api.example.com은 별개의 호스트 이름입니다.
  2. 도메인별 우회 활성화: 해당 도메인의 SWG 우회 행에서 켜기를 클릭하거나 터미널에서 다음을 실행합니다.
swgbar bypass enable api.example.com
swgbar bypass status
  1. 기존 TLS 및 HTTP/3 풀 연결 종료: 브라우저 탭만 새로 고치면 기존 검사 경로의 HTTP/2·QUIC 소켓이 재사용될 수 있습니다. SWG bar 네이티브 우회는 새 연결에서 HTTP/3를 TCP 기반 HTTPS로 전환하므로 우회 중이 표시된 뒤 탭을 새로 고치거나 대상 앱을 재시작하세요.
  2. 새 인증서 체인 검증: swgbar probe api.example.com(또는 openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null)을 실행해 원본 서버의 공개 발급자가 반환되는지 확인합니다.

우회 중 대신 복구 중이나 일시 중지가 표시된다면 macOS에서 SWG 우회 복구 중 및 일시 중지 상태 해결을 참고하세요.

필요 시 우회 끄기 또는 CA 신뢰 방식으로 전환

활성화된 SWG 우회 컨트롤을 다시 클릭하거나 swgbar bypass disable <domain>을 실행하면 해당 호스트 이름이 즉시 일반 게이트웨이 라우팅으로 복귀합니다. SWG bar를 종료해도 활성 우회는 즉시 중단되며 저장한 도메인 선택은 다음 실행 시 복원되도록 유지됩니다.

방화벽 수준에서 직접 아웃바운드 IPv4 트래픽이 차단되는 네트워크라면 우회를 끄고 CLI 및 AI 도구 CA 신뢰 해결 가이드를 적용하거나 IT에 해당 호스트 이름의 Do Not Decrypt 규칙을 요청하세요.