Lavorare con AWS IoT un AWS Cloud9 IDE

Con AWS IoT AWS Cloud9 IDE, puoi interagire con il AWS IoT servizio riducendo al minimo le interruzioni del flusso di lavoro. AWS Cloud9 Questa guida spiega come iniziare a utilizzare le funzionalità AWS IoT di servizio disponibili nell' AWS Cloud9 IDE. Per ulteriori informazioni, consulta Cos'è AWS IoT? nella Guida per gli sviluppatori AWS IoT .

AWS IoT prerequisiti

Per iniziare a utilizzare AWS IoT in AWS Cloud9 IDE, assicurati che la tua Account AWS AWS Cloud9 configurazione soddisfi tutti i requisiti. Per informazioni sui Account AWS requisiti e le autorizzazioni AWS utente specifici del AWS IoT servizio, consulta la Guida introduttiva a AWS IoT Core nella Guida per gli AWS IoT sviluppatori.

AWS IoT Cose

AWS IoT connette dispositivi Servizi AWS e AWS risorse. 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 AWS IoT , consulta Managing devices with AWS IoT nella AWS IoT Developer Guide.

Gestire AWS IoT le cose

L' AWS Cloud9 IDE ha diverse funzionalità che rendono efficiente la gestione degli oggetti. Per gestire AWS IoT le tue cose, segui questi passaggi:

• Create a thing

• Attach a certificate to a thing

• Detach a certificate from a thing

• Delete a thing

Per creare un oggetto

1. Da AWS Explorer, espandi la sezione dei servizi IoT.

2. Apri il menu contestuale (pulsante destro del mouse) per l'oggetto, quindi seleziona Create Thing (Crea oggetto).

3. Immetti un nome per l'oggetto nel campo Thing Name (Nome oggetto) e segui le istruzioni.

4. Al termine di questo passaggio, l'icona di un oggetto seguita dal nome specificato sarà visibile nella sezione Thing (Oggetto).

Collegamento di un certificato a un oggetto

1. Da AWS Explorer, espandi la sezione dei servizi IoT.

2. Nella sottosezione Things (Oggetti), individua l'oggetto a cui allegare il certificato.

3. Apri il menu contestuale (pulsante destro del mouse) relativo all'oggetto e scegli Attach Certificate (Allega certificato) da tale menu per aprire un selettore di input con un elenco dei tuoi certificati.

4. Nell'elenco, scegli l'ID corrispondente al certificato da allegare al tuo oggetto.

5. Una volta completato questo passaggio, il certificato è accessibile in AWS Explorer come elemento dell'oggetto a cui è stato allegato.

Annullamento del collegamento di un certificato a un oggetto

1. Da AWS Explorer, espandi la sezione dei servizi IoT.

2. Nella sottosezione Things (Oggetti), trova l'oggetto per cui annullare il collegamento del certificato.

3. Apri il menu contestuale (pulsante destro del mouse) per l'oggetto, quindi seleziona Attach Certificate (Allega certificato).

4. Una volta completato questo passaggio, il certificato separato non viene più visualizzato sotto l'oggetto in AWS Explorer. Tuttavia, è ancora accessibile dalla sottosezione Certificates (Certificati).

Eliminazione di un oggetto

1. Da AWS Explorer, espandi la sezione dei servizi IoT.

2. Nella sottosezione Things (Oggetti), trova l'oggetto da eliminare.

3. Apri il menu contestuale (pulsante destro del mouse) per l'oggetto, quindi seleziona Delete Thing (Elimina oggetto).

4. Una volta completato questo passaggio, l'oggetto eliminato non è più disponibile nella sottosezione Things (Oggetti).

   Nota

   Puoi eliminare solo oggetti a cui non sono allegati certificati.

AWS IoT certificati

I certificati sono un modo comune per creare una connessione sicura tra dispositivi e servizi AWS IoT . 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 Authentication (IoT) nella AWS IoT Developer Guide.

Gestione dei certificati

Il AWS toolkit offre diversi modi per gestire i AWS IoT certificati direttamente da AWS Explorer. Tali modi sono illustrati nei seguenti passaggi:

• Create a certificate

• Change a certificate status

• Attach a policy to a certificate

• Delete a certificate

Per creare un certificato AWS IoT

Un certificato X.509 viene utilizzato per connettersi con l'istanza di. AWS IoT

1. Da AWS Explorer, espandi la sezione del servizio IoT e apri (fai clic con il pulsante destro del mouse) Certificati.

2. Per aprire una finestra di dialogo, nel menu contestuale scegli Create Certificate (Crea certificato).

3. Per salvare la coppia di chiavi RSA e il certificato X.509, seleziona una directory nel file system locale.

   Nota

   • I nomi di file predefiniti contengono l'ID del certificato come prefisso.

   • Solo il certificato X.509 viene archiviato con il tuo Account AWS, tramite il AWS IoT servizio.

   • La coppia di chiavi RSA può essere emessa una sola volta, salvala in una posizione sicura nel file system quando ti viene richiesto.

   • Se il certificato o la key pair non possono essere salvati nel file system, il AWS Toolkit elimina il certificato dal tuo. Account AWS

Modifica dello stato di un certificato

Lo stato di un singolo certificato viene visualizzato accanto all'ID del certificato 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.

• È possibile attivare un certificato inactive (inattivo), 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.

2. Nella sottosezione Certificates (Certificati), individua il certificato da modificare.

3. Apri il menu contestuale (pulsante destro del mouse) per il certificato; verranno mostrate le opzioni di modifica dello stato 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 selezionando un certificato allegato a un oggetto mentre è mostrato nella sottosezione Things (Oggetti).

Collegamento di una policy IoT a un certificato

1. Da AWS Explorer, espandi la sezione dei servizi IoT.

2. Nella sottosezione Certificates (Certificati), individua il certificato da modificare.

3. Apri il menu contestuale (pulsante destro del mouse) per il certificato e scegli Attach Policy (Collega policy) per aprire un selettore di input con un elenco delle policy disponibili.

4. Scegli la policy da allegare al certificato.

5. Una volta completato questo passaggio, la policy selezionata viene 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.

2. Nella sottosezione Certificates (Certificati), individua il certificato da modificare.

3. Espandi il certificato e individua la policy per cui annullare il collegamento.

4. Apri il menu contestuale (pulsante destro del mouse) per la policy, quindi scegli Detach (Annulla collegamento) nel menu contestuale.

5. Una volta completato questo passaggio, la policy non è più accessibile dal certificato, ma continua a esserlo dalla sottosezione Policy.

Eliminazione di un certificato

1. Da AWS Explorer, espandi la rubrica dei servizi IoT.

2. Nella sottosezione Certificates (Certificati), individua il certificato da eliminare.

3. Apri il menu contestuale (pulsante destro del mouse) per il certificato e scegli Delete Certificate (Elimina certificato) nel 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. Ognuno deve includere almeno un'istruzione di policy. 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 Policy IoT nella Guida per gli sviluppatori di AWS IoT .

Nota

Le policy con assegnazione del nome dispongono di un controllo delle versioni, così da poter essere ripristinate. In AWS Explorer, le policy IoT sono elencate nella sottosezione Policies del AWS IoT servizio. È possibile visualizzare le diverse versioni di una policy espandendola. La versione predefinita è indicata da un asterisco (*).

Gestione delle policy

L' AWS Cloud9 IDE offre diversi modi per gestire le politiche di AWS IoT servizio. Questi sono i modi in cui puoi gestire o modificare le tue politiche direttamente da AWS Explorer in VS Code:

• 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 AWS IoT politica

Nota

È possibile creare una nuova politica 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.

2. Apri il menu contestuale (pulsante destro del mouse) per la sottosezione Policies (Policy) e, per aprire il campo di input Policy Name (Nome policy), scegli Create Policy from Document (Crea policy dal documento).

3. Immetti un nome e segui le istruzioni per aprire una finestra di dialogo da cui potrai selezionare un documento JSON dal tuo file system.

4. Scegli il file JSON che contiene le definizioni della policy. Al termine, la policy sarà disponibile in AWS Explorer.

Per caricare una nuova versione AWS IoT della policy

È possibile creare una nuova versione di una policy caricandovi un documento JSON.

Nota

Il nuovo documento JSON deve essere presente nel file system per creare una nuova versione utilizzando AWS Explorer.

1. Da AWS Explorer, espandi la sezione dei servizi IoT.

2. Espandi la sottosezione Policies (Policy) per vedere le policy AWS IoT .

3. Apri il menu contestuale (pulsante destro del mouse) per il documento da aggiornare, quindi scegli Create new version from Document (Crea nuova versione dal documento).

4. Quando si apre la finestra di dialogo, scegli il file JSON che contiene gli aggiornamenti delle definizioni per le tue policy.

   La nuova versione è accessibile dalla policy in AWS Explorer.

Per modificare una versione AWS IoT della policy

È possibile aprire e modificare un documento di policy utilizzando AWS Cloud9. Quando hai finito di modificare il documento, salvalo nel tuo file system. Quindi, caricalo sul tuo AWS IoT servizio da AWS Explorer.

1. Da AWS Explorer, espandi la sezione dei servizi IoT.

2. Espandi la sottosezione Policies (Policy) e individua la policy da aggiornare.

3. Per aprire Policy Name (Nome policy), scegli Create Policy from Document (Crea policy da documento).

4. Espandi la policy da aggiornare, quindi apri il menu contestuale (pulsante destro del mouse) per la versione della policy da modificare.

5. Per aprire la versione della policy in AWS Cloud9, scegli Visualizza dal menu contestuale per aprire la versione della policy.

6. Quando il documento di policy viene aperto, modifica e salva le modifiche.

   Nota

   A questo punto, le modifiche apportate alla policy sono state salvate solo nel file system locale. Per aggiornare la versione e tenerne traccia con AWS Explorer, ripeti i passaggi indicati in. Upload a new policy version

Selezione di una nuova versione predefinita della policy

1. Da AWS Explorer, espandi la sezione dei servizi IoT.

2. Espandi la sottosezione Policies (Policy) e individua la policy che desideri aggiornare.

3. Espandi la policy da aggiornare, quindi apri il menu contestuale (pulsante destro del mouse) per la versione della policy che vuoi impostare e seleziona Set as Default (Imposta come predefinita).

   Al termine, la nuova versione predefinita selezionata è contrassegnata da una stella.

Per eliminare policy

Nota

Prima di poter eliminare una policy o una sua versione, assicurati che siano soddisfatte le seguenti condizioni:

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

• Non è possibile eliminare una policy se ha versioni non predefinite.

• È possibile eliminare la versione predefinita di una policy solo se ne viene selezionata una nuova o se la policy viene eliminata per intero.

• Prima di eliminare una policy per intero, è necessario eliminare tutte le versioni non predefinite della stessa policy.

1. Da AWS Explorer, espandi la sezione dei servizi IoT.

2. Espandi la sottosezione Policies (Policy) e individua la policy che desideri aggiornare.

3. Espandi la policy da aggiornare, quindi apri il menu contestuale (pulsante destro del mouse) per la versione della policy che vuoi eliminare e seleziona Delete (Elimina).

4. Quando una versione viene eliminata, non è più visibile da AWS Explorer.

5. Se è rimasta solo la versione predefinita di una policy, apri il menu contestuale (pulsante destro del mouse) per la policy principale e scegli Delete (Elimina).