用于 CLI 验证的个人 API 密钥

对应的官方文档地址

您的 Bitwarden 个人 API 密钥可以作为一种验证进入命令行界面（CLI）的方式。

个人 API 密钥与用于访问 Bitwarden 公共 API 或目录连接器的组织 API 密钥是不同的。个人 API 密钥的 client_id 格式为 "user.clientId"，而组织 API 密钥的 client_id 格式为 "organization.ClientId"。

获取您的个人 API 密钥

使用以下步骤来获取您的 API 密码：

1、在网页密码库中，选择配置文件图标然后从下拉列表中选择账户设置：

账户设置

2、从账户设置菜单中，选择安全页面然后选择密钥选项卡：

密钥选项卡

3、选择查看 API 密钥按钮后将提示您输入主密码。

输入正确的主密码后，将为你提供以下内容：

• client_id: "user.clientId" （这个值对于你的账户是唯一的，并且不会改变）

• client_secret: "clientSecret" （这个值是唯一的，但可以被轮换）

• scope: "api" （这个值固定为 "api"）

• grant_type: "client_credentials" （这个值固定为"client_credentials"）

轮换您的 API 密钥

选择轮换 API 密钥按钮来轮换您的个人 API 密钥。轮换您的密钥将只会更改您的 client_secret 的值。

轮换您的密钥将使您之前的密钥和所有使用该密钥的活动会话失效。

使用您的 API 密钥验证

使用个人 API 密钥登录 CLI 建议用于自动化工作流程或对外部应用程序提供访问的场景。要使用 API 密钥登录：

bw login --apikey

这将提示您输入获您的个人 client_id 和 client_secret 来进行验证。使用这些值对您的会话进行身份验证后，您就可以使用 unlock 命令了（了解更多）。

使用 API 密钥环境变量

在使用 Bitwarden CLI 完成自动化工作的场景中，您可以保存环境变量以避免在身份验证时需要手动介入。

环境变量名称	要求的值
BW_CLIENTID	client_id
BW_CLIENTSECRET	client_secret