この記事では、Eclipse ThreadXデバイス向けにネットワーク、帯域幅、メモリの要件を満たすためにDefender-IoTマイクロエージェントを設定する方法を説明します。 ターゲット配布の選択、デバイスの動作設定の調整、データ収集間隔の調整、リソースに制約のあるデバイスの個々のコレクターの有効化または無効化を行う方法について説明します。
注:
Defender for IoT は、2027 年 6 月 1 日にマイクロ エージェントを廃止する予定です。
Defender-IoT-micro-agent を構成する
*.distディレクトリからnetxduo/addons/azure_iot/azure_iot_security_module/configs拡張子のターゲット配布ファイルを選択しなければなりません。
CMake コンパイル環境を使用する場合は、コマンド ライン パラメーターを、選択した値の IOT_SECURITY_MODULE_DIST_TARGET に設定する必要があります。 たとえば、 -DIOT_SECURITY_MODULE_DIST_TARGET=RTOS_BASEと指定します。
IAR またはその他の CMake 以外のコンパイル環境では、 netxduo/addons/azure_iot/azure_iot_security_module/inc/configs/<target distribution>/ パスを既知のインクルード パスに追加する必要があります。 たとえば、 netxduo/addons/azure_iot/azure_iot_security_module/inc/configs/RTOS_BASEと指定します。
デバイスの動作設定を構成する
次のファイルを使用して、デバイスの動作を構成します。
netxduo/addons/azure_iot/azure_iot_security_module/inc/configs/<ターゲット ディストリビューション>/asc_config.h
CMake コンパイル環境では、 netxduo/addons/azure_iot/azure_iot_security_module/configs/<target distribution>.dist ファイルを編集して既定の構成を変更する必要があります。 次の CMake 形式の set(ASC_XXX ON)を使用するか、他のすべての環境に対して次のファイル netxduo/addons/azure_iot/azure_iot_security_module/inc/configs/<target distribution>/asc_config.h を使用します。 たとえば、「 #define ASC_XXX 」のように入力します。
一般設定、データ収集設定、コレクター設定のデフォルト値は以下の表に示されています。
マイクロ エージェントの全般設定を構成する
以下の表は一般的な設定設定とそのデフォルト値を一覧にしています。
| 名前 | タイプ | 既定値 | 詳細 |
|---|---|---|---|
| ASC_SECURITY_MODULE_ID | 文字列 | defender-iot-micro-agent | デバイスの一意の識別子。 |
| SECURITY_MODULE_VERSION_(MAJOR)(MINOR)(PATCH) | 番号 | 3.2.1 | バージョン。 |
| ASC_SECURITY_MODULE_SEND_MESSAGE_RETRY_TIME | 番号 | 3 | 失敗後 (秒単位) に Defender-IoT-micro-agent がセキュリティ メッセージを送信するのにかかる時間。 |
| ASCセキュリティモジュールの保留時間 | 番号 | 300 | Defender-IoT-micro-agent の保留時間 (秒) 時間を超えると、状態が一時停止に変わります。 |
データ収集設定を構成する
以下の表は、データ収集の設定設定とそのデフォルト値を一覧にしています。
| 名前 | タイプ | 既定値 | 詳細 |
|---|---|---|---|
| 最初の収集間隔 | 番号 | 30 | コレクターの開始コレクション間隔のオフセット。 起動時に、複数のデバイスからのメッセージを同時に送信しないように、値がシステムのコレクションに追加されます。 |
| ASC_HIGH_PRIORITY_INTERVAL | 番号 | 10 | コレクターの優先度の高いグループ間隔 (秒単位)。 |
| ASC_MEDIUM_PRIORITY_INTERVAL | 番号 | 30 | コレクターの中優先度グループ間隔 (秒単位)。 |
| ASC_LOW_PRIORITY_INTERVAL | 番号 | 145,440 | コレクターの優先度の低いグループ間隔 (秒単位)。 |
ネットワークアクティビティコレクションの設定
コレクター ネットワーク アクティビティの構成をカスタマイズするには、次を使用します。
| 名前 | タイプ | 既定値 | 詳細 |
|---|---|---|---|
| コレクターのネットワーク アクティビティ: TCP は無効 | ブール値 | false |
TCP ネットワーク アクティビティをフィルター処理します。 |
| ASC_COLLECTOR_NETWORK_ACTIVITY_UDP_DISABLED | ブール値 | false |
UDPネットワーク アクティビティ イベントをフィルター処理します。 |
| コレクターのネットワーク アクティビティ: ICMP は無効です | ブール値 | false |
ICMPネットワーク アクティビティ イベントをフィルター処理します。 |
| ASC_COLLECTOR_NETWORK_ACTIVITY_CAPTURE_UNICAST_ONLY | ブール値 | true | ユニキャスト着信パケットのみをキャプチャします。 false に設定すると、ブロードキャストとマルチキャストの両方がキャプチャされます。 |
| ASC_COLLECTOR_NETWORK_ACTIVITY_SEND_EMPTY_EVENTS | ブール値 | false | コレクターの空のイベントを送信します。 |
| ASC コレクターのネットワーク アクティビティのキャッシュ内の IPv4 オブジェクト最大数 | 番号 | 64 | メモリに格納する IPv4 ネットワーク イベントの最大数。 |
| ASC コレクターのネットワーク アクティビティのキャッシュ内 IPv6 オブジェクトの最大数 | 番号 | 64 | メモリに格納する IPv6 ネットワーク イベントの最大数。 |
利用可能なコレクター
以下の表は利用可能なコレクタイネーブルフラグを示しています:
| 名前 | タイプ | 既定値 | 詳細 |
|---|---|---|---|
| ASC_COLLECTOR_HEARTBEAT_ENABLED | ブール値 | オン | ハートビート コレクターを有効にします。 |
| ASC コレクタのネットワークアクティビティが有効 | ブール値 | オン | ネットワーク アクティビティ コレクターを有効にします。 |
| ASC_COLLECTOR_SYSTEM_INFORMATION_ENABLED | ブール値 | オン | システム情報コレクターを有効にします。 |
他の構成フラグは高度で、サポートされていない機能を持っています。 これらの詳細な構成フラグを変更するには、サポートにお問い合わせください。詳細については、サポートにお問い合わせください。
サポートされているセキュリティ アラートと推奨事項
Eclipse ThreadX 用 Defender-IoT-micro-agent では、特定のセキュリティ アラートと推奨事項がサポートされています。 サービス の Eclipse ThreadX のセキュリティ アラートと推奨事項の値を必ずカスタマイズ してください。
Log Analytics (省略可能)
Log Analytics を有効にして構成して、デバイスのイベントとアクティビティを調査できます。 Defender for IoTサービスでLog Analyticsの設定と使用方法を学びましょう。