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

Cette documentation concerne les déploiements fédéraux de Devin. Retour à la documentation Devin

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 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
`MDL`	Validation du fichier de modèles	Fichier de modèles
`IDP`	SSO et fournisseur d’identité	SSO
`NET`	Accessibilité des endpoints, TLS, tests HTTP	Réseau et certificats
`CFG`	Chemins locaux, configuration, environnement	Réseau et certificats, Fichier de modèles

`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`. 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.
`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`, 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.
`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.
`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.
`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.
`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 :

devin models validate

/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.

​LIC Licence

​Fichier de modèles MDL

​IDP SSO et fournisseur d’identité

​NET Réseau

​Configuration CFG

​Interpréter un échec

`LIC` Licence

Fichier de modèles `MDL`

`IDP` SSO et fournisseur d’identité

`NET` Réseau

Configuration `CFG`

Interpréter un échec