Rôle de l’Agent
UBC Data Bridge Agent est un service qui relie UBC Data Bridge 2.1.1 aux ressources de votre réseau privé. Il s’exécute sur un ordinateur Windows, macOS ou Linux capable d’accéder aux dossiers, bases de données et API nécessaires. Un flux Data Bridge peut alors lire un fichier Excel local, se connecter à une base interne ou appeler une API d’entreprise par une route explicitement autorisée.
L’Agent effectue des opérations définies de connexion et d’échange de données. Il ne fournit pas d’invite de commande distante sans restriction. L’accès dépend de trois niveaux distincts : les ressources autorisées localement, les droits du compte de service dans le système d’exploitation et les identifiants acceptés par le système cible.
Fonctionnement de la connexion
L’Agent ouvre une connexion sortante TCP 443 vers votre installation Data Bridge via UBC Secure Access Gateway. Cette route ne nécessite ni port entrant ni base locale exposée sur Internet. Un WebSocket sécurisé est le transport privilégié ; le mode automatique utilise de longues requêtes HTTPS si le réseau n’autorise pas les WebSockets.
HTTPS protège le transport extérieur, tandis qu’un canal interne TLS 1.3 utilise une authentification mutuelle par certificat. La clé privée est générée sur l’ordinateur de l’Agent et y reste. L’environnement d’entreprise peut configurer un proxy et un certificat racine de confiance supplémentaire. Les règles réseau doivent aussi autoriser l’ordinateur de l’Agent à atteindre les ressources internes nécessaires.
Préparer l’ordinateur et les autorisations
- Choisissez un ordinateur qui reste allumé, conserve une heure exacte et peut atteindre les ressources requises. Désignez un administrateur et prévoyez des fenêtres de maintenance.
- Confirmez l’adresse HTTPS de l’installation Data Bridge, les règles sortantes TCP 443, les paramètres du proxy d’entreprise et les éventuelles exigences supplémentaires de certificats.
- Listez les ressources minimales : adresses et ports précis des bases, URL de base des API, dossiers et opérations autorisées sur les fichiers.
- Obtenez l’installateur adapté à votre système et sa somme de contrôle SHA-256 auprès de l’administrateur Data Bridge. Vérifiez son origine et son intégrité avant l’installation.
- Suivez le guide d’installation Windows ou macOS ou Linux. L’installation et la configuration du service local nécessitent des droits d’administrateur sur cet ordinateur.
Créer et approuver l’Agent
Dans Data Bridge, ouvrez Paramètres → Accès → Agents, créez un agent et définissez sa durée d’accès. Générez une clé d’enregistrement à usage unique. Transmettez-la à l’administrateur de l’ordinateur par un canal sécurisé approuvé. Ne l’incluez pas dans des messages largement accessibles, des captures d’écran ou des exemples de commandes.
Dans la fenêtre locale des paramètres, ouvrez Connexion, collez la clé dans son champ dédié et sélectionnez Enregistrer l’agent. La clé identifie l’environnement approprié ; aucun identifiant d’organisation ne doit être saisi manuellement. Chaque clé enregistre un ordinateur.
Si l’approbation est activée, comparez le code de la fenêtre locale à celui de Data Bridge : Approuver… → Les codes correspondent — approuver. S’ils diffèrent, révoquez l’accès et recherchez où la clé a été utilisée. Un agent en attente d’approbation peut établir son canal, mais ne peut pas effectuer d’opération sur les ressources.
L’expiration de la clé d’enregistrement et celle de l’accès de l’Agent sont des paramètres distincts. Les clés durent 24 heures par défaut ; les autres choix sont 1 ou 8 heures, ou 3 ou 7 jours. Choisissez la durée pratique la plus courte. Après l’enregistrement, la durée d’accès propre à l’Agent détermine la poursuite de l’accès.
Créer la première connexion opérationnelle
Dans l’onglet local Ressources , ajoutez l’hôte, l’API ou le dossier nécessaire. Enregistrez la règle et sélectionnez Tester la connexion. Ce contrôle s’exécute sous le compte de service : il représente donc l’accès du flux plus fidèlement que l’ouverture de la même ressource dans votre session personnelle.
Dans Data Bridge, ouvrez les paramètres de la connexion concernée et choisissez Mode de connexion → Via un agent, puis sélectionnez l’agent. Pour les fichiers, utilisez Dossier local (via UBC Agent). Sélectionnez Test, puis exécutez un flux contrôlé avec les données de test convenues. L’administrateur de l’ordinateur modifie la liste locale des ressources ; Data Bridge en affiche une copie en lecture seule.
Vérifier la route prise en charge
La route via l’Agent prend en charge les connexions HTTP et TCP compatibles ainsi que les dossiers locaux. Exemples : API REST interne, PostgreSQL, Microsoft SQL Server et IBM Planning Analytics avec une méthode d’authentification compatible. Chaque connexion conserve ses propres exigences d’identifiants et de certificats.
Ne prévoyez pas de connexion ODBC ou FTP/FTPS via l’Agent. Utilisez un connecteur de base dédié ou un dossier autorisé pour les échanges de fichiers. Les connexions IBM Planning Analytics utilisant l’authentification d’entreprise Cognos Gateway ou une session utilisateur emploient la route directe. Consultez les ressources et le réseau pour les détails de configuration.
Gérer les accès pendant l’exploitation
Utilisez Désactiver pour suspendre temporairement l’accès. Activer le rétablit sans nouvelle clé d’enregistrement. Révoquer l’accès invalide les certificats et clés inutilisées ; un nouvel enregistrement nécessite alors une nouvelle clé.
Pour déplacer un agent, installez-le sur le nouvel ordinateur, configurez les ressources et enregistrez-le avec Émettre une nouvelle clé. Une fois le nouvel enregistrement terminé, les anciens certificats cessent de fonctionner. Ne copiez pas le répertoire d’état : l’enregistrement est lié à l’ordinateur. Consultez régulièrement les journaux, l’expiration des accès et l’historique des mises à jour. Utilisez le guide de dépannage en cas d’échec d’un contrôle.