エージェントダウンロードのURL形式

エージェントソフトウェアパッケージは、明確に定義されたURL形式を使用してWorkload Securityからダウンロードできます。

ほとんどの場合、標準の配信スクリプト ( エージェントソフトウェアのダウンロードにも同じURL形式を使用します) を使用するのが最も簡単で、ほとんどの配信要件を満たすことができます。

このURL形式は、Agentのダウンロードとインストールをさらにカスタマイズする必要がある場合に便利です。たとえば、ソフトウェアをダウンロードするために各サーバがWorkload Securityに接続するのではなく、各サーバで実行されるデプロイスクリプトがローカルのストレージの場所 (AWS S3など) を指すようにする必要がある場合があります。このURL形式を使用すると、独自の自動化を構築して、新しいバージョンのエージェントをローカルの保存場所に定期的にダウンロードし、各サーバで実行されるエージェント配信スクリプトがローカルの保存場所を指すようにすることで、この目的を達成できます。

エージェントのダウンロードURL形式

エージェントをダウンロードするためのURLの形式は次のとおりです。

https://<dsm fqdn>/software/agent/<platform>/<arch>/<agent version>/<filename>

<dsm fqdn>パラメータ

<dsm fqdn> パラメータは、 Workload Securityの完全修飾ドメイン名で、 app.deepsecurity.trendmicro.comです。Workload Security は、このトピックで提供されるサンプルをテストするために使用できます。

<filename>パラメータ

<filename> パラメータは、エージェントインストーラファイルのファイル名です。ファイル名は、各プラットフォームで使用されるインストールプロセスによって異なります。

Workload Securityはファイル名自体を検証しません。ただし、ファイル名を指定する場合、拡張子は .rpm .msi .deb .gzのいずれかにする必要があります。他のファイル名が指定された場合、Workload Securityによって返されるファイル名は常に上記の表に示す名前のいずれかになります。

<agent version>パラメータ

<agent version> パラメーターはオプションです。

このパラメータが指定されていない場合は、対象プラットフォームに対してトレンドマイクロがリリースした最新のLTSエージェントが返されます。

このパラメータを指定すると、エージェントのバージョン文字列が表示されます。例：「12.0.0.123」

管理された環境で特定のバージョンのエージェントのみを使用する場合は、エージェントのバージョンをURLに明示的に追加することで実現できます。

エージェントを大規模に配信する場合は、URLにエージェントのバージョンを追加することで、配信するすべてのスクリプトにこのエージェントのバージョンがハードコードされる可能性があることに注意してください。

新しいバージョンのエージェントを使用する際に必要なプロセスを考慮してください。配布する各スクリプトに <agent version> がハードコードされている場合、新しいバージョンのエージェントを使用するには、各スクリプトをアップデートする必要があります。社内に多数のアプリケーションチームがいる場合は、使用中のこれらのスクリプトのそれぞれに変更を要求するプロセスが重要になる可能性があります。

Workload Security には、この課題に対処するための2つのオプションがあります。

• パスから <agent version> コンポーネントを省略したスクリプトを使用します。最新のLTSエージェントが要件を満たしています。これは、最も簡単に使用できるオプションです。

• エージェントのバージョン管理を使用すると、Workload Security管理者は、Workload Securityから返されるエージェントのバージョンをプラットフォームごとに正確に選択できます。詳細については、エージェントのバージョン管理を使用して、返されるエージェントのバージョンを定義するを参照してください。

<platform>, <arch>, および<filename>パラメータ

<platform> <arch>および <filename> パラメータは、次の表に示す文字列に置き換える必要があります。

<platform> と <arch> 大文字と小文字が区別されることに注意してください。

エージェントダウンロードURLの例

<agent version>がない場合：

• https://app.deepsecurity.trendmicro.com/software/agent/RedHat_EL7/x86_64/agent.rpm
• https://app.deepsecurity.trendmicro.com/software/agent/Windows/x86_64/agent.msi

<agent version>の場合：

• https://app.deepsecurity.trendmicro.com/software/agent/RedHat_EL7/x86_64/12.0.0.481/agent.rpm
• https://app.deepsecurity.trendmicro.com/software/agent/Windows/x86_64/12.0.0.481/agent.msi

下位互換性のための除外

[...]/<platform>/<arch>/の後に <filename> が指定されていない場合、Workload Securityは、前の表で説明されているように、そのプラットフォーム用のエージェントのダウンロードを返します。

パスが [...]<platform>/<arch> で終わる場合 ( <agent version> と <filename> の両方が指定されていないため)、Workload Securityは、前の表で説明したように、そのプラットフォーム用のエージェントのダウンロードを返します。

例:

• https://app.deepsecurity.trendmicro.com/software/agent/RedHat_EL7/x86_64/
• https://app.deepsecurity.trendmicro.com/software/agent/Windows/x86_64

エージェントバージョン管理

エージェントバージョン管理 ] を使用すると、Workload Securityに対してエージェントのダウンロード要求が行われたときに返されるエージェントを指定できます。

エージェントのバージョン管理を有効にするには、URL要求を使用して次のHTTPヘッダを送信します。

Agent-Version-Control: on

次の表は、エージェントのバージョン管理を使用するために各プラットフォームで必要な特定のクエリパラメータの詳細を示しています。

これらのパラメータは、配置スクリプトによって自動的に生成されます。

エージェントのバージョン管理の使用例については、Workload Securityから生成されたサンプル配信スクリプトを参照してください。初期設定では、Workload Securityによって生成される配信スクリプトは、エージェントのバージョン管理を使用して、各プラットフォームのこれらのパラメータを取得する方法を示します。

パラメータとエージェントバージョンコントロール間の相互作用

エージェントのバージョン管理の目的が、返されるエージェントのバージョンをWorkload Security管理者が制御できるようにすることであることを考えると、 <agent version> パラメータも含むURL要求と自然に競合が発生します。

このため、HTTPヘッダに Agent-Version-Control: on を送信する際に、 <agent version> をリクエストの一部として指定しないでください。

リクエストに Agent-Version-Control: on HTTPヘッダと <agent version> パラメータの両方がある場合、返されるエージェントのバージョンは、エージェントのバージョン管理設定から取得した値によって決まります。 URL内の <agent version> パラメータは無視されます。