As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar o corretor EMQX
<a name="configure-emqx-broker"></a>

Esta seção aborda como adicionar nomes de usuário e senhas. Também aborda como estabelecer uma conexão TLS de uma fonte externa usando o nome de usuário e a senha adicionados. Você pode configurar o corretor EMQX usando Linux ou. Microsoft Windows

**nota**  
Para configurar o broker, você precisa de um dispositivo principal configurado com a configuração EMQX padrão em seu gateway V3 habilitado para MQTT.

**Importante**  
Depois de concluir esse procedimento, é altamente recomendável configurar as regras de autorização. Para obter mais informações, consulte [Configurar regras de autorização para o AWS IoT SiteWise Edge no EMQX](authorization-rules-emqx-broker.md). As regras de autorização para usuários adicionais aumentam a segurança. 

## Atualize a configuração de implantação do EMQX para autenticação
<a name="update-emqx-broker-authentication"></a>

**Para atualizar a configuração de implantação do EMQX para autenticação**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Na navegação à esquerda, escolha **Edge gateways** na seção **Edge**.

1. Escolha o gateway a ser configurado.

1. Na seção de **configuração do gateway Edge**, copie o valor do seu **dispositivo principal do Greengrass**. Guarde-o para uso posterior.

1. Abra o [console do AWS IoT](https://console.aws.amazon.com/iot/).

1. **No painel de navegação à esquerda, na seção **Gerenciar**, escolha **dispositivos Greengrass e, em seguida, Implantações**.**

1. Encontre o valor do dispositivo principal que você salvou anteriormente e escolha esse link para abrir a implantação.

1. **Escolha o botão suspenso **Ações** e, em seguida, Revisar.**

1. Leia a mensagem que aparece e escolha **Revisar implantação**. A página **Especificar destino** é exibida.

1. Escolha **Avançar** até chegar à etapa **Configurar componentes**.

1. Selecione o botão `aws.greengrass.clientdevices.mqtt.EMQX` de rádio.

1. Escolha o botão **Configurar componente**. Uma página de configuração é exibida para o componente.

1. Em **Atualização de configuração**, escolha **Redefinir a configuração padrão para a versão do componente: 2.\*. **\*.

1. Insira a seguinte configuração na seção **Configuração para mesclar** com base em seu sistema operacional.

------
#### [ 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"
   }
   ```

   O `dockerOptions` campo é somente para gateways Linux.

------

1. Escolha **Confirmar**.

1. Escolha **Avançar** até chegar à etapa de **revisão**.

1. Escolha **Implantar**.

1. Depois que a implantação for bem-sucedida, vá para a próxima etapa.

## Ativar autenticação de nome de usuário e senha
<a name="emqx-broker-username-password-auth"></a>

Esta seção mostra como adicionar nomes de usuário e senhas por meio da GUI do painel do EMQX.

**nota**  
As instruções relacionadas ao EMQX fornecidas são apenas para referência. Como a documentação e os recursos do EMQX podem mudar com o tempo e não mantemos sua documentação, recomendamos consultar a [documentação oficial do EMQX para obter](https://docs.emqx.com/en/emqx/latest/) as informações mais atuais.

------
#### [ EMQX Dashboard ]

**Para habilitar a autenticação de nome de usuário e senha por meio do painel do EMQX**

1. Verifique se você está dentro do host do gateway.

1. Abra uma janela do navegador e acesse [http://localhost:18083/](http://localhost:18083/).

1. Insira o nome de usuário padrão do **admin** e a senha padrão do**public**. Para obter mais informações, consulte [Painel do EMQX na documentação do](https://docs.emqx.com/en/emqx/latest/dashboard/introduction.html#first-login) *EMQX*.

1. Após o login, você será solicitado a alterar sua senha. Atualize sua senha para continuar no painel do EMQX.

1. No painel de navegação à esquerda, escolha o ícone de escudo e, em seguida, **Autenticação**.

1. Na linha **Banco de dados incorporado**, escolha o botão **Usuários**.

1. Escolha o botão do ícone do sinal de adição para adicionar usuários. Uma tela **Adicionar** é exibida.

1. Insira um nome de usuário e uma senha para o usuário do aplicativo externo.

1. Escolha **Salvar**. O nome de usuário que você escolheu aparece na tabela da página **Autenticação**.

**nota**  
As regras de autorização existentes ou padrão se aplicam ao novo usuário. É recomendável revisá-los e ajustá-los às necessidades de seus aplicativos externos.

------
#### [ EMQX Management with Linux ]

Use a ferramenta AWS IoT SiteWise EMQX CLI em. `/greengrass/v2/bin/swe-emqx-cli`

**Para habilitar a autenticação de nome de usuário e senha por meio do EMQX Management usando Linux**

1. Altere a senha do administrador executando o seguinte comando:

   ```
   /greengrass/v2/bin/swe-emqx-cli admin change-pwd
   ```

1. Quando solicitado, faça o seguinte:

   1. Digite seu usuário administrador atual (o padrão é`admin`) e a senha (o padrão é`public`).

   1. Digite e confirme sua nova senha.

   Se for bem-sucedido, você verá a seguinte mensagem:

   ```
   admin password changed successfully
   ```

1. Adicione usuários para aplicativos externos executando o seguinte comando:

   ```
   /greengrass/v2/bin/swe-emqx-cli users add
   ```

1. Quando solicitado, faça o seguinte:

   1. Insira o nome de usuário do novo usuário.

   1. Digite e confirme a senha do novo usuário.

   Se for bem-sucedido, você verá a seguinte mensagem:

   ```
   User '[username]' created successfully
   ```

1. Verifique a configuração do usuário executando o seguinte comando:

   ```
   /greengrass/v2/bin/swe-emqx-cli users list
   ```

   A saída mostra todos os usuários configurados:

   ```
   Users:
   - [your-added-username]
   
   Total users: 1
   ```

------
#### [ EMQX Management with Windows ]

Use a ferramenta AWS IoT SiteWise CLI EMQX em um dos seguintes locais:
+ PowerShell: `C:\greengrass\v2\bin\swe-emqx-cli.ps1`
+ Prompt de comando: `C:\greengrass\v2\bin\swe-emqx-cli.bat`

**Para habilitar a autenticação de nome de usuário e senha por meio do EMQX Management usando o Windows**

1. Altere a senha do administrador executando o seguinte comando:

   ```
   C:\greengrass\v2\bin\swe-emqx-cli.ps1 admin change-pwd
   ```

1. Quando solicitado, faça o seguinte:

   1. Digite seu usuário administrador atual (o padrão é`admin`) e a senha (o padrão é`public`).

   1. Digite e confirme sua nova senha.

   Se for bem-sucedido, você verá a seguinte mensagem:

   ```
   admin password changed successfully
   ```

1. Adicione usuários para aplicativos externos executando o seguinte comando:

   ```
   C:\greengrass\v2\bin\swe-emqx-cli.ps1 users add
   ```

1. Quando solicitado, faça o seguinte:

   1. Insira o nome de usuário do novo usuário.

   1. Digite e confirme a senha do novo usuário.

   Se for bem-sucedido, você verá a seguinte mensagem:

   ```
   User '[username]' created successfully
   ```

1. Verifique a configuração do usuário executando o seguinte comando:

   ```
   C:\greengrass\v2\bin\swe-emqx-cli.ps1 users list
   ```

   A saída mostra todos os usuários configurados:

   ```
   Users:
   - [your-added-username]
   
   Total users: 1
   ```

------