サポート終了通知: 2026 年 10 月 7 日、 AWS はサポートを終了します AWS IoT Greengrass Version 1。2026 年 10 月 7 日以降、 AWS IoT Greengrass V1 リソースにアクセスできなくなります。詳細については、[「 からの移行 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)」を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Device Defender コネクタ Device Defender [コネクタ](connectors.md)は、Greengrass Core デバイスの状態の変化を管理者に通知します。これは、侵害されたデバイスを示す可能性のある異常な動作を特定するのに役立ちます。 このコネクタは、コアデバイスの `/proc` ディレクトリからシステムメトリクスを読み取り、メトリクスを公開します AWS IoT Device Defender。メトリクスレポートの詳細については、「AWS IoT デベロッパーガイド」の「[デバイスメトリクスドキュメントの仕様](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec)」を参照してください。 このコネクタには、次のバージョンがあります。 | バージョン | ARN | | --- | --- | | 3 | `arn:aws:greengrass:{{region}}::/connectors/DeviceDefender/versions/3` | | 2 | `arn:aws:greengrass:{{region}}::/connectors/DeviceDefender/versions/2` | | 1 | `arn:aws:greengrass:{{region}}::/connectors/DeviceDefender/versions/1` | バージョンの変更については、「[Changelog](#device-defender-connector-changelog)」を参照してください。 ## 要件 このコネクタには以下の要件があります。 ------ #### [ Version 3 ] + AWS IoT Greengrass Core ソフトウェア v1.9.3 以降。 + [Python](https://www.python.org/) バージョン 3.7 または 3.8 が Core デバイスにインストールされ、PATH 環境変数に追加されている。 **注記** Python 3.8 を使用するには、次のコマンドを実行して、Python 3.7 のデフォルトのインストールフォルダからインストール済みの Python 3.8 バイナリへのシンボリックリンクを作成します。 ``` sudo ln -s {{path-to-python-3.8}}/python3.8 /usr/bin/python3.7 ``` これにより、 AWS IoT Greengrassの Python 要件を満たすようにデバイスが設定されます。 + AWS IoT Device Defender Detect 機能を使用して違反を追跡するように設定されています。詳細については、「AWS IoT デベロッパーガイド」の「[検出](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html)」を参照してください。 + `/proc` ディレクトリを参照する Greengrass グループの[ローカルボリュームリソース](access-local-resources.md)。リソースは以下のプロパティを使用する必要があります。 + ソースパス: `/proc` + ターゲットパス: `/host_proc` (または[有効なパターン](#param-ProcDestinationPath)と一致する値) + AutoAddGroupOwner: `true` + Greengrass コアにインストールされた [psutil](https://pypi.org/project/psutil/) ライブラリ。バージョン 5.7.0 は、コネクタで動作することが確認された最新バージョンです。 + Greengrass コアにインストールされた [cbor](https://pypi.org/project/cbor/) ライブラリ。バージョン 1.0.0 は、コネクタで動作することが確認された最新バージョンです。 ------ #### [ Versions 1 - 2 ] + AWS IoT Greengrass Core ソフトウェア v1.7 以降。 + [Python](https://www.python.org/) バージョン 2.7 が Core デバイスにインストールされ、PATH 環境変数に追加されている。 + AWS IoT Device Defender Detect 機能を使用して違反を追跡するように設定されています。詳細については、「AWS IoT デベロッパーガイド」の「[検出](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html)」を参照してください。 + `/proc` ディレクトリを参照する Greengrass グループの[ローカルボリュームリソース](access-local-resources.md)。リソースは以下のプロパティを使用する必要があります。 + ソースパス: `/proc` + ターゲットパス: `/host_proc` (または[有効なパターン](#param-ProcDestinationPath)と一致する値) + AutoAddGroupOwner: `true` + Greengrass コアにインストールされた [psutil](https://pypi.org/project/psutil/) ライブラリ。 + Greengrass コアにインストールされた [cbor](https://pypi.org/project/cbor/) ライブラリ。 ------ ## コネクタパラメータ このコネクタには、以下のパラメータが用意されています。 `SampleIntervalSeconds` メトリクスの収集およびレポートの各サイクル間の秒数。最小値は 300 秒 (5 分) です。 AWS IoT コンソールでの名前の表示: **メトリクスレポート間隔** 必須: `true` 型: `string` 有効なパターン: `^[0-9]*(?:3[0-9][0-9]|[4-9][0-9]{2}|[1-9][0-9]{3,})$` `ProcDestinationPath-ResourceId` `/proc` ボリュームリソースの ID。 このコネクタには、リソースへの読み取り専用アクセス許可が付与されています。 AWS IoT コンソールの表示名: **/proc ディレクトリのリソース** 必須: `true` 型: `string` 有効なパターン: `[a-zA-Z0-9_-]+` `ProcDestinationPath` `/proc` ボリュームリソースのターゲットパス。 AWS IoT コンソールの表示名: **/proc リソースの送信先パス** 必須: `true` 型: `string` 有効なパターン: `\/[a-zA-Z0-9_-]+` ### サンプルコネクタを作成する (AWS CLI) 以下の CLI コマンドは、Device Defender コネクタを含む初期バージョンで `ConnectorDefinition` を作成します。 ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyDeviceDefenderConnector", "ConnectorArn": "arn:aws:greengrass:{{region}}::/connectors/DeviceDefender/versions/3", "Parameters": { "SampleIntervalSeconds": "600", "ProcDestinationPath": "/host_proc", "ProcDestinationPath-ResourceId": "my-proc-resource" } } ] }' ``` **注記** このコネクタの Lambda 関数には[存続期間の長い](lambda-functions.md#lambda-lifecycle)ライフサイクルがあります。 AWS IoT Greengrass コンソールでは、グループのコネクタページから**コネクタ**を追加できます。詳細については、「[Greengrass コネクタの開始方法 (コンソール)](connectors-console.md)」を参照してください。 ## 入力データ このコネクタは MQTT メッセージを入力データとして受け入れません。 ## 出力データ このコネクタは、セキュリティメトリクスを出力データ AWS IoT Device Defender として に発行します。 **サブスクリプションのトピックフィルター** `$aws/things/+/defender/metrics/json` これは、 が AWS IoT Device Defender 想定するトピック構文です。コネクタはワイルドカード `+` をデバイス名 (`$aws/things/{{thing-name}}/defender/metrics/json` など) に置き換えます。 **出力例** メトリクスレポートの詳細については、「AWS IoT デベロッパーガイド」の「[デバイスメトリクスドキュメントの仕様](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec)」を参照してください。 ``` { "header": { "report_id": 1529963534, "version": "1.0" }, "metrics": { "listening_tcp_ports": { "ports": [ { "interface": "eth0", "port": 24800 }, { "interface": "eth0", "port": 22 }, { "interface": "eth0", "port": 53 } ], "total": 3 }, "listening_udp_ports": { "ports": [ { "interface": "eth0", "port": 5353 }, { "interface": "eth0", "port": 67 } ], "total": 2 }, "network_stats": { "bytes_in": 1157864729406, "bytes_out": 1170821865, "packets_in": 693092175031, "packets_out": 738917180 }, "tcp_connections": { "established_connections":{ "connections": [ { "local_interface": "eth0", "local_port": 80, "remote_addr": "192.168.0.1:8000" }, { "local_interface": "eth0", "local_port": 80, "remote_addr": "192.168.0.1:8000" } ], "total": 2 } } } } ``` ## ライセンス このコネクタは、[Greengrass Core ソフトウェアライセンス契約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)に従ってリリースされます。 ## 変更ログ 次の表に、コネクタの各バージョンにおける変更点を示します。 | バージョン | 変更 | | --- | --- | | 3 | Lambda ランタイムを Python 3.7 にアップグレードしたことで、ランタイム要件が変更。 | | 2 | 過剰なログ記録を減らすための修正。 | | 1 | 初回リリース。 | Greengrass グループには、一度に 1 つのバージョンのコネクタしか含めることができません。コネクタのバージョンのアップグレードについては、「[コネクタのバージョンのアップグレード](connectors.md#upgrade-connector-versions)」を参照してください。 ## 関連情報 + [Greengrass コネクタを使用したサービスおよびプロトコルとの統合](connectors.md) + [Greengrass コネクタの開始方法 (コンソール)](connectors-console.md) + [Greengrass コネクタの開始方法 (CLI)](connectors-cli.md) + 「AWS IoT デベロッパーガイド」の「[Device Defender](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender.html)」