Source: https://swgbar.com/ko/guides/multi-domain-sso-api-cdn-swg-bypass/
Language: ko

# Mac에서 멀티 도메인 웹 앱, SSO, CDN, API용 SWG 우회하기

최신 앱에서는 루트 도메인 하나만 우회하는 것으로 부족한 이유—SWG bar에서 로그인, CDN, API 호스트 이름을 찾고 Keep-Alive 연결을 깔끔하게 초기화하는 방법을 안내합니다.

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

macOS에서 **SWG 우회**를 켰을 때 흔히 겪는 의외의 상황은 메인 웹페이지는 정상적으로 새로 고침되는데 로그인 리다이렉트, 이미지, 패키지 다운로드 또는 API 호출은 여전히 HTTPS 검사를 거치거나 실패하는 경우입니다. SWG bar는 우회 규칙을 **정확한 호스트 이름 단위로만** 적용하기 때문에, 멀티 도메인 웹 앱과 개발 도구는 종종 여러 개의 별도 호스트에 의존합니다.

## 단일 호스트 이름 우회가 하위 도메인까지 적용되지 않는 이유

`app.example.com`에서 우회를 켜면 **오직 `app.example.com`만** 우회 경로로 라우팅됩니다. 다음 호스트들은 자동으로 우회되지 않습니다.

*   **싱글 사인온(SSO) 및 OAuth 공급자**: `login.example.com`, `auth.example.com`, `sso.company.com` 또는 서드파티 ID 호스트(`accounts.google.com`, `login.microsoftonline.com`).
*   **API 및 AI 엔드포인트**: `api.example.com`, `graphql.example.com` 또는 별도의 텔레메트리/스트리밍 하위 도메인.
*   **정적 리소스 및 레지스트리**: `cdn.example.net`, `assets.example.com` 또는 객체 스토리지 버킷(`*.s3.amazonaws.com`, `objects.githubusercontent.com`).

참고로 **식별할 수 없거나 암호화된 SNI(ECH) 호스트 이름**은 도메인별 우회 규칙과 매칭할 수 없습니다.

## 앱이 사용하는 모든 검사 대상 호스트 이름 찾기

1.  SWG bar가 모니터링 중인 상태에서 웹사이트를 열거나 실패하는 개발자 워크플로를 한 번 실행하세요.
2.  **SWG bar → 도메인**에서 **확인됨** / **의심됨**으로 정렬하거나 필터링하고 키워드(예: `example` 또는 `auth`)로 검색하거나, [CLI](<https://swgbar.com/ko/cli/>)로 조회하세요.

```
swgbar domains list --status confirmed --search example
swgbar domains list --bypass active
```

3.  워크플로에 필요한 각 검사 대상 호스트 이름의 상세 정보를 열어 **SWG 우회**를 켜거나(`swgbar bypass enable <hostname>` 실행) 규칙을 추가하세요.
4.  승인된 네트워크에서 하나의 인증 또는 API 도메인을 우회했다고 해서 무관한 모든 도메인을 우회할 필요는 없습니다. 규칙은 반드시 필요한 특정 호스트로만 엄격히 제한하세요.

## Keep-Alive 연결 닫고 Chrome 상태 확인하기

**우회 중**이 표시된 후에도 브라우저와 백그라운드 데몬은 우회 전에 기존 검사 경로로 열어 둔 HTTP/2, HTTP/3 또는 TLS Keep-Alive 소켓을 계속 재사용할 수 있습니다.

*   **웹 브라우저**: 영향을 받는 탭을 강력 새로 고침(`Cmd + Shift + R`)하거나, 사이트가 오래 유지되는 WebSocket 또는 HTTP/3 연결을 사용한다면 브라우저 창을 닫았다가 다시 여세요. [Chrome 컴패니언 확장 프로그램](<https://swgbar.com/ko/chrome-extension/>)으로 현재 탭에 표시되는 활성 호스트 이름을 확인할 수 있지만, 이 확장 프로그램은 Chrome의 실시간 소켓을 검사하는 대신 SWG bar에 기록된 관측 결과를 표시한다는 점을 기억하세요.
*   **터미널 및 IDE**: 물리 인터페이스를 통해 새 TCP/TLS 연결을 맺도록 오래 실행 중인 프로세스(`npm`, `Claude Code` 데몬, IDE 언어 서버 또는 `git` 자격 증명 도우미)를 다시 시작하세요.

## 각 호스트 이름을 개별적으로 검증하기

규칙을 업데이트한 뒤에는 **도메인**을 열거나 `swgbar domains detail <hostname>`을 실행하여 브라우저 주소 표시줄에 보이는 최상위 URL뿐만 아니라 워크플로의 **모든** 호스트 이름에서 새 프로브가 공개 신뢰를 확인했는지 검증하세요. 조직 전체의 SaaS 또는 SSO 도메인이 팀 모두에게 영향을 미친다면 관리자 정책 예외가 더 적합한지 [SWG 우회와 TLS 검사 예외 비교](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)에서 비교해 보세요.

## 관련 가이드

*   [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에서 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/>)
