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

# Dépannage : authentification et clés API

> Identifiez le contrôle à l’origine d’une réponse 401, 403 ou 422 et corrigez la clé, le mode ou la liste d’adresses IP.

# Dépannage : authentification et clés API

Chaque requête Orbit passe par les contrôles des identifiants, de l’expiration et de la révocation, du mode sandbox/live, de la liste IP, puis des permissions. Lisez `code` : plusieurs contrôles peuvent partager le même statut HTTP.

| Code | HTTP | Contrôle déclenché |
| - | - | - |
| `UNAUTHORIZED` | 401 | Aucun identifiant utilisable |
| `INVALID_API_KEY` | 401 | Clé inconnue, révoquée ou source IP non autorisée |
| `EXPIRED_TOKEN` | 401 | Clé expirée ou révocation planifiée arrivée |
| `WRONG_KEY_MODE` | 403 | Mode de la clé différent de celui de l’espace de travail |
| `IP_NOT_ALLOWED` | 403 | La liste IP de l’organisation bloque la source |
| `INSUFFICIENT_PERMISSIONS` | 403 | Le rôle ou le scope n’autorise pas la route |
| Écriture avec une clé publique | 422 | La clé `dv_..._pk_` est en lecture seule |
| `STALE_WEBHOOK` | 401 | Horodatage du webhook absent ou trop ancien |

## Erreurs 401

Pour `UNAUTHORIZED`, vérifiez l’en-tête `X-API-Key` et envoyez la clé complète. `INVALID_API_KEY` signale une clé inconnue, révoquée ou bloquée par sa liste IP. Recopiez-la depuis **Settings → API Keys** ou créez-en une nouvelle. `EXPIRED_TOKEN` signifie que l’expiration ou `revoke_at` est passée : faites tourner la clé.

## Sandbox et live

Une clé `dv_test_sk_` s’utilise en sandbox et une clé `dv_live_sk_` en live. Une combinaison incorrecte renvoie `403 WRONG_KEY_MODE` avant l’exécution du handler. Créez la clé dans l’organisation appelée.

## Listes IP

Une IP refusée par la clé renvoie volontairement `401 INVALID_API_KEY`. La liste de l’organisation renvoie `403 IP_NOT_ALLOWED`. Vérifiez l’IP publique de sortie visible par Orbit, puis ajoutez-la ou ajoutez son bloc CIDR dans la configuration de sécurité.

## Clés publiques et SAML/SCIM

Les clés publiques sont en lecture seule. Utilisez une clé secrète sur votre backend pour les écritures comme `messages:write`. Avec SAML, l’utilisateur doit appartenir à l’organisation ; SCIM ne peut pas dépasser la limite de rôle configurée.

Ne transmettez jamais le secret au support. Fournissez le code, le `request_id` et le préfixe de la clé uniquement.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.