> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qaos.machdel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentification

> Connectez le CLI QAOS à votre compte via OAuth dans le navigateur ou avec un jeton API.

Avant de lancer des tests, le CLI QAOS doit être authentifié avec votre compte. Deux méthodes d'authentification sont disponibles.

***

## Méthode 1 — Connexion via le navigateur (recommandée)

Ouvrez une session de connexion dans le navigateur :

```bash theme={null}
npx qaos auth --ui
```

Votre navigateur par défaut ouvrira la page de connexion QAOS. Connectez-vous avec vos identifiants — le CLI capturera automatiquement le jeton de session une fois l'authentification terminée.

Il s'agit de la méthode recommandée pour une utilisation interactive sur une machine personnelle.

***

## Méthode 2 — Jeton API

Authentifiez-vous directement avec un jeton API personnel. Cette méthode est idéale pour les pipelines CI/CD ou les environnements non interactifs.

**Étape 1 — Générer un jeton**

1. Connectez-vous au [Tableau de bord QAOS](https://qaos.machdel.com)
2. Naviguez vers **Paramètres → Jetons API**
3. Cliquez sur **Nouveau jeton**, donnez-lui un nom et copiez la valeur

**Étape 2 — Authentifier le CLI**

```bash theme={null}
npx qaos auth --api <votre-jeton-api>
```

Remplacez `<votre-jeton-api>` par le jeton copié depuis le tableau de bord.

<Warning>
  Les jetons API donnent un accès complet à votre compte QAOS. Traitez-les comme des mots de passe : ne les committez jamais dans le contrôle de version, et faites-les tourner s'ils sont compromis. Utilisez des variables d'environnement pour passer les jetons dans les pipelines CI :

  ```bash theme={null}
  npx qaos auth --api $QAOS_API_TOKEN
  ```
</Warning>

***

## Vérifier le statut d'authentification

Pour savoir si le CLI est actuellement authentifié et quel compte il utilise :

```bash theme={null}
npx qaos auth
```

Cette commande affiche votre statut d'authentification et les détails du compte sans effectuer aucun changement.

***

## Se déconnecter

Pour supprimer les identifiants sauvegardés de la machine actuelle :

```bash theme={null}
npx qaos auth --logout
```

Cela efface le jeton stocké dans le trousseau local. Le jeton lui-même n'est pas invalidé — pour révoquer définitivement un jeton, supprimez-le depuis le tableau de bord sous **Paramètres → Jetons API**.

***

## Étapes suivantes

Avec l'authentification configurée, vous êtes prêt à [lancer votre premier test](/fr/getting-started/quickstart).
