Intégration de l’agent hybride

En un coup d'œil

Connectez votre espace de travail Altium 365 à un système PLM sur site sans l’exposer à Internet ni ouvrir de ports pour le trafic entrant. Cet article explique comment l’agent hybride relaie les informations via des connexions HTTPS sortantes et vous guide à travers les prérequis, l’installation et la configuration, y compris l’exécution de l’agent en tant que service Windows. Poursuivez votre lecture pour passer à l’étape suivante de la mise en place de votre intégration PLM hybride.

- Découvrez les prérequis de l’agent hybride en matière de licence, de Java et de réseau.
- Apprenez à générer une clé API, à démarrer l’agent et à configurer la connexion PLM dans votre espace de travail.
- Consultez les instructions pour exécuter l’agent en tant que service Windows et le mettre à jour afin qu’il utilise une nouvelle clé API.
Approfondissez avec l'IA :

L’intégration hybride s’applique lorsqu’une entreprise utilisant Altium 365 souhaite intégrer son espace de travail à un système PLM hébergé sur site, au sein de son réseau, qui ne dispose pas d’adresse IP publique et n’est donc pas exposé à Internet.

Pour ce faire, un petit programme appelé Hybrid Agent est exécuté au sein du réseau de l’entreprise. Ce programme communique avec Altium 365 et relaie les informations entre l’espace de travail Altium 365 et le système PLM au sein du réseau fermé. La communication avec l’agent hybride s’effectue via HTTPS et ne nécessite l’ouverture d’aucun port réseau pour le trafic entrant depuis Internet. Le port HTTPS standard 443 n’est requis que pour le trafic sortant.

Note:

Configurer l’intégration hybride

Téléchargez l’archive de l’agent () et décompressez son contenu dans un emplacement connu. Elle contient une application Java (hybrid-agent.jar) qui doit être exécutée sur une machine du réseau de l’entreprise depuis laquelle le système PLM sur site et Altium 365 sont accessibles.

Cette machine n’a not besoin d’être accessible publiquement depuis Internet, mais elle doit pouvoir se connecter à l’environnement Altium 365 utilisé par votre entreprise.

  • Notez qu’il n’est not nécessaire d’exécuter l’agent hybride sur la machine qui héberge le système PLM, bien qu’une telle configuration ne devrait pas poser de problème.
  • L’application de l’agent hybride inclut des fichiers de script shell équivalents (tels que agent.sh) pour les systèmes Linux : utilisez-les à la place des fichiers Windows *.bat dans les instructions de configuration de l’agent ci-dessous.

Les versions 5 et antérieures de l’agent hybride nécessitent Java Development Kit (JDK) version 11 ou ultérieure. À partir de la version 6 (publiée le 6 juillet 2026), l’agent hybride nécessite le JDK version 17 ou ultérieure.

Les espaces de travail Altium 365 prennent en charge les versions 5 et 6 de l’agent hybride. Par conséquent, si la version 5 de l’agent hybride est déjà installée, il n’est pas nécessaire de passer à la version 6.

Une fois l’application de l’agent hybride en place :

  1. Générez la clé API sur la page Hybrid Agent de l’espace de travail Altium 365 ().
  2. Créez une variable d’environnement HYBRID_AGENT_API_KEY ayant pour valeur la clé API.
  3. Exécutez agent.bat à l’aide de la syntaxe de commande suivante, en indiquant comme argument du paramètre URL l’adresse de votre espace de travail Altium 365 :
    agent.bat https://acme.365.altium.com

Lorsqu’il est actif, l’agent hybride génère un fichier journal dans le dossier hybrid-agent\logs de l’application.

Notez que l’espace de travail ne dispose que d’une seule clé API valide à la fois et qu’une seule instance de l’agent hybride peut être exécutée. L’agent prend en charge plusieurs instances de configuration PLM si les deux systèmes PLM sont hébergés au sein du même réseau fermé.

Il est vivement recommandé d’exécuter l’agent hybride en tant que service Windows dans l’environnement de production plutôt que directement dans le terminal, bien que cette dernière méthode puisse être utilisée pour les tests.

Exemple de procédure pour exécuter l’agent hybride en tant que service Windows à l’aide du gestionnaire de services NSSM :

  1. Exécutez la commande : nssm install HybridAgent.
  2. Dans la boîte de dialogue NSSM (sous l’onglet Application), saisissez le chemin du fichier agent.bat dans le champ Path et l’URL de votre espace de travail dans le champ Arguments, puis cliquez sur Install service.
    1. Vous pouvez définir le comportement de démarrage du service à l’aide de l’option Startup type sous l’onglet Details de la boîte de dialogue NSSM. Si nécessaire, exécutez nssm edit HybridAgent pour effectuer ces modifications.
    2. Au lieu de créer les variables d’environnement standard PATH et JAVA_HOME pour Java, vous pouvez les ajouter sous l’onglet Environment de NSSM. Avec cette méthode, les variables ne sont actives que lorsque le service HybridAgent est en cours d’exécution.
    3. De même, la variable HYBRID_AGENT_API_KEY peut également être déplacée vers la configuration de l’environnement NSSM afin qu’elle soit active lorsque le service est en cours d’exécution.

  3. Démarrez le service HybridAgent à l’aide de l’outil de gestion Services de Windows ou de la commande NSSM : nssm start HybridAgent. Cette opération n’est pas nécessaire (après un redémarrage du PC) si le service est configuré pour démarrer automatiquement.
  4. Vérifiez que le service HybridAgent est en cours d’exécution dans l’outil de gestion Services de Windows ou à l’aide de la commande NSSM : nssm status HybridAgent.

Une fois l’agent hybride connecté à votre espace de travail Altium 365 (actualisez la fenêtre du navigateur pour vérifier son état), vous pouvez configurer l’intégration PLM dans l’espace de travail Altium 365. Sur la page Add Configuration, activez l’option de connexion Hybrid Agent et saisissez dans le champ URL l’URL de votre PLM sur site, telle qu’elle est accessible depuis votre réseau fermé.

 

La clé API actuelle peut être révoquée à l’aide de la commande Revoke qui lui est associée. Dans ce cas, vous devez générer une nouvelle clé API et mettre à jour la variable d’environnement HYBRID_AGENT_API_KEY avec la valeur de cette nouvelle clé.

Redémarrez l’agent hybride pour utiliser la nouvelle clé : avec NSSM, utilisez la commande nssm restart HybridAgent, ou arrêtez puis redémarrez le service HybridAgent dans Services de Windows.

AI-LocalizedLocalisé par IA
Si vous trouvez un problème, sélectionnez le texte/l’image et appuyez surCtrl + Enterpour nous envoyer vos commentaires.
Contents
Disponibilité des fonctionnalités

Les fonctionnalités auxquelles vous avez accès dépendent de la solution Altium dont vous disposez – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, ou Altium Designer (avec un abonnement actif).

Si vous ne voyez pas une fonctionnalité documentée dans votre logiciel actuel, contactez le service commercial d’Altium pour en savoir plus.