Un connecteur ne fonctionne pas

1. Lire le résultat du test

Sur la page de configuration du connecteur, ⚡ Tester vérifie la connexion sans rien synchroniser. Pendant le test, le bouton affiche « Test en cours… » ; le résultat s'affiche ensuite dans le panneau du haut : « Dernier test : — réussi » ou « — en échec », avec le message.

Message	Cause habituelle	Que faire
`Name or service not known`, `getaddrinfo failed`, `ConnectionError`	Nom d'hôte faux, DNS, ou pas de route vers le système	Vérifiez l'URL (avec `https://`), puis depuis le serveur : `curl -sv <url>`.
`Connection refused`, `timed out`	Pare-feu, mauvais port, ou système arrêté	Vérifiez les Flux réseau et le port.
Échec seulement vers Internet	Le proxy de l'entreprise n'est pas réglé	Administration → Proxy sortant : renseignez `HTTPS_PROXY` et testez avec URL de test. Mettez les systèmes internes dans `NO_PROXY`. Voir Proxy sortant.
« Erreur TLS », `certificate verify failed`	Certificat signé par une autorité interne, ou inspection TLS du proxy	Renseignez le champ Certificat CA du connecteur s'il en a un, sinon ajoutez l'autorité au magasin du système (`/etc/pki/ca-trust/source/anchors/`, puis `update-ca-trust`) et redémarrez `infrariver`.
`401 Unauthorized`, « Accès refusé »	Identifiants faux, compte verrouillé ou expiré	Vérifiez le compte de service dans le système cible.
`403 Forbidden`	Compte authentifié, mais sans droit de lecture	Donnez au compte les droits de lecture décrits sur la page du connecteur (par exemple ServiceNow).
« URL non configurée — renseignez-la et enregistrez avant de tester »	Le connecteur n'est pas encore réglé	Renseignez les champs, Enregistrez, puis testez.
« L'adresse ou le mode de connexion a été modifié : saisissez à nouveau … »	Vous avez changé l'adresse (ou coupé le TLS) sans ressaisir le mot de passe, le jeton ou la clé	Ressaisissez le secret dans le formulaire : un secret enregistré n'est jamais envoyé vers une autre adresse que celle enregistrée.
« Adresse refusée : … adresse locale ou réservée »	L'adresse saisie est une adresse de bouclage (`127.0.0.1`, `localhost`), locale au lien (`169.254.x.x`) ou utilise un autre schéma que `http`/`https`	Corrigez l'adresse. Pour une adresse locale voulue, enregistrez d'abord la configuration, puis testez : l'adresse enregistrée est toujours acceptée.

Droit requis

Le bouton ⚡ Tester demande le droit de gérer les connecteurs (plugins.manage), comme Enregistrer et Synchroniser : le droit de lecture seul ne suffit plus. Le panneau « Dernier test » ne montre que le code de retour et la première ligne de la réponse du système distant, jamais son contenu complet.

Seuls les champs de la méthode choisie comptent

Pour les connecteurs qui proposent plusieurs méthodes d'authentification (certificat ou secret client, utilisateur ou clé API…), seuls les champs de la méthode sélectionnée sont affichés et utilisés.

2. Le test réussit, mais la synchronisation ne ramène rien

La synchronisation automatique est-elle cochée ? Décochée, la collecte planifiée s'arrête et la synchronisation manuelle est refusée ; les données déjà importées restent affichées.
Quand a-t-elle tourné ? Administration → Scheduler montre les tâches et leur dernier passage.
Que dit son journal ? Sur la page du connecteur, voir le log affiche les 400 dernières lignes ; Journal complet permet de choisir une synchronisation précise et de ne garder que les erreurs et avertissements. Le fichier est /var/log/infrariver/sync_<connecteur>.log :
```
grep -E "\[ERROR\]|\[WARNING\]" /var/log/infrariver/sync_<connecteur>.log | tail -50
```
La page Journal complet n'affiche jamais plus de 20 000 lignes ; Télécharger le fichier complet donne le fichier entier sans le charger dans le navigateur.
Les droits du compte sont-ils complets ? Les analyses (Azure, AWS, Active Directory…) affichent un cadre « Ce que cette analyse ne regarde pas (encore) » : ce qui n'a pas pu être lu y est listé, avec la raison. Une lecture refusée ne retire jamais ce qui était déjà connu.

3. Une synchronisation est très longue

Regardez dans le journal l'étape qui dure (les lignes sont horodatées).
Les gros volumes (annuaire de plusieurs dizaines de milliers d'objets, base CVE complète, abonnements cloud nombreux) demandent plus de temps à la première synchronisation ; les suivantes sont incrémentales quand le connecteur le permet.
Si les pages ralentissent pendant ce temps : Lenteurs et erreurs 504.

Une page a disparu

Une entrée de menu absente, ou une page qui affiche « Module désactivé », veut dire que le module a été désactivé par un administrateur (interrupteur Module activé). Aucune donnée n'a été supprimée : un administrateur le réactive depuis la page de configuration du module ou Administration → Réglages des modules. Chaque changement est au journal d'audit. Voir Activer ou désactiver un module.

Cas particuliers

Connecteur	Situation	Ce qui se passe
EOLRIVER	endoflife.date injoignable (pas d'accès Internet, proxy refusé)	La synchronisation utilise le référentiel embarqué livré avec le paquet, sans échec, et la page l'indique. Voir EOLRIVER.
CVE River	Synchronisation NVD lente	Une clé API NVD (`NVD_API_KEY` dans `server.conf`) accélère le rythme autorisé par la NVD. Voir CveRiver.
Entra ID, Microsoft 365	Onglets vides, règles « non calculables »	Profil de permissions Graph non accordé (par exemple Intune), ou licence du tenant insuffisante (Entra ID P1 ou P2 pour les dernières connexions et les méthodes d'authentification) : un bandeau le dit sur la page. Voir Entra ID.