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

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

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

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

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를 설치](<https://swgbar.com/ko/install/>)(14사용일 무료 체험)하고 대상 사이트에 접속하거나 실패한 명령을 실행합니다. **SWG bar → 도메인** 또는 `swgbar domains list --status confirmed`에서 Netskope 테넌트 CA(보통 `ca.<tenant>.goskope.com` 또는 회사 사용자 지정 CA)로 재서명된 호스트 이름을 모두 확인할 수 있습니다. 무료 [SWG bar Chrome 확장 프로그램](<https://swgbar.com/ko/chrome-extension/>)과 함께 쓰면 브라우저 도구 모음에서도 상태를 바로 볼 수 있습니다.
*   **터미널에서 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 우회하는 방법](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)) |
| **Netskope 테넌트 `Do Not Decrypt` / 인증서 피닝 앱 예외** | 예(관리형 Mac 전체에 중앙 적용) | 예(**Policies → SSL Decryption → Do Not Decrypt** 또는 **Steering Configuration → Exceptions**) | 전사 피닝 데스크톱 앱이나 팀 공용 개발 엔드포인트가 모두 실패할 때([SWG 우회와 TLS 예외 비교](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)) |
| **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 인증서 오류 해결](<https://swgbar.com/ko/guides/swg-tls-certificate-errors-macos/>)과 [Homebrew·Docker·Python·Node.js CA 신뢰 설정](<https://swgbar.com/ko/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)을 참고하세요.

## 관련 가이드

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