ハイブリッドエージェント統合

ハイブリッド統合は、Altium 365 を使用している企業が、自社ネットワーク内のオンプレミス環境でホストされている PLM システム（パブリック IP アドレスを持たず、インターネットに公開されていない）と Workspace を統合したい場合に適用されます。

これを実現するために、Hybrid Agent と呼ばれる小さなプログラムを企業ネットワーク内で実行します。このプログラムは Altium 365 と通信し、Altium 365 Workspace と閉域ネットワーク内の PLM システムの間で情報を中継します。Hybrid Agent との通信は HTTPS 経由で行われ、インターネットからの受信トラフィックのためにネットワークポートを開放する必要はありません。必要なのは送信トラフィック用の標準 HTTPS ポート 443 のみです。

Hybrid Integration のセットアップ

Agent アーカイブ（）をダウンロードし、その内容を既知の場所に展開します。これには Java アプリケーション（hybrid-agent.jar）が含まれており、オンプレミスの PLM システムと Altium 365 の両方に到達可能な企業ネットワーク内のマシンで実行する必要があります。

そのマシンはnot インターネットからパブリックにアクセス可能である必要はありませんが、会社で使用している Altium 365 環境に接続できる必要があります。

Hybrid Agent アプリケーションを配置したら、次を実行します。

1. Altium 365 Workspace の Hybrid Agent ページ（）で API キーを生成します。
2. 値として API キーを設定した HYBRID_AGENT_API_KEY 環境変数を作成します。

3. 次のコマンドコンテキストを使用して agent.bat を実行します。URL パラメーター引数には、使用している Altium 365 Workspace の URL を指定してください。
   agent.bat https://acme.365.altium.com

アクティブになると、Hybrid Agent はアプリケーションの hybrid-agent\logs フォルダーにログファイルを生成します。

本番環境では、Hybrid Agent をターミナルから直接実行するのではなく、Windows service として実行することを強く推奨します。ただし、後者はテスト目的で使用できます。

NSSM サービスマネージャーを使用して Hybrid Agent を Windows サービスとして実行する方法の一例を示します。

1. コマンド nssm install HybridAgent を実行します。
2. NSSM ダイアログウィンドウの Application タブで、Path フィールドに agent.bat ファイルパスを、Arguments フィールドに Workspace URL を入力し、Install service をクリックします。
   1. NSSM ダイアログの Details タブにある Startup type オプションで、サービスの起動動作を設定できます。必要に応じて、変更を行うために nssm edit HybridAgent を実行してください。
   2. Java 用の標準的な PATH および JAVA_HOME 環境変数を作成する代わりに、それらを NSSM の Environment タブで追加することもできます。この方法では、変数は HybridAgent サービスの実行中のみ有効になります。

   3. 同様に、HYBRID_AGENT_API_KEY 変数も NSSM の環境設定に移動でき、サービス実行中に有効になります。

3. Windows の Services 管理ツール、または NSSM コマンド nssm start HybridAgent を使用して HybridAgent サービスを開始します。サービスが自動起動に設定されている場合は、PC 再起動後にこれは不要です。
4. Windows の Services 管理ツール、または NSSM コマンド nssm status HybridAgent を使用して、HybridAgent サービスが実行中であることを確認します。

Hybrid Agent が Altium 365 Workspace に接続したら（状態を確認するにはブラウザーウィンドウを更新してください）、Altium 365 Workspace で PLM Integration の設定に進むことができます。Add Configuration ページで Hybrid Agent 接続オプションを有効にし、URL フィールドに、閉域ネットワーク内から見たオンプレミス PLM の URL を入力します。