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

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

ほとんどの場合、 標準配信スクリプトを使用することになります（ただし、このセクションで説明する同じURL形式を使用してエージェントソフトウェアをダウンロードすることもできます）。デプロイ要件の大部分を満たします。

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

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

エージェントのダウンロードに使用されるURL形式は次のとおりです。

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

URL形式を構成するすべてのパラメータは、次のとおりです。

<dsm fqdn>パラメータ

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

<filename>パラメータ

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

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

<agent version>パラメータ

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

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

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

スクリプトに明示的に<agent version>を含める必要がありますか？

特定のバージョンのエージェントを管理下の環境でのみ使用する場合は、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>/, Workload Security の実行後に <filename> が指定されていない場合、前の表の説明に従って、そのプラットフォームのエージェントのダウンロードが返されます。

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

例:

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

エージェントバージョンコントロールを使用して、返されるエージェントバージョンを定義する

エージェントのバージョン管理 機能を使用すると、エージェントをダウンロードするために Workload Security に対してURL要求が行われたときに、どのエージェントが返されるかを制御できます。

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

Agent-Version-Control: on

エージェントバージョン管理を使用するには、各プラットフォームでも必要な特定のクエリパラメータがあることに注意してください。彼らは次のとおりです。

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

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

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

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

エージェントのバージョン管理機能の目的は、 Workload Security 管理者がどのバージョンのエージェントを返すかの制御を提供することです。URLリクエストとの間には自然な競合があり、 <agent version> パラメータも含まれます。

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

我々は要求の両方 Agent-Version-Control: on HTTPヘッダと <agent version> パラメータが表示されている場合、返されるエージェントのバージョンは、エージェントバージョンの制御構成から採取値によって決定されるであろう。（URL内の <agent version> は無視されます。）