# Méthodes d’authentification des agents

Connectez-vous avec une clé API ou OAuth MCP, vérifiez l’accès sans requête payante et réutilisez-le pour les tâches suivantes.

Référence canonique : https://flashdata.dev/fr/docs/guides/agent-access
Vérifié le 2026-11-05 par FlashData

<a id="access"></a>

## 1. Choisir et configurer la connexion

Déjà connecté ? Passez directement à la vérification gratuite de l’étape 2. Sinon, choisissez l’accès adapté à votre application ou à votre agent.

| Vous connectez | Méthode | Qui conserve les identifiants ? |
| --- | --- | --- |
| Une application, un SDK, une CLI ou un script planifié | Clé API propriétaire | Le gestionnaire de secrets de votre serveur ou le profil CLI |
| Les outils de recherche de Codex ou d’OpenClaw | MCP OAuth | L’hôte, après autorisation dans le navigateur |
| Un agent qui essaie FlashData sans compte | Clé API temporaire | Le profil d’essai enregistré de l’agent, puis l’accès propriétaire après rattachement |

### Clé API

Créez une clé dans API Keys avec les sources nécessaires à votre tâche, ou réutilisez une clé existante. Fournissez-la au SDK ou envoyez-la dans X-API-Key depuis votre serveur. Les vérifications Bash et PowerShell de l’étape 2 utilisent directement l’API ; aucune installation de la CLI n’est nécessaire.

- [Clés API](https://flashdata.dev/app/api-keys)
- [Enregistrer une clé dans la CLI](https://flashdata.dev/fr/docs/guides/agent-access/reference.md#import-key)
- [Configurer une clé pour le SDK ou HTTP](https://flashdata.dev/fr/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

Utilisez un hôte configuré pour OAuth FlashData. Le propriétaire du compte s’inscrit ou se connecte et autorise l’accès dans le navigateur ; l’hôte enregistre les jetons. Cette connexion n’installe pas de clé CLI et ne rattache pas d’essai.

#### Connexion au serveur MCP hébergé

```text
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:research
```

- [Connecter Codex](https://flashdata.dev/fr/docs/integrations/codex/reference.md#setup)
- [Connecter OpenClaw](https://flashdata.dev/fr/docs/integrations/openclaw/reference.md#setup)
- [Autres clients MCP](https://flashdata.dev/fr/docs/integrations/mcp-clients/reference.md#connect)

### Essai d’agent

Pour un agent sans clé, consultez les conditions d’éligibilité actuelles avant l’inscription. Réutilisez un essai existant et son profil. YouTube Download et les tâches récurrentes nécessitent un accès propriétaire.

#### Consulter les possibilités sans s’inscrire

```bash
flashdata discover --profile research --json
```

- [Démarrer un essai et le rattacher au compte](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md)
- [Protocole d’authentification des agents](https://flashdata.dev/auth.md)


<a id="permissions"></a>

### Quelles sources cet accès autorise-t-il ?

Utilisez X-API-Key pour les requêtes HTTP ordinaires et les connexions MCP par clé API. Les jetons Bearer OAuth fonctionnent uniquement sur le point de terminaison MCP hébergé. YouTube Download nécessite une clé API propriétaire autorisant youtube_download et un stockage de destination.

| Identifiant | Sources disponibles |
| --- | --- |
| Clé API propriétaire | Les sources autorisées pour la clé, y compris youtube_download si cette permission a été accordée. |
| Clé API temporaire | Uniquement les sources autorisées et éligibles à l’essai. Lisez scopes dans la réponse d’identité actuelle. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


<a id="import-key"></a>

### Enregistrer une clé dans la CLI

Ignorez l’importation si la CLI dispose déjà d’un accès ou si votre gestionnaire de secrets fournit FLASHDATA_API_KEY. Sinon, choisissez une méthode ci-dessous et conservez le même profil research pour les commandes suivantes. Une clé enregistrée dans la CLI n’est pas automatiquement disponible dans les SDK ou les serveurs MCP locaux.

#### Terminal interactif

Collez la clé dans la saisie masquée du terminal.

##### Importer une seule fois

```bash
flashdata auth login --profile research
```


#### Automatisation · Bash

Définissez FLASHDATA_KEY_FILE avec le chemin d’un fichier de clé protégé existant. La commande le lit via stdin ; ne placez pas la clé dans la conversation ni dans les arguments de commande.

##### Lire un secret protégé via stdin

```bash
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
  < "$FLASHDATA_KEY_FILE"
```


- [Installer la CLI](https://flashdata.dev/fr/docs/guides/flashdata-cli/reference.md#install)

<a id="verify"></a>

## 2. Vérifier la connexion

Exécutez la vérification gratuite dans l’environnement qui effectuera la tâche. Les vérifications CLI et HTTP utilisent une clé API ; la vérification MCP utilise la connexion enregistrée par l’hôte.

### Bash / cURL

Nécessite Bash et cURL 7.76+. Ignorez la saisie masquée si votre environnement fournit déjà FLASHDATA_API_KEY. Exécutez les commandes de lecture dans le même terminal.

#### Définir la clé · ignorer si elle est déjà configurée

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```

#### Lire les données JSON du compte

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

Ignorez la saisie masquée si FLASHDATA_API_KEY est déjà définie. Exécutez les commandes de lecture dans le même terminal.

#### Définir la clé · ignorer si elle est déjà configurée

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```

#### Lire les données JSON du compte

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


### CLI

Utilisez le même utilisateur du système, le même profil et le même répertoire d’état que lors de la connexion. Remplacez research si vous utilisez un autre profil ; ajoutez --state-dir PATH si nécessaire. FLASHDATA_API_KEY est prioritaire sur la clé enregistrée. Vérifiez ok: true et data.accessVerified: true, puis les champs d’identité ci-dessous.

#### Consultations gratuites du compte

```bash
flashdata auth status --profile research --json --non-interactive
```

- [Configurer une clé](https://flashdata.dev/fr/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP

Envoyez cette consigne dans une nouvelle session de votre agent connecté. Remplacez google_search par la source nécessaire à la tâche. Les deux appels d’outils doivent réussir ; vérifiez les tarifs et le solde séparément avant tout traitement payant. La simple présence d’un serveur dans la liste ne vérifie pas l’accès.

#### Vérifier la connexion

```text
Utilise la connexion MCP flashdata existante.
Appelle get_pricing avec {"source":"google_search","request_count":1}.
Appelle get_balance avec {}.
Indique si les deux appels ont réussi, si un tarif est disponible pour la source
et quel est le solde de crédits disponible. Un solde nul n’est pas un échec d’authentification.
Ne lance aucune recherche ni aucun téléchargement, ne crée pas d’essai et ne modifie pas les identifiants.
```



<a id="identity-result"></a>

### Lire l’identité associée à la clé API

Dans la réponse HTTP, les champs d’identité se trouvent au premier niveau. Dans le JSON de la CLI, lisez data.identity.identity et vérifiez data.accessVerified: true. HTTP 200 ou ok: true dans la CLI ne suffit pas.

| Point à vérifier | Résultat requis |
| --- | --- |
| Compte prévu | accountId et apiKeyId identifient le compte et la clé que vous souhaitez utiliser. |
| Accès utilisable | access: ready |
| Autorisation pour la tâche | scopes contient la source, par exemple google_search. La CLI indique aussi les sources autorisées dans data.identity.permittedSources. |
| Tâche récurrente | accountType: owned · installed: true · recurringAllowed: true |

- [Automatiser ces vérifications avant la planification](https://flashdata.dev/fr/docs/guides/agent-access/reference.md#recurring-check)

<a id="trial-result"></a>

### Un essai actif constitue une connexion valide

Un essai peut réussir la vérification d’une tâche ponctuelle alors que recurringAllowed vaut false. Consultez les sources autorisées et l’expiration réelles ; rattachez l’essai existant avant de planifier des tâches.

#### Identité temporaire · champs illustratifs

```json
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}
```


<a id="codex"></a>

### Retrouver la connexion dans Codex

Listez les serveurs configurés, puis utilisez /mcp dans une nouvelle session Codex. Exécutez la vérification MCP ci-dessus pour confirmer la validité des identifiants.

#### Lister les serveurs

```bash
codex mcp list
```

- [Configuration de Codex et première tâche](https://flashdata.dev/fr/docs/integrations/codex/reference.md)

<a id="openclaw"></a>

### Vérifier la connexion dans OpenClaw

Testez le serveur enregistré, puis effectuez la vérification MCP ci-dessus dans votre conversation active.

#### Tester le serveur

```bash
openclaw mcp doctor flashdata --probe
```

- [Configuration d’OpenClaw et première tâche](https://flashdata.dev/fr/docs/integrations/openclaw/reference.md)

<a id="refresh"></a>

## 3. Réutiliser l’accès pour les prochaines tâches

Conservez les identifiants dans un stockage privé et persistant entre les redémarrages de processus. Vérifiez l’accès dans un nouveau processus avant d’activer votre planificateur.

| Identifiant | Pour la tâche suivante |
| --- | --- |
| Clé API propriétaire | Réutilisez la clé enregistrée. Elle n’a pas d’étape de renouvellement OAuth ; remplacez-la si elle expire ou est révoquée. |
| MCP OAuth | L’hôte renouvelle les jetons d’accès OAuth valables une heure à l’aide de jetons de renouvellement rotatifs. Reconnectez-vous lorsque l’autorisation de 90 jours expire ou est révoquée. Chaque installation possède son propre stockage de jetons ; ne partagez pas les fichiers de jetons de renouvellement entre hôtes. |
| Clé API temporaire | Terminez le rattachement au propriétaire et la transmission des identifiants avant les tâches récurrentes. Réutilisez le profil d’origine ; ne vous inscrivez pas à nouveau à chaque exécution. |

- [Parcours des tâches récurrentes](https://flashdata.dev/fr/docs/guides/recurring-tasks/reference.md)

<a id="recurring-check"></a>

### Vérifier une tâche CLI avant de la planifier

Nécessite Bash et jq. Définissez SOURCE avec la source utilisée par la tâche. Le script utilise research par défaut ; définissez FLASHDATA_PROFILE et FLASHDATA_STATE_DIR pour choisir un autre profil ou répertoire d’état. Le code de sortie 0, accompagné de l’identité JSON, indique que la clé propriétaire est prête, installée et autorisée pour cette source. Faites arrêter le planificateur pour tout autre code de sortie. Aucune requête de données n’est soumise.

#### Vérifier l’accès dans un nouveau processus · Bash

```bash
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
  args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi

flashdata auth status "${args[@]}" |
  jq -e --arg source "$SOURCE" '
    select(.ok == true and .data.accessVerified == true)
    | .data.identity as $auth
    | $auth.identity
    | select(.accountType == "owned" and .access == "ready"
        and .installed == true and .recurringAllowed == true
        and ((.scopes // []) | index($source) != null)
        and (($auth.permittedSources // []) | index($source) != null))
    | {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)
```

- [Ajouter les tarifs, le solde et l’exécution récurrente](https://flashdata.dev/fr/docs/guides/recurring-tasks/reference.md#prepare)

<a id="claim"></a>

### Si l’accès correspond encore à un essai

Suivez le guide d’essai et de rattachement avec le profil d’origine. Après l’approbation du propriétaire et la transmission des identifiants, la vérification gratuite doit indiquer un accès owned et recurringAllowed: true. Les requêtes suivantes utilisent le solde partagé du propriétaire ; les crédits d’essai inutilisés ne sont pas transférés. La connexion OAuth MCP est distincte et ne rattache pas cet essai.

- [Commandes d’essai et de rattachement](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

<a id="revoke"></a>

## Révoquer l’accès

Suspendez d’abord les tâches récurrentes. Révoquez l’identifiant correspondant ci-dessous, puis répétez la vérification gratuite dans un nouveau processus ou une nouvelle session avant d’effacer l’accès local. L’authentification doit échouer ou demander une reconnexion ; n’approuvez pas de nouvelle connexion pendant cette vérification. Une déconnexion locale ne révoque pas l’accès côté serveur.

| Connexion | Où révoquer l’accès |
| --- | --- |
| MCP OAuth | Settings → Connected apps → l’autorisation de l’application. |
| Clé API d’un agent rattaché au compte | Settings → Connected apps → Agent connections. |
| Clé API du compte | API Keys → la clé utilisée par cette intégration. |

- [Applications connectées](https://flashdata.dev/app/settings/connections)
- [Clés API](https://flashdata.dev/app/api-keys)
- [Résoudre les erreurs d’accès](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#credentials)

<a id="fixes"></a>

## Corriger une vérification échouée

| Résultat | Action |
| --- | --- |
| accessVerified: false | Lisez phase et nextCommand. Un profil en attente peut renvoyer ok: true avant que sa clé soit utilisable. Terminez l’inscription ou le rattachement enregistré en conservant le même profil. |
| access: blocked | Arrêtez même si la réponse HTTP est 200. Examinez le compte ou la connexion dans la console ; une réponse d’identité ne constitue pas, à elle seule, une autorisation de lancer une requête. |
| accountType: temporary | Utilisez l’essai éligible pour une tâche ponctuelle. Rattachez-le avant de planifier des tâches ; une nouvelle connexion OAuth ne rattache pas ce profil. |
| installed: false | Après l’approbation du propriétaire, exécutez flashdata auth finish --wait avec le profil et le répertoire d’état d’origine. Répétez ensuite la vérification. |
| 401 / invalid_grant | Reconnectez l’identifiant expiré ou révoqué dans son hôte d’origine. Ne créez pas un autre essai pour contourner cette situation. |
| 403 / source_forbidden | Vérifiez scopes pour la clé ou la liste des sources OAuth. YouTube Download utilise une clé API propriétaire. |
| Accès valide, solde nul | L’authentification a réussi. Consultez la facturation avant tout traitement payant ; ne remplacez pas une clé valide. |

- [Facturation](https://flashdata.dev/app/billing)
- [Rétablir une connexion interrompue](https://flashdata.dev/fr/docs/guides/agent-recovery/reference.md)
