

Avviso di fine del supporto: il 7 ottobre 2026, AWS il supporto per. AWS IoT Greengrass Version 1 Dopo il 7 ottobre 2026, non potrai più accedere alle risorse. AWS IoT Greengrass V1 Per ulteriori informazioni, visita [Migrate](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html) from. AWS IoT Greengrass Version 1

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Connettore Device Defender
<a name="device-defender-connector"></a>

Il [connettore](connectors.md) Device Defender notifica agli amministratori le modifiche allo stato di un dispositivo core Greengrass. Ciò consente di identificare un comportamento anomalo che potrebbe indicare la compromissione del dispositivo.

Questo connettore legge le metriche di sistema dalla `/proc` directory sul dispositivo principale, quindi le pubblica su. AWS IoT Device Defender*Per i dettagli sui rapporti sulle metriche, consulta le specifiche del [documento sulle metriche del dispositivo](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec) nella Guida per gli sviluppatori.AWS IoT *

Questo connettore ha le seguenti versioni.


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

Per informazioni sulle modifiche di ogni versione, consulta [Changelog](#device-defender-connector-changelog).

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

Questo connettore presenta i seguenti requisiti:

------
#### [ Version 3 ]
+ <a name="conn-req-ggc-v1.9.3"></a>AWS IoT Greengrass Software principale v1.9.3 o successivo.
+ <a name="conn-req-py-3.7-and-3.8"></a>[Python](https://www.python.org/) versione 3.7 o 3.8 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
**Nota**  <a name="use-runtime-py3.8"></a>
Per usare Python 3.8, esegui il seguente comando per creare un collegamento simbolico dalla cartella di installazione predefinita di Python 3.7 ai binari Python 3.8 installati.  

  ```
  sudo ln -s path-to-python-3.8/python3.8 /usr/bin/python3.7
  ```
Questo configura il dispositivo in modo che soddisfi il requisito Python per AWS IoT Greengrass.
+ <a name="conn-device-defender-req-itdd-config"></a>AWS IoT Device Defender configurato per utilizzare la funzione Detect per tenere traccia delle violazioni. Per ulteriori informazioni, consulta [Detect](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) nella *AWS IoT Developer Guide*.
+ <a name="conn-device-defender-req-proc-dir-resource"></a>Una [risorsa di volume locale](access-local-resources.md) nel gruppo Greengrass che punta alla `/proc` directory. La risorsa deve utilizzare le seguenti proprietà:
  + Percorso di origine: `/proc`
  + Percorso di destinazione: `/host_proc` (o un valore che corrisponda al [modello valido](#param-ProcDestinationPath))
  + AutoAddGroupOwner: `true`
+ <a name="conn-device-defender-req-psutil-v3"></a>La libreria [psutil](https://pypi.org/project/psutil/) installata sul core Greengrass. La versione 5.7.0 è la versione più recente verificata per funzionare con il connettore.
+ <a name="conn-device-defender-req-cbor-v3"></a>La libreria [cbor](https://pypi.org/project/cbor/) installata sul core Greengrass. La versione 1.0.0 è l'ultima versione verificata per il funzionamento con il connettore.

------
#### [ Versions 1 - 2 ]
+ <a name="conn-req-ggc-v1.7.0"></a>AWS IoT Greengrass Software principale v1.7 o successivo.
+ [Python](https://www.python.org/) versione 2.7 installato sul dispositivo principale e aggiunto alla variabile di ambiente PATH.
+ <a name="conn-device-defender-req-itdd-config"></a>AWS IoT Device Defender configurato per utilizzare la funzione Detect per tenere traccia delle violazioni. Per ulteriori informazioni, consulta [Detect](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) nella *AWS IoT Developer Guide*.
+ <a name="conn-device-defender-req-proc-dir-resource"></a>Una [risorsa di volume locale](access-local-resources.md) nel gruppo Greengrass che punta alla `/proc` directory. La risorsa deve utilizzare le seguenti proprietà:
  + Percorso di origine: `/proc`
  + Percorso di destinazione: `/host_proc` (o un valore che corrisponda al [modello valido](#param-ProcDestinationPath))
  + AutoAddGroupOwner: `true`
+ <a name="conn-device-defender-req-psutil"></a>La libreria [psutil](https://pypi.org/project/psutil/) installata sul core Greengrass.
+ <a name="conn-device-defender-req-cbor"></a>La libreria [cbor](https://pypi.org/project/cbor/) installata sul core Greengrass.

------

## Parametri del connettore
<a name="device-defender-connector-param"></a>

Questo connettore fornisce i seguenti parametri:

`SampleIntervalSeconds`  
Il numero di secondi tra ciascun ciclo di raccolta e produzione del rapporto dei parametri. Il valore minimo è di 300 secondi (5 minuti).  
Nome visualizzato nella AWS IoT console: Intervallo di **segnalazione delle metriche**  
Obbligatorio: `true`  
Tipo: `string`  
Schema valido: `^[0-9]*(?:3[0-9][0-9]|[4-9][0-9]{2}|[1-9][0-9]{3,})$`

`ProcDestinationPath-ResourceId`  
L'ID della risorsa del volume `/proc`.  
Al connettore è concesso l'accesso in sola lettura alla risorsa.
Nome visualizzato nella AWS IoT console: **Resource for /proc directory**  
Obbligatorio: `true`  
Tipo: `string`  
Schema valido: `[a-zA-Z0-9_-]+`

`ProcDestinationPath`  <a name="param-ProcDestinationPath"></a>
Il percorso di destinazione della risorsa del volume `/proc`.  
Nome visualizzato nella AWS IoT console: **percorso di destinazione della risorsa /proc**  
Obbligatorio: `true`  
Tipo: `string`  
Schema valido: `\/[a-zA-Z0-9_-]+`

### Esempio di creazione di un connettore (AWS CLI)
<a name="device-defender-connector-create"></a>

Il seguente comando CLI crea un `ConnectorDefinition` con una versione iniziale che contiene il connettore Device Defender.

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

**Nota**  
La funzione Lambda in questo connettore ha un ciclo di vita di [lunga durata](lambda-functions.md#lambda-lifecycle).

**Nella AWS IoT Greengrass console, puoi aggiungere un connettore dalla pagina Connettori del gruppo.** Per ulteriori informazioni, consulta [Nozioni di base sui connettori Greengrass (console)](connectors-console.md).

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

Questo connettore non accetta messaggi MQTT come dati di input.

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

Questo connettore pubblica le metriche di sicurezza AWS IoT Device Defender come dati di output.

<a name="topic-filter"></a>**Filtro argomento in sottoscrizione**  
`$aws/things/+/defender/metrics/json`  
Questa è la sintassi dell'argomento prevista. AWS IoT Device Defender Il connettore sostituisce il carattere jolly `+` con il nome del dispositivo (ad esempio, `$aws/things/thing-name/defender/metrics/json`).

**Output di esempio**  
*Per i dettagli relativi ai rapporti sulle metriche, consulta le [specifiche del documento sulle metriche dei dispositivi](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec) nella Guida per gli sviluppatori.AWS IoT *  

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

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

Questo connettore è rilasciato ai sensi del contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

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

La tabella seguente descrive le modifiche apportate a ciascuna versione del connettore.


| Versione | Modifiche | 
| --- | --- | 
| 3 | <a name="upgrade-runtime-py3.7"></a>È stato aggiornato il runtime Lambda a Python 3.7, che modifica i requisiti di runtime. | 
| 2 | Correggere per ridurre l'eccessiva registrazione di log. | 
| 1 | Versione iniziale.  | 

<a name="one-conn-version"></a>Un gruppo Greengrass può contenere una sola versione del connettore alla volta. Per informazioni sull'aggiornamento di una versione del connettore, consulta [Aggiornamento delle versioni dei connettori](connectors.md#upgrade-connector-versions).

## Consulta anche
<a name="device-defender-connector-see-also"></a>
+ [Integrazione con servizi e protocolli tramite i connettori Greengrass](connectors.md)
+ [Nozioni di base sui connettori Greengrass (console)](connectors-console.md)
+ [Nozioni di base sui connettori Greengrass (CLI)](connectors-cli.md)
+ [Device Defender](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender.html) *nella Guida per gli sviluppatori AWS IoT *