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

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

SWG bar · 업데이트

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

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

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

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

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

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