Lavorare con AWS IoT in AWS Toolkit for Visual Studio Code

AWS IoTnelAWS Toolkit for Visual Studio Codeconsente di interagire conAWS IoTservizio, riducendo al minimo le interruzioni del flusso di lavoro in VS Code. Questa guida per l'utente è pensata per essere utili per iniziare a utilizzare laAWS IoTcaratteristiche del servizio che sono disponibili inAWS Toolkit for Visual Studio Code. Ulteriori informazioni suAWS IoTservice, consulta la guida per gli sviluppatoriChe cos'èAWS IoT?

Prerequisiti di AWS IoT

Per iniziare a usareAWS IoTda Toolkit for VS Code, assicurati cheAWSaccount e VS Code soddisfano i requisiti di queste guide:

• PerAWSrequisiti dell'account eAWSautorizzazioni utente specifiche perAWS IoTservice, vedere ilNozioni di base suAWS IoTCoreGuida per sviluppatori.

• Per i requisiti specifici di Toolkit for VS Code, consultare ilConfigurazione del Toolkit for VS CodeGuida per l'utente.

AWS IoTOggetti

AWS IoTcollegamento di dispositiviAWSservizi e risorse cloud. Puoi connettere i tuoi dispositivi aAWS IoTusando oggetti chiamaticose. 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. Ulteriori informazioni suAWS IoTcose, consulta la guida per gli sviluppatoriGestione di dispositivi conAWS IoT.

GestioneAWS IoTcose

Il Toolkit for VS Code ha diverse funzionalità che rendono il tuoAWS IoTgestione delle cose più efficiente. Questi sono i modi in cui puoi utilizzare il toolkit VS Code per gestire il tuoAWS IoTthings:

• Create a thing

• Attach a certificate to a thing

• Detach a certificate from a thing

• Delete a thing

Per creare un oggetto

1. Da aAWSExplorer, espandiIoTintestazione del servizio e contestuale (pulsante destro del mouse)Oggetti.

2. ScegliereCreazione di oggettidal menu contestuale per aprire una finestra di dialogo.

3. Segui la richiesta inserendo un nome per il tuo oggetto IoT nellaNome oggetto.

4. Una volta completata questa operazione, un.seguito dal nome specificato sarà visibile nellaOggettosezione.

Collegamento di un certificato a un oggetto

1. Da aAWSExplorer, espandiIoTsezione di servizio.

2. InOggettisottosezione, individuare ilcosadove si allega il certificato.

3. contestuale (pulsante destro del mouse)cosae scegliCollegamento di un certificatodal menu contestuale, per aprire un selettore di input con un elenco dei tuoi certificati.

4. Dall'elenco, scegliere laID del certificatoche corrisponde al certificato che vuoi allegare alla tua cosa.

5. Al termine, il certificato è accessibile nellaAWSexplorer, come elemento della cosa a cui l'hai attaccata.

Scollegamento di un certificato da un oggetto

1. Da aAWSExplorer, espandiIoTsezione servizi

2. NellaOggettisottosezione, individuare ilcosada cui si desidera distaccare un certificato.

3. contestuale (pulsante destro del mouse)cosae scegliScollegare il certificatodal menu contestuale.

4. Una volta completata questa operazione, il certificato distaccato non verrà più visualizzato sotto quella cosa nellaAWSExplorer, ma sarà comunque accessibile dalCertificatisottosezione.

Per eliminare un oggetto

1. Da aAWSExplorer, espandiIoTsezione di servizio.

2. NellaOggettisottosezione, individuare ilcosache desideri eliminare.

3. contestuale: seleziona (pulsante destro del mouse) e scegliEliminazione di un oggettodal menu contestuale per eliminarlo.

4. Al termine, l'elemento eliminato non sarà più disponibile dalOggettisottosezione.

   Nota

   Nota: È possibile eliminare solo un elemento a cui non è allegato un certificato.

AWS IoTCertificati

I certificati sono un modo comune per creare una connessione sicura traAWS IoTservizi e 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. Ulteriori informazioni suAWS IoTcertificati, consulta la guida per gli sviluppatoriAutenticazione (IoT).

Gestione dei certificati

Il toolkit VS Code offre una varietà di modi per gestire il tuoAWS IoTcertificati, direttamente dalAWSCost.

• Create a certificate

• Change a certificate status

• Attach a policy to a certificate

• Delete a certificate

Per creare unAWS IoTcertificato

È possibile utilizzare un certificato X.509 per connettersi con l'istanza diAWS IoT.

1. Da aAWSExplorer, espandiIoTsezione servizio e contestuale (pulsante destro del mouse)Certificati.

2. ScegliereCreazione di un certificatodal menu contestuale per aprire una finestra di dialogo.

3. Selezionare una directory nel file system locale in cui salvare la key pair 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 con ilAWSaccount, tramite ilAWS IoTserviceServizio.

   • La key pair RSA può essere emessa una sola volta, salvandola in una posizione sicura nel file system quando richiesto.

   • Se il certificato o la key pair non possono essere salvati nel tuo file system in questo momento, alloraAWSToolkit elimina il certificato dal tuoAWSconto.

Per modificare lo stato di un certificato

Lo stato di un certificato individuale viene visualizzato accanto al suo ID nellaAWSExplorer e può essere impostato su: attivo, inattivo o revocato.

Nota

• Il certificato richiede unattivostato prima di poterlo utilizzare per collegare il dispositivo alAWS IoTserviceServizio.

• Un recordinattivoil certificato può essere attivato, indipendentemente dal fatto che sia stato disattivato in precedenza o sia inattivo per impostazione predefinita.

• Un certificato che è statorevocatanon può essere riattivato.

1. Da aAWSExplorer, espandiIoTsezione di servizio.

2. NellaCertificatisottosezione, individuare il certificato da modificare.

3. Contesto: selezionare (fare clic con il pulsante destro del mouse) sul certificato per aprire un menu di scelta rapida che visualizza le opzioni di modifica dello stato disponibili per quel certificato

• Se un certificato ha lo statoinattivo, scegliattivatoper modificare lo stato di suattivo.

• Se un certificato ha lo statoattivo, sceglidisattivareper modificare lo stato di suinattivo.

• Se un certificato ha uno dei dueattivooinattivostatus, sceglirevocareper modificare lo stato di surevocata.

Nota

Ognuna di queste azioni di modifica dello stato è disponibile anche se si seleziona un certificato allegato a un oggetto mentre è visualizzato nellaOggettisottosezione.

Per allegare una policy IoT a un certificato

1. Da aAWSExplorer, espandiIoTsezione di servizio.

2. NellaCertificatisottosezione, individuare il certificato da modificare.

3. contestuale: selezionare (pulsante destro del mouse) e scegliereCollegamento di policydal menu contestuale, per aprire un selettore di input con un elenco delle politiche disponibili.

4. Scegli la policy da collegare al certificato.

5. Al termine, il criterio selezionato verrà aggiunto al certificato come voce di sottomenu.

Per scollegare una policy IoT da un certificato

1. Da aAWSExplorer, espandiIoTsezione di servizio.

2. NellaCertificatisottosezione, individuare il certificato da modificare.

3. Espandi il certificato e individua la policy da scollegare.

4. contestuale: selezionare (pulsante destro del mouse) e scegliereDistaccadal menu contestuale.

5. Al termine, la politica non sarà più un elemento accessibile dal tuo certificato, ma sarà disponibile dalPolicysottosezione.

Eliminazione di un certificato

1. Da aAWSExplorer, espandiIoTSMS?.

2. NellaCertificatisottosezione, individuare il certificato da eliminare.

3. contestuale: selezionare (pulsante destro del mouse) e scegliereEliminazione di un certificatodal menu contestuale.

   Nota

   Non puoi eliminare un certificato se è collegato a un oggetto o ha uno stato attivo. È possibile eliminare un certificato a cui sono allegati criteri.

Policy AWS IoT

AWS IoTLe policy principali sono definite tramite documenti JSON, ognuno dei quali contiene una o più dichiarazioni di policy. Le politiche definiscono comeAWS IoT,AWSe il dispositivo può interagire tra loro. Per ulteriori informazioni su come creare un documento policy, consulta la guida per gli sviluppatoriPolicy IoT.

Nota

Le policy denominate hanno più versioni in modo da poterle ripristinare. NelAWSExplorer, le tue politiche IoT sono elencate nellaPolicysottosezione, nel servizio IoT. È possibile visualizzare le versioni dei criteri espandendo un criterio. La versione predefinita è indicata da un asterisco.

Gestione di policy

Toolkit for VS Code offre vari modi per gestire i tuoiAWS IoTpolicy di servizio. Questi sono modi in cui è possibile gestire o modificare le politiche direttamente dalAWSExplorer nel codice VS:

• Create a policy

• Upload a new policy version

• Edit a policy version

• Change the policy version defualt

• Change the policy version defualt

Per creare una policy AWS IoT

Nota

Puoi creare una nuova policy dallaAWSExplorer, ma il documento JSON che definisce la politica deve già esistere nel tuo file system.

1. Da aAWSExplorer, espandiIoTsezione di servizio.

2. contestuale (pulsante destro del mouse)Policysottosezione e scegliCrea criterio da un documento, per aprireNome policycampo di input.

3. Inserisci un nome e segui le istruzioni per aprire una finestra di dialogo che ti chiede di selezionare un documento JSON dal tuo file system.

4. Scegliere il file JSON che contiene le definizioni dei criteri, la politica sarà disponibile nellaAWSexplorer quando questo è completo.

Per caricare un nuovoAWS IoTversione della policy

È 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 ilAWSCost.

1. Da aAWSExplorer, espandiIoTsezione di servizio.

2. Espandere laPolicysottosezione per visualizzare i tuoiAWS IoTnorme

3. contestuale: selezionare (pulsante destro del mouse) la policy da aggiornare e scegliereCrea nuova versione da Document.

4. Quando si apre la finestra di dialogo, scegliere il file JSON che contiene gli aggiornamenti alle definizioni dei criteri.

5. La nuova versione sarà accessibile dalla tua politica nellaAWSCost.

Per modificare unAWS IoTversione della policy

Un documento politico può essere aperto e modificato utilizzando VS Code. Al termine della modifica del documento, puoi salvarlo nel file system. Quindi puoi caricarlo sulAWS IoTservizio dalAWSCost.

1. Da aAWSExplorer, espandiIoTsezione di servizio.

2. Espandere laPolicysottosezione e individuare la policy da aggiornare.Crea criterio da un documentoper aprireNome policycampo di input.

3. Espandere il criterio che si desidera aggiornare e quindi selezionare contestualmente (fare clic con il pulsante destro del mouse) la versione del criterio che si desidera modificare.

4. ScegliereVisualizzazionedal menu di scelta rapida per aprire la versione della politica in VS Code

5. All'apertura del documento di policy, apportare e salvare le modifiche desiderate.

   Nota

   A questo punto, le modifiche apportate alla politica vengono salvate solo nel file system locale. Per aggiornare la versione e seguirla conAWSExplorer, ripeti i passaggi descritti nellaUpload a new policy versionprocedura.

Per selezionare una nuova versione del criterio (default)

1. Da aAWSExplorer, espandiIoTsezione di servizio.

2. Espandere laPolicysottosezione e individuare la policy da aggiornare.

3. Espandere il criterio che si desidera aggiornare e quindi selezionare contestualmente (fare clic con il pulsante destro del mouse) la versione del criterio che si desidera impostare e scegliereImposta come impostazione predefinita.

4. Al termine, la nuova versione predefinita selezionata avrà una stella accanto.

Per eliminare policy

Nota

Prima di poter eliminare una policy o una versione di policy, ci sono delle condizioni che devono essere soddisfatte.

• Non puoi eliminare una policy se è allegata a un certificato.

• Non è possibile eliminare un criterio se dispone di versioni non predefinite.

• Non è possibile eliminare la versione predefinita di un criterio a meno che non sia selezionata una nuova versione predefinita o non venga eliminata l'intera policy.

• Prima di poter eliminare un intero criterio, è necessario eliminare prima tutte le versioni non predefinite di tale criterio.

1. Da aAWSExplorer, espandiIoTsezione di servizio.

2. Espandere laPolicysottosezione e individuare la policy da aggiornare.

3. Espandere il criterio che si desidera aggiornare e quindi selezionare contestualmente (fare clic con il pulsante destro del mouse) la versione del criterio che si desidera eliminare e scegliereElimina.

4. Quando una versione viene eliminata, non sarà più visibile da Explorer.

5. Quando l'unica versione rimasta per un criterio è quella predefinita, è possibile selezionare contestualmente (fare clic con il pulsante destro del mouse) sulla politica principale e scegliereEliminaper eliminarlo.