# Clé API personnelle pour l'authentification CLI

Votre clé API personnelle Bitwarden peut être utilisée comme méthode d'authentification dans l'interface en ligne de commande (CLI).

> [!NOTE] Personal API key vs organization API key
> Votre clé API personnelle n'est **pas la même** que la [clé API de l'organisation](https://bitwarden.com/fr-fr/help/public-api/#authentication/) utilisée pour accéder à l'[API publique de Bitwarden](https://bitwarden.com/fr-fr/help/public-api/) ou au [Connecteur de répertoire](https://bitwarden.com/fr-fr/help/directory-sync/). Les clés API personnelles auront un `client_id` au format `"user.clientId"`, tandis que les clés API de l'organisation auront un `client_id` au format `"organisation.ClientId"`.

## Obtenez votre clé API personnelle

Pour obtenir votre clé API personnelle :

1. Dans l'application web Bitwarden, naviguez vers **Paramètres** → **Sécurité** → **Clés** :

![Clés](https://bitwarden.com/assets/3IHpaOpEB5a13TF3B3RqqB/fab175095404a90d9d372542745bb9bb/Keys_settings.png)
2. Sélectionnez le bouton **Afficher la clé API** et entrez votre mot de passe principal pour valider l'accès. Une fois entré, on vous fournira ce qui suit :

 - `client_id: "user.clientId"` (Cette valeur est unique à votre compte et ne change pas.)
 - `client_secret: "clientSecret"` (Cette valeur est unique et peut être régénérée).
 - `portée: "api"` (Cette valeur sera toujours `"api"`).
 - `grant_type: "client_credentials"` (Cette valeur sera toujours `"client_credentials"`).

### Régénérez votre clé API

Sélectionnez le bouton **Régénérer la clé API** pour régénérer votre clé API personnelle. La régénération de votre clé ne changera que votre `client_secret`.

La régénération de votre clé invalidera votre clé précédente et toutes les sessions actives utilisant cette clé.

## Authentifiez-vous en utilisant votre clé API

Se connecter à la CLI avec la clé API personnelle est **recommandé pour les flux de travail automatisés ou pour fournir un accès à une application externe**. Pour se connecter avec la clé API :

```
bw login --apikey
```

Cela déclenchera une invite pour votre `client_id` et `client_secret` personnels. Une fois que votre session est authentifiée en utilisant ces valeurs, on vous demandera d'utiliser la commande `déverrouiller` ([en savoir plus](https://bitwarden.com/fr-fr/help/cli/#unlock/)).

#### Utilisation de variables d'environnement de clé API

Dans les scénarios où un travail automatisé est effectué avec le CLI de Bitwarden, vous pouvez enregistrer des variables d'environnement pour éviter la nécessité d'une intervention manuelle lors de l'authentification.

| **Nom de la variable d'environnement** | **Valeur requise** |
|------|------|
| BW_CLIENTID | `identifiant du client` |
| BW_SECRETCLIENT | `secret_client` |