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

# Obtenir une clé API et se connecter

> Authentifiez Octoparse CLI avec OAuth ou une clé API, et utilisez une variable d’environnement ou stdin pour la CI et les environnements automatisés.

## Conditions d’authentification

La plupart des commandes Octoparse CLI nécessitent une authentification. Une clé API ou une session OAuth identifie votre compte et autorise l’accès à vos tâches et données Octoparse.

<Warning>
  Toutes les commandes fonctionnelles nécessitent des identifiants valides, notamment les exécutions locales avec `--task-file` et les fichiers `.otd`, ainsi que les commandes de recherche de modèles. Authentifiez-vous avant de répertorier, rechercher, exécuter ou exporter des tâches.
</Warning>

<Note>
  À partir de la version 0.1.33 de la CLI, `template search`, `template view` et `template version` nécessitent des identifiants. La version 0.1.32 permettait à ces commandes de parcourir le même catalogue de modèles sans se connecter.
</Note>

Seules les commandes de configuration et de diagnostic peuvent être exécutées sans identifiants :

```bash theme={null}
octoparse --help
octoparse --version
octoparse capabilities
octoparse doctor
octoparse browser status
octoparse auth
octoparse auth info
```

## Méthodes de connexion

Octoparse CLI propose deux méthodes de connexion : OAuth et la clé API.

### OAuth (dans le navigateur)

Ouvrez la procédure de connexion dans le navigateur et enregistrez localement les jetons d’accès et d’actualisation :

```bash theme={null}
octoparse auth login --oauth
```

Utilisez OAuth si vous préférez ne pas gérer manuellement les clés API ou si votre équipe utilise l’authentification unique (SSO).

### Clé API

Créez vos clés API dans la console Octoparse :

<Card title="Ouvrir la page des clés API" icon="key" href="https://www.octoparse.fr/console/account-center/api-keys">
  Créez, copiez et gérez les clés API Octoparse depuis votre centre de compte.
</Card>

**Connexion interactive** : ouvre la page des clés API, puis vous invite à coller une clé :

```bash theme={null}
octoparse auth login
```

**Transmission directe de la clé** : vérifie et enregistre une clé copiée :

```bash theme={null}
octoparse auth login <apiKey>
```

**Sans ouvrir le navigateur :**

```bash theme={null}
octoparse auth login --no-open
```

**Lecture de la clé depuis stdin** : pour les gestionnaires de secrets et les pipelines CI :

```bash theme={null}
echo "<apiKey>" | octoparse auth login --stdin
```

Par exemple, avec 1Password CLI :

```bash theme={null}
op read "op://vault/octoparse/credential" | octoparse auth login --stdin
```

<Note>
  La CLI vérifie la clé API avant de l’enregistrer. Les clés non valides ne sont pas conservées.
</Note>

## Utiliser une variable d’environnement

Pour la CI ou les sessions temporaires, transmettez les identifiants au moyen de variables d’environnement plutôt que d’identifiants enregistrés :

```bash theme={null}
OCTO_ENGINE_API_KEY=xxx octoparse task list --json
```

Pour un accès avec un jeton porteur, utile dans les tâches CI de courte durée :

```bash theme={null}
OCTO_ENGINE_ACCESS_TOKEN=xxx octoparse task list --json
```

Vous pouvez également remplacer l’URL de base de l’API :

```bash theme={null}
OCTO_ENGINE_API_BASE_URL=https://example.com OCTO_ENGINE_API_KEY=xxx octoparse task list
```

## Ordre de priorité des identifiants

Octoparse CLI vérifie les identifiants dans l’ordre suivant :

```text theme={null}
1. OCTO_ENGINE_ACCESS_TOKEN  (bearer token, highest priority)
2. OCTO_ENGINE_API_KEY       (API key override)
3. ~/.octoparse/credentials.json  (stored by auth login)
```

Le fichier d’identifiants est créé automatiquement par `octoparse auth login`.

Sous macOS et Linux :

```text theme={null}
~/.octoparse/credentials.json
```

Sous Windows :

```text theme={null}
%USERPROFILE%\.octoparse\credentials.json
```

<Warning>
  Ne publiez jamais de clés API ni de jetons dans Git, des scripts, la documentation, des captures d’écran, des journaux partagés ou la sortie de la CI.
</Warning>

## Vérifier et gérer l’état de l’authentification

Vérifiez que votre session est active :

```bash theme={null}
octoparse auth status
```

Affichez des informations détaillées sur le compte et les identifiants :

```bash theme={null}
octoparse auth info
```

Supprimez les identifiants enregistrés :

```bash theme={null}
octoparse auth logout
```

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Exécuter votre première tâche" href="/docs/fr/cli/quick-start/run-your-first-task">
    Répertoriez les tâches, inspectez-en une, exécutez-la en local et exportez les données.
  </Card>

  <Card title="Parcourir toutes les commandes" href="../reference/command-cheatsheet">
    Consultez les commandes d’authentification, de tâche, d’exécution locale et dans le Cloud, et d’export.
  </Card>
</CardGroup>