Mac의 SWG 환경에서 Homebrew, Docker, Python, Node.js CA 신뢰 구성
macOS에서 Homebrew, Docker Desktop, Node.js, Python, git, curl이 SWG 서명 TLS 인증서를 거부하는 이유와 CA 번들 구성 vs. SWG 우회 선택 기준을 안내합니다.
SWG bar · 업데이트
HTTPS Break-and-Inspect가 적용된 기업용 Mac에서는 개발자 런타임마다 TLS 인증서를 검증하는 방식이 다릅니다. Safari와 Chrome은 macOS 키체인을 참조하지만, CLI 도구와 컨테이너는 자체 CA 번들을 사용하는 경우가 많아 패키지 관리자나 SDK 전반에서 갑작스러운 빌드 오류가 발생합니다.
Mac 개발 도구가 선택적으로 실패하는 이유
| 도구 / 런타임 | macOS의 기본 신뢰 저장소 | 주요 환경 변수 또는 설정 |
|---|---|---|
| Node.js / npm / yarn / pnpm | 내장 컴파일된 Mozilla CA 번들 | NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem |
| Python / pip / uv / requests | certifi 번들 또는 OpenSSL CA 경로 |
SSL_CERT_FILE / REQUESTS_CA_BUNDLE |
| git | 빌드에 따라 OpenSSL 또는 Secure Transport | git config --global http.sslCAInfo /path/to/corp-ca.pem |
curl / Homebrew(brew) |
macOS Secure Transport 또는 OpenSSL CA 번들 | HOMEBREW_CURLRC / CURL_CA_BUNDLE(curl --version으로 확인) |
| Docker Desktop / 컨테이너 | Linux VM 및 이미지 내 /etc/ssl/certs(macOS 키체인 아님) |
Docker VM / 이미지 신뢰 저장소에 기업 CA 추가 |
1. 어떤 레지스트리나 API 호스트 이름이 가로채기되는지 식별하기
셸 프로필이나 컨테이너 빌드를 수정하기 전에 DNS나 방화벽 차단이 아니라 정확히 어떤 외부 호스트 이름이 SSL 검사를 받고 있는지 확인하세요.
swgbar domains list --status confirmed
swgbar probe registry.npmjs.org
swgbar probe pypi.org
swgbar probe ghcr.io
패키지 관리자는 종종 다운로드를 여러 호스트로 리다이렉트합니다(예: formulae.brew.sh → ghcr.io, 또는 github.com → objects.githubusercontent.com). 자세한 내용은 멀티 도메인 웹 앱, SSO, CDN, API용 SWG 우회하기를 참고하세요.
2. CA 번들 구성, TLS 검사 예외, SWG 우회 중 선택하기
- 기업 루트 CA PEM 추가: 사내 정책상 모든 트래픽이 SWG 복호화를 거쳐야 한다면, SWG bar → 인증서에서 확인한 정확한 루트 CA를 내보내어 IT 보안 지침에 따라
NODE_EXTRA_CA_CERTS,SSL_CERT_FILE,REQUESTS_CA_BUNDLE또는http.sslCAInfo를 구성하세요. TLS 검증 자체를 끄는 설정(NODE_TLS_REJECT_UNAUTHORIZED=0또는sslVerify=false)은 절대 사용하지 마세요. - IT 팀에 TLS 검사 예외 요청: 공용 레지스트리, Docker 베이스 이미지, 또는 CI와 로컬 머신 모두에서 사용자 지정 CA 번들을 유지하기 까다로운 엄격한 인증서 피닝 도구에 권장됩니다.
- 승인된 네트워크에서 도메인별 SWG 우회 사용: Mac에서 특정 호스트를 우회할 권한이 있거나 네트워크를 직접 관리하는 경우, SWG bar에서 SWG 우회를 켜고(
swgbar bypass enable <domain>포함) CLI 프로세스를 다시 시작하세요.
시스템 기본값을 바꾸기 전에 워크플로 비교하기
단계별 CERTIFICATE_VERIFY_FAILED 해결 방법은 Mac의 CLI 및 AI 도구에서 발생하는 SWG TLS/SSL 인증서 오류 해결을 읽어보세요. 로컬 라우팅 규칙과 게이트웨이 정책 제외를 비교하려면 SWG 우회와 TLS 검사 예외 비교를 확인하세요.