Corretora MQTT 5 (EMQX)

(Opcional) A configuração do broker EMQX MQTT a ser usada. Você pode definir as opções de configuração do EMQX neste componente.

Quando você usa o corretor EMQX, o Greengrass usa uma configuração padrão. Essa configuração é usada, a menos que você a modifique usando esse campo.

A modificação das seguintes configurações faz com que o componente do agente EMQX seja reiniciado. Outras alterações de configuração se aplicam sem reiniciar o componente.

{
  "authorization": {
    "no_match": "deny",
    "sources": []
  },
  "node": {
    "cookie": "<placeholder>"
  }, 
  "listeners": {
     "ssl": {
       "default": {
         "ssl_options": {
           "keyfile": "{work:path}\\data\\key.pem",
           "certfile": "{work:path}\\data\\cert.pem",
           "cacertfile": null,
           "verify": "verify_peer",
           "versions": ["tlsv1.3", "tlsv1.2"],
           "fail_if_no_peer_cert": true
         }
       }
     },
     "tcp": {
       "default": {
         "enabled": false
       }
     },
     "ws": {
       "default": {
         "enabled": false
       }
     },
     "wss": {
       "default": {
         "enabled": false
       }
     }
  },
  "plugins": {
    "states": [{"name_vsn": "gg-1.0.0", "enable": true}],
    "install_dir": "plugins"
  }
}

(Opcional) Define o provedor de autorização para o corretor. Pode ser um dos valores a seguir:

(Opcional) Nos dispositivos principais do Linux, você pode especificar a execução do broker EMQX MQTT sem privilégios de root ou administrador. Se você definir essa opção comofalse, o usuário do sistema que executa esse componente deverá ser membro do docker grupo.

Padrão: true

(Opcional) O tempo máximo em segundos para o broker EMQX MQTT iniciar. O estado do componente muda para BROKEN se ele exceder esse tempo limite.

Padrão: 90

(Opcional) O tempo máximo em segundos para o componente esperar até que o núcleo do Greengrass responda às solicitações de comunicação entre processos (IPC). Aumente esse número se esse componente relatar erros de tempo limite ao verificar se um dispositivo cliente está autorizado.

Padrão: 5

(Opcional) O nível de registro da biblioteca AWS Common Runtime (CRT).

O padrão é o nível de log (in) do broker EMQX MQTT. log.level emqx

(Opcional) Configure essa opção para reiniciar o agente EMQX MQTT. Quando esse valor de configuração é alterado, esse componente reinicia o agente MQTT. Você pode usar essa opção para forçar a desconexão dos dispositivos cliente.

(Opcional) Configure essa opção somente em sistemas operacionais Linux para adicionar parâmetros à linha de comando do Docker. Por exemplo, para mapear portas adicionais, use o parâmetro -p Docker:

"-p 1883:1883"

(Opcional) A configuração do broker EMQX MQTT a ser usada. Você pode configurar um subconjunto de opções de configuração do EMQX neste componente.

Esse objeto contém as seguintes informações:

(Opcional) Nos dispositivos principais do Linux, você pode especificar a execução do broker EMQX MQTT sem privilégios de root ou administrador. Se você definir essa opção comofalse, o usuário do sistema que executa esse componente deverá ser membro do docker grupo.

Padrão: true

(Opcional) O tempo máximo em segundos para o broker EMQX MQTT iniciar. O estado do componente muda para BROKEN se ele exceder esse tempo limite.

Padrão: 90

(Opcional) O tempo máximo em segundos para o componente esperar até que o núcleo do Greengrass responda às solicitações de comunicação entre processos (IPC). Aumente esse número se esse componente relatar erros de tempo limite ao verificar se um dispositivo cliente está autorizado.

Padrão: 5

(Opcional) O nível de registro da biblioteca AWS Common Runtime (CRT).

O padrão é o nível de log (in) do broker EMQX MQTT. log.level emqx

(Opcional) Configure essa opção para reiniciar o agente EMQX MQTT. Quando esse valor de configuração é alterado, esse componente reinicia o agente MQTT. Você pode usar essa opção para forçar a desconexão dos dispositivos cliente.

(Opcional) Configure essa opção somente em sistemas operacionais Linux para adicionar parâmetros à linha de comando do Docker. Por exemplo, para mapear portas adicionais, use o parâmetro -p Docker:

"-p 1883:1883"

(Opcional) Configure essa opção para adicionar ou substituir os padrões nos arquivos de configuração do EMQX especificados. Para obter informações sobre os arquivos de configuração e seus formatos, consulte Configuração na documentação do EMQX 4.0. Os valores que você especifica são anexados ao arquivo de configuração.

O exemplo a seguir atualiza o etc/emqx.conf arquivo.

"mergeConfigurationFiles": {
    "etc/emqx.conf": "broker.sys_interval=30s\nbroker.sys_heartbeat=10s"
},

Além dos arquivos de configuração suportados pelo EMQX, o Greengrass suporta um arquivo que configura o plug-in de autenticação do Greengrass para EMQX chamado. etc/plugins/aws_greengrass_emqx_auth.conf Há duas opções suportadas, auth_mode use_greengrass_managed_certificates e. Para usar outro provedor de autenticação, defina a auth_mode opção como uma das seguintes:

Se use_greengrass_managed_certificates fortrue, essa opção indica que o Greengrass gerencia os certificados TLS do broker. Sefalse, isso indica que você fornece os certificados por meio de outra fonte.

O exemplo a seguir atualiza os padrões no arquivo de etc/plugins/aws_greengrass_emqx_auth.conf configuração.

"mergeConfigurationFiles": {
    "etc/plugins/aws_greengrass_emqx_auth.conf": "auth_mode=enabled\n use_greengrass_managed_certificates=true\n"
  },

(Opcional) Configure essa opção para substituir os arquivos de configuração do EMQX especificados. Os valores que você especifica substituem todo o arquivo de configuração existente. Você não pode especificar o etc/emqx.conf arquivo nesta seção. Você deve usar mergeConfigurationFile para modificaretc/emqx.conf.