Suivre un ordre d’analyse cohérent

  1. Dans Data Bridge, ouvrez Paramètres → Accès → Agents et sélectionnez l’Agent. Notez son état, l’heure de l’incident, la dernière cause de déconnexion et l’entrée de journal correspondante.
  2. Sur l’ordinateur de l’Agent, ouvrez les paramètres locaux et État. Vérifiez que le service fonctionne et que l’ordinateur n’est pas en veille.
  3. Ouvrez Diagnostic → Lancer le diagnostic. Résolvez la première défaillance significative sur le trajet vers Data Bridge.
  4. Après rétablissement du canal, sélectionnez Tester la connexion pour la ressource et Test sur la connexion Data Bridge.

Les diagnostics s’exécutent avec le compte de service. Ouvrir une API dans votre navigateur ne prouve pas que le service dispose du même proxy, des mêmes certificats ou des mêmes autorisations. Les vérifications standard ne modifient pas les données ; un test d’écriture dans un dossier nécessite une confirmation distincte.

États d’enregistrement et d’accès

  • En attente d’enregistrement. Saisissez la clé à usage unique localement. Sélectionnez Émettre une nouvelle clé si elle a été perdue, utilisée ou a expiré.
  • En attente d’approbation. Comparez les codes affichés localement et dans Data Bridge. Les opérations deviennent disponibles après approbation d’une correspondance exacte.
  • Actif, hors ligne. Vérifiez le service, l’alimentation et le réseau. Une autorisation active ne signifie pas à elle seule que l’Agent est connecté.
  • Désactivé. Un administrateur sélectionne Activer; aucune nouvelle clé n’est nécessaire.
  • Accès révoqué. Déterminez pourquoi l’accès a été révoqué, puis obtenez une nouvelle clé pour un enregistrement autorisé.
  • Accès expiré. Un administrateur prolonge la période d’accès dans Data Bridge.

AGENT_MACHINE_CHANGED signale une différence avec l’ordinateur enregistré. Pour un déplacement planifié, enregistrez le nouvel ordinateur avec une nouvelle clé ; ne copiez pas le répertoire d’état. Si aucun déplacement n’était prévu, examinez le journal et révoquez l’accès si nécessaire. Après un blocage temporaire des tentatives d’enregistrement, attendez 15 minutes et vérifiez que la clé est correcte.

Réseau, proxy et TLS

Les diagnostics vérifient les paramètres, le proxy, le DNS, TCP 443, TLS et la passerelle, l’horloge, l’enregistrement, le transport et le canal sécurisé. Suivez la recommandation à côté de la première étape en échec. Lorsque le proxy résout les noms d’hôtes externes, un avertissement DNS ne suffit pas à indiquer un échec.

Si TCP 443 est bloqué, autorisez l’accès sortant à Data Bridge ou configurez le proxy. Si les WebSockets sont bloqués, conservez le mode automatique ou sélectionnez manuellement les requêtes HTTPS. Pour un certificat non reconnu, ajoutez un certificat racine PEM approuvé et lisible par le service ; ne désactivez pas la vérification TLS. Si la passerelle est absente, vérifiez l’adresse de l’installation et le chemin agent/v1/ avec l’administrateur.

Examinez le proxy système Windows avec netsh winhttp show proxy, ou les paramètres de proxy macOS avec scutil --proxy. Synchronisez l’horloge dans les paramètres du système d’exploitation. Consultez le guide de configuration réseau pour les autres paramètres. Sous Linux, vérifiez les paramètres de proxy accessibles au service Agent lui-même ; voir la préparation du réseau.

Une ressource est inaccessible

AGENT_POLICY_DENIED signifie que l’hôte, le port ou le dossier ne correspond pas à une ressource autorisée. Comparez les valeurs exactes de la connexion à la politique locale. AGENT_RIGHTS_DENIED identifie une méthode API ou une opération sur fichier interdite ; vérifiez également les autorisations de dossier dans la connexion Data Bridge.

Pour AGENT_DNS_FAILED, vérifiez la résolution des noms sur l’ordinateur de l’Agent. AGENT_CONNECT_REFUSED signifie souvent que le service cible n’écoute pas sur ce port. Pour AGENT_CONNECT_TIMEOUT ou AGENT_UNREACHABLE, vérifiez le routage et les règles de pare-feu. AGENT_TLS_CERTIFICATE concerne la confiance accordée au certificat de la ressource, et non les droits du compte de base de données.

AGENT_ACCESS_DENIED est un refus du système d’exploitation. Accordez les autorisations au compte de service lui-même. Pour les chemins UNC, vérifiez l’accès au partage et les droits NTFS ; sous macOS, vérifiez les montages système et les autorisations de confidentialité requises. Suivez les instructions spécifiques Windows ou macOS . Sous Linux, vérifiez aussi les droits du compte de service, les montages réseau et les règles SELinux ou AppArmor selon le guide d’accès aux ressources.

Erreurs de fichiers et nouvelles tentatives sûres

Pour AGENT_PATH_OUTSIDE, utilisez un chemin situé dans le dossier autorisé, sans remontée de répertoires ni liens externes. Pour AGENT_NOT_FOUND, vérifiez le chemin et les masques. AGENT_CHANGED signale une modification simultanée du fichier ; réessayez une fois cette modification terminée. Avec AGENT_INTEGRITY_FAILED, le fichier n’a pas été écrit, car sa taille ou son empreinte SHA-256 ne correspondait pas ; examinez la stabilité du transfert.

Pour WRITE_OUTCOME_UNKNOWN, examinez d’abord le dossier de destination. Le canal s’est déconnecté après l’envoi des données ; l’écriture a donc peut-être abouti. Ne la répétez pas automatiquement avant d’avoir vérifié le résultat. Pour AGENT_TOO_LARGE, AGENT_DISK_FULL et AGENT_BUSY, vérifiez respectivement les limites, l’espace de stockage disponible et la charge. Évaluez la capacité avant d’augmenter les limites.

Échecs d’installation et de mise à jour

En cas d’échec d’installation, lisez le journal d’installation et corrigez le prérequis système indiqué. Obtenez à nouveau un paquet endommagé auprès de l’administrateur et vérifiez son SHA-256. Si l’installation a réussi mais pas l’enregistrement, terminez l’enregistrement dans l’onglet local Connexion .

Sous Version et mises à jour, examinez le résultat : réussite, échec, retour à la version précédente ou rejet. N’installez pas un paquet dont la signature n’est pas reconnue ; contactez le fournisseur. Après un retour à la version précédente, consultez agent.log, corrigez la cause et relancez la mise à jour. AGENT_OPERATION_UNKNOWN peut nécessiter une mise à jour de l’Agent ; AGENT_HUB_UNAVAILABLE nécessite une nouvelle vérification après le rétablissement de la passerelle.

Préparer un rapport utile pour l’assistance

Copiez le rapport de diagnostic, les 200 dernières lignes de agent.log et la période concernée dans audit.log. Indiquez le nom de l’Agent, les versions de l’Agent et du système d’exploitation, l’heure de l’incident et l’identifiant d’exécution s’il est connu. Les journaux Windows se trouvent dans C:\ProgramData\UBC Data Bridge Agent\logs\; les journaux macOS se trouvent dans /Library/Logs/UBC Data Bridge Agent/. Sous Linux, l’emplacement du journal dépend du paquet installé. Confirmez-le avec l’administrateur et consultez le guide de maintenance.

Examinez les noms de fichiers, d’utilisateurs et de systèmes internes avant de partager les journaux. N’envoyez jamais la clé d’enregistrement, les fichiers state ou secrets.json. Après avoir corrigé le problème, répétez les diagnostics, le test de ressource et une exécution contrôlée, puis confirmez que l’opération a produit le résultat attendu.