用于 CLI 验证的个人 API 密钥
最后更新于
最后更新于
对应的官方文档地址
您的 Bitwarden 个人 API 密钥可以作为一种验证进入命令行界面(CLI)的方式。
个人 API 密钥与用于访问 Bitwarden 公共 API 或目录连接器的组织 API 密钥是不同的。个人 API 密钥的 client_id
格式为 "user.clientId"
,而组织 API 密钥的 client_id
格式为 "organization.ClientId"
。
使用以下步骤来获取您的 API 密码:
1、在网页密码库中,选择配置文件图标然后从下拉列表中选择账户设置:
2、从账户设置菜单中,选择安全页面然后选择密钥选项卡:
3、选择查看 API 密钥按钮后将提示您输入主密码。
输入正确的主密码后,将为你提供以下内容:
client_id: "user.clientId"
(这个值对于你的账户是唯一的,并且不会改变)
client_secret: "clientSecret"
(这个值是唯一的,但可以被轮换)
scope: "api"
(这个值固定为 "api"
)
grant_type: "client_credentials"
(这个值固定为"client_credentials"
)
选择轮换 API 密钥按钮来轮换您的个人 API 密钥。轮换您的密钥将只会更改您的 client_secret
的值。
轮换您的密钥将使您之前的密钥和所有使用该密钥的活动会话失效。
使用个人 API 密钥登录 CLI 建议用于自动化工作流程或对外部应用程序提供访问的场景。要使用 API 密钥登录:
这将提示您输入获您的个人 client_id
和 client_secret
来进行验证。使用这些值对您的会话进行身份验证后,您就可以使用 unlock
命令了(了解更多)。
在使用 Bitwarden CLI 完成自动化工作的场景中,您可以保存环境变量以避免在身份验证时需要手动介入。
环境变量名称 | 要求的值 |
---|---|
BW_CLIENTID |
|
BW_CLIENTSECRET |
|