GitLab 인스턴스에서 자체 서명 SSL 인증서를 사용하더라도 GitLab for VS Code 확장 프로그램을 계속 사용할 수 있습니다.

프록시를 통해 GitLab 인스턴스에 연결하는 경우에는 이슈 314를 통해 알려 주세요. 이 단계를 완료한 후에도 연결 문제가 지속된다면, GitLab for VS Code 확장 프로그램의 모든 기존 SSL 이슈가 연결된 에픽 6244를 검토하세요.

자체 서명 CA와 함께 확장 프로그램 사용#

사전 요구 사항:

• GitLab 인스턴스가 자체 서명 인증 기관(CA)으로 서명된 인증서를 사용해야 합니다.

• GitLab for VS Code 버전이 6.51.1 이상이어야 합니다.

• VS Code 버전이 1.101.2(2025년 5월) 이상이어야 합니다.

• gitlab.ca VS Code 설정이 사용 중이 아니어야 합니다.

확장 프로그램이 작동하려면 CA 인증서가 시스템에 올바르게 추가되어 있어야 합니다. VS Code는 시스템 인증서 저장소를 읽고, 모든 node http 요청이 해당 인증서를 신뢰하도록 변경합니다:

%%{init: { "fontFamily": "GitLab Sans" }}%% graph LR accTitle: Self-signed certificate chain accDescr: Shows a self-signed CA that signs the GitLab instance certificate.

A[Self-signed CA] -- signed --> B[Your GitLab instance certificate]

GitLab 인스턴스 인증서의 CA는 명시적으로 신뢰할 수 있는 CA로 지정되어야 합니다. 중간 인증서가 사용 중인 경우, 해당 인증서가 시스템에서 사용 가능해야 합니다. 전체 체인이 성공적으로 유효성 검사되지 않으면, 확장 프로그램 내의 네트워크 연결이 인증에 실패합니다.

자세한 내용은 Visual Studio Code 이슈 트래커의 WSL에서 Python 지원 설치 시 자체 서명 인증서 오류를 참조하세요.

VS Code의 settings.json에서 "http.systemCertificates": true로 설정하세요. 기본값이 true이므로 이 값을 변경하지 않아도 될 수 있습니다.

다음 섹션의 운영 체제별 지침을 완료하세요.

Windows#

이 지침은 Windows 10 및 VS Code 1.60.0에서 테스트되었습니다.

인증서 저장소에서 자체 서명 CA를 볼 수 있는지 확인하세요:

• 명령 프롬프트를 엽니다.

• certmgr을 실행합니다.

• 신뢰할 수 있는 루트 인증 기관 > 인증서에서 인증서가 표시되는지 확인합니다.

Linux#

이 지침은 Arch Linux `5.14.3-arch1-1` 및 VS Code 1.60.0에서 테스트되었습니다.

• 운영 체제의 도구를 사용하여 자체 서명 CA를 시스템에 추가할 수 있는지 확인하세요:

update-ca-trust (Fedora, RHEL, CentOS)

• update-ca-certificates (Ubuntu, Debian, OpenSUSE, SLES)

• trust (Arch)

• CA 인증서가 /etc/ssl/certs/ca-certificates.crt 또는 /etc/ssl/certs/ca-bundle.crt에 있는지 확인하세요. VS Code는 이 위치를 확인합니다.

MacOS#

이 지침은 macOS Tahoe 26, VS Code 1.101.2, GitLab for VS Code 6.51.1에서 테스트되었습니다.

키체인에서 자체 서명 CA를 볼 수 있는지 확인하세요:

• Finder > 응용 프로그램 > 유틸리티 > 키체인 접근으로 이동합니다.

• 왼쪽 열에서 시스템을 선택합니다.

• 목록에서 자체 서명 CA 인증서를 찾습니다.

• 인증서를 마우스 오른쪽 버튼으로 클릭하고 정보 가져오기를 선택합니다.

• 신뢰 섹션을 펼칩니다.

• Secure Sockets Layer (SSL) 옵션이 '항상 신뢰'로 설정되어 있는지 확인합니다.