# Nozioni di base su Wireless AWS IoT Puoi accedere alle nozioni di base su Wireless AWS IoT registrandoti a un Account AWS e seguendo i passaggi per creare un utente IAM. Dopo esserti registrato, puoi utilizzare la Console di gestione AWS, l'API Wireless AWS IoT o la AWS CLI per effettuare l'onboarding dei tuoi dispositivi e gateway Sidewalk e LoRaWAN. Durante l'onboarding dei dispositivi, considera come descrivere ed etichettare le risorse per identificarle più facilmente. I seguenti argomenti offrono le nozioni di base su Wireless AWS IoT. **Topics** + [Configurazione di Wireless AWS IoT](setting-up-iotwireless.md) + [Descrizione delle risorse Wireless AWS IoT](iotwireless-describe-resources.md) # Configurazione di Wireless AWS IoT Quando effettui la registrazione ad AWS, il tuo account Account AWS viene automaticamente registrato per tutti i servizi in AWS, incluso Wireless AWS IoT. Ti vengono addebitati solo i servizi che utilizzi. Per configurare Wireless AWS IoT, attieniti alla procedura descritta nella sezione seguente: **Topics** + [Configurare l'account Account AWS](#iotwireless-setup-account) + [Installazione di Python e della AWS CLI](#wireless-onboard-prereq) ## Configurare l'account Account AWS Prima di usare AWS IoT Core per LoRaWAN o AWS IoT Core per Amazon Sidewalk per la prima volta, devi completare le seguenti operazioni di configurazione del tuo Account AWS: **Topics** + [Effettua la registrazione per creare un account AWS.](#aws-sign-up-iotwireless) + [Crea un utente IAM](#create-iam-user-iotwireless) + [Accesso come utente IAM](#sign-in-iam-user-iotwireless) ### Effettua la registrazione per creare un account AWS. Se non disponi di un Account AWS, completa la procedura seguente per crearne uno. **Per registrarsi a un Account AWS** 1. Apri la pagina all'indirizzo [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup). 1. Segui le istruzioni online. Nel corso della procedura di registrazione riceverai una telefonata, durante la quale sarà necessario inserire un codice di verifica attraverso la tastiera del telefono. Durante la registrazione di un Account AWS, viene creato un *Utente root dell'account AWS*. L'utente root dispone dell'accesso a tutte le risorse e tutti i Servizi AWSnell'account. Come best practice di sicurezza, [assegna l'accesso amministrativo a un utente amministrativo](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) e utilizza solo l'utente root per eseguire [attività che richiedono l'accesso di un utente root](https://docs.aws.amazon.com/accounts/latest/reference/root-user-tasks.html). ### Crea un utente IAM Per creare un utente amministratore, scegli una delle seguenti opzioni. **** | Scelta di un modo per gestire il tuo amministratore | Per | Come | Puoi anche | | --- | --- | --- | --- | | In IAM Identity Center (Consigliato) | Usa credenziali a breve termine per accedere a AWS.Ciò è in linea con le best practice per la sicurezza. Per informazioni sulle best practice, consulta [Best practice per la sicurezza in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp) nella *Guida per l'utente di IAM*. | Segui le istruzioni riportate in [Nozioni di base](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) nella Guida per l'utente di AWS IAM Identity Center. | Configura l'accesso programmatico seguendo quanto riportato in [Configurazione della AWS CLI per utilizzare AWS IAM Identity Center](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html) nella Guida per l'utente di AWS Command Line Interface. | | In IAM (Non consigliato) | Usa credenziali a lungo termine per accedere a AWS. | Segui le istruzioni in [Creazione del primo utente e gruppo di utenti IAM di amministrazione](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) nella Guida per l'utente di IAM. | Configura l'accesso programmatico seguendo quanto riportato in [Gestione delle chiavi di accesso per gli utenti IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) nella Guida per l'utente di IAM. | ### Accesso come utente IAM Dopo aver creato un utente IAM, puoi accedere ad AWS con il nome utente e la password IAM. Prima di accedere come utente IAM, puoi verificare il link di accesso per gli utenti IAM nella console IAM. Nel pannello di controllo IAM, nel link di accesso degli utenti IAM, puoi visualizzare il link di accesso per l'Account AWS. L'URL del link di accesso contiene il tuo ID account Account AWS senza trattini (-). Se non desideri che l'URL per il tuo link di accesso contenga il tuo ID Account AWS, puoi creare un alias dell'account. Per maggiori informazioni, consulta [Creazione, eliminazione e visualizzazione di un alias di un account Account AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html#CreateAccountAlias) nella *Guida per l'utente di IAM*. **Accesso come utente IAM** 1. Disconnettiti dalla Console di gestione AWS. 1. Inserisci il tuo link di accesso, che include il tuo ID Account AWS (senza trattini) o l'alias Account AWS. ``` https://aws_account_id_or_alias.signin.aws.amazon.com/console ``` 1. Immettere il nome utente e la password di IAM appena creati. Una volta effettuato l'accesso, la barra di navigazione visualizza *"your\$1user\$1name @ your\$1aws\$1account\$1id"*. ## Installazione di Python e della AWS CLI Prima di collegare il dispositivo finale LoRaWAN o Sidewalk, è necessario installare Python e configurare la AWS CLI. **Importante** Per eseguire l'intero flusso di lavoro di onboarding per il provisioning e la registrazione del dispositivo finale Sidewalk, è necessario anche configurare il gateway Sidewalk e l'HDK. Per istruzioni, consultare le pagine relative alla [configurazione del kit di sviluppo dell'hardware (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) e alla [configurazione di un gateway Sidewalk](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-gateway.html) nella *documentazione di Amazon Sidewalk*. **Topics** + [Installazione di Python e Python3-PIP](#wireless-prereq-python) + [Configurazione di AWS CLI](#wireless-prereq-cli) ### Installazione di Python e Python3-PIP Per utilizzare AWS CLI e boto3 come descritto nella sezione successiva, è necessario utilizzare Python versione 3.6 o successive. Se si desidera eseguire l'onboarding dei dispositivi finali utilizzando la console AWS IoT, è possibile saltare questa sezione e continuare a configurare Account AWS. Per verificare se Python e Python3-PIP sono già installati, esegui i comandi seguenti. Se l'esecuzione di questi comandi restituisce la versione, significa che Python e Python3-PIP sono stati installati correttamente. ``` python3 -V pip3 --version ``` Se questo comando restituisce un errore, è possibile che Python non sia installato o che il sistema operativo chiami l'eseguibile Python v3.x come Python3. In tal caso, sostituisci tutte le istanze di `python` con `python3` quando esegui i comandi. Se l'errore persiste, scarica ed esegui il [programma di installazione di Python](https://www.python.org/downloads/) o installa Python a seconda del sistema operativo in uso come descritto di seguito. ------ #### [ Windows ] Sul computer Windows, scarica Python dal [sito Web di Python](https://www.python.org/downloads/windows/), quindi esegui il programma di installazione per installare Python sul computer. ------ #### [ Linux ] Sul computer Ubuntu, esegui il comando `sudo` seguente per installare Python. ``` sudo apt install python3 sudo apt install python3-pip ``` ------ #### [ macOS ] Sul computer Mac, utilizza Homebrew per installare Python. Homebrew installa anche pip, che quindi punta alla versione Python3 installata. ``` $ brew install python ``` ------ ### Configurazione di AWS CLI Nei passaggi seguenti viene illustrato come configurare AWS CLI e boto3 (AWS SDK per Python). Prima di seguire questi passaggi, devi registrarti a Account AWS e creare un utente amministrativo. Per istruzioni, consulta [Configurazione di Wireless AWS IoT](#setting-up-iotwireless). 1. **Installazione e configurazione dell'AWS CLI** Puoi utilizzare la AWS CLI per eseguire l'onboarding programmatico dei dispositivi finali Sidewalk in AWS IoT Core per Amazon Sidewalk. Se desideri eseguire l'onboarding dei dispositivi utilizzando la console AWS IoT, puoi saltare questa sezione. Apri la [console AWS IoT Core](https://console.aws.amazon.com/iot/home#/) e continua con la sezione successiva per iniziare a connettere i dispositivi a AWS IoT Core per Amazon Sidewalk. Per istruzioni sulla configurazione di AWS CLI, consultare la pagina relativa all'[installazione e alle configurazione di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). 1. **Installazione di boto3 (AWS SDK per Python)** I seguenti comandi mostrano come installare boto3 (AWS SDK per Python) e AWS CLI. Verrà installato anche botocore, che è richiesto per eseguire boto3. Per istruzioni dettagliate, consultare [Installazione di Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation) nella *Guida alla documentazione di Boto3*. **Nota** `awscli` versione `1.26.6` richiede PyYAML versione 3.10 o successiva, ma non successiva alla 5.5. ``` python3 -m pip install botocore-version-py3-none-any.whl python3 -m pip install boto3-version-py3-none-any.whl ``` 1. **Configurazione delle credenziali e della regione predefinita** Configura le credenziali e la regione predefinita nei file `~/.aws/credentials` e `~/.aws/config`. La libreria boto3 utilizza queste credenziali per identificare Account AWS e autorizzare le chiamate API. Per le istruzioni di configurazione, consultare: + [Configurazione](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration) nella *Guida alla documentazione di Boto3* + [Configurazione e impostazioni del file delle credenziali](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) nella *Guida alla documentazione di AWS CLI* # Descrizione delle risorse Wireless AWS IoT Prima di iniziare l'onboarding dei dispositivi LoRaWAN o Sidewalk, devi considerare la convenzione di denominazione dei dispositivi, dei gateway e della destinazione. Wireless AWS IoT offre diverse opzioni per identificare le risorse create. Quando vengono create, alle risorse Wireless AWS IoT viene assegnato un ID univoco che non è descrittivo né può essere modificato dopo la creazione della risorsa. Per rendere più agevole la selezione, l'identificazione e la gestione delle risorse, è possibile assegnare un nome, aggiungere una descrizione e assegnare tag e valori di tag alla maggior parte delle risorse Wireless AWS IoT. + **[Nomi delle risorse e descrizione](#wireless-describe-resource-names)** Per gateway, dispositivi e profili, il nome della risorsa è un campo facoltativo che è possibile modificare dopo la creazione della risorsa. Il nome viene visualizzato negli elenchi visualizzati nelle pagine dell'hub delle risorse. Per le destinazioni, fornisci un nome univoco al tuo account AWS e alla regione Regione AWS. Non è possibile modificare il nome di destinazione dopo aver creato la risorsa di destinazione. Mentre un nome può contenere fino a 256 caratteri, lo spazio di visualizzazione nell'hub della risorsa è limitato. Assicurati che la parte distintiva del nome venga visualizzata nei primi 20-30 caratteri, se possibile. + **[Tag delle risorse](#wireless-describe-resource-tags)** I tag sono coppie chiave-valore (metadati) che possono essere collegati alle risorse AWS. È possibile scegliere sia le chiavi tag che i relativi valori. A gateway, destinazioni e profili possono essere collegati fino a 50 tag. I dispositivi non supportano i tag. ## Nomi delle risorse e descrizione **Supporto di risorse Wireless AWS IoT per nome** | Risorsa | Supporto del campo nome | | --- | --- | | Destinazione | Il nome è un ID univoco della risorsa e non può essere modificato. | | Dispositivo wireless | Il nome è un descrittore facoltativo della risorsa e può essere modificato. | | Gateway LoRaWAN | Il nome è un descrittore facoltativo della risorsa e può essere modificato. | | Profilo | Il nome è un descrittore facoltativo della risorsa e può essere modificato. | Il campo nome viene visualizzato negli elenchi di hub di risorse delle risorse; tuttavia, lo spazio è limitato e quindi potrebbero essere visibili solo i primi 15-30 caratteri del nome. Quando selezioni i nomi per le tue risorse, considera come vuoi che identifichino le risorse e come verranno visualizzate nella console. **Descrizione** Le risorse di destinazione, dispositivo e gateway supportano anche un campo di descrizione, che può accettare fino a 2.048 caratteri. Il campo descrizione viene visualizzato solo nella pagina dettagli della singola risorsa. Anche se il campo della descrizione può contenere molte informazioni, poiché viene visualizzato solo nella pagina dettagli della risorsa, non è conveniente eseguire la scansione nel contesto di più risorse. ## Tag delle risorse **Supporto di risorse Wireless AWS IoT per i tag AWS** | Risorsa | Supporto dei tag AWS | | --- | --- | | Destinazione | È possibile aggiungere fino a 50 tag AWS alla risorsa. | | Dispositivo wireless | Questa risorsa non supporta tag AWS. | | Gateway LoRaWAN | È possibile aggiungere fino a 50 tag AWS alla risorsa. | | Profilo | È possibile aggiungere fino a 50 tag AWS alla risorsa. | I tag sono parole o frasi che fungono da metadati e che puoi utilizzare per identificare e organizzare le risorse dei servizi AWS. È possibile considerare la chiave del tag come una categoria di informazioni e il valore del tag come un valore specifico in quella categoria. Ad esempio, si potrebbe avere un valore di tag pari a *colore* e poi dare ad alcune risorse un valore di *blu* per quel tag e ad altre un valore di *rosso*. Con questo, potresti usare l'[Editor di tag](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) nella console AWS per trovare le risorse con un tag *colore* del valore di *blu*. Per ulteriori informazioni sull'assegnazione di tag in Wireless AWS IoT, consulta [Tagging delle risorse Wireless AWS IoT](tagging-iotwireless.md). Per ulteriori informazioni sulle strategie di tagging, consulta [Editor di tag](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html).