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à.
# Configurare il broker EMQX
Questa sezione spiega come aggiungere nomi utente e password. Spiega anche come stabilire una connessione TLS da una fonte esterna utilizzando il nome utente e la password aggiunti. È possibile configurare il broker EMQX utilizzando Linux o. Microsoft Windows
**Nota**
Per configurare il broker, è necessario un dispositivo principale configurato con la configurazione EMQX predefinita nel gateway V3 abilitato per MQTT.
**Importante**
Dopo aver completato questa procedura, consigliamo vivamente di configurare le regole di autorizzazione. Per ulteriori informazioni, consulta [Imposta le regole di autorizzazione per AWS IoT SiteWise Edge in EMQX](authorization-rules-emqx-broker.md). Le regole di autorizzazione per gli utenti aggiunti migliorano la sicurezza.
## Aggiornare la configurazione di distribuzione EMQX per l'autenticazione
**Per aggiornare la configurazione di distribuzione EMQX per l'autenticazione**
1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. **Nella barra di navigazione a sinistra, scegli **Edge gateway nella sezione** Edge.**
1. Scegli il gateway da configurare.
1. Nella sezione di **configurazione del gateway Edge**, copia il valore del **dispositivo principale Greengrass**. Salvalo per un uso successivo.
1. Apri la [AWS IoT console](https://console.aws.amazon.com/iot/).
1. **Nella barra di navigazione a sinistra, nella sezione **Gestisci**, scegli **Dispositivi Greengrass**, quindi Implementazioni.**
1. Trova il valore principale del dispositivo che hai salvato in precedenza e scegli quel link per aprire la distribuzione.
1. Scegli il pulsante a discesa **Azioni**, quindi **Rivedi**.
1. Leggi il messaggio che appare, quindi scegli **Revise** deployment. Viene visualizzata la pagina **Specificare la destinazione**.
1. Scegli **Avanti** fino a raggiungere il passaggio **Configura componenti**.
1. Seleziona il pulsante `aws.greengrass.clientdevices.mqtt.EMQX` radio.
1. Scegli il pulsante **Configura componente**. Viene visualizzata una pagina di configurazione per il componente.
1. In **Aggiornamento della configurazione**, scegli **Ripristina la configurazione predefinita per la versione del componente: 2.\$1. **\$1.
1. Inserisci la seguente configurazione nella sezione **Configurazione da unire** in base al tuo sistema operativo.
------
#### [ Linux ]
```
{
"emqxConfig": {
"authorization": {
"no_match": "allow"
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
},
"ssl": {
"default": {
"enabled": true,
"enable_authn": true,
"ssl_options": {
"verify": "verify_none",
"fail_if_no_peer_cert": false
}
}
}
},
"authentication": {
"enable": true,
"backend": "built_in_database",
"mechanism": "password_based",
"password_hash_algorithm": {
"iterations": 210000,
"mac_fun": "sha512",
"name": "pbkdf2"
},
"user_id_type": "username"
},
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"authMode": "bypass",
"dockerOptions": "-p 8883:8883 -p 127.0.0.1:1883:1883 -p 127.0.0.1:18083:18083 -v emqx-data:/opt/emqx/data -e EMQX_NODE__NAME=emqx@local",
"requiresPrivilege": "true"
}
```
------
#### [ Windows ]
```
{
"emqxConfig": {
"authorization": {
"no_match": "allow"
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
},
"ssl": {
"default": {
"enabled": true,
"enable_authn": true,
"ssl_options": {
"verify": "verify_none",
"fail_if_no_peer_cert": false
}
}
}
},
"authentication": {
"enable": true,
"backend": "built_in_database",
"mechanism": "password_based",
"password_hash_algorithm": {
"iterations": 210000,
"mac_fun": "sha512",
"name": "pbkdf2"
},
"user_id_type": "username"
},
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"authMode": "bypass",
"requiresPrivilege": "true"
}
```
Il `dockerOptions` campo è solo per i gateway Linux.
------
1. Scegli **Conferma**.
1. Scegli **Avanti** fino a raggiungere la fase di **revisione**.
1. Seleziona **Implementa**.
1. Una volta completata la distribuzione, procedi al passaggio successivo.
## Abilita l'autenticazione con nome utente e password
Questa sezione mostra come aggiungere nomi utente e password tramite la GUI del dashboard EMQX.
**Nota**
Le istruzioni relative a EMQX fornite sono solo di riferimento. Poiché la documentazione e le funzionalità di EMQX possono cambiare nel tempo e non conserviamo tale documentazione, consigliamo di consultare la documentazione [ufficiale di EMQX per le informazioni più](https://docs.emqx.com/en/emqx/latest/) aggiornate.
------
#### [ EMQX Dashboard ]
**Per abilitare l'autenticazione di nome utente e password tramite il dashboard EMQX**
1. Assicurati di essere all'interno dell'host del gateway.
1. Apri una finestra del browser e visita [http://localhost:18083/](http://localhost:18083/).
1. Inserisci il nome utente **admin** e la password predefiniti di**public**. Per ulteriori informazioni, vedere [EMQX Dashboard nei documenti](https://docs.emqx.com/en/emqx/latest/dashboard/introduction.html#first-login) *EMQX*.
1. Dopo l'accesso, ti viene richiesto di cambiare la password. Aggiorna la password per passare alla dashboard EMQX.
1. **Nella barra di navigazione a sinistra, scegli l'icona a forma di scudo, quindi Autenticazione.**
1. Nella riga **Database integrato**, scegli il pulsante **Utenti**.
1. Scegli il pulsante con l'icona del segno più per aggiungere utenti. Viene visualizzata una schermata **Aggiungi**.
1. Immettere un nome utente e una password per l'utente dell'applicazione esterna.
1. Scegli **Save** (Salva). Il nome utente scelto viene visualizzato nella tabella della pagina **Autenticazione**.
**Nota**
Le regole di autorizzazione esistenti o predefinite si applicano al nuovo utente. Si consiglia di rivederle e adattarle alle esigenze delle applicazioni esterne.
------
#### [ EMQX Management with Linux ]
Utilizza lo strumento AWS IoT SiteWise CLI EMQX all'indirizzo. `/greengrass/v2/bin/swe-emqx-cli`
**Per abilitare l'autenticazione di nome utente e password tramite EMQX Management utilizzando Linux**
1. Modificare la password dell'amministratore eseguendo il seguente comando:
```
/greengrass/v2/bin/swe-emqx-cli admin change-pwd
```
1. Quando richiesto, procedi come segue:
1. Immettete l'utente amministratore corrente (l'impostazione predefinita è`admin`) e la password (l'impostazione predefinita è`public`).
1. Inserisci e conferma la tua nuova password.
In caso di successo, viene visualizzato il seguente messaggio:
```
admin password changed successfully
```
1. Aggiungi utenti per applicazioni esterne eseguendo il comando seguente:
```
/greengrass/v2/bin/swe-emqx-cli users add
```
1. Quando richiesto, effettuate le seguenti operazioni:
1. Immettete il nome utente per il nuovo utente.
1. Inserisci e conferma la password per il nuovo utente.
In caso di successo, viene visualizzato il seguente messaggio:
```
User '[username]' created successfully
```
1. Verifica la configurazione utente eseguendo il comando seguente:
```
/greengrass/v2/bin/swe-emqx-cli users list
```
L'output mostra tutti gli utenti configurati:
```
Users:
- [your-added-username]
Total users: 1
```
------
#### [ EMQX Management with Windows ]
Utilizzate lo strumento AWS IoT SiteWise CLI EMQX in una delle seguenti posizioni:
+ PowerShell: `C:\greengrass\v2\bin\swe-emqx-cli.ps1`
+ Prompt dei comandi: `C:\greengrass\v2\bin\swe-emqx-cli.bat`
**Per abilitare l'autenticazione di nome utente e password tramite EMQX Management utilizzando Windows**
1. Modificare la password dell'amministratore eseguendo il comando seguente:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 admin change-pwd
```
1. Quando richiesto, procedi come segue:
1. Immettete l'utente amministratore corrente (l'impostazione predefinita è`admin`) e la password (l'impostazione predefinita è`public`).
1. Inserisci e conferma la tua nuova password.
In caso di successo, viene visualizzato il seguente messaggio:
```
admin password changed successfully
```
1. Aggiungi utenti per applicazioni esterne eseguendo il comando seguente:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 users add
```
1. Quando richiesto, effettuate le seguenti operazioni:
1. Immettete il nome utente per il nuovo utente.
1. Inserisci e conferma la password per il nuovo utente.
In caso di successo, viene visualizzato il seguente messaggio:
```
User '[username]' created successfully
```
1. Verifica la configurazione utente eseguendo il comando seguente:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 users list
```
L'output mostra tutti gli utenti configurati:
```
Users:
- [your-added-username]
Total users: 1
```
------