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à.

# Tunneling sicuro
<a name="secure-tunneling-component"></a>

Con il `aws.greengrass.SecureTunneling` componente, è possibile stabilire una comunicazione bidirezionale sicura con un dispositivo principale Greengrass situato dietro firewall limitati.

Ad esempio, immagina di avere un dispositivo core Greengrass protetto da un firewall che vieta tutte le connessioni in entrata. Il tunneling sicuro utilizza MQTT per trasferire un token di accesso al dispositivo e quindi lo utilizza WebSockets per stabilire una connessione SSH al dispositivo tramite il firewall. Con questo tunnel AWS IoT gestito, puoi aprire la connessione SSH necessaria per il tuo dispositivo. *Per ulteriori informazioni sull'utilizzo del tunneling AWS IoT sicuro per la connessione a dispositivi remoti, consulta [AWS IoT Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) nella Developer Guide.AWS IoT *

Questo componente sottoscrive il broker di messaggi AWS IoT Core MQTT sull'`$aws/things/greengrass-core-device/tunnels/notify`argomento per ricevere notifiche di tunneling sicuro.

**Topics**
+ [Versioni](#secure-tunneling-component-versions)
+ [Tipo](#secure-tunneling-component-type)
+ [Sistema operativo](#secure-tunneling-component-os-support)
+ [Requisiti](#secure-tunneling-component-requirements)
+ [Dipendenze](#secure-tunneling-component-dependencies)
+ [Configurazione](#secure-tunneling-component-configuration)
+ [File di registro locale](#secure-tunneling-component-log-file)
+ [Licenze](#secure-tunneling-component-licenses)
+ [Utilizzo](#secure-tunneling-component-usage)
+ [Consulta anche](#secure-tunneling-component-see-also)
+ [Changelog](#secure-tunneling-component-changelog)

## Versioni
<a name="secure-tunneling-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 1.1.x
+ 1.0.x

## Tipo
<a name="secure-tunneling-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="secure-tunneling-component-os-support"></a>

Questo componente può essere installato solo sui dispositivi principali di Linux.

Architetture:
+ Arm v71
+ Arm v 8 () AArch64
+ x86\$164

## Requisiti
<a name="secure-tunneling-component-requirements"></a>

Questo componente ha i seguenti requisiti:
+ Almeno 32 MB di spazio su disco disponibile per il componente di tunneling sicuro. Questo requisito non include il software di base Greengrass o altri componenti in esecuzione sullo stesso dispositivo.
+ Sono disponibili almeno 16 MB di RAM per il componente di tunneling sicuro. Questo requisito non include il software di base Greengrass o altri componenti in esecuzione sullo stesso dispositivo. Per ulteriori informazioni, consulta [Controlla l'allocazione della memoria con le opzioni JVM](configure-greengrass-core-v2.md#jvm-tuning).
+ La versione 2.25 o superiore della GNU C Library (glibc) con un kernel Linux 3.2 o superiore è richiesta per la versione 1.0.12 e successive del componente di tunneling sicuro. Le versioni del sistema operativo e delle librerie che hanno superato la data di scadenza del supporto a lungo termine non sono supportate. È necessario utilizzare un sistema operativo e delle librerie con supporto a lungo termine.
+ Sia il sistema operativo che il runtime Java devono essere installati a 64 bit.
+ [Python](https://www.python.org/) 3.5 o successivo installato sul dispositivo principale Greengrass e aggiunto alla variabile di ambiente PATH.
+ `libcrypto.so.1.1`installato sul dispositivo principale Greengrass e aggiunto alla variabile di ambiente PATH.
+ Apri il traffico in uscita sulla porta 443 del dispositivo principale Greengrass.
+ Attiva il supporto per il servizio di comunicazione che desideri utilizzare per comunicare con il dispositivo principale Greengrass. Ad esempio, per aprire una connessione SSH al dispositivo, è necessario attivare SSH su quel dispositivo.

### Endpoint e porte
<a name="secure-tunneling-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `data.tunneling.iot.region.amazonaws.com`  | 443 | Sì |  Stabilisci tunnel sicuri.  | 

## Dipendenze
<a name="secure-tunneling-component-dependencies"></a>

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#secure-tunneling-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 1.0.19 – 1.1.3 ]

La tabella seguente elenca le dipendenze per le versioni da 1.0.19 a 1.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <3.0.0  | Flessibili | 

------
#### [ 1.0.18 ]

La tabella seguente elenca le dipendenze per la versione 1.0.18 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.13.0  | Flessibili | 

------
#### [ 1.0.16 – 1.0.17 ]

La tabella seguente elenca le dipendenze per le versioni da 1.0.16 a 1.0.17 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.12.0  | Flessibili | 

------
#### [ 1.0.14 – 1.0.15 ]

La tabella seguente elenca le dipendenze per le versioni da 1.0.14 a 1.0.15 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.11.0  | Flessibili | 

------
#### [ 1.0.11 – 1.0.13 ]

La tabella seguente elenca le dipendenze per le versioni 1.0.11 - 1.0.13 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.10.0  | Flessibili | 

------
#### [ 1.0.10 ]

La tabella seguente elenca le dipendenze per la versione 1.0.10 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.9.0  | Flessibili | 

------
#### [ 1.0.9 ]

La tabella seguente elenca le dipendenze per la versione 1.0.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.8.0  | Flessibili | 

------
#### [ 1.0.8 ]

La tabella seguente elenca le dipendenze per la versione 1.0.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.7.0  | Flessibili | 

------
#### [ 1.0.5 - 1.0.7 ]

La tabella seguente elenca le dipendenze per le versioni da 1.0.5 a 1.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.6.0  | Flessibili | 

------
#### [ 1.0.4 ]

La tabella seguente elenca le dipendenze per la versione 1.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.5.0  | Flessibili | 

------
#### [ 1.0.3 ]

La tabella seguente elenca le dipendenze per la versione 1.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.4.0  | Flessibili | 

------
#### [ 1.0.2 ]

La tabella seguente elenca le dipendenze per la versione 1.0.2 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.3.0  | Flessibili | 

------
#### [ 1.0.1 ]

La tabella seguente elenca le dipendenze per la versione 1.0.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.0 <2.2.0  | Flessibili | 

------
#### [ 1.0.0 ]

La tabella seguente elenca le dipendenze per la versione 1.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) |  >=2.0.3 <2.1.0  | Flessibili | 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="secure-tunneling-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`OS_DIST_INFO`  
(Facoltativo) Il sistema operativo del dispositivo principale. Per impostazione predefinita, il componente tenta di identificare automaticamente il sistema operativo in esecuzione sul dispositivo principale. Se il componente non si avvia con il valore predefinito, utilizzate questo valore per specificare il sistema operativo. Per un elenco dei sistemi operativi supportati per questo componente, vedere[Requisiti per il dispositivo](greengrass-nucleus-component.md#greengrass-v2-requirements).  
Questo valore può essere uno dei seguenti:`auto`,`ubuntu`,`amzn2`,`raspberrypi`.  
Impostazione predefinita: `auto`

`accessControl`  
(Facoltativo) L'oggetto che contiene la [politica di autorizzazione](interprocess-communication.md#ipc-authorization-policies) che consente al componente di sottoscrivere l'argomento delle notifiche di tunneling sicuro.   
Non modificate questo parametro di configurazione se la distribuzione è destinata a un gruppo di oggetti. Se la distribuzione riguarda un singolo dispositivo core e desideri limitarne l'abbonamento all'argomento del dispositivo, specifica il nome dell'oggetto del dispositivo principale. Nel `resources` valore della politica di autorizzazione del dispositivo, sostituisci la wildcard dell'argomento MQTT con il nome dell'oggetto del dispositivo. 

```
{
  "aws.greengrass.ipc.mqttproxy": {
    "aws.iot.SecureTunneling:mqttproxy:1": {
      "policyDescription": "Access to tunnel notification pubsub topic",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "$aws/things/+/tunnels/notify"
      ]
    }
  }
}
```

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di consentire a questo componente di aprire tunnel sicuri su un dispositivo principale denominato **MyGreengrassCore** che esegue Ubuntu.  

```
{
  "OS_DIST_INFO": "ubuntu",
  "accessControl": {
    "aws.greengrass.ipc.mqttproxy": {
      "aws.iot.SecureTunneling:mqttproxy:1": {
        "policyDescription": "Access to tunnel notification pubsub topic",
        "operations": [
          "aws.greengrass#SubscribeToIoTCore"
        ],
        "resources": [
          "$aws/things/MyGreengrassCore/tunnels/notify"
        ]
      }
    }
  }
}
```

## File di registro locale
<a name="secure-tunneling-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

```
/greengrass/v2/logs/aws.greengrass.SecureTunneling.log
```

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` con il percorso della cartella AWS IoT Greengrass principale.

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.SecureTunneling.log
  ```

## Licenze
<a name="secure-tunneling-component-licenses"></a>

Questo componente include i seguenti software/licenze di terze parti:
+ [AWS IoT Device Client /Apache](https://github.com/awslabs/aws-iot-device-client) License 2.0
+ [SDK per dispositivi AWS IoT per Java](https://github.com/aws/aws-greengrass-core-sdk-java/)/Apache License 2.0
+ [Licenza gson/Apache](https://github.com/google/gson) 2.0
+ [log4j /Apache](https://logging.apache.org/log4j/2.x/) Licenza 2.0
+ [slf4j /Apache Licenza 2.0](http://www.slf4j.org/)

## Utilizzo
<a name="secure-tunneling-component-usage"></a>

Per utilizzare il componente di tunneling sicuro sul tuo dispositivo, procedi come segue:

1. Implementa il componente di tunneling sicuro sul tuo dispositivo.

1. Apri la [AWS IoT console](https://console.aws.amazon.com/iot). **Dal menu a sinistra, scegli **Azioni remote**, quindi scegli Tunnel sicuri.**

1. Crea un tunnel per il tuo dispositivo Greengrass. 

1. Scarica il token di accesso sorgente.

1. Usa il proxy locale con il token di accesso sorgente per connetterti alla tua destinazione. Per ulteriori informazioni, consulta [Come utilizzare il proxy locale](https://docs.aws.amazon.com/iot/latest/developerguide/how-use-local-proxy.html) nella *Guida per gli AWS IoT sviluppatori*.

## Consulta anche
<a name="secure-tunneling-component-see-also"></a>
+ [AWS IoT tunneling sicuro nella Developer](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) *Guide AWS IoT *
+ [Come usare il proxy locale](https://docs.aws.amazon.com/iot/latest/developerguide/how-use-local-proxy.html) *nella Developer Guide AWS IoT *

## Changelog
<a name="secure-tunneling-component-changelog"></a>

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


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.1.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.1.2  |   Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.19  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  Se utilizzate il proxy locale Secure Tunneling come client di origine del tunnel, non aggiornate il componente a questa versione prima di aver aggiornato anche il proxy locale alla versione 3.1.1 o successiva.   | 
|  1.0.18  | Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. | 
|  1.0.17  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.16  | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
|  1.0.15  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.14  | Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. | 
|  1.0.13  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.12  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.11  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  1.0.10  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  1.0.9  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  1.0.8  |  Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.  | 
|  1.0.7  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/secure-tunneling-component.html)  | 
|  1.0.6  |  Questa versione contiene correzioni di bug.  | 
|  1.0.5  |  Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.  | 
|  1.0.4  |  Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.  | 
|  1.0.3  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  1.0.2  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  1.0.1  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  1.0.0  |  Versione iniziale.  |