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

# Référence des codes d’erreur de Devin en air gap

> Catalogue complet des codes d’erreur LIC, MDL, IDP, NET et CFG affichés par Devin CLI et Desktop en air gap, avec la signification de chacun et l’action à mener par l’administrateur.

> [!NOTE]
>
> Cette documentation concerne les déploiements fédéraux de Devin. [Retour à la documentation Devin](/fr/get-started/devin-intro)

Chaque échec que le CLI et Desktop en air gap sont en mesure de diagnostiquer est signalé par un code stable au format `XXXnnn`. Ces codes apparaissent au début du message d’erreur dans le terminal, dans la sortie de `devin airgap doctor`, dans les données de diagnostic de Desktop et dans le champ `error_code` des [événements d’audit](/fr/federal/air-gapped/on-disk-formats#auth) `auth`. Le numéro identifie la condition, et non le libellé du message : vous pouvez donc vous appuyer dessus pour indexer vos guides d’exploitation de support et vos alertes SIEM.

| Espace de noms | Périmètre | Page détaillée |
| - | - | - |
| `LIC` | Validation du fichier de licence | [Licence](/fr/federal/air-gapped/license) |
| `MDL` | Validation du fichier de modèles | [Fichier de modèles](/fr/federal/air-gapped/models-file) |
| `IDP` | SSO et fournisseur d’identité | [SSO](/fr/federal/air-gapped/sso) |
| `NET` | Accessibilité des endpoints, TLS, tests HTTP | [Réseau et certificats](/fr/federal/air-gapped/network-and-certificates) |
| `CFG` | Chemins locaux, configuration, environnement | [Réseau et certificats](/fr/federal/air-gapped/network-and-certificates), [Fichier de modèles](/fr/federal/air-gapped/models-file) |

## `LIC` Licence

Affiché sous la forme `LIC00n: <message>`, suivi du chemin vérifié et de la manière de le remplacer (`DEVIN_LICENSE_FILE`).

| Code | Signification | Que faire |
| - | - | - |
| `LIC001` | Fichier de licence manquant ou illisible à l'emplacement `/etc/devin/license.devin-onprem-license` (`C:\ProgramData\Devin\license.devin-onprem-license` sous Windows), ou au chemin `DEVIN_LICENSE_FILE`. Sous Windows, également renvoyé lorsqu'un utilisateur standard tente de remplacer depuis Desktop une licence appartenant à un administrateur. | Installez le fichier au chemin par défaut ou définissez `DEVIN_LICENSE_FILE` ; vérifiez que l'utilisateur qui exécute Devin dispose de l'autorisation de lecture. |
| `LIC002` | Fichier mal formé : JWT EdDSA non valide, ou absence de `kid` dans l'en-tête. | Téléchargez à nouveau la licence depuis le portail ; transférez-la octet par octet (sans saut de ligne ajouté, retour à la ligne automatique ni changement d'encodage). |
| `LIC003` | Échec de la vérification de la signature. | La charge utile a été modifiée après la signature. Téléchargez à nouveau la licence. |
| `LIC004` | `kid` inconnu : aucune clé publique correspondante n'est intégrée à ce build. | Effectuez la [vérification du `kid`](/fr/federal/air-gapped/license#check-the-key-id). La licence a été émise par un autre environnement, ou votre build est antérieur à une rotation de clé ; installez la version actuelle. |
| `LIC005` | Licence expirée depuis plus de 24 heures (période de grâce dépassée). | Renouvelez la licence via le portail. |
| `LIC006` | Pas encore valide : date d'émission située plus de 24 heures dans le futur. | Vérifiez l'horloge de l'hôte ; si elle est correcte, contactez votre équipe d'assistance. |
| `LIC007` | Claim `product` incorrect (différent de `devin-onprem`). | Le fichier n'est pas une licence Devin en air gap. Téléchargez-le à nouveau depuis le portail. |

## Fichier de modèles `MDL`

Signalés par `devin models validate`, `devin airgap doctor`, les paramètres de modèles de Desktop, ainsi qu’au démarrage de l’agent. Chaque diagnostic indique l’entrée de modèle concernée.

| Code | Signification | Action à effectuer |
| - | - | - |
| `MDL001` | Le fichier n’est pas un JSON valide pour le schéma v0, notamment en raison de champs inconnus. | Corrigez le JSON ; supprimez les champs absents du [schéma](/fr/federal/air-gapped/models-file#schema-reference-version-0). |
| `MDL002` | `schema_version` non pris en charge. | Définissez `"schema_version": 0`. |
| `MDL003` | `models` est vide. | Ajoutez au moins une entrée de modèle. |
| `MDL004` | Un modèle a un `name` vide. | Attribuez un `name` unique à chaque entrée. |
| `MDL005` | `name` de modèle en double. | Renommez l’une des entrées. |
| `MDL006` | `base_url` vide. | Définissez l’URL de l’endpoint. |
| `MDL007` | `api_key.env` vide. | Indiquez le nom de la variable d’environnement qui contient la clé. |
| `MDL008` | `max_context_tokens` vaut zéro. | Définissez la fenêtre de contexte du modèle. |
| `MDL009` | Plusieurs modèles sont marqués `default`. | Ne laissez `default: true` que sur une seule entrée. |
| `MDL010` | `base_url` n’est pas une URL `https://` avec un hôte (`http://` n’est accepté que pour les adresses de bouclage). | Utilisez `https://`, ou une adresse de bouclage pour un serveur situé sur le même hôte. |
| `MDL011` | `max_output_tokens` dépasse `max_context_tokens`. | Réduisez `max_output_tokens`. |
| `MDL012` | Le fichier existe, mais n’a pas pu être lu (autorisations insuffisantes ou UTF-8 invalide). | Accordez l’autorisation de lecture à l’utilisateur qui exécute Devin ; enregistrez le fichier en UTF-8. |
| `MDL013` | `max_output_tokens` vaut zéro. | Supprimez le champ ou définissez une valeur positive. |
| `MDL014` | Le fichier appartient à un autre utilisateur ; Desktop refuse donc de le remplacer. | Modifiez le fichier sur le disque en tant que propriétaire, ou faites pointer `DEVIN_MODELS_FILE` vers un fichier qui vous appartient. |

## `IDP` SSO et fournisseur d’identité

Signalés par `devin auth login` et `devin auth status`, au démarrage de l’agent et lors du processus de connexion de Desktop. `IDP004` et `IDP005` sont également consignés dans le journal d’audit lors des événements `sso_login_denied`, et tout code `IDP` peut apparaître lors d’un événement `sso_revalidation_failed`.

| Code | Signification | Que faire |
| - | - | - |
| `IDP001` | Le fichier d’authentification est illisible ou invalide. | Corrigez `/etc/devin/auth.json` (`C:\ProgramData\Devin\auth.json` sous Windows) ou le fichier situé au chemin indiqué par `DEVIN_AUTH_FILE`ﾠ; le message précise le champ en cause. |
| `IDP002` | Aucune connexion en cache pour l’émetteur configuré. | Exécutez `devin auth login`. |
| `IDP003` | La connexion est invalide ou a expiré, et n’a pas pu être actualisée de manière transparente (y compris en cas de réponse `invalid_grant` de l’IdP). | Exécutez à nouveau `devin auth login`. |
| `IDP004` | L’utilisateur est connecté, mais n’est pas membre de `required_group`. | Ajoutez l’utilisateur au groupe dans l’IdP, ou corrigez `required_group` / `groups_claim` dans le fichier d’authentification. |
| `IDP005` | L’IdP est injoignable, a renvoyé une erreur ou a renvoyé un token d’ID dont la validation a échoué. | Vérifiez l’accessibilité réseau, la confiance TLS (`DEVIN_CA_BUNDLE`), la valeur `issuer` et les logs de l’IdP. |
| `IDP006` | Le cache local des tokens SSO est illisible, mal formé ou n’est pas réservé à l’utilisateur actuel. | Exécutez `devin auth login`ﾠ; une nouvelle connexion réécrit le cache avec des autorisations limitées au propriétaire. |

## `NET` Réseau

Signalés par les sondes d’endpoint de `devin airgap doctor` ainsi que par les requêtes d’inférence et vers l’IdP. Chaque échec `NET` inclut la chaîne d’erreurs sous-jacente.

| Code | Signification | Que faire |
| - | - | - |
| `NET001` | La résolution DNS de l’hôte de l’endpoint a échoué. | Vérifiez le hostname dans le fichier des modèles ou le fichier d’authentification, ainsi que la configuration DNS du poste de travail. |
| `NET002` | Impossible d’établir la connexion TCP (connexion refusée, réinitialisée ou hôte non routable). | Vérifiez que l’endpoint écoute bien sur le port et que les règles du pare-feu ou du proxy autorisent le poste de travail à le joindre. |
| `NET003` | Échec de la négociation TLS : certificat non approuvé, expiré ou ne correspondant pas. `devin airgap doctor` affiche, lorsque c’est possible, le certificat présenté par le serveur (sujet, émetteur, expiration) et indique si `DEVIN_CA_BUNDLE` était pris en compte. | Ajoutez l’autorité de certification privée aux autorités de confiance avec [`DEVIN_CA_BUNDLE`](/fr/federal/air-gapped/network-and-certificates#trust-a-private-ca-with-devin_ca_bundle), ou corrigez le certificat du serveur (nom, chaîne, expiration). |
| `NET004` | L’endpoint a renvoyé un statut HTTP d’échec autre que 401/403. Un `404` sur `GET {base_url}/models` est signalé comme un simple avertissement, car certains serveurs compatibles OpenAI n’implémentent pas `/models`. | Consultez les log de l’endpoint lui-même et vérifiez le chemin `base_url` (par exemple, un `/v1` manquant). |
| `NET005` | La requête a dépassé le délai d’expiration (10 s pour les sondes doctor, 30 s pour les requêtes vers l’IdP, 30 s de connexion / 300 s de lecture pour l’inférence). | Vérifiez la charge de l’endpoint et de tout proxy intermédiaire ; consultez la section [délais d’expiration](/fr/federal/air-gapped/network-and-certificates#timeouts). |
| `NET006` | L’endpoint a rejeté les credentials configurés (HTTP 401/403). | Vérifiez la valeur de la variable `api_key.env` ainsi que la validité de la clé pour l’endpoint. |

## Configuration `CFG`

Signalé par `devin airgap doctor` et au démarrage.

| Code | Signification | Que faire |
| - | - | - |
| `CFG001` | Un répertoire de configuration ou un répertoire d’état requis est manquant ou non accessible en écriture (`~/.config/devin`, `~/.local/share/devin` ou le répertoire produit `cli-federal` ; sous Windows, `%APPDATA%\devin` ou son sous-répertoire `cli-federal`). | Créez le répertoire ou corrigez son propriétaire et ses autorisations pour l’utilisateur qui exécute Devin. |
| `CFG002` | Une variable d’environnement référencée par la configuration (le `api_key.env` d’un modèle) n’est pas définie dans l’environnement de l’agent. | Exportez la variable ou définissez-la via le paramètre `devin.acp.agentEnv` de Desktop ; consultez [Variables d’environnement de clé d’API](/fr/federal/air-gapped/models-file#api-key-environment-variables). |
| `CFG003` | Le fichier de modèles est introuvable à l’emplacement `/etc/devin/models.json` (`C:\ProgramData\Devin\models.json` sous Windows) ou à l’emplacement défini par la dérogation `DEVIN_MODELS_FILE`. | Installez le fichier de modèles ; consultez [Fichier de modèles](/fr/federal/air-gapped/models-file). |
| `CFG004` | Le fichier `DEVIN_CA_BUNDLE` est manquant, illisible ou ne contient aucun certificat PEM valide. | Corrigez le chemin ou le contenu du fichier ; consultez [Réseau et certificats](/fr/federal/air-gapped/network-and-certificates). |
| `CFG005` | Une définition de sous-agent personnalisé (`agents/**/AGENT.md` ou un fichier plat `agents/<name>.md`) n’a pas pu être analysée, le plus souvent en raison d’un frontmatter YAML invalide ; le profil est ignoré. Également signalé sous forme d’avertissement lorsqu’une définition déclare des clés de frontmatter que Devin ne lit pas (par exemple `allowed_tools` au lieu de `allowed-tools`) ; le profil est tout de même chargé. | Corrigez le fichier indiqué ainsi que l’erreur d’analyse affichée par `devin doctor`. |
| `CFG006` | Une variable d’environnement `OTEL_EXPORTER_OTLP_*` est définie, mais l’export OTLP l’ignore (tout champ autre que `ENDPOINT`, `HEADERS`, `TIMEOUT`, `PROTOCOL` ; toute variable `TRACES_` ; ou un `PROTOCOL` non pris en charge). Il s’agit d’un avertissement ; le nom de la variable est affiché, jamais sa valeur. | Supprimez ou corrigez la variable. |

`CFG005` et `CFG006` proviennent des vérifications standard de `devin doctor` et ne sont pas propres au build en air gap.

## Interpréter un échec

Voici un exemple typique d'échec de validation :

```sh theme={null}
devin models validate
```

```text theme={null}
/etc/devin/models.json: 1 problem(s) found
  MDL010 [model 'qwen3-vl-32b']: model 'qwen3-vl-32b': `base_url` must be an https:// URL (plain http:// is only allowed for loopback addresses: localhost, 127.0.0.0/8, or [::1])
```

Repérez le code dans les tableaux ci-dessus, appliquez l'action correspondante, puis relancez `devin airgap doctor` jusqu'à ce que toutes les vérifications réussissent. Si un code ne figure pas ici, c'est que votre build est plus récent que cette page ; exécutez `devin --version` et joignez le message complet à votre requête d'assistance, comme indiqué dans la section [Dépannage](/fr/federal/air-gapped/troubleshooting).


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