Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Konektor Pertahanan Perangkat
<a name="device-defender-connector"></a>

Pertahanan Perangkat [konektor](connectors.md) memberitahu administrator perubahan dalam keadaan perangkat core Greengrass. Ini dapat membantu mengidentifikasi perilaku yang tidak biasa yang mungkin menunjukkan perangkat yang dikompromikan.

Konektor ini membaca metrik sistem dari `/proc` direktori pada perangkat inti, dan kemudian menerbitkan metrik ke. AWS IoT Device Defender Untuk detail pelaporan metrik, lihat [Spesifikasi dokumen metrik perangkat](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec) dalam *AWS IoT Panduan Developer*.

Konektor ini memiliki versi berikut.


| Versi | 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` | 

Untuk informasi tentang perubahan versi, lihat [Changelog](#device-defender-connector-changelog).

## Persyaratan
<a name="device-defender-connector-req"></a>

Konektor ini memiliki persyaratan sebagai berikut:

------
#### [ Version 3 ]
+ <a name="conn-req-ggc-v1.9.3"></a>AWS IoT Greengrass Perangkat lunak inti v1.9.3 atau yang lebih baru.
+ <a name="conn-req-py-3.7-and-3.8"></a>[Python](https://www.python.org/) versi 3.7 atau 3.8 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH.
**catatan**  <a name="use-runtime-py3.8"></a>
Untuk menggunakan Python 3.8, jalankan perintah berikut untuk membuat link simbolik dari folder instalasi default Python 3.7 ke binari Python 3.8 yang diinstal.  

  ```
  sudo ln -s {{path-to-python-3.8}}/python3.8 /usr/bin/python3.7
  ```
Ini mengonfigurasi perangkat Anda untuk memenuhi persyaratan Python untuk AWS IoT Greengrass.
+ <a name="conn-device-defender-req-itdd-config"></a>AWS IoT Device Defender dikonfigurasi untuk menggunakan fitur Deteksi untuk melacak pelanggaran. Untuk informasi lebih lanjut, lihat [Lacak](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) dalam *AWS IoT Panduan Developer*.
+ <a name="conn-device-defender-req-proc-dir-resource"></a>Sebuah [sumber daya volume lokal](access-local-resources.md) dalam grup Greengrass yang menunjuk ke direktori `/proc` ini. Sumber daya harus menggunakan properti berikut:
  + Jalur sumber: `/proc`
  + Jalur tujuan: `/host_proc` (atau nilai yang cocok [Pola yang valid](#param-ProcDestinationPath))
  + AutoAddGroupOwner: `true`
+ <a name="conn-device-defender-req-psutil-v3"></a>Perpustakaan [psutil](https://pypi.org/project/psutil/) diinstal pada core Greengrass. Versi 5.7.0 adalah versi terkini yang disahkan untuk bekerja dengan konektor.
+ <a name="conn-device-defender-req-cbor-v3"></a>Perpustakaan [cbor](https://pypi.org/project/cbor/) diinstal pada core Greengrass. Versi 1.0.0 adalah versi terbaru yang diverifikasi untuk bekerja dengan konektor.

------
#### [ Versions 1 - 2 ]
+ <a name="conn-req-ggc-v1.7.0"></a>AWS IoT Greengrass Perangkat lunak inti v1.7 atau yang lebih baru.
+ [Python](https://www.python.org/) versi 2.7 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH.
+ <a name="conn-device-defender-req-itdd-config"></a>AWS IoT Device Defender dikonfigurasi untuk menggunakan fitur Deteksi untuk melacak pelanggaran. Untuk informasi lebih lanjut, lihat [Lacak](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) dalam *AWS IoT Panduan Developer*.
+ <a name="conn-device-defender-req-proc-dir-resource"></a>Sebuah [sumber daya volume lokal](access-local-resources.md) dalam grup Greengrass yang menunjuk ke direktori `/proc` ini. Sumber daya harus menggunakan properti berikut:
  + Jalur sumber: `/proc`
  + Jalur tujuan: `/host_proc` (atau nilai yang cocok [Pola yang valid](#param-ProcDestinationPath))
  + AutoAddGroupOwner: `true`
+ <a name="conn-device-defender-req-psutil"></a>Perpustakaan [psutil](https://pypi.org/project/psutil/) diinstal pada core Greengrass.
+ <a name="conn-device-defender-req-cbor"></a>Perpustakaan [cbor](https://pypi.org/project/cbor/) diinstal pada core Greengrass.

------

## Parameter Konektor
<a name="device-defender-connector-param"></a>

Konektor ini menyediakan parameter berikut:

`SampleIntervalSeconds`  
Jumlah detik antara setiap siklus pengumpulan dan pelaporan metrik. Nilai minimum adalah 300 detik (5 menit).  
Nama tampilan di AWS IoT konsol: Interval **pelaporan metrik**  
Wajib: `true`  
Jenis: `string`  
Pola yang valid: `^[0-9]*(?:3[0-9][0-9]|[4-9][0-9]{2}|[1-9][0-9]{3,})$`

`ProcDestinationPath-ResourceId`  
ID dari Sumber daya volume `/proc` ini.  
Konektor ini diberikan akses baca-saja ke sumber daya.
Nama tampilan di AWS IoT konsol: **Sumber daya untuk direktori /proc**  
Wajib: `true`  
Jenis: `string`  
Pola yang valid: `[a-zA-Z0-9_-]+`

`ProcDestinationPath`  <a name="param-ProcDestinationPath"></a>
Jalur tujuan dari sumber daya volume `/proc` ini.  
Nama tampilan di AWS IoT konsol: **Jalur tujuan dari sumber daya /proc**  
Wajib: `true`  
Jenis: `string`  
Pola yang valid: `\/[a-zA-Z0-9_-]+`

### Buat Contoh Konektor (AWS CLI)
<a name="device-defender-connector-create"></a>

Perintah CLI berikut membuat `ConnectorDefinition` dengan versi awal yang berisi konektor Pertahanan Perangkat.

```
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"
            }
        }
    ]
}'
```

**catatan**  
Fungsi Lambda dalam konektor mempunyai siklus hidup yang [berumur panjang](lambda-functions.md#lambda-lifecycle) ini.

Di AWS IoT Greengrass konsol, Anda dapat menambahkan konektor dari halaman **Konektor** grup. Untuk informasi selengkapnya, lihat [Memulai dengan konektor Greengrass (konsol)](connectors-console.md).

## Data input
<a name="device-defender-connector-data-input"></a>

Konektor ini tidak menerima pesan MQTT sebagai data input.

## Data output
<a name="device-defender-connector-data-output"></a>

Konektor ini menerbitkan metrik keamanan AWS IoT Device Defender sebagai data keluaran.

<a name="topic-filter"></a>**Filter topik dalam langganan**  
`$aws/things/+/defender/metrics/json`  
Ini adalah sintaks topik yang AWS IoT Device Defender diharapkan. Konektor menggantikan `+` wildcard dengan nama perangkat (sebagai contoh, `$aws/things/{{thing-name}}/defender/metrics/json`).

**Contoh keluaran**  
Untuk detail pelaporan metrik, lihat [ Spesifikasi dokumen metrik perangkat](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec) dalam *AWS IoT Panduan Developer*.  

```
{
    "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
            }
        }
    }
}
```

## Lisensi
<a name="device-defender-connector-license"></a>

Konektor ini dirilis di bawah [Perjanjian Lisensi Perangkat lunak core Greengrass](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="device-defender-connector-changelog"></a>

Tabel berikut menjelaskan perubahan dalam setiap versi konektor.


| Versi | Perubahan | 
| --- | --- | 
| 3 | <a name="upgrade-runtime-py3.7"></a>Memperbarui waktu aktif Lambda untuk Python 3.7, yang mengubah persyaratan waktu aktif. | 
| 2 | Perbaiki untuk mengurangi pencatatan berlebihan. | 
| 1 | Pelepasan awal. | 

<a name="one-conn-version"></a>Sebuah grup Greengrass dapat berisi hanya satu versi konektor pada suatu waktu. Untuk informasi lebih lanjut tentang pembaruan versi konektor, lihat [Versi upgrade konektor](connectors.md#upgrade-connector-versions).

## Lihat juga
<a name="device-defender-connector-see-also"></a>
+ [Integrasikan dengan layanan dan protokol menggunakan konektor Greengrass](connectors.md)
+ [Memulai dengan konektor Greengrass (konsol)](connectors-console.md)
+ [Memulai dengan konektor Greengrass (CLI)](connectors-cli.md)
+ [Pertahanan Perangkat](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender.html) dalam *AWS IoT Panduan Developer*