チュートリアル: Defender for IoT マイクロエージェントをインストールする

このチュートリアルでは、Defender for IoT マイクロエージェントをインストールして認証する方法について説明します。

このチュートリアルでは、次の方法を学習します。

マイクロエージェントをダウンロードしてインストールする
マイクロエージェントを認証する
インストールを検証する
システムをテストする
特定のマイクロエージェントバージョンをインストールする

注:

Defender for IoT は、2025 年 8 月 1 日にマイクロエージェントを廃止する予定です。

前提条件

アクティブなサブスクリプションを持つAzure アカウント。無料でアカウントを作成します。
IoT ハブ。
次のいずれかのオペレーティングシステムを実行していることを確認します。
Azure IoT Hubで IoT のMicrosoft Defenderを有効にしている必要があります。
IoT ソリューションにリソースグループを追加している必要があります。
Defender for IoT マイクロエージェントモジュールツインを作成している必要があります。

マイクロエージェントをダウンロードしてインストールする

セットアップに応じて、適切な Microsoft パッケージをインストールする必要があります。

適切な Microsoft パッケージリポジトリを追加するには:

デバイスのオペレーティングシステムに一致するリポジトリ構成をダウンロードします。

Ubuntu 18.04 の場合:

curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list

Ubuntu 20.04 の場合:

    curl https://packages.microsoft.com/config/ubuntu/20.04/prod.list > ./microsoft-prod.list

Debian 9 (AMD64 と ARM64 の両方) の場合:

curl https://packages.microsoft.com/config/debian/stretch/multiarch/prod.list > ./microsoft-prod.list

次のコマンドを使用して、リポジトリ構成を sources.list.d ディレクトリにコピーします。
```
sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/
```

次のコマンドを使用して、Microsoft GPG 公開キーをインストールします。

curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

次のコマンドを使用して apt を更新したことを確認します。
```
sudo apt-get update
```
次のコマンドを使用して、Debian または Ubuntu ベースの Linux ディストリビューションに Defender for IoT マイクロエージェントパッケージをインストールします。
```
sudo apt-get install defender-iot-micro-agent 
```

プロキシ経由で接続する

この手順では、プロキシ経由で Defender for IoT マイクロエージェントをIoT Hubに接続する方法について説明します。

プロキシ経由で接続を構成するには:

マイクロエージェントコンピューターで、次の内容の /etc/defender_iot_micro_agent/conf.json ファイルを作成します。
```
{
    "IothubModule_ProxyConfig": "<proxy_ipv4>,<port>,<username>,<password>",
    "IothubModule_TransportProtocol": "MQTT_WebSocket_Protocol"
}
```
ユーザーフィールドとパスワードフィールドは省略可能です。不要な場合は、代わりに次の構文を使用します。
```
{
    "IothubModule_ProxyConfig": "<proxy_ipv4>,<port>",
    "IothubModule_TransportProtocol": "MQTT_WebSocket_Protocol"
}
```
/var/lib/defender_iot_micro_agent/cache.jsonでキャッシュされたファイルを削除します。
マイクロエージェントを再起動します。実行：
```
sudo systemctl restart defender-iot-micro-agent.service
```

AMQP プロトコルのサポートを追加する

この手順では、AMQP プロトコルをサポートするために必要な追加の手順について説明します。

AMQP プロトコルのサポートを追加するには:

マイクロエージェントコンピューターで、 /etc/defender_iot_micro_agent/conf.json ファイルを開き、次の内容を追加します。
```
{
"IothubModule_TransportProtocol": "AMQP_Protocol"
}
```
/var/lib/defender_iot_micro_agent/cache.jsonでキャッシュされたファイルを削除します。
マイクロエージェントを再起動します。実行：
```
sudo systemctl restart defender-iot-micro-agent.service
```

WEB ソケットプロトコルのサポート経由で AMQP を追加するには:

マイクロエージェントコンピューターで、 /etc/defender_iot_micro_agent/conf.json ファイルを開き、次の内容を追加します。
```
{
"IothubModule_TransportProtocol": "AMQP_WebSocket_Protocol"
}
```
/var/lib/defender_iot_micro_agent/cache.jsonでキャッシュされたファイルを削除します。
マイクロエージェントを再起動します。実行：
```
sudo systemctl restart defender-iot-micro-agent.service
```

エージェントはこのプロトコルを使用し、ポート 443 のIoT Hubと通信します。このプロトコルでは HTTP プロキシ構成がサポートされています。プロキシも構成されている場合、プロキシとの通信ポートはプロキシ構成で定義されています。

マイクロエージェントを認証する

Defender for IoT マイクロエージェントの認証に使用できるオプションは 2 つあります。

モジュール ID 接続文字列を使用して認証します。
証明書を使用して認証します。

モジュール ID 接続文字列を使用して認証する

モジュール ID 接続文字列を DefenderIoTMicroAgent モジュール ID の詳細からコピーする必要があります。

モジュール ID の接続文字列をコピーするには:

IoT Hub>Your hub>Device management>Devices に移動します。
[デバイス ID] ボックスの一覧からデバイスを選択します。
[ モジュール ID] タブを 選択します。
デバイスに関連付けられているモジュール ID の一覧から DefenderIotMicroAgent モジュールを選択します。
[コピー] ボタンを選択して、接続文字列 (主キー) を コピー します。
次のコマンドを入力して、/etc/defender_iot_micro_agentconnection_string.txtという名前のファイル接続文字列を作成します。
```
sudo bash -c 'echo "<connection string>" > /etc/defender_iot_micro_agent/connection_string.txt'
```
connection_string.txtは、次のパスの場所/etc/defender_iot_micro_agent/connection_string.txtに配置されます。

注:

接続文字列には、モジュール自体への直接アクセスを可能にするキーが含まれているため、ルートユーザーのみが使用して読み取り可能な機密情報が含まれます。
次のコマンドを使用してサービスを再起動します。
```
sudo systemctl restart defender-iot-micro-agent.service 
```

証明書を使用した認証

証明書を使用して認証するには:

次の手順に従って証明書を調達します。
証明書の PEM でエンコードされた公開部分と秘密キーを /etc/defender_iot_micro_agent に、 certificate_public.pem と呼ばれるファイルに配置し、 certificate_private.pemします。
適切な接続文字列を connection_string.txt ファイルに配置します。接続文字列は次のようになります。

HostName=<the host name of the iot hub>;DeviceId=<the id of the device>;ModuleId=<the id of the module>;x509=true

この文字列は、認証のために証明書が提供されることを Defender for IoT エージェントに通知します。
次のコマンドを使用してサービスを再起動します。
```
sudo systemctl restart defender-iot-micro-agent.service
```

インストールを検証する

インストールを検証するには:

マイクロエージェントが正しく実行されていることを確認するには、次のコマンドを使用します。
```
systemctl status defender-iot-micro-agent.service
```
サービスが activeであることを確認し、プロセスのアップタイムが適切であることを確認して、サービスが安定していることを確認します。

システムをテストする

システムをテストするには、デバイスにトリガーファイルを作成します。トリガーファイルによって、エージェントのベースラインスキャンによって、ベースライン違反としてファイルが検出されます。

次のコマンドを使用して、ファイルシステムにファイルを作成します。
```
sudo touch /tmp/DefenderForIoTOSBaselineTrigger.txt
```
Log Analytics ワークスペースが IoT ハブにアタッチされていることを確認します。詳細については、「ログ分析ワークスペースの作成」を参照してください。
コマンドを使用してエージェントを再起動します。
```
sudo systemctl restart defender-iot-micro-agent.service
```

ハブに推奨事項が表示されるには、最大 1 時間を許可します。

"IoT_CISBenchmarks_DIoTTest" というベースラインの推奨事項が作成されます。この推奨事項は、Log Analytics から次のように照会できます。

SecurityRecommendation

| where RecommendationName contains "IoT_CISBenchmarks_DIoTTest"

| where DeviceId contains "<device-id>"

| top 1 by TimeGenerated desc

例:

Log Analytics で実行IoT_CISBenchmarks_DIoTTestクエリのスクリーンショット。

特定のマイクロエージェントバージョンをインストールする

特定のコマンドを使用して、特定のバージョンのマイクロエージェントをインストールできます。

特定のバージョンの Defender for IoT マイクロエージェントをインストールするには:

ターミナルを開きます。

次のコマンドを実行します。

sudo apt-get install defender-iot-micro-agent=<version>

リソースをクリーンアップする

クリーンするリソースはありません。

次の手順

IoT エージェントベースのソリューションのMicrosoft Defenderを構成する

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-04-29