Mac의 Netskope SSL 검사: 복호화 확인 및 도메인별 우회

Mac에서 Netskope Client가 HTTPS(*.goskope.com CA)를 복호화하는지 확인하고, SWG bar 도메인별 우회 vs. Do Not Decrypt 정책 및 nscacert_combined.pem 설정을 비교하세요.

SWG bar · 업데이트

Mac에서 Netskope Client가 SSL/TLS 복호화를 수행 중인지 확인하려면 SWG bar → 개요를 열거나 swgbar overview를 실행해 도메인 통신 가로채기 비율이 0%를 넘는지, 그리고 중간자 인증서에 Netskope 또는 *.goskope.com 테넌트 인증서가 표시되는지 확인하세요. 승인된 Mac에서 특정 호스트 이름의 Netskope SSL 검사를 우회하려면 SWG bar → 도메인에서 호스트 이름을 선택하고 SWG 우회 옆의 켜기를 누르세요(또는 swgbar bypass enable <domain> 실행).

Netskope 보안 웹 게이트웨이는 기업용 macOS 환경에서 NetworkExtension 스티어링 클라이언트와 테넌트별 중간 CA로 널리 배포됩니다. MDM이 Netskope 루트 CA를 macOS 키체인에 설치하므로 브라우저는 정상적인 보안 아이콘을 표시하지만, CLI 런타임(pip, npm, AWS CLI, git, Docker, Claude Code)과 인증서 피닝 데스크톱 앱은 CERTIFICATE_VERIFY_FAILED 또는 UNABLE_TO_GET_ISSUER_CERT_LOCALLY 오류로 실패합니다.

1. Mac에서 Netskope가 도메인을 복호화하는지 확인하기

시스템 전체 가로채기와 개별 호스트 이름을 함께 점검하세요.

  • SWG bar 메뉴 막대 및 Chrome에서 확인: macOS 14+(Apple Silicon)에 SWG bar를 설치(14사용일 무료 체험)하고 대상 사이트에 접속하거나 실패한 명령을 실행합니다. SWG bar → 도메인 또는 swgbar domains list --status confirmed에서 Netskope 테넌트 CA(보통 ca.<tenant>.goskope.com 또는 회사 사용자 지정 CA)로 재서명된 호스트 이름을 모두 확인할 수 있습니다. 무료 SWG bar Chrome 확장 프로그램과 함께 쓰면 브라우저 도구 모음에서도 상태를 바로 볼 수 있습니다.
  • 터미널에서 Netskope 인증서와 실시간 발급자 확인:
# macOS 시스템 키체인에 Netskope CA가 설치되어 있는지 확인
security find-certificate -c "Netskope" /Library/Keychains/System.keychain

# 특정 호스트 이름에 대해 반환되는 실시간 인증서 발급자 검사
openssl s_client -connect registry.npmjs.org:443 -servername registry.npmjs.org </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

Netskope 정책은 일부 SaaS나 코드 호스팅 도메인만 복호화하고 다른 도메인은 그대로 전달하는 경우가 많으므로 반드시 오류가 나는 정확한 호스트 이름을 테스트하세요.

2. Netskope Client를 직접 종료해도 보통 통하지 않는 이유

Netskope의 Protect Client configuration and resources 변조 방지 정책이 켜진 관리형 환경에서는 메뉴 막대 Netskope 아이콘의 Disable 옵션이 비활성화되거나 암호로 잠겨 있으며, 데몬을 강제 언로드하면 시스템 네트워크 라우팅이 끊어집니다. Netskope는 macOS NetworkExtension 계층에서 트래픽을 스티어링하므로 Wi-Fi 프록시 설정을 지워도 소용없습니다.

3. macOS에서 상황에 맞는 Netskope 해결책 선택하기

방법 Netskope 복호화 중단 여부 Netskope 테넌트 관리자 필요 여부 적합한 상황
도메인별 SWG 우회(SWG bar) 예(선택한 호스트 이름을 물리 하드웨어 IPv4로 라우팅) 아니요(승인된 Mac에서 로컬 제어) Netskope 복호화 때문에 피닝 앱·WebSocket·개발 엔드포인트가 깨지고 직접 IPv4 경로가 존재할 때(Mac에서 SWG 우회하는 방법)
Netskope 테넌트 Do Not Decrypt / 인증서 피닝 앱 예외 예(관리형 Mac 전체에 중앙 적용) 예(Policies → SSL Decryption → Do Not Decrypt 또는 Steering Configuration → Exceptions) 전사 피닝 데스크톱 앱이나 팀 공용 개발 엔드포인트가 모두 실패할 때(SWG 우회와 TLS 예외 비교)
CLI 도구용 통합 CA 번들(nscacert_combined.pem) 아니요(트래픽은 계속 검사됨) 아니요 정책상 Netskope 복호화를 유지하면서 CLI/AI 도구가 Netskope CA 체인을 신뢰하게 해야 할 때

4. 도메인별 우회 적용 또는 Netskope CLI CA 신뢰 구성

옵션 A: 승인된 환경에서 SWG bar로 도메인별 우회 켜기

  1. SWG bar → 도메인에서 검사 중인 정확한 호스트 이름(예: api.anthropic.com, pypi.org)을 선택하고 SWG 우회 옆 켜기를 클릭하거나 swgbar bypass enable <domain>을 실행합니다.
  2. 우회 중이 표시되면 기존 TLS/HTTP/3 연결 풀이 물리 하드웨어 IPv4 인터페이스로 재연결되도록 브라우저 탭, 터미널 도구, IDE를 다시 시작하세요.
  3. swgbar probe <domain>으로 원본 서버의 공개 인증서 체인이 반환되는지 확인합니다. 즉시 되돌리려면 활성화된 컨트롤을 다시 누르거나 swgbar bypass disable <domain>을 실행하세요.

옵션 B: Netskope 환경의 CLI 도구용 통합 PEM 번들 생성

트래픽이 계속 Netskope 검사를 거쳐야 한다면 macOS 신뢰 저장소에서 통합 PEM 번들을 내보내거나 IT에서 받은 nscacert_combined.pem을 ~/.zshrc에 지정하세요.

security find-certificate -a -p \
  /System/Library/Keychains/SystemRootCertificates.keychain \
  /Library/Keychains/System.keychain > "$HOME/.certs/nscacert_combined.pem"

export NODE_EXTRA_CA_CERTS="$HOME/.certs/nscacert_combined.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
export SSL_CERT_FILE="$HOME/.certs/nscacert_combined.pem"
export AWS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"

도구별 자세한 설정은 Mac의 CLI 및 AI 도구에서 발생하는 SWG TLS/SSL 인증서 오류 해결과 Homebrew·Docker·Python·Node.js CA 신뢰 설정을 참고하세요.