Source: https://swgbar.com/ko/guides/bypass-https-tls-inspection-mac/
Language: ko

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

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

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

보안 클라이언트를 전역으로 끄지 않고 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](<https://swgbar.com/ko/guides/certificate-pinning-mtls-swg-inspection-macos/>)를 참고하세요.
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 검사 예외 비교](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)에서 확인하세요.

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

1.  **검사 대상 호스트 이름 모두 식별**: **SWG bar → 도메인**을 열거나 [CLI](<https://swgbar.com/ko/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
```

3.  **기존 TLS 및 HTTP/3 풀 연결 종료**: 브라우저 탭만 새로 고치면 기존 검사 경로의 HTTP/2·QUIC 소켓이 재사용될 수 있습니다. SWG bar 네이티브 우회는 새 연결에서 HTTP/3를 TCP 기반 HTTPS로 전환하므로 **우회 중**이 표시된 뒤 탭을 새로 고치거나 대상 앱을 재시작하세요.
4.  **새 인증서 체인 검증**: `swgbar probe api.example.com`(또는 `openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null`)을 실행해 원본 서버의 공개 발급자가 반환되는지 확인합니다.

**우회 중** 대신 **복구 중**이나 **일시 중지**가 표시된다면 [macOS에서 SWG 우회 복구 중 및 일시 중지 상태 해결](<https://swgbar.com/ko/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)을 참고하세요.

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

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

방화벽 수준에서 직접 아웃바운드 IPv4 트래픽이 차단되는 네트워크라면 우회를 끄고 [CLI 및 AI 도구 CA 신뢰 해결 가이드](<https://swgbar.com/ko/guides/swg-tls-certificate-errors-macos/>)를 적용하거나 IT에 해당 호스트 이름의 **Do Not Decrypt** 규칙을 요청하세요.

## 관련 가이드

*   [Mac에서 SWG 우회하는 방법 (원클릭 도메인 우회 및 CLI)](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)
*   [Mac에서 SSL 검사 우회하는 방법(기업 SWG 도메인별 해결책)](<https://swgbar.com/ko/guides/bypass-ssl-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/>)
*   [인증서 피닝 및 mTLS 앱이 SWG 검사 환경에서 실패하는 이유](<https://swgbar.com/ko/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [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/>)
