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à. # Lavorare con AWS IoT in AWS Toolkit for Visual Studio Code AWS IoT in AWS Toolkit for Visual Studio Code consente di interagire con il AWS IoT servizio, riducendo al minimo le interruzioni del flusso di lavoro in VS Code. Questa guida per l'utente ha lo scopo di aiutarti a iniziare a utilizzare le funzionalità del AWS IoT servizio disponibili in. AWS Toolkit for Visual Studio Code Per ulteriori informazioni sul AWS IoT servizio, consulta la guida per sviluppatori [What is AWS IoT?](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html) ## AWS IoT prerequisiti Per iniziare a utilizzare AWS IoT Toolkit for VS Code, assicurati che AWS il tuo account e VS Code soddisfino i requisiti indicati in queste guide: + Per i requisiti dell' AWS account e le autorizzazioni AWS utente specifici per il AWS IoT servizio, consulta la guida per sviluppatori [Getting Started with AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html). + Per i requisiti specifici di Toolkit for VS Code, consulta [la guida per l'utente di Configurazione del Toolkit for](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setting-up.html) VS Code. ## AWS IoT Cose AWS IoT connette i dispositivi a servizi e risorse AWS cloud. Puoi connettere i tuoi dispositivi AWS IoT utilizzando oggetti chiamati **oggetti**. Un oggetto è una rappresentazione di un'entità logica o un dispositivo specifico. Può trattarsi di un dispositivo fisico o un sensore, ad esempio una lampadina o un interruttore su un muro. Per ulteriori informazioni su questo argomento AWS IoT , consulta la guida per sviluppatori [Gestire i dispositivi con AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html). ### Gestire AWS IoT le cose Il Toolkit for VS Code ha diverse funzionalità che rendono più efficiente AWS IoT la gestione degli oggetti. Questi sono i modi in cui puoi usare il toolkit VS Code per gestire le tue AWS IoT cose: + [Create a thing](#thing-create) + [Attach a certificate to a thing](#thing-certificate-attach) + [Detach a certificate from a thing](#thing-certificate-detach) + [Delete a thing](#thing-delete) **Per creare un oggetto** 1. **Da AWS Explorer, espandi l'intestazione del servizio **IoT** e seleziona contestualmente (fai clic con il pulsante destro del mouse) Cose.** 1. Scegliete **Crea oggetto** dal menu contestuale per aprire una finestra di dialogo. 1. Segui la richiesta inserendo un nome per il tuo oggetto IoT nel campo **Thing Name**. 1. Al termine, nella sezione Oggetto sarà visibile l'**icona di un **oggetto**** seguita dal nome specificato. **Collegamento di un certificato a un oggetto** 1. Da AWS Explorer, espandi la sezione dei servizi **IoT**. 1. Nella sottosezione **Oggetti**, individua l'**elemento** a cui alleghi il certificato. 1. Seleziona contestualmente (fai clic con il pulsante destro del mouse) sull'**oggetto** e scegli **Allega certificato** dal menu contestuale, per aprire un selettore di input con un elenco dei tuoi certificati. 1. Dall'elenco, scegli l'**ID del certificato** che corrisponde al certificato che desideri allegare al tuo oggetto. 1. Al termine, il certificato è accessibile in AWS Explorer, come elemento dell'elemento a cui lo hai allegato. **Annullamento del collegamento di un certificato a un oggetto** 1. Da AWS Explorer, espandi la sezione dei servizi **IoT** 1. Nella sottosezione **Things** (Oggetti), trova l'**oggetto** per cui annullare il collegamento del certificato. 1. Seleziona contestualmente (fai clic con il pulsante destro del mouse) sull'**oggetto** e scegli **Scollega certificato dal** menu contestuale. 1. **Al termine, il certificato separato non verrà più visualizzato sotto quell'elemento in AWS Explorer, ma sarà comunque accessibile dalla sottosezione Certificati.** **Eliminazione di un oggetto** 1. Da AWS Explorer, espandi la sezione dei servizi **IoT**. 1. Nella sottosezione **Oggetti**, individua l'**elemento** che desideri eliminare. 1. Fate clic con il pulsante destro del mouse sull'oggetto e scegliete **Elimina oggetto** dal menu contestuale per eliminarlo. 1. **Al termine, l'elemento eliminato non sarà più disponibile nella sottosezione Oggetti.** **Nota** Nota: è possibile eliminare solo un elemento a cui non è allegato un certificato. ## AWS IoT certificati I certificati sono un modo comune per creare una connessione sicura tra i AWS IoT servizi e i dispositivi. I certificati X.509 sono certificati digitali che usano lo standard di infrastruttura a chiave pubblica X.509 per associare una chiave pubblica a un'identità contenuta in un certificato. Per ulteriori informazioni sui AWS IoT certificati, consulta la guida per sviluppatori [Authentication (IoT)](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html). ### Gestione dei certificati Il toolkit VS Code offre una varietà di modi per gestire i AWS IoT certificati, direttamente da AWS Explorer. + [Create a certificate](#cert-create) + [Change a certificate status](#cert-status) + [Attach a policy to a certificate](#cert-attach-policy) + [Delete a certificate](#cert-delete) **Per creare un certificato AWS IoT** È possibile utilizzare un certificato X.509 per connettersi con l'istanza di. AWS IoT 1. **Da AWS Explorer, espandi la sezione dei servizi **IoT** e seleziona contestualmente (fai clic con il pulsante destro del mouse) Certificati.** 1. Scegli **Crea certificato** dal menu contestuale per aprire una finestra di dialogo. 1. Seleziona una directory nel file system locale per salvare la coppia di chiavi RSA e il certificato X.509. **Nota** I nomi di file predefiniti contengono l'ID del certificato come prefisso. Solo il certificato X.509 viene archiviato nel tuo AWS account, tramite il servizio. AWS IoT La coppia di chiavi RSA può essere emessa una sola volta, salvala in una posizione sicura nel file system quando ti viene richiesto. Se al momento non è possibile salvare il certificato o la key pair nel file system, il AWS Toolkit elimina il certificato dal tuo AWS account. **Modifica dello stato di un certificato** Lo stato di un singolo certificato viene visualizzato accanto al relativo ID in AWS Explorer e può essere impostato su: attivo, inattivo o revocato. **Nota** Il certificato deve avere uno stato **attivo** prima di poterlo utilizzare per connettere il dispositivo AWS IoT al servizio. Un certificato **inattivo** può essere attivato, indipendentemente dal fatto che sia stato disattivato in precedenza o che sia inattivo per impostazione predefinita. Un certificato **revoked** (revocato) non può essere riattivato. 1. Da AWS Explorer, espandi la sezione dei servizi **IoT**. 1. Nella sottosezione **Certificati**, individua il certificato che desideri modificare. 1. Seleziona contestualmente (fai clic con il pulsante destro del mouse) sul certificato per aprire un menu contestuale che mostra le opzioni di modifica dello stato disponibili per quel certificato. + Se un certificato ha lo stato **inactive** (inattivo), scegli **activate** (attiva) per modificare lo stato in **active** (attivo). + Se un certificato ha lo stato **active** (attivo), scegli **deactivate** (disattiva) per modificare lo stato in **inactive** (inattivo). + Se un certificato ha lo stato **active** (attivo) o **inactive** (inattivo), scegli **revoke** (revoca) per modificare lo stato in **revoked** (revocato). **Nota** **Ognuna di queste azioni di modifica dello stato è disponibile anche se selezioni un certificato allegato a un oggetto mentre è visualizzato nella sottosezione Oggetti.** **Collegamento di una policy IoT a un certificato** 1. Da AWS Explorer, espandi la sezione dei servizi **IoT**. 1. Nella sottosezione **Certificati**, individua il certificato che desideri modificare. 1. Seleziona contestualmente (fai clic con il pulsante destro del mouse) sul certificato e scegli **Allega politica** dal menu contestuale per aprire un selettore di input con un elenco delle politiche disponibili. 1. Scegli la politica che desideri allegare al certificato. 1. Al termine, la politica selezionata verrà aggiunta al certificato come voce di sottomenu. **Annullamento del collegamento di una policy IoT a un certificato** 1. Da AWS Explorer, espandi la sezione dei servizi **IoT**. 1. Nella sottosezione **Certificati**, individua il certificato che desideri modificare. 1. Espandi il certificato e individua la politica che desideri scollegare. 1. Seleziona contestualmente (fai clic con il pulsante destro del mouse) sulla politica e scegli Scollega dal menu **contestuale**. 1. **Al termine, la politica non sarà più un elemento accessibile dal certificato, ma sarà disponibile nella sottosezione Policy.** **Eliminazione di un certificato** 1. Da AWS Explorer, espandi la rubrica dei servizi **IoT**. 1. Nella sottosezione **Certificati**, individua il certificato che desideri eliminare. 1. Seleziona contestualmente (fai clic con il pulsante destro del mouse) sul certificato e scegli **Elimina certificato** dal menu contestuale. **Nota** Non è possibile eliminare un certificato se è collegato a un oggetto o se il suo stato è attivo. È possibile eliminare un certificato a cui sono collegate policy. ## AWS IoT politiche AWS IoT Le politiche di base sono definite tramite documenti JSON, ciascuno contenente una o più dichiarazioni politiche. Le policy definiscono in che modo AWS IoT e in che modo i dispositivi possono interagire tra loro. AWS Per ulteriori informazioni su come creare un documento di policy, consulta la guida per sviluppatori [IoT Polices](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html). **Nota** Le policy denominate sono suddivise in versioni in modo da poterle ripristinare. In The AWS Explorer, le tue **policy** IoT sono elencate nella sottosezione Policies, nel servizio IoT. È possibile visualizzare le diverse versioni di una policy espandendola. La versione predefinita è contrassegnata da un asterisco. ### Gestione delle policy Il Toolkit for VS Code offre diversi modi per gestire AWS IoT le politiche di servizio. Questi sono i modi in cui puoi gestire o modificare le tue politiche direttamente da AWS Explorer in VS Code: + [Create a policy](#policy-create) + [Upload a new policy version](#policy-version-upload) + [Edit a policy version](#policy-version-edit) + [Change the policy version defualt](#policy-version-default) + [Change the policy version defualt](#policy-delete) **Per creare una AWS IoT politica** **Nota** È possibile creare una nuova policy da AWS Explorer, ma il documento JSON che definisce la policy deve già esistere nel file system. 1. Da AWS Explorer, espandi la sezione dei servizi **IoT**. 1. Seleziona contestualmente (fai clic con il pulsante destro del mouse) sulla sottosezione **Politiche** e scegli **Crea politica dal documento** per aprire il campo di immissione **Nome della politica**. 1. Immetti un nome e segui le istruzioni per aprire una finestra di dialogo da cui potrai selezionare un documento JSON dal tuo file system. 1. Scegli il file JSON che contiene le definizioni delle tue policy, la policy sarà disponibile nell' AWS explorer una volta completata. **Per caricare una nuova versione AWS IoT della politica** È possibile creare una nuova versione di una policy caricando un documento JSON nella policy. **Nota** Il nuovo documento JSON deve essere presente nel file system per creare una nuova versione utilizzando Explorer. AWS 1. Da AWS Explorer, espandi la sezione dei servizi **IoT**. 1. **Espandi la sottosezione Politiche** per visualizzare le tue AWS IoT politiche 1. Seleziona contestualmente (fai clic con il pulsante destro del mouse) la politica che desideri aggiornare e scegli **Crea nuova versione** dal documento. 1. Quando si apre la finestra di dialogo, scegli il file JSON che contiene gli aggiornamenti delle definizioni per le tue policy. 1. La nuova versione sarà accessibile dalla tua politica in Explorer. AWS **Per modificare una versione AWS IoT della politica** Un documento di policy può essere aperto e modificato utilizzando VS Code. Al termine della modifica del documento, è possibile salvarlo nel file system. Quindi, puoi caricarlo sul tuo AWS IoT servizio da AWS Explorer. 1. Da AWS Explorer, espandi la sezione dei servizi **IoT**. 1. **Espandi la sottosezione Politiche** e individua la politica che desideri aggiornare. **Crea policy from document** per aprire il campo di immissione **Policy Name**. 1. Espandi la politica che desideri aggiornare, quindi seleziona contestualmente (fai clic con il pulsante destro del mouse) la versione della politica che desideri modificare. 1. Scegli **Visualizza** dal menu contestuale per aprire la versione della politica in VS Code 1. Quando il documento di policy viene aperto, apporta e salva le modifiche desiderate. **Nota** A questo punto, le modifiche apportate alla politica vengono salvate solo nel file system locale. Per aggiornare la versione e tenerne traccia con AWS Explorer, ripeti i passaggi descritti nella [Upload a new policy version](#policy-version-upload) procedura. **Selezione di una nuova versione predefinita della policy** 1. Da AWS Explorer, espandi la sezione dei servizi **IoT**. 1. Espandi la sottosezione **Policies** (Policy) e individua la policy da aggiornare. 1. Espandi la politica che desideri aggiornare, quindi seleziona contestualmente (fai clic con il pulsante destro del mouse) la versione della politica che desideri impostare e scegli **Imposta come predefinito**. 1. Al termine, la nuova versione predefinita selezionata avrà una stella accanto ad essa. **Per eliminare policy** **Nota** Prima di poter eliminare una politica o una versione della politica, è necessario soddisfare alcune condizioni. Non è possibile eliminare una politica se è allegata a un certificato. Non è possibile eliminare una politica se contiene versioni non predefinite. Non è possibile eliminare la versione predefinita di una politica a meno che non venga selezionata una nuova versione predefinita o non venga eliminata l'intera politica. Prima di poter eliminare un'intera politica, è necessario eliminare tutte le versioni non predefinite di tale policy. 1. Da AWS Explorer, espandi la sezione dei servizi **IoT**. 1. Espandi la sottosezione **Policies** (Policy) e individua la policy da aggiornare. 1. **Espandi la politica che desideri aggiornare, quindi seleziona contestualmente (fai clic con il pulsante destro del mouse) la versione della politica che desideri eliminare e scegli Elimina.** 1. Quando una versione viene eliminata, non sarà più visibile da Explorer. 1. Quando l'unica versione rimasta per una policy è quella predefinita, puoi selezionare contestualmente (con il pulsante destro del mouse) la policy principale e scegliere **Elimina per eliminarla**.