byteforce

CPN 한국어 자습서 · 외부 문서 한국어 미러

UV 문서 · Concepts

HTTP 자격증명

HTTP credentials · 원문: docs.astral.sh/uv/concepts/authentication/http/

아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.

uv는 패키지 레지스트리(registry)를 조회할 때 여러 자격증명 소스를 통해 HTTP 인증을 지원합니다. 시스템은 다음 순서로 자격증명을 우선시합니다:

  1. URL에 포함된 자격증명 (예: https://<user>:<password>@<hostname>/...)
  2. .netrc 설정 파일
  3. uv 자격증명 저장소
  4. 키링(Keyring) 프로바이더 (기본적으로 비활성화)

netrc 파일

.netrc 형식은 자격증명을 평문으로 저장하는 오래된 방식입니다. uv는 NETRC 환경변수에 지정된 경로나 기본값 ~/.netrc에서 이 형식을 자동으로 읽습니다.

uv 자격증명 저장소

uv auth 명령어를 사용하면 uv 전용 저장소에서 자격증명을 읽고 쓸 수 있습니다. 자격증명은 uv의 상태 디렉터리(예: Unix 시스템의 ~/.local/share/uv/credentials/credentials.toml) 내에 평문으로 보관됩니다. 이 파일을 직접 수정하지 않는 것을 권장합니다.

프리뷰 기능으로 시스템 네이티브 스토리지를 사용할 수 있습니다: macOS의 Keychain Services, Windows의 Windows Credential Manager, Linux의 DBus Secret Service API. UV_PREVIEW_FEATURES=native-auth로 활성화합니다. uv는 이전에 네이티브 메커니즘에 저장한 자격증명만 가져옵니다.

키링 프로바이더

키링 프로바이더는 pip의 설계를 따르며, 널리 사용되는 keyring Python 패키지의 인터페이스에서 자격증명을 가져올 수 있습니다. 현재 uv는 keyring 명령어를 호출하는 "subprocess" 프로바이더만 지원합니다.

subprocess 프로바이더를 활성화하는 방법: - --keyring-provider subprocess - UV_KEYRING_PROVIDER=subprocess - 설정 파일에 tool.uv.keyring-provider = "subprocess" 추가

자격증명 지속성

특정 인덱스 URL 또는 네트워크 위치에서 발견된 자격증명은 명령 실행 중에 캐시됩니다. 그러나 별도의 uv 실행 간에는 자격증명이 유지되지 않습니다.

uv add를 실행할 때, uv는 의도적으로 인덱스 자격증명을 pyproject.toml이나 uv.lock 파일에 저장하지 않습니다. 이는 이러한 파일이 일반적으로 버전 관리에 포함되기 때문입니다. 직접 URL 자격증명(예: package @ https://username:password@example.com/foo.whl 형식)은 현재 대안이 없으므로 유지됩니다.

uv add 중에 인덱스 자격증명이 첨부된 경우, 이후 작업이 실패할 수 있습니다. 인덱스 인증을 지속적으로 유지하는 방법은 인덱스 인증 문서를 참조하세요.

원문(영어): https://docs.astral.sh/uv/concepts/authentication/http/ · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Astral)에게 있습니다.

원문(영어): https://docs.astral.sh/uv/concepts/authentication/http/