byteforce

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

UV 문서 · Concepts

인증 CLI

The auth CLI · 원문: docs.astral.sh/uv/concepts/authentication/cli/

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

uv는 커맨드라인 인터페이스를 통해 서비스와 상호작용하기 위한 자격증명 관리 기능을 제공합니다.

서비스에 로그인하기

uv auth login 명령어는 자격증명을 저장합니다:

코드 · 명령
$ uv auth login example.com

이 명령어는 인증 정보를 입력하도록 프롬프트를 표시합니다. --username 및 --password 옵션을 지정하거나, 토큰 기반 인증을 위해 --token을 사용할 수 있습니다.

시크릿 관련 모범 사례: -를 사용하여 stdin을 통해 민감한 정보를 전달합니다:

코드 · 명령
$ echo 'my-password' | uv auth login example.com --password -

현재는 HTTPS Basic 인증만 지원합니다. 자격증명은 유효성 검사 없이 저장되므로, 잘못된 자격증명을 입력해도 실패하지 않습니다.

서비스에서 로그아웃하기

저장된 자격증명을 제거하려면 다음 명령어를 사용합니다:

코드 · 명령
$ uv auth logout example.com

자격증명은 로컬에서만 삭제되며, 원격 서버에서 무효화되지는 않습니다.

서비스의 자격증명 확인하기

저장된 자격증명을 조회하려면 다음을 사용합니다:

코드 · 명령
$ uv auth token example.com

사용자 이름으로 로그인한 경우 함께 제공합니다:

코드 · 명령
$ uv auth token --username foo example.com

외부 도구에서 자격증명 사용하기

uv auth helper 명령어는 자격증명 헬퍼를 지원하는 외부 도구가 HTTP 자격증명에 접근할 수 있도록 합니다. 현재 Bazel 자격증명 헬퍼 프로토콜을 지원하며, stdin에서 JSON 요청을 읽고 Authorization 헤더가 포함된 JSON 응답을 반환합니다.

요청 및 응답 예시:

코드 · 명령
$ echo '{"uri": "https://example.com/path"}' | uv --preview-features auth-helper auth helper --protocol=bazel get
{"headers":{"Authorization":["Basic ..."]}}

일치하는 자격증명이 없으면 빈 headers 객체가 반환됩니다.

이 기능을 사용하려면 --preview-features auth-helper 또는 UV_PREVIEW_FEATURES=auth-helper 환경변수가 필요합니다.

스토리지 백엔드 설정하기

자격증명은 uv의 자격증명 저장소에 저장됩니다. 기본적으로 평문으로 기록됩니다. UV_PREVIEW_FEATURES=native-auth를 설정하면 암호화된 시스템 네이티브 스토리지를 사용할 수 있습니다.

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

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