# Secrets Manager CLI

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/secrets-manager-cli/)
{% endhint %}

Secrets Manager 命令行界面 (CLI) 是用于检索和注入您的机密的强大工具。可以使用 Secrets Manager CLI 来组织您的密码库，包括创建、删除、编辑和列出您的机密和工程。Secrets Manager CLI 有两种运行选项：

* [标准用法](#download-and-install)
* [Docker 用法](#run-with-docker)

Secrets Manager CLI 是自描述的。在命令行中，使用以下命令了解有关可用命令的更多信息：

```shellscript
bws --help, -h
```

## 下载和安装 <a href="#download-and-install" id="download-and-install"></a>

CLI 可以在 Windows、macOS 和 Linux 发行版上跨平台使用。要下载并安装 Secrets Manager CLI：

从 <https://github.com/bitwarden/sdk/releases> 下载 Secrets Manager CLI。

{% hint style="info" %}
使用已下载的本地可执行文件时，您需要将可执行文件添加到您的 PATH 中，或者从文件下载到的目录运行命令。
{% endhint %}

## 使用 Docker 运行 <a href="#run-with-docker" id="run-with-docker"></a>

Secrets Manager CLI 还可以与 Docker 一起运行。示例 Dockerfile 位于 [Bitwarden Secrets Manager SDK 存储库](https://github.com/bitwarden/sdk/tree/84c73826d58e848d92b7b86f9595d9169c541f20/crates/bws)中。

您可以使用以下命令运行 Docker 映像：

```bash
docker run --rm -it bitwarden/bws --help
```

{% hint style="info" %}
如果您想在主机和容器中使用相同的配置文件路径，则父目录必须已存在于主机和容器中。
{% endhint %}

## 身份验证 <a href="#authentication" id="authentication"></a>

可以使用为特定[机器账户](/docs/secrets-manager/your-secrets/machine-accounts.md)生成的[访问令牌](/docs/secrets-manager/your-secrets/access-tokens.md)登录 Secrets Manager CLI。这意味着**只有对机密和工程有访问权限的机器账户可以使用 CLI 进行交互**。有多种方式可以对 CLI 会话进行身份验证：

{% tabs %}
{% tab title="环境变量" %}
您可以通过将访问令牌的值保存到环境变量 `BWS_ACCESS_TOKEN` 来对 CLI 会话进行身份验证，例如：

```shellscript
export BWS_ACCESS_TOKEN=0.48c78342-1635-48a6-accd-afbe01336365.C0tMmQqHnAp1h0gL8bngprlPOYutt0:B3h5D+YgLvFiQhWkIq6Bow==
```

{% endtab %}

{% tab title="Inline" %}
您可以在任何单个命令中使用 `-t`，`--access-token` 标志对单个 CLI 请求进行身份验证，例如：

```shellscript
bws list secrets --access-token 0.48c78342-1635-48a6-accd-afbe01336365.C0tMmQqHnAp1h0gL8bngprlPOYutt0:B3h5D+YgLvFiQhWkIq6Bow==
```

{% endtab %}
{% endtabs %}

{% hint style="danger" %}
如果您的工作流程使用许多单独的会话（每次使用访问令牌进行身份验证都构成一个「会话」）在短时间内从同一 IP 地址发出请求，您可能会遇到速率限制。
{% endhint %}

## 命令 <a href="#commands" id="commands"></a>

命令用于与 Secrets Manager CLI 进行交互。机密和工程是否能被读取或写入，具体取决于授予您的特定访问令牌的权限。要获取 `secret` 和 `project` 命令的更多详细信息，请使用：

* `bws secret --help`
* `bws project --help`

{% hint style="info" %}
从 Secrets Manager 版本 0.3.0 开始，CLI 语法已更改。例如，列出机密的命令已从 `bws list secret` 更改为 `bws secret list`。

Secrets Manager CLI 将暂时保留对旧语法的支持。如果您不确定正在使用的 Secrets Manager CLI 的版本，请输入 `bws --version`。
{% endhint %}

## run

`run` 命令在执行命令时将密钥注入为环境变量，使您能够轻松调整现有开发项目和脚本以使用安全机密管理。

{% hint style="danger" %}
**请只执行您信任的命令**。`run` 命令执行您在 shell 中指定的命令，因此您不应使用它来执行您不信任的二进制文件、shell 脚本或临时 shell 命令。不受信任的可执行文件可能包含命令注入或其他恶意行为，这些行为在 `bws run` 内部运行时会获得对机密的访问权限。
{% endhint %}

{% tabs %}
{% tab title="单个命令" %}
您可以使用 `bws run -- 'your-command'` 执行单个命令：

```shellscript
# run an npm project with secrets injected
bws run -- 'npm run start'
```

{% endtab %}

{% tab title="多个命令" %}
可以通过将多个 shell 命令用单引号括起来来执行它们。将多个命令用单引号括起来将确保在 shell 解释特殊字符（例如 `$`、`&`、`;`、`"` 等）之前将整个命令传递给 run 命令：

```shellscript
# start a container stack, execute a script, and tear down the container stack
bws run -- 'docker compose up -d && ./second-command.sh; docker compose down'

# echo a secret's value by name
bws run -- 'echo "$secret_name"'
```

{% endtab %}
{% endtabs %}

{% hint style="success" %}
大多数命令行实用程序都受到 POSIX 的限制。POSIX 合规性要求环境变量名称仅包含字母数字字符或下划线，并且只能以字母或下划线开头。

Secrets Manager CLI 仍会将不符合 POSIX 标准的密钥名称设置为环境变量，但是它们只能从不受 POSIX 合规性限制的程序访问。请参阅描述 `--uuids-as-keynames` 参数的部分，以了解确保机密的环境变量名称符合 POSIX 标准的简单方法。
{% endhint %}

### run --project-id

使用 `--project-id` 选项和 `run` 命令来注入单个项目的机密，例如：

```shellscript
bws run --project-id 7b006643-89c1-4202-a5ca-90510f566030 -- echo "only secrets from the specified project will be available"
```

### run --shell

`run` 命令在 Linux 和 macOS 上默认使用 `sh`，在 Windows 上默认使用 PowerShell。将 `--shell` 选项与 `run` 命令一起使用可使用另一个已安装的 shell 运行，例如：

```shellscript
bws run --shell fish -- echo “running a command with the Fish shell” 
```

### run --no-inherit-env

在 `run` 命令中使用 `--no-inherit-env` 选项来执行进程，而不从 shell 继承大部分环境变量，例如：

{% hint style="success" %}
虽然 `--no-inherit-env` 参数尝试从 shell 中删除环境变量，但它始终会继承 `$PATH`。此外，一些环境变量（`$PWD`、`$SLVL` 等）将由 shell 本身自动设置，因此可能是持久性的。
{% endhint %}

```shellscript
bws run --no-inherit-env -- echo "running a command with a minimal environment"
```

{% hint style="danger" %}
`--no-inherit-env` 参数是从 shell 中删除可能与正在执行的进程冲突的环境变量的简单方法。此选项不会创建沙箱。您执行的进程将具有与任何其他非沙盒应用程序相同的系统访问权限。
{% endhint %}

### run --uuids-as-keynames

默认情况下，`run` 命令将采用机密名称并将其设置为正在执行的进程中的环境变量。将 `--uuids-as-keynames` 参数与 `run` 命令结合使用，以使用符合 POSIX 标准的机密 ID 作为环境变量名称，例如：

```shellscript
# echo a secret’s value by its POSIX-compliant UUID
bws run --uuids-as-keynames -- 'echo $_64246aa4_70b3_4332_8587_8b1284ce6d76'
```

或者，您可以将 `BWS_UUIDS_AS_KEYNAMES=true` 设置为环境变量，以获得与传递参数相同的效果。

{% hint style="success" %}
由于 UUIDS 包含连字符，有时以数字开头，因此 `--uuids-as-keynames` 参数将用下划线替换连字符，并始终在机密 UUIDS 前面添加下划线以确保符合 POSIX 标准。例如，ID 为 `64246aa4-70b3-4332-8587-8b1284ce6d76` 的机密将转换为 `_64246aa4_70b3_4332_8587_8b1284ce6d76`。
{% endhint %}

## secret

`secret` 命令用于访问、操作和创建[机密](/docs/secrets-manager/your-secrets/secrets.md)。与所有命令一样，访问令牌的访问权限范围之外的机密和[工程](/docs/secrets-manager/your-secrets/projects.md)无法读取或写入。

### secret create

使用 `bws secret create` 创建一个新的机密。此命令需要 `KEY`、`VALUE` 和 `PROJECT_ID`：

```shellscript
bws secret create <KEY> <VALUE> <PROJECT_ID>
```

或者，您可以使用 `--note <NOTE>` 选项添加注释。例如：

```shellscript
bws secret create SES_KEY 0.982492bc-7f37-4475-9e60 f588b2f2-4780-4a78-be2a-b02d014d622f --note "API Key for AWS SES"
```

默认情况下，此命令将返回一个 JSON 对象并将机密保存到 Secrets Manager。您可以使用 `--output` 标志更改输出格式（[了解更多](#o-output)）。

```json
{
  "object": "secret",
  "id": "be8e0ad8-d545-4017-a55a-b02f014d4158",
  "organizationId": "10e8cbfa-7bd2-4361-bd6f-b02e013f9c41",
  "projectId": "e325ea69-a3ab-4dff-836f-b02e013fe530",
  "key": "SES_KEY",
  "value": "0.982492bc-7f37-4475-9e60",
  "note": "API Key for AWS SES",
  "creationDate": "2023-06-28T20:13:20.643567Z",
  "revisionDate": "2023-06-28T20:13:20.643567Z"
}
```

### secret delete

`bws secret delete` 命令用来删除 `SECRET_IDS` 指定的一个或多个机密。

```shellscript
bws secret delete <SECRET_IDS>
```

要删除 ID 为 `be8e0ad8-d545-4017-a55a-b02f014d4158` 的单个机密：

```shellscript
bws secret delete be8e0ad8-d545-4017-a55a-b02f014d4158
```

对于 ID 为 `382580ab-1368-4e85-bfa3-b02e01400c9f` 和 `47201c5c-5653-4e14-9007-b02f015b2d82` 的多个机密：

```shellscript
bws secret delete 382580ab-1368-4e85-bfa3-b02e01400c9f 47201c5c-5653-4e14-9007-b02f015b2d82
```

输出：

```
1 secret deleted successfully.
```

### secret edit

要编辑机密，以下结构会将更改应用于所选值。在 CLI 中，此命令可以编辑机密的 `KEY`、`VALUE`、`NOTE` 或 `PROJECT_ID`。

```shellscript
bws secret edit <SECRET_ID> --key <KEY> --value <VALUE> --note <NOTE> --project-id <PROJECT_ID>
```

例如，如果您希望向现有机密添加注释：

```batch
bws secret edit be8e0ad8-d545-4017-a55a-b02f014d4158 --note "I am adding a note"
```

{% hint style="info" %}
编辑包含空格的 `NOTE` 时，请在字符串两边加上引号。
{% endhint %}

要编辑多个字段，其中 `SES_KEY2` 是新的 `key`，`0.1982492bc-7f37-4475-9e60` 是新 `value`：

```shellscript
bws secret edit be8e0ad8-d545-4017-a55a-b02f014d4158 --key SES_KEY2 --value 0.1982492bc-7f37-4475-9e60
```

输出：

```json
{
  "object": "secret",
  "id": "be8e0ad8-d545-4017-a55a-b02f014d4158",
  "organizationId": "10e8cbfa-7bd2-4361-bd6f-b02e013f9c41",
  "projectId": "e325ea69-a3ab-4dff-836f-b02e013fe530",
  "key": "SES_KEY2",
  "value": "0.1982492bc-7f37-4475-9e60",
  "note": "I am adding a note",
  "creationDate": "2023-06-28T20:13:20.643567Z",
  "revisionDate": "2023-06-28T20:45:37.46232Z"
}
```

### secret get

`bws secret get` 用于检索特定的机密：

```shellscript
bws secret get <SECRET_ID>
```

默认情况下，此命令将检索具有 `SECRET_ID` 的机密对象。

```shellscript
bws secret get be8e0ad8-d545-4017-a55a-b02f014d4158
```

默认情况下，`get` 将以 JSON 数组的形式返回对象，如以下示例所示。您可以使用 `--output` 标志更改输出格式（[了解更多](#o-output)）。

```json
{
  "object": "secret",
  "id": "be8e0ad8-d545-4017-a55a-b02f014d4158",
  "organizationId": "10e8cbfa-7bd2-4361-bd6f-b02e013f9c41",
  "projectId": "e325ea69-a3ab-4dff-836f-b02e013fe530",
  "key": "SES_KEY",
  "value": "0.982492bc-7f37-4475-9e60",
  "note": "",
  "creationDate": "2023-06-28T20:13:20.643567Z",
  "revisionDate": "2023-06-28T20:13:20.643567Z"
}
```

### secret list

要列出机器账户可以访问的机密，请使用以下命令：

```shellscript
bws secret list
```

您还可以使用以下命令仅列出特定项目中的机密，其中 `e325ea69-a3ab-4dff-836f-b02e013fe530` 表示项目标识符：

```shellscript
bws secret list e325ea69-a3ab-4dff-836f-b02e013fe530
```

默认情况下，`list` 将以 JSON 数组的形式返回对象，如下例所示。您可以使用 `--output` 标志更改输出格式（[了解更多](#o-output)）。

```json
[
  {
    "object": "secret",
    "id": "382580ab-1368-4e85-bfa3-b02e01400c9f",
    "organizationId": "10e8cbfa-7bd2-4361-bd6f-b02e013f9c41",
    "projectId": "e325ea69-a3ab-4dff-836f-b02e013fe530",
    "key": "Repository 1",
    "value": "1234567ertthrjytkuy",
    "note": "Main Repo",
    "creationDate": "2023-06-27T19:25:15.822004Z",
    "revisionDate": "2023-06-27T19:25:15.822004Z"
  },
  {
    "object": "secret",
    "id": "be8e0ad8-d545-4017-a55a-b02f014d4158",
    "organizationId": "10e8cbfa-7bd2-4361-bd6f-b02e013f9c41",
    "projectId": "e325ea69-a3ab-4dff-836f-b02e013fe530",
    "key": "SES_KEY",
    "value": "0.982492bc-7f37-4475-9e60",
    "note": "",
    "creationDate": "2023-06-28T20:13:20.643567Z",
    "revisionDate": "2023-06-28T20:13:20.643567Z"
  }
]
```

## project

`project` 命令用于访问、操作和创建[工程](/docs/secrets-manager/your-secrets/projects.md)。分配给您的机器账户的访问范围将决定可以使用 `project` 命令完成哪些操作。

{% hint style="info" %}
工程可以由具有只读访问权限的机器账户创建。但是，如果此机器账户没有**读取**和**写入**访问权限，则无法编辑不是由其创建的现有工程。
{% endhint %}

### project create

`bws project create` 用于创建一个新的工程。此命令需要一个 `NAME`。

```shellscript
bws project create <NAME>
```

在此示例中，将创建一个名为 `My project` 的工程。

```shellscript
bws project create "My project"
```

默认情况下，`bws project create` 将以 JSON 数组的形式返回对象，如下例所示。您可以使用 `--output` 标志更改输出格式（[了解更多](#huan-jing-bian-liang)）。

```json
{
  "object": "project",
  "id": "1c80965c-acb3-486e-ac24-b03000dc7318",
  "organizationId": "10e8cbfa-7bd2-4361-bd6f-b02e013f9c41",
  "name": "My project",
  "creationDate": "2023-06-29T13:22:37.942559Z",
  "revisionDate": "2023-06-29T13:22:37.942559Z"
}
```

### project delete

`bws project delete` 用于删除 `PROJECT_IDS` 指定的一个或多个工程。

```shellscript
bws project delete <PROJECT_IDS>
```

对于单个项目，其中 `f1fe5978-0aa1-4bb0-949b-b03000e0402a` 代表 `PROJECT_ID`：

```shellscript
bws project delete f1fe5978-0aa1-4bb0-949b-b03000e0402a
```

对于多个项目，其中 `1c80965c-acb3-486e-ac24-b03000dc7318` 和 `f277fd80-1bd2-4532-94b2-b03000e00c6c` 代表 `PROJECT_IDS`：

```shellscript
bws project delete 1c80965c-acb3-486e-ac24-b03000dc7318 f277fd80-1bd2-4532-94b2-b03000e00c6c
```

输出：

```
1 project deleted successfully.
```

### project edit

用 `edit` 命令，您可以通过以下输入更改g工程的名称：

```shellscript
bws project edit <PROJECT_ID> --name <NEW_NAME>
```

例如，此命令会将项目名称更改为 `My project 2`。

```shellscript
bws project edit 1c80965c-acb3-486e-ac24-b03000dc7318 --name "My project 2"
```

默认情况下，`bws project edit` 将返回 JSON 数组形式的对象，如下例所示。您可以使用 `--output` 标志更改输出格式（[了解更多](#o-output)）。

```json
{
  "object": "project",
  "id": "1c80965c-acb3-486e-ac24-b03000dc7318",
  "organizationId": "10e8cbfa-7bd2-4361-bd6f-b02e013f9c41",
  "name": "My project 2",
  "creationDate": "2023-06-29T13:22:37.942559Z",
  "revisionDate": "2023-06-29T13:31:07.927829Z"
}
```

### project get

`get` 命令检索已登录的机器账户可以从您的密码库访问的特定工程。无法检索密码库中机器账户无权访问的对象。

```shellscript
bws project get <PROJECT_ID>
```

要获取特定工程，请使用以下命令，其中 `e325ea69-a3ab-4dff-836f-b02e013fe530` 代表 `PROJECT_ID`：

```shellscript
bws project get e325ea69-a3ab-4dff-836f-b02e013fe530
```

默认情况下，`get` 将返回 JSON 数组形式的对象，如下例所示。您可以使用 `--output` 标志更改输出格式（[了解更多](#o-output)）。

```json
{
  "object": "project",
  "id": "e325ea69-a3ab-4dff-836f-b02e013fe530",
  "organizationId": "10e8cbfa-7bd2-4361-bd6f-b02e013f9c41",
  "name": "App 1",
  "creationDate": "2023-06-27T19:24:42.181607Z",
  "revisionDate": "2023-06-27T19:24:42.181607Z"
}
```

### project list

要列出此机器账户有权访问的工程，请使用以下命令：

```shellscript
bws project list
```

默认情况下，`list` 将返回 JSON 数组形式的对象，如下例所示。您可以使用 `--output` 标志更改输出格式（[了解更多](#o-output)）。

```json
[
  {
    "object": "project",
    "id": "e325ea69-a3ab-4dff-836f-b02e013fe530",
    "organizationId": "10e8cbfa-7bd2-4361-bd6f-b02e013f9c41",
    "name": "App 1",
    "creationDate": "2023-06-27T19:24:42.181607Z",
    "revisionDate": "2023-06-27T19:24:42.181607Z"
  }.
  ...
]
```

## config

`config` 命令为 Secrets Manager CLI 指定要使用的服务器设置。`bws config` 的主要用途是将 CLI 连接到自托管的 Bitwarden 服务器。

### server

可用的 `bws` 服务器设置包括 `server-base`、`server-api` 和 `server-identity`，例如：

```shellscript
bws config server-base https://my_hosted_server.com
```

{% hint style="info" %}
如果未配置 `server_api` 和 `server_identity`，则这些值将默认为 `server_base` 值。例如： `https://serverbase.com/api`\
`https://serverbase.com/identity`
{% endhint %}

以这种方式完成后，您指定的服务器值将保存到 `~/.bws/config` 文件中作为默认个人资料。您可以使用后续选项来创建备用个人资料和配置文件：

### **config --profile**

将 `--profile` 选项与 `config` 命令一起使用可将指定的服务器值保存到备用个人资料，例如：

```shellscript
bws config server-base http://other_hosted_server.com --profile dev
```

创建后，您可以将该个人资料与其他命令一起使用以将请求路由到指定的服务器，例如：

```shellscript
bws get secret 2863ced6-eba1-48b4-b5c0-afa30104877a --profile dev
```

### **config --config-file**

将 `--config-file` 选项与 `config` 命令一起使用可将指定的服务器值保存到备用配置文件，例如将值保存到新配置文件中的默认个人资料：

```shellscript
bws config server-base http://third_hosted_server.com --config-file ~/.bws/alt_config
```

您可以将 `--config-file` 与 `--profile` 链接起来，以将值保存到备用配置文件中的备用个人资料，例如：

```shellscript
bws config server-base http://third_hosted_server.com --config-file ~/.bws/alt_config --profile alt_dev
```

创建后，您可以将该个人资料与其他命令一起使用以将请求路由到指定的服务器，例如：

```shellscript
bws secret get 2863ced6-eba1-48b4-b5c0-afa30104877a --config-file ~/.bws/alt_config --profile alt_dev
```

### config --state

状态文件是完全加密的文件，用于存储身份验证令牌和其他相关数据。状态文件可以使用存储的令牌进行身份验证，从而减少身份验证时的速率限制。状态目录默认位置是 `~/.config/bws/state`。状态文件必须指定绝对路径：

```shellscript
bws config state-dir /Users/user/Desktop/bws/state
```

用户可以通过访问 `~/.config/bws/config` 并将 `state_opt_out` 设置为值 `true` 或 `1` 来选择不使用状态文件。

## 配置 Docker <a href="#config-docker" id="config-docker"></a>

运行以下命令将配置文件传递到 Docker 容器：

```bash
docker run -it -v /PATH/TO/YOUR/CONFIGFILE:/home/app/.bws/config -e BWS_ACCESS_TOKEN=<ACCESS_TOKEN_VALUE> bitwarden/bws secret list
```

## 选项 <a href="#options" id="options"></a>

### -o, --output

默认情况下，Secrets Manager CLI 将返回一个 JSON 对象或 JSON 对象数组以响应命令。可以使用 `-o`，`--output` 标志以及以下选项之一更改输出的格式以满足您的需要：

* `json`：默认。输出 JSON。
* `yaml`：输出 YAML。
* `table`：输出一个 ASCII 表，其中键值作为列标题。
* `tsv`：输出没有键值的制表符分隔值。
* `none`：只输出错误和警告。
* `env`：以 KEY=VALUE 格式输出机密。

例如，以下命令：

```shellscript
bws secret get 2863ced6-eba1-48b4-b5c0-afa30104877a --output yaml
```

将返回以下内容：

```
object: secret
id: 2863ced6-eba1-48b4-b5c0-afa30104877a
organizationId: b8824f88-c57c-4a36-8b1a-afa300fe0b52
projectId: 1d0a63e8-3974-4cbd-a7e4-afa30102257e
key: Stripe API Key
value: osiundfpowubefpouwef
note: 'These are notes.'
creationDate: 2023-02-08T15:48:33.470701Z
revisionDate: 2023-02-08T15:48:33.470702Z
```

{% hint style="info" %}
使用 env 输出格式时，如果键名称不符合 POSIX 标准，则该键值对将被注释掉，并且输出底部将显示一条注释，指示输出已被修改。
{% endhint %}

使用 `--output env` 标志，例如：

```shellscript
bws secret list --output env
```

将返回以下内容：

```systemd
this_is_a_keyname="this is a key value"
CLOUDFLARE_API_TOKEN="123412341234123412341234"
# This is an invalid keyname="this will get commented-out"

# one or more secrets have been commented-out due to a problematic key name
```

### -c, --color

可以通过指示是否需要彩色输出来进一步自定义输出。此选项的可用值为 `yes`、`no` 和 `auto`。

### --access-token

您可以将 `-t`，`--access-token` 选项与任何单个命令一起使用来验证单个 CLI 请求，例如：

```shellscript
bws list secrets --access-token 0.48c78342-1635-48a6-accd-afbe01336365.C0tMmQqHnAp1h0gL8bngprlPOYutt0:B3h5D+YgLvFiQhWkIq6Bow==
```

### --profile

将 `--profile` 选项与 `list` 或 `get` 命令一起使用以指定要使用的个人资料，例如：

```shellscript
bws get secret 2863ced6-eba1-48b4-b5c0-afa30104877a --profile dev
```

请参阅 `config` 命令（[此处](#config)）以帮助理解和设置备用个人资料。

### --config-file

将 `--config-file` 选项与 `--profile` 选项和 `list` 或 `get` 命令一起使用，以指定要使用哪个配置文件中的哪个配置文件，例如：

```shellscript
bws get secret 2863ced6-eba1-48b4-b5c0-afa30104877a --config-file ~/.bws/alt_config --profile alt_dev
```

请参阅 `config` 命令（[此处](#config)）以帮助理解和设置备用配置文件和个人资料。

### --server-url

此选项可用于设置 CLI 将向其发送与指定的命令关联的请求的服务器 URL，例如：

```shellscript
bws list secrets --server-url http://my_hosted_server.com
```

此选项将覆盖通过 `config` 命令配置的任何 URL（请参阅此处）。

### --help

使用此选项打印任何指定的 `bws` 命令的帮助。

### --version

使用此选项打印您正在使用的 `bws` 客户端的版本。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.ppgg.in/docs/secrets-manager/developer-tools/secrets-manager-cli.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.