# Défis d'authentification CLI

La version d'août 2021 de Bitwarden (**2021-09-21**) a introduit des exigences de [CAPTCHA](https://www.hcaptcha.com/about) pour augmenter la sécurité contre le trafic de bots. Sur le CLI, les défis CAPTCHA sont remplacés par des défis d'authentification qui peuvent être validés en utilisant la [clé API personnelle](https://bitwarden.com/fr-fr/help/personal-api-key/) de votre compte `client_secret`.

> [!NOTE] bwlogin api key
> **Pour les flux de travail automatisés ou pour fournir un accès à une application externe**, nous recommandons d'utiliser la `identifiant bw --apikey` [méthode](https://bitwarden.com/fr-fr/help/cli/#using-an-api-key/). Cette méthode suit un flux d'authentification plus prévisible et la révocation de l'accès d'une application ou d'une machine peut être obtenue en faisant tourner la [clé API](https://bitwarden.com/fr-fr/help/personal-api-key/#rotate-your-api-key/) .

## 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.
3. Depuis la boîte de dialogue **clé API**, copiez la valeur **client_secret:**, qui est une chaîne aléatoire comme `efrbgT9C6BogEfXi5pZc48XyJjfpR`.

## Répondre aux défis

Selon vos préférences, vous pouvez [enregistrer une variable d'environnement](https://bitwarden.com/fr-fr/help/cli-auth-challenges/#answer-challenges-with-an-environment-variable/) pour passer automatiquement les défis d'authentification ou [entrer manuellement](https://bitwarden.com/fr-fr/help/cli-auth-challenges/#using-the-prompt/) votre `client_secret` chaque fois qu'un défi est lancé :

### Répondez aux défis avec une variable d'environnement

Les défis d'authentification rechercheront une variable d'environnement non vide `BW_CLIENTSECRET` avant de vous inviter à en entrer une manuellement. Enregistrer cette variable avec la [valeur client_secret récupérée](https://bitwarden.com/fr-fr/help/cli-auth-challenges/#get-your-personal-api-key/) vous permettra de passer automatiquement les défis d'authentification. Pour enregistrer cette variable d'environnement :

🐧 🍎 Bash

```
export BW_CLIENTSECRET="client_secret"
```

🪟 PowerShell

```
env:BW_CLIENTSECRET="client_secret"
```

> [!NOTE] Client secret value incorrect 
> Si votre `client_secret` est incorrect, vous recevrez une erreur. Dans la plupart des cas, c'est parce que vous avez [régénéré votre clé API](https://bitwarden.com/fr-fr/help/personal-api-key/#rotate-your-api-key/) depuis l'enregistrement de la variable. [Utilisez les étapes ci-dessus](https://bitwarden.com/fr-fr/help/cli-auth-challenges/#get-your-personal-api-key/) pour récupérer la valeur correcte.

### Répondez aux défis manuellement

Lorsqu'un défi d'authentification est lancé et qu'aucune valeur `BW_CLIENTSECRET` n'est trouvée, on vous demandera d'entrer manuellement votre valeur `client_secret` :

![Invite d'identifiant avec défi d'authentification ](https://bitwarden.com/assets/6YPFmH0ALYCuKcpOs6yf8X/e12166c2a561203f4605401b716f89e6/cli-captcha-1-markup.png)

> [!NOTE] Client secret value incorrect 
> Si votre `client_secret` est incorrect, vous recevrez une erreur. Dans la plupart des cas, c'est parce que vous avez [régénéré votre clé API](https://bitwarden.com/fr-fr/help/personal-api-key/#rotate-your-api-key/) depuis l'enregistrement de la variable. [Utilisez les étapes ci-dessus](https://bitwarden.com/fr-fr/help/cli-auth-challenges/#get-your-personal-api-key/) pour récupérer la valeur correcte.