Personlig API-nyckel för CLI-autentisering
Din Bitwarden personliga API-nyckel kan användas som en metod för autentisering i kommandoradsgränssnittet (CLI).
note
Your personal API key is not the same as the organization API key used to access the Bitwarden Public API or Directory Connector. Personal API keys will have a client_id
with format "user.clientId"
, while organization API keys will have a client_id
with format "organization.ClientId"
.
Skaffa din personliga API-nyckel
Så här får du din personliga API-nyckel:
I Bitwarden webbapp, navigera till Inställningar → Säkerhet → Nycklar:
Keys Välj knappen Visa API-nyckel och ange ditt huvudlösenord för att validera åtkomst. När du har angetts får du följande:
client_id: "user.clientId
" (Detta värde är unikt för ditt konto och ändras inte.)client_secret: "
clientSecret" (Detta värde är unikt och kan roteras).scope: "
api" (Detta värde kommer alltid att vara"api"
).grant_type: "client_credentials
" (Detta värde kommer alltid att vara "client_credentials"
).
Rotera din API-nyckel
Välj knappen Rotera API-nyckel för att rotera din personliga API-nyckel. Att vrida på din nyckel kommer bara att ändra din client_secret
.
Om du roterar din nyckel ogiltigförklaras din tidigare nyckel och alla aktiva sessioner som använder den nyckeln.
Autentisera med din API-nyckel
Att logga in på CLI med den personliga API-nyckeln rekommenderas för automatiserade arbetsflöden eller för att ge åtkomst till en extern applikation. För att logga in med API-nyckeln:
Bashbw login --apikey
Detta kommer att initiera en prompt för ditt personliga client_id
och client_secret
. När din session har autentiserats med dessa värden kommer du att uppmanas att använda kommandot upplåsning
(läs mer).
Använder API-nyckelmiljövariabler
I scenarier där automatiserat arbete utförs med Bitwarden CLI, kan du spara miljövariabler för att förhindra behovet av manuell intervention vid autentisering.
Miljövariabelnamn | Obligatoriskt värde |
---|---|
BW_CLIENTID |
|
BW_CLIENTSECRET |
|