Como criar seu primeiro conector MQTT

Como criar seu primeiro conector MQTT

Use este guia para saber como trazer os tópicos MQTT para o Tulip

Neste guia, você aprenderá:* Como configurar uma fonte de dados MQTT no Tulip

Se você tem um broker MQTT em funcionamento que gostaria de conectar ao Tulip, então está pronto para configurar uma fonte de dados MQTT e criar seu primeiro aplicativo de monitoramento de máquina.

Configuração de uma conexão MQTT

Os conectores MQTT podem ser criados na página de conectores ou na página de fonte de dados da máquina. O processo de configuração não é diferente, e uma conexão criada em um lugar aparecerá no outro.

Mais detalhes sobre a criação de conectores podem ser encontrados aqui: Como configurar um conector

Configuração como uma fonte de dados de máquina

1. Clique na opção Machines (Máquinas) na guia Shop Floor (Chão de fábrica) na barra de menus.

1. Em seguida, clique em Machine Data Sources (Fontes de dados da máquina ) na gaveta do lado esquerdo.

1. Em seguida, clique em Create Machine Data Source (Criar fonte de dados da máquina ) na página Machine Data Sources (Fontes de dados da máquina).

1. Nomeie sua fonte de dados, selecione um Connector Host, selecione MQTT e a versão desejada do MQTT.

1. Adicione os detalhes da conexão para se conectar ao seu corretor.

Configuração da conexão MQTT

Executa em

Executa representa o host do conector que será responsável por lidar com a conexão com o seu corretor. Se o seu corretor não estiver acessível à Internet em geral, será necessário um host do conector local para acessar o seu corretor MQTT. Consulte os requisitos de versão a seguir antes de testar o Connector Host.

:::(Warning) (Versão do host do conector local) Somente os hosts do conector local da versão 261 (LTS11) ou superior oferecem suporte a fontes de dados MQTT. Somente dispositivos de borda no OS56 ou superior oferecem suporte a fontes de dados MQTT.

:::

MQTT vs. MQTTs

MQTTs é simplesmente MQTT, com uma camada adicional de segurança. Quando o MQTTs for selecionado, o SSL/TLS será usado para a comunicação do cliente com o agente. Além disso, o MQTTs suporta chaves privadas, certificados e/ou tokens de CA confiáveis. Com apenas MQTT selecionado, somente a autenticação por meio de nome de usuário e senha ou nome de usuário por ID de cliente está disponível.

ID do cliente

O ID do cliente é como o cliente Tulip se identificará para o seu broker MQTT. No nível mais simples, isso é frequentemente usado para autenticação e controle de acesso. Pode ser definido como um valor estático ou como um valor aleatório com o sinalizador "Auto-generate" ativado.

Manter vivo

O keep alive é o tempo máximo, em segundos, que o cliente gostaria de manter a comunicação aberta com o corretor. Se nenhuma mensagem tiver sido passada do intermediário para o cliente durante esse período, o cliente enviará uma mensagem ao intermediário indicando que ainda está ativo.

Informações do certificado MQTTs

Chave privada

Atualiza a propriedade da chave na configuração de autenticação do Node.js.

Chaves privadas no formato PEM. O PEM permite a opção de criptografia das chaves privadas. As chaves criptografadas serão descriptografadas com options.passphrase. Várias chaves usando algoritmos diferentes podem ser fornecidas como uma matriz de cadeias de caracteres ou buffers de chaves não criptografadas ou como uma matriz de objetos no formato. A forma de objeto só pode ocorrer em uma matriz. object.passphrase é opcional. As chaves criptografadas serão descriptografadas com object.passphrase, se fornecido, ou options.passphrase, se não for.

Certificado

Atualiza a propriedade cert na configuração de autenticação do Node.js.

Cadeias de certificados no formato PEM. Deve ser fornecida uma cadeia de certificados por chave privada. Cada cadeia de certificados deve consistir no certificado formatado em PEM para uma chave privada fornecida, seguido pelos certificados intermediários formatados em PEM (se houver), em ordem, e não incluindo a CA raiz (a CA raiz deve ser conhecida previamente pelo par, consulte ca). Ao fornecer várias cadeias de certificados, elas não precisam estar na mesma ordem que suas chaves privadas na chave. Se os certificados intermediários não forem fornecidos, o par não conseguirá validar o certificado e o handshake falhará.

CA confiável

Atualiza a propriedade ca na configuração de autenticação do Node.js.

Opcionalmente, substitua os certificados de CA confiáveis. O padrão é confiar nas CAs conhecidas selecionadas pela Mozilla. As CAs da Mozilla são completamente substituídas quando as CAs são explicitamente especificadas usando essa opção. O valor pode ser uma cadeia de caracteres ou um buffer, ou uma matriz de cadeias de caracteres e/ou buffers. Qualquer cadeia de caracteres ou buffer pode conter várias CAs PEM concatenadas. O certificado do par deve ser encadeável a uma CA confiável pelo servidor para que a conexão seja autenticada. Ao usar certificados que não são encadeáveis a uma CA conhecida, a CA do certificado deve ser explicitamente especificada como confiável ou a conexão falhará na autenticação. Se o par usar um certificado que não corresponda ou não possa ser encadeado a uma das CAs padrão, use a opção ca para fornecer um certificado de CA ao qual o certificado do par possa corresponder ou ser encadeado. Para certificados autoassinados, o certificado é sua própria CA e deve ser fornecido. Para certificados codificados em PEM, os tipos suportados são "TRUSTED CERTIFICATE", "X509 CERTIFICATE" e "CERTIFICATE". Consulte também tls.rootCertificates.

Teste da conexão

Clique em Test (Testar ) para ver se você consegue se conectar com êxito ao corretor.

Se o teste for bem-sucedido, você estará pronto para configurar uma máquina. Clique em Save (Salvar) e vá para a página Machine Types (Tipos de máquinas ) para configurar sua primeira categoria de máquinas.

Encontrou o que estava procurando?

Você também pode ir para community.tulip.co para postar sua pergunta ou ver se outras pessoas tiveram uma pergunta semelhante!