用于 CLI 验证的个人 API 密钥

对应的官方文档地址

您的 Bitwarden 个人 API 密钥可用作命令行界面 (CLI) 的验证方法。

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

获取您的个人 API 密钥

要获取您的个人 API 密码：

1、在网页 App 中，导航到设置 → 安全 → 密钥：

密钥

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