Clientes MQTT

Neste artigo, você aprenderá a configurar clientes MQTT e grupos de clientes.

Clientes

Os clientes podem ser dispositivos ou aplicativos, como dispositivos ou veículos que enviam/recebem mensagens MQTT.

Por exemplo, considere uma empresa de gerenciamento de frota com centenas de caminhões e outros veículos de entrega de remessa. Você pode aprimorar o roteamento, o acompanhamento, a segurança do driver e as funcionalidades de manutenção previsível enviando e recebendo mensagens MQTT em um serviço de nuvem.

Nesse cenário, os veículos podem ser configurados como clientes que fazem publicações em vários tópicos e os assinam, como informações meteorológicas, condições das estradas, localização geográfica, desempenho do motor e outros aspectos de desgaste do veículo. E, ao configurar o veículo como um cliente, um conjunto de atributos como tipo de veículo, ano, marca e modelo, capacidade máxima de carga, etc. também podem ser incluídos nos metadados do cliente.

Principais termos de metadados do cliente

Nome de Autenticação do Cliente: forneça um identificador exclusivo para o cliente sem restrições de nomenclatura do Azure Resource Manager. É um campo obrigatório e, se o nome não for fornecido explicitamente, ele usará o Nome do Cliente como padrão.

Dois clientes não podem ter o mesmo nome de autenticação em um namespace. Ao autenticarmos um cliente, tratamos o Nome de autenticação do cliente como não diferenciando maiúsculas de minúsculas.

Preservamos as maiúsculas e minúsculas originais do nome de autenticação do cliente que você configura no cliente. Usamos o nome original de autenticação do cliente (diferencia maiúsculas de minúsculas) fornecido quando o cliente foi criado, em enriquecimentos de roteamento, correspondência de espaços de tópicos etc.

Esquema de Validação de Autenticação de Certificado do Cliente: para usar o Certificado de Autoridade de Certificação para autenticação, você pode escolher uma das opções a seguir para especificar o local da identidade do cliente no certificado do cliente. Quando o cliente tenta se conectar ao serviço, o serviço localiza a identificação do cliente desse campo de certificado e o corresponde com o nome de autenticação do cliente para autenticar o cliente.

Damos suporte a cinco campos de certificado:

• Correspondência entre entidade e nome de autenticação
• Correspondência entre DNS e nome de autenticação
• Correspondência entre URI e nome de autenticação
• Correspondência entre IP e nome de autenticação
• Correspondência entre email e nome de autenticação

Use a opção "Correspondência de Impressão Digital" ao usar o certificado autoassinado para autenticar o cliente.

Atributos de cliente

Os atributos de cliente são um conjunto de pares chave-valor definidos pelo usuário ou marcas que fornecem informações sobre o cliente.

Esses atributos de cliente podem ser usados para criar os grupos de clientes. Por exemplo, você pode agrupar todos os veículos do tipo carreta em um grupo e todos os veículos do tipo caminhonete em outro.

Esses atributos são usados nas consultas do grupo de clientes para filtrar um conjunto de clientes. Os atributos podem descrever as características físicas ou funcionais do cliente. O atributo típico pode ser o "tipo" do cliente.

Aqui está um exemplo:

• Tipo: os valores podem ser "sensor", "termostato" ou "veículo"

Veja um exemplo de esquema para o cliente com a definição de atributo:

{  
    "id": "device123",  
    "attributes": {  
        "type": "home-sensors",
        "sensors": ["motion", "noise", "light"]
     }
}

Ao configurar os atributos do cliente, considere os tópicos nos quais os clientes fazem publicações (assinam). Pensar de trás para frente de tópicos para clientes ajuda a identificar mais facilmente as semelhanças entre as funções de cliente e definir os atributos de cliente, a fim de simplificar o agrupamento de clientes.

Exemplos de contratos

Exemplo de autenticação do cliente baseada em cadeia de certificados

{
    "properties": {
        "authenticationName": "127.0.0.1",
        "state": "Enabled",
        "clientCertificateAuthentication": {
            "validationScheme": "IpMatchesAuthenticationName"
        },
        "attributes": {
            "room": "345",
            "floor": 3,
            "bldg": "17"
        },
        "description": "Description of the client"
    }
}

Exemplo de autenticação do cliente baseada em impressão digital do certificado autoassinado

{
    "properties": {
        "authenticationName": "abcd@domain.com-1",
        "state": "Enabled",
        "clientCertificateAuthentication": {
            "validationScheme": "ThumbprintMatch",
            "allowedThumbprints": ["primary", "secondary"]
        },
        "attributes": {
            "room": "345",
            "floor": "3",
            "bldg": 17
        },
        "description": "Description of the client"
    }
}

Configuração do portal do Azure

Use as seguintes etapas para criar um cliente:

1. Acessar seu namespace no portal do Azure

2. Em Clientes, selecione + Cliente.

   

3. Escolha o esquema de validação de autenticação do certificado do cliente. Para obter mais informações sobre a configuração de autenticação do cliente, confira o artigo Autenticação do cliente.

• Adicione atributos do cliente.

  

4. Escolha Criar

Configuração da CLI do Azure

Use os comandos a seguir para criar/mostrar/excluir um cliente

Criar cliente

az eventgrid namespace client create -g myRG --namespace-name myNS -n myClient

Obter um cliente

az eventgrid namespace client show -g myRG --namespace-name myNS -n myClient

Excluir o cliente

az eventgrid namespace client delete -g myRG --namespace-name myNS -n myClient

Próximas etapas

• Saiba mais sobre a autenticação do cliente