Skip to content

The uv auth CLIThe uv auth CLI

uv provides a high-level interface for storing and retrieving credentials from services.uvは、サービスからの資格情報の保存と取得のための高レベルインターフェースを提供します。

Logging in to a serviceサービスへのログイン

To add credentials for service, use the uv auth login command:サービスの資格情報を追加するには、uv auth loginコマンドを使用します：

$ uv auth login example.com

This will prompt for the credentials.これにより、資格情報の入力が求められます。

The credentials can also be provided using the --username and --password options, or the --token option for services which use a __token__ or arbitrary username.資格情報は、--usernameおよび--passwordオプションを使用して提供することもできます。また、__token__または任意のユーザー名を使用するサービスには--tokenオプションを使用します。

Note注意

We recommend providing the secret via stdin. Use - to indicate the value should be read from stdin, e.g., for --password:秘密情報はstdinを介して提供することをお勧めします。-を使用して、値がstdinから読み取られるべきであることを示します。例えば、--passwordの場合：

$ echo 'my-password' | uv auth login example.com --password -

The same pattern can be used with --token.--tokenでも同じパターンを使用できます。

Once credentials are added, uv will use them for packaging operations that require fetching content from the given service. At this time, only HTTPS Basic authentication is supported. The credentials will not yet be used for Git requests.資格情報が追加されると、uvは指定されたサービスからコンテンツを取得する必要があるパッケージング操作にそれらを使用します。この時点では、HTTPS Basic認証のみがサポートされています。資格情報はまだGitリクエストには使用されません。

Note注意

The credentials will not be validated, i.e., incorrect credentials will not fail.資格情報は検証されません。つまり、不正な資格情報は失敗しません。

Logging out of a serviceサービスからのログアウト

To remove credentials, use the uv auth logout command:資格情報を削除するには、uv auth logout コマンドを使用します：

$ uv auth logout example.com

Note注意

The credentials will not be invalidated with the remote server, i.e., they will only be removed from local storage not rendered unusable.資格情報はリモートサーバーでは無効化されず、つまり、ローカルストレージからのみ削除され、使用不可にはなりません。

Showing credentials for a serviceサービスの資格情報を表示する

To show the credential stored for a given URL, use the uv auth token command:特定のURLに保存されている資格情報を表示するには、uv auth token コマンドを使用します：

$ uv auth token example.com

If a username was used to log in, it will need to be provided as well, e.g.:ログインにユーザー名が使用された場合、それも提供する必要があります。例：

$ uv auth token --username foo example.com

Configuring the storage backendストレージバックエンドの設定

Credentials are persisted to the uv credentials store.資格情報はuv 資格情報ストアに永続化されます。

By default, credentials are written to a plaintext file. An encrypted system-native storage backend can be enabled with UV_PREVIEW_FEATURES=native-auth.デフォルトでは、資格情報はプレーンテキストファイルに書き込まれます。暗号化されたシステムネイティブストレージバックエンドは、UV_PREVIEW_FEATURES=native-authを使用して有効にできます。