Konfigurace koncových bodů toku dat MQTT

Důležité

Tato stránka obsahuje pokyny ke správě komponent operací Azure IoT pomocí manifestů nasazení Kubernetes, které jsou ve verzi Preview. Tato funkce je poskytována s několika omezeními a neměla by se používat pro produkční úlohy.

Právní podmínky, které platí pro funkce Azure, které jsou ve verzi beta, verzi Preview nebo které zatím nejsou veřejně dostupné, najdete v Dodatečných podmínkách použití pro Microsoft Azure verze Preview.

Koncové body toku dat MQTT se používají pro zdroje a cíle MQTT. Můžete nakonfigurovat nastavení koncového bodu, protokol TLS (Transport Layer Security), ověřování a další nastavení.

Požadavky

• Instance operací Azure IoT

Místní zprostředkovatel MQTT provozu Azure IoT

Operace Azure IoT poskytují integrovaný místní zprostředkovatel MQTT, který můžete použít s toky dat. Zprostředkovatel MQTT můžete použít jako zdroj k příjmu zpráv z jiných systémů nebo jako cíle k odesílání zpráv do jiných systémů.

Výchozí koncový bod

Když nasadíte operace Azure IoT, vytvoří se koncový bod toku dat zprostředkovatele MQTT s názvem "default" s výchozím nastavením. Tento koncový bod můžete použít jako zdroj nebo cíl pro toky dat.

Důležité

V každém toku dat musíte použít výchozí koncový bod nebo jeden se stejným nastavením. Může to být zdroj, cíl nebo obojí. Další podrobnosti najdete v tématu Toky dat musí používat místní koncový bod zprostředkovatele MQTT.

Výchozí koncový bod používá následující nastavení:

• Hostitel: aio-broker:18883 prostřednictvím výchozího naslouchacího procesu zprostředkovatele MQTT
• Ověřování: Token účtu služby (SAT) prostřednictvím výchozího prostředku BrokerAuthentication
• TLS: Povoleno
• Certifikát důvěryhodné certifikační autority: Výchozí certifikát azure-iot-operations-aio-ca-trust-bundle certifikační autority z výchozí kořenové certifikační autority

Upozornění

Neodstraňovat výchozí koncový bod Pokud odstraníte výchozí koncový bod, musíte ho znovu vytvořit se stejným nastavením.

Zobrazení nebo úprava výchozího nastavení koncového bodu zprostředkovatele MQTT:

Azure Portal

1. V provozním prostředí vyberte koncové body toku dat.

2. Vyberte výchozí koncový bod, který chcete zobrazit nebo upravit nastavení.

   

Bicep

Pokud chcete upravit výchozí koncový bod, vytvořte soubor Bicep .bicep s následujícím obsahem. Podle potřeby aktualizujte nastavení a nahraďte zástupné hodnoty <AIO_INSTANCE_NAME> jako vlastní.

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'

resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}
resource defaultMqttBrokerDataflowEndpoint 'Microsoft.IoTOperations/instances/dataflowEndpoints@2024-11-01' = {
  parent: aioInstance
  name: 'default'
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    endpointType: 'Mqtt'
    mqttSettings: {
      host: 'aio-broker:18883'
      authentication: {
        method: 'ServiceAccountToken'
        serviceAccountTokenSettings: {
          audience: 'aio-internal'
        }
      }
      tls: {
        mode: 'Enabled'
        trustedCaCertificateConfigMapRef: 'azure-iot-operations-aio-ca-trust-bundle'
      }
    }
  }
}

Pak nasaďte pomocí Azure CLI.

az deployment group create --resource-group <RESOURCE_GROUP> --template-file <FILE>.bicep

Kubernetes (Preview)

Výchozí nastavení koncového bodu zprostředkovatele MQTT můžete zobrazit v clusteru Kubernetes. Pokud chcete zobrazit nastavení, použijte následující příkaz:

kubectl get dataflowendpoint default -n azure-iot-operations -o yaml

Vytvoření nového koncového bodu

Můžete také vytvořit nové místní koncové body zprostředkovatele MQTT s vlastním nastavením. Můžete například vytvořit nový koncový bod zprostředkovatele MQTT pomocí jiného portu, ověřování nebo nastavení autorizace. Stále však musíte vždy použít výchozí koncový bod jako zdroj nebo cíl v každém toku dat, i když vytváříte nové koncové body.

Azure Portal

1. V provozním prostředí vyberte koncové body toku dat.

2. V části Vytvořit nový koncový bod toku dat vyberte Azure IoT Operations Local MQTT>New.

   

   Zadejte následující nastavení pro koncový bod:

   Nastavení	Description
   Name	Název koncového bodu toku dat.
   Hostitelský počítač	Název hostitele a port zprostředkovatele MQTT. Použití formátu <hostname>:<port>
   Metoda ověřování	Metoda použitá k ověřování. Volba tokenu účtu služby nebo certifikátu X509
   Cílová skupina služeb	Cílová skupina tokenu účtu služby. Vyžaduje se, pokud používáte token účtu služby.
   Klientský certifikát X509	Klientský certifikát X.509 používaný k ověřování. Vyžaduje se, pokud používáte certifikát X509.
   Klientský klíč X509	Privátní klíč odpovídající klientskému certifikátu X.509. Vyžaduje se, pokud používáte certifikát X509.
   Zprostředkující certifikáty X509	Zprostředkující certifikáty pro řetěz klientských certifikátů X.509. Vyžaduje se, pokud používáte certifikát X509.

Bicep

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'
param endpointName string = '<ENDPOINT_NAME>'
param mqttBrokerHostname string = '<HOSTNAME>:<PORT>'
param trustedCA string = '<TRUST_BUNDLE>'
param serviceAccountAudience string = '<SA_AUDIENCE>'

resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}
resource MqttBrokerDataflowEndpoint 'Microsoft.IoTOperations/instances/dataflowEndpoints@2024-11-01' = {
  parent: aioInstance
  name: endpointName
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    endpointType: 'Mqtt'
    mqttSettings: {
      host: mqttBrokerHostname
      authentication: {
        method: 'ServiceAccountToken'
        serviceAccountTokenSettings: {
          audience: serviceAccountAudience
        }
      }
      tls: {
        mode: 'Enabled'
        trustedCaCertificateConfigMapRef: trustedCA
      }
    }
  }
}

Kubernetes (Preview)

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowEndpoint
metadata:
  name: <ENDPOINT_NAME>
  namespace: azure-iot-operations
spec:
  endpointType: Mqtt
  mqttSettings:
    host: "<HOSTNAME>:<PORT>"
    tls:
      mode: Enabled
      trustedCaCertificateConfigMapRef: <TRUST_BUNDLE>
    authentication:
      method: ServiceAccountToken
      serviceAccountTokenSettings:
        audience: <SA_AUDIENCE>

Azure Event Grid

Azure Event Grid poskytuje plně spravovaného zprostředkovatele MQTT, který funguje s toky dat operací Azure IoT. Pokud chcete nakonfigurovat koncový bod zprostředkovatele Azure Event Grid MQTT, doporučujeme pro ověřování použít spravovanou identitu.

Konfigurace oboru názvů Event Gridu

Pokud jste to ještě neudělali, nejprve vytvořte obor názvů Event Gridu.

Povolení MQTT

Jakmile máte obor názvů Event Gridu, přejděte do části Konfigurace a zkontrolujte:

• Povolit MQTT: Zaškrtněte políčko.
• Maximální počet relací klienta na název ověřování: Nastaveno na 3 nebo více.

Možnost maximálního počtu relací klientů je důležitá, aby se toky dat mohly vertikálně navýšit a stále se připojit. Další informace najdete v tématu Podpora více relací ve službě Event Grid MQTT.

Vytvoření prostoru tématu

Aby toky dat odesílaly nebo přijímaly zprávy do zprostředkovatele Event Grid MQTT, musíte v oboru názvů Event Gridu vytvořit alespoň jeden prostor tématu. V oboru názvů Event Gridu můžete vytvořit prostor tématu tak, že vyberete Mezery>tématu Nový prostor tématu.

Pokud chcete rychle začít a testovat, můžete jako šablonu # tématu vytvořit prostor tématu se zástupnými znaky.

Přiřazení oprávnění ke spravované identitě

Pokud chcete nakonfigurovat koncový bod toku dat pro zprostředkovatele Event Grid MQTT, doporučujeme použít spravovanou identitu přiřazenou uživatelem nebo systémem. Tento přístup je zabezpečený a eliminuje potřebu správy přihlašovacích údajů ručně.

Po vytvoření prostoru tématu je potřeba přiřadit roli spravované identitě operací Azure IoT, která uděluje oprávnění k odesílání nebo přijímání zpráv zprostředkovateli Event Grid MQTT.

Pokud používáte spravovanou identitu přiřazenou systémem, přejděte na webu Azure Portal do instance operací Azure IoT a vyberte Přehled. Zkopírujte název rozšíření uvedené za rozšířením Azure IoT Operations Arc. Například azure-iot-operations-xxxx7. Spravovanou identitu přiřazenou systémem najdete pomocí stejného názvu rozšíření Azure IoT Operations Arc.

Pak přejděte do řízení přístupu k oboru názvů >Event Gridu (IAM)>Přidat přiřazení role.

1. Na kartě Role vyberte odpovídající roli, například EventGrid TopicSpaces Publisher nebo EventGrid TopicSpaces Subscriber. Díky tomu má spravovaná identita potřebná oprávnění k odesílání nebo přijímání zpráv pro všechny prostory témat v oboru názvů. Další informace najdete v tématu Ověřování Microsoft Entra JWT a autorizace Azure RBAC k publikování nebo přihlášení k odběru zpráv MQTT.
2. Na kartě Členové:
   1. Pokud používáte spravovanou identitu přiřazenou systémem, pro přiřazení přístupu, vyberte možnost Uživatel, skupina nebo instanční objekt , pak vyberte a vyberte členy a vyhledejte název rozšíření Azure IoT Operations Arc.
   2. Pokud používáte spravovanou identitu přiřazenou uživatelem, jako možnost Přiřadit přístup, vyberte možnost Spravovaná identita a pak vyberte a vyberte členy a vyhledejte spravovanou identitu přiřazenou uživatelem nastavenou pro cloudová připojení.

Případně můžete roli přiřadit na úrovni prostoru tématu. Přejděte na téma Řízení přístupu k prostoru >(IAM)>Přidat přiřazení role. Přiřaďte spravovanou identitu s odpovídající rolí, jako EventGrid TopicSpaces Publisher je nebo EventGrid TopicSpaces Subscriber. Díky tomu má spravovaná identita potřebná oprávnění k odesílání nebo přijímání zpráv pro konkrétní prostor tématu.

Vytvoření koncového bodu toku dat pro zprostředkovatele Event Grid MQTT

Po nakonfigurování oboru názvů Event Gridu můžete vytvořit koncový bod toku dat pro zprostředkovatele Event Grid MQTT.

Azure Portal

1. V provozním prostředí vyberte kartu Koncové body toku dat.

2. V části Vytvořit nový koncový bod toku dat vyberte Azure Event Grid MQTT>Nový.

   

   Zadejte následující nastavení pro koncový bod:

   Nastavení	Description
   Name	Název koncového bodu toku dat.
   Hostitelský počítač	Název hostitele a port zprostředkovatele Event Grid MQTT. Použití formátu <NAMESPACE>.<REGION>-1.ts.eventgrid.azure.net:8883
   Metoda ověřování	Metoda použitá k ověřování. Doporučujeme zvolit spravovanou identitu přiřazenou systémem nebo spravovanou identitu přiřazenou uživatelem.

3. Vyberte Použít pro zřízení koncového bodu.

Bicep

Vytvořte soubor Bicep .bicep s následujícím obsahem.

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'
param endpointName string = '<ENDPOINT_NAME>'
param eventGridHostName string = '<NAMESPACE>.<REGION>-1.ts.eventgrid.azure.net:8883'

resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}
resource remoteMqttBrokerDataflowEndpoint 'Microsoft.IoTOperations/instances/dataflowEndpoints@2024-11-01' = {
  parent: aioInstance
  name: endpointName
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    endpointType: 'Mqtt'
    mqttSettings: {
      host: eventGridHostName
      authentication: {
        // See available authentication methods section for method types
        // method: <METHOD_TYPE>
      }
      tls: {
        mode: 'Enabled'
      }
    }
  }
}

Pak nasaďte pomocí Azure CLI.

az deployment group create --resource-group <RESOURCE_GROUP> --template-file <FILE>.bicep

Kubernetes (Preview)

Vytvořte soubor manifestu .yaml Kubernetes s následujícím obsahem.

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowEndpoint
metadata:
  name: <ENDPOINT_NAME>
  namespace: azure-iot-operations
spec:
  endpointType: Mqtt
  mqttSettings:
    host: <NAMESPACE>.<REGION>-1.ts.eventgrid.azure.net:8883
    authentication:
      # See available authentication methods section for method types
      # method: <METHOD_TYPE>
    tls:
      mode: Enabled

Pak použijte soubor manifestu na cluster Kubernetes.

kubectl apply -f <FILE>.yaml

Po vytvoření koncového bodu ho můžete použít v toku dat a připojit se ke zprostředkovateli Event Grid MQTT jako zdroj nebo cíl. Témata MQTT se konfigurují v toku dat.

Použití ověřování certifikátů X.509 s Event Gridem

Při použití ověřování X.509 s zprostředkovatelem Event Grid MQTT přejděte do konfigurace oboru názvů >Event Grid a zkontrolujte tato nastavení:

• Povolit MQTT: Zaškrtněte políčko.
• Povolte alternativní zdroje názvů ověřování klientů: Zaškrtněte políčko.
• Název subjektu certifikátu: Tuto možnost vyberte v rozevíracím seznamu.
• Maximální počet relací klienta na název ověřování: Nastaveno na 3 nebo více.

Alternativní ověřování klienta a maximální možnosti klientských relací umožňují tokům dat používat název subjektu klientského certifikátu pro ověřování místo MQTT CONNECT Username. Tato funkce je důležitá, aby toky dat mohly vytvářet více instancí a stále se mohly připojit. Další informace najdete v tématu Ověřování klientských certifikátů Event Grid MQTT a podpora více relací.

Potom podle kroků v certifikátu X.509 nakonfigurujte koncový bod s nastavením certifikátu X.509.

Omezení sdíleného předplatného služby Event Grid

Zprostředkovatel Azure Event Grid MQTT nepodporuje sdílená předplatná, což znamená, že pro tok dat nemůžete nastavit instanceCount více než 1 v profilu toku dat, pokud se Event Grid používá jako zdroj (kde se tok dat přihlásí k odběru zpráv). Pokud v tomto případě nastavíte instanceCount větší než 1, tok dat se nespustí.

Vlastní zprostředkovatelé MQTT

U jiných zprostředkovatelů MQTT můžete podle potřeby nakonfigurovat koncový bod, protokol TLS, ověřování a další nastavení.

Azure Portal

1. V provozním prostředí vyberte kartu Koncové body toku dat.

2. V části Vytvořit nový koncový bod toku dat vyberte Vlastní Zprostředkovatele>MQTT Nový.

   

3. Zadejte následující nastavení pro koncový bod:

   Nastavení	Description
   Name	Název koncového bodu toku dat
   Hostitelský počítač	Název hostitele koncového bodu zprostředkovatele MQTT ve formátu <hostname>.<port>.
   Metoda ověřování	Metoda použitá k ověřování. Zvolte token účtu služby nebo certifikát X509.
   Cílová skupina služeb	Cílová skupina tokenu účtu služby. Vyžaduje se, pokud používáte token účtu služby.
   Klientský certifikát X509	Klientský certifikát X.509 používaný k ověřování. Vyžaduje se, pokud používáte certifikát X509.
   Klientský klíč X509	Privátní klíč odpovídající klientskému certifikátu X.509. Vyžaduje se, pokud používáte certifikát X509.
   Zprostředkující certifikáty X509	Zprostředkující certifikáty pro řetěz klientských certifikátů X.509. Vyžaduje se, pokud používáte certifikát X509.

4. Vyberte Použít pro zřízení koncového bodu.

Bicep

mqttSettings: {
  authentication: {
    // See available authentication methods section for method types
    // method: <METHOD_TYPE>
  }
  host: '<HOST>:<PORT>'
  tls: {
    mode: 'Enabled' // or 'Disabled'
    trustedCaCertificateConfigMapRef: '<TRUSTED_CA_CERT_CONFIGMAP>'
  }
}

Kubernetes (Preview)

spec:
  endpointType: Mqtt
  mqttSettings:
    host: <HOST>:<PORT>
    authentication:
      # See available authentication methods section for method types
      # method: <METHOD_TYPE>
    tls:
      mode: Enabled # or Disabled
      trustedCaCertificateConfigMapRef: <TRUSTED_CA_CERT_CONFIGMAP>

Pokud chcete přizpůsobit nastavení koncového bodu MQTT, další informace najdete v následujících částech.

Dostupné metody ověřování

Pro koncové body toku dat zprostředkovatele MQTT jsou k dispozici následující metody ověřování.

Spravovaná identita přiřazená systémem

Před konfigurací koncového bodu toku dat přiřaďte roli spravované identitě azure IoT Operations, která uděluje oprávnění pro připojení ke zprostředkovateli MQTT:

1. Na webu Azure Portal přejděte do instance operace Azure IoT a vyberte Přehled.
2. Zkopírujte název rozšíření uvedené za rozšířením Azure IoT Operations Arc. Například azure-iot-operations-xxxx7.
3. Přejděte do cloudového prostředku, který potřebujete udělit oprávnění. Přejděte například do řízení přístupu k oboru názvů >Event Gridu (IAM)>Přidat přiřazení role.
4. Na kartě Role vyberte příslušnou roli.
5. Na kartě Členové vyberte možnost Přiřadit přístup, vyberte Možnost Uživatel, skupina nebo instanční objekt a pak vyberte a vyberte členy a vyhledejte spravovanou identitu operací Azure IoT. Například azure-iot-operations-xxxx7.

Pak nakonfigurujte koncový bod toku dat s nastavením spravované identity přiřazené systémem.

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Základní a pak zvolte spravovanou identitu přiřazenou systémem ověřování>.

Bicep

mqttSettings: {
  authentication: {
    method: 'SystemAssignedManagedIdentity'
    systemAssignedManagedIdentitySettings: {}
  }
}

Kubernetes (Preview)

mqttSettings:
  authentication:
    method: SystemAssignedManagedIdentity
    systemAssignedManagedIdentitySettings:
      {}

Ve většině případů při použití se službou Event Grid můžete ponechat nastavení prázdná, jak je znázorněno. Tím se cílová skupina spravované identity nastaví na společnou cílovou skupinu https://eventgrid.azure.netEvent Gridu . Pokud potřebujete nastavit jinou cílovou skupinu, můžete ji zadat v nastavení.

Azure Portal

Nepodporováno

Bicep

mqttSettings: {
  authentication: {
    method: 'SystemAssignedManagedIdentity'
    systemAssignedManagedIdentitySettings: {
      audience: 'https://<AUDIENCE>'
    }
  }
}

Kubernetes (Preview)

mqttSettings:
  authentication:
    method: SystemAssignedManagedIdentity
    systemAssignedManagedIdentitySettings:
      audience: https://<AUDIENCE>

Spravovaná identita přiřazená uživatelem

Pokud chcete pro ověřování použít spravovanou identitu přiřazenou uživatelem, musíte nejprve nasadit operace Azure IoT s povoleným zabezpečeným nastavením. Pak musíte nastavit spravovanou identitu přiřazenou uživatelem pro cloudová připojení. Další informace najdete v tématu Povolení nastavení zabezpečení v nasazení operací Azure IoT.

Před konfigurací koncového bodu toku dat přiřaďte spravované identitě přiřazené uživatelem roli, která uděluje oprávnění pro připojení ke zprostředkovateli MQTT:

1. Na webu Azure Portal přejděte do cloudového prostředku, který potřebujete udělit oprávnění. Přejděte například do řízení přístupu k oboru názvů >Event Gridu (IAM)>Přidat přiřazení role.
2. Na kartě Role vyberte příslušnou roli.
3. Na kartě Členové vyberte možnost Přiřadit přístup, vyberte možnost Spravovaná identita a pak vyberte a vyberte členy a vyhledejte spravovanou identitu přiřazenou uživatelem.

Pak nakonfigurujte koncový bod toku dat s nastavením spravované identity přiřazené uživatelem.

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Základní a pak zvolte Spravovaná identita přiřazená metodou>ověřování.

Bicep

mqttSettings: {
  authentication: {
    method: 'UserAssignedManagedIdentity'
    userAssignedManagedIdentitySettings: {
      clientId: '<ID>'
      tenantId: '<ID>'
      // Optional, defaults to 'https://eventgrid.azure.net/.default'
      // scope: 'https://<SCOPE_URL>' 
    }
  }
}

Kubernetes (Preview)

mqttSettings:
  authentication:
    method: UserAssignedManagedIdentity
    userAssignedManagedIdentitySettings:
      clientId: <ID>
      tenantId: <ID>
      # Optional, defaults to 'https://eventgrid.azure.net/.default'
      # scope: https://<SCOPE_URL>

Tady je obor volitelný a výchozí hodnota, která funguje pro všechny obory https://eventgrid.azure.net/.default názvů Azure Event Gridu. Pokud potřebujete nastavit jiný obor, můžete ho zadat v nastavení prostřednictvím Bicep nebo Kubernetes.

Token účtu služby Kubernetes (SAT)

Pokud chcete pro ověřování použít token účtu služby Kubernetes Service (SAT), nemusíte vytvářet tajný kód. Sat se používá k ověření u zprostředkovatele MQTT tak, že odpovídá cílové skupině.

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Základní a pak zvolte token účtu služby metody>ověřování.

Zadejte cílovou skupinu služeb.

Bicep

mqttSettings: {
  authentication: {
    method: 'ServiceAccountToken'
    serviceAccountTokenSettings: {
      audience: '<YOUR_SERVICE_ACCOUNT_AUDIENCE>'
    }
  }
}

Kubernetes (Preview)

mqttSettings:
  authentication:
    method: ServiceAccountToken
    serviceAccountTokenSettings:
      audience: <YOUR_SERVICE_ACCOUNT_AUDIENCE>

Certifikát X.509

Mnoho zprostředkovatelů MQTT, jako je Event Grid, podporuje ověřování X.509. Toky dat můžou prezentovat klientský certifikát X.509 a vyjednat komunikaci TLS.

Certifikát a privátní klíč musí být ve formátu PEM a nesmí být chráněný heslem.

Tip

Formát PEM je běžný formát pro certifikáty a klíče. Certifikáty a klíče ve formátu PEM jsou soubory ASCII s kódováním Base64 s hlavičkami, které vypadají podobně -----BEGIN CERTIFICATE----- a -----BEGIN EC PRIVATE KEY----

Pokud máte certifikát v jiném formátu, můžete ho převést na formát PEM pomocí OpenSSL. Další informace najdete v tématu Jak převést certifikát do příslušného formátu.

Před konfigurací koncového bodu toku dat vytvořte tajný klíč s certifikátem a privátním klíčem.

• Pokud používáte portál Operations Portal, tajný kód se automaticky naformátuje a synchronizuje do clusteru Kubernetes.

• Pokud používáte Bicep nebo Kubernetes, ručně vytvořte tajný klíč pomocí certifikátu a privátního klíče ve stejném oboru názvů jako koncový bod toku dat MQTT.

  kubectl create secret generic <X509_SECRET_NAME> -n azure-iot-operations --from-file=client_cert.pem=<CLIENT_CERT_FILE>.pem --from-file=client_key.pem=<PRIVATE_KEY_FILE>.pem --from-file=client_intermediate_certs.pem=<INTERMEDIATE_CERT_FILE>.pem
  

  V této části musí tajný klíč obsahovat client_cert.pem a client_key.pem jako názvy klíčů pro certifikát a privátní klíč. Volitelně může tajný klíč mít client_intermediate_certs.pem také název klíče pro zprostředkující certifikáty.

Azure Portal

Důležité

Pokud chcete ke správě tajných kódů použít portál provozního prostředí, musí být operace Azure IoT nejprve povoleny se zabezpečeným nastavením konfigurací služby Azure Key Vault a povolením identit úloh. Další informace najdete v tématu Povolení nastavení zabezpečení v nasazení operací Azure IoT.

Důležité

Portál provozního prostředí má aktuálně známý problém, kdy vytvoření tajného kódu X.509 vede k tajnému kódu s nesprávně zakódovanými daty. Další informace a alternativní řešení najdete v známých problémech.

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Základní a pak zvolte certifikát metody>ověřování X509.

V části Název synchronizovaného tajného kódu zadejte název tajného kódu. Tento název se používá k odkazování na tajný klíč v nastavení koncového bodu toku dat a je to název tajného kódu, který je uložený v clusteru Kubernetes.

Potom v části Klientský certifikát X509, klientský klíč X509 a zprostředkující certifikáty X509 vyberte Přidat odkaz pro přidání certifikátu, privátního klíče a zprostředkujících certifikátů. Na další stránce vyberte tajný klíč ze služby Azure Key Vault a přidejte ho ze služby Azure Key Vault nebo vytvořte nový tajný klíč.

Pokud vyberete Vytvořit nový, zadejte následující nastavení:

Nastavení	Popis
Název tajného klíče	Název tajného kódu ve službě Azure Key Vault. Vyberte název, který si můžete snadno zapamatovat, abyste ho později ze seznamu vybrali.
Hodnota tajného klíče	Certifikát, privátní klíč nebo zprostředkující certifikáty ve formátu PEM.
Nastavení data aktivace	Pokud je zapnuté, datum, kdy se tajný klíč aktivuje.
Nastavení data vypršení platnosti	Pokud je tato možnost zapnutá, datum vypršení platnosti tajného kódu.

Další informace o tajných kódech najdete v tématu Vytváření a správa tajných kódů v operacích Azure IoT.

Bicep

mqttSettings: {
  authentication: {
    method: 'X509Certificate'
      x509CertificateSettings:
        secretRef: '<X509_SECRET_NAME>'
  }
}

Kubernetes (Preview)

mqttSettings:
  authentication:
    method: X509Certificate
    x509CertificateSettings:
      secretRef: <X509_SECRET_NAME>

Anonymní

Chcete-li použít anonymní ověřování, nastavte metodu ověřování na Anonymous.

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Základní a pak zvolte Metodu>ověřování None.

Bicep

mqttSettings: {
  authentication: {
    method: 'Anonymous'
  }
}

Kubernetes (Preview)

mqttSettings:
  authentication:
    method: Anonymous
    anonymousSettings:
      {}

Rozšířené nastavení

Můžete nastavit upřesňující nastavení pro koncový bod toku dat zprostředkovatele MQTT, jako je TLS, důvěryhodný certifikát certifikační autority, nastavení zasílání zpráv MQTT a CloudEvents. Tato nastavení můžete nastavit na kartě Portál Advanced Portal koncového bodu toku dat v rámci vlastního prostředku koncového bodu toku dat.

Azure Portal

V provozním prostředí vyberte kartu Upřesnit pro koncový bod toku dat.

Bicep

// See sections below for explanation of each setting
mqttSettings: {
  qos: 1
  retain: 'Keep'
  sessionExpirySeconds: 3600
  keepAliveSeconds: 60
  maxInflightMessages: 100
  protocol: WebSockets
  clientIdPrefix: 'dataflow'
  cloudEventAttributes : 'Propagate' // or 'CreateOrRemap'
}

Kubernetes (Preview)

# See sections below for explanation of each setting
mqttSettings:
  qos: 1
  retain: Keep
  sessionExpirySeconds: 3600
  keepAliveSeconds: 60
  maxInflightMessages: 100
  protocol: WebSockets
  clientIdPrefix: dataflow
  cloudEventAttributes : Propagate # or CreateOrRemap

Nastavení protokolu TLS

Režim TLS

Pokud chcete povolit nebo zakázat protokol TLS pro koncový bod MQTT, aktualizujte mode nastavení v nastavení protokolu TLS.

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Upřesnit a pak použijte zaškrtávací políčko vedle povoleného režimu TLS.

Bicep

mqttSettings: {
  tls: {
    mode: 'Enabled' // or 'Disabled'
  }
}

Kubernetes (Preview)

mqttSettings:
  tls:
    mode: Enabled # or Disabled

Režim TLS lze nastavit na Enabled nebo Disabled. Pokud je režim nastavený na Enabled, tok dat používá zabezpečené připojení k zprostředkovateli MQTT. Pokud je režim nastavený na Disabled, tok dat používá nezabezpečené připojení ke zprostředkovateli MQTT.

Certifikát důvěryhodné certifikační autority

Nakonfigurujte certifikát důvěryhodné certifikační autority pro koncový bod MQTT, aby vytvořil zabezpečené připojení ke zprostředkovateli MQTT. Toto nastavení je důležité, pokud zprostředkovatel MQTT používá certifikát podepsaný svým držitelem nebo certifikát podepsaný vlastní certifikační autoritou, která není ve výchozím nastavení důvěryhodná.

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Upřesnit a pak pomocí pole mapování konfigurace certifikátu důvěryhodné certifikační autority zadejte objekt ConfigMap obsahující certifikát důvěryhodné certifikační autority.

Bicep

mqttSettings: {
  tls: {
    trustedCaCertificateConfigMapRef: '<YOUR_CA_CERTIFICATE>'
  }
}

Kubernetes (Preview)

mqttSettings:
  tls:
    trustedCaCertificateConfigMapRef: <YOUR_CA_CERTIFICATE>

Tato mapa configmap by měla obsahovat certifikát certifikační autority ve formátu PEM. Objekt ConfigMap musí být ve stejném oboru názvů jako prostředek toku dat MQTT. Příklad:

kubectl create configmap client-ca-configmap --from-file root_ca.crt -n azure-iot-operations

---

Tip

Při připojování ke zprostředkovateli Event Grid MQTT se certifikát certifikační autority nevyžaduje, protože služba Event Hubs používá certifikát podepsaný veřejnou certifikační autoritou, která je ve výchozím nastavení důvěryhodná.

Předpona ID klienta

Můžete nastavit předponu ID klienta pro klienta MQTT. ID klienta se vygeneruje připojením názvu instance toku dat k předponě.

Upozornění

Většina aplikací by neměla upravovat předponu ID klienta. Po počátečním nasazení operací IoT to neupravujte. Změna předpony ID klienta po nasazení může způsobit ztrátu dat.

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Upřesnit a pak pomocí pole předpony ID klienta zadejte předponu .

Bicep

mqttSettings: {
  clientIdPrefix: '<YOUR_PREFIX>'
}

Kubernetes (Preview)

mqttSettings:
  clientIdPrefix: <YOUR_PREFIX>

QoS

Úroveň kvality služby (QoS) pro zprávy MQTT můžete nastavit na hodnotu 1 nebo 0. Výchozí hodnota je 1.

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Upřesnit a pak pomocí pole QoS (Quality of Service) zadejte úroveň QoS.

Bicep

mqttSettings: {
  qos: 1 // Or 0
}

Kubernetes (Preview)

mqttSettings:
  qos: 1 # Or 0

Ponechat si

retain Pomocí nastavení určete, jestli má tok dat uchovávat příznak pro zprávy MQTT. Výchozí hodnota je Keep.

Nastavení tohoto pole tak, aby Keep bylo užitečné zajistit, aby vzdálený zprostředkovatel zachoval stejné zprávy jako místní zprostředkovatel, což může být důležité pro scénáře sjednoceného oboru názvů (UNS).

Pokud je nastavená hodnota Never, příznak zachování se odebere ze zpráv MQTT. To může být užitečné, když nechcete, aby vzdálený zprostředkovatel uchovál žádné zprávy nebo pokud vzdálený zprostředkovatel nepodporuje zachování.

Konfigurace nastavení zachování:

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Upřesnit a pak pomocí pole Zachovat určete nastavení zachování.

Bicep

mqttSettings: {
  retain: Keep // or Never
}

Kubernetes (Preview)

mqttSettings:
  retain: Keep # or Never

Nastavení zachování se projeví jenom v případě, že tok dat jako zdroj i cíl používá koncový bod MQTT. Například ve scénáři mostu MQTT.

Důležité

Zprostředkovatel Azure Event Grid MQTT v současné době nepodporuje příznak zachování. To znamená, že pokud příznak zachování nastavíte na Keep koncový bod zprostředkovatele Event Grid MQTT a použijete ho jako cíl, zprávy se zamítnou. Chcete-li tomu zabránit, nastavte příznak zachování při Never použití zprostředkovatele Event Grid MQTT jako cíle.

Vypršení platnosti relace

Pro klienta MQTT toku dat můžete nastavit interval vypršení platnosti relace. Interval vypršení platnosti relace je maximální doba, po kterou se relace MQTT udržuje, pokud se klient toku dat odpojí. Výchozí hodnota je 600 sekund. Konfigurace intervalu vypršení platnosti relace:

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Upřesnit a potom pomocí pole Vypršení platnosti relace určete interval vypršení platnosti relace.

Bicep

mqttSettings: {
  sessionExpirySeconds: 600
}

Kubernetes (Preview)

mqttSettings:
  sessionExpirySeconds: 600

Protokol MQTT nebo WebSockets

Ve výchozím nastavení nejsou protokoly WebSockets povolené. Pokud chcete použít MQTT přes WebSockets, nastavte protocol pole na WebSocketshodnotu .

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Upřesnit a pak pomocí pole Protokol zadejte protokol.

Bicep

mqttSettings: {
  protocol: 'WebSockets'
}

Kubernetes (Preview)

mqttSettings:
  protocol: WebSockets

Maximální počet příchozích zpráv

Můžete nastavit maximální počet příchozích zpráv, které může mít klient MQTT toku dat. Výchozí volba je 100.

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Upřesnit a pak pomocí pole Maximální počet zpráv v letu určete maximální počet letových zpráv.

Bicep

mqttSettings: {
  maxInflightMessages: 100
}

Kubernetes (Preview)

mqttSettings:
  maxInflightMessages: 100

Pro přihlášení k odběru, když se koncový bod MQTT používá jako zdroj, je to maximum pro příjem. Pro publikování, když se koncový bod MQTT používá jako cíl, je to maximální počet zpráv, které se mají odeslat před čekáním na potvrzení.

Udržování naživu

Můžete nastavit interval uchování pro klienta MQTT toku dat. Interval zachování je maximální doba, po kterou může být klient toku dat nečinný před odesláním zprávy PINGREQ do zprostředkovatele. Výchozí hodnota je 60 sekund.

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Upřesnit a potom pomocí pole Zachovat aktivní určete interval zachování.

Bicep

mqttSettings: {
  keepAliveSeconds: 60
}

Kubernetes (Preview)

mqttSettings:
  keepAliveSeconds: 60

CloudEvents

CloudEvents představují způsob, jak běžným způsobem popsat data událostí. Nastavení CloudEvents slouží k odesílání nebo přijímání zpráv ve formátu CloudEvents. CloudEvents můžete použít pro architektury řízené událostmi, ve kterých se různé služby potřebují vzájemně komunikovat ve stejných nebo různých poskytovatelích cloudu.

Možnosti cloudEventAttributes jsou Propagate neboCreateOrRemap. Konfigurace nastavení CloudEvents:

Azure Portal

Na stránce nastavení koncového bodu toku dat v provozním prostředí vyberte kartu Upřesnit a pak pomocí pole Atributy cloudové události určete nastavení CloudEvents.

Bicep

mqttSettings: {
  cloudEventAttributes : 'Propagate' // or 'CreateOrRemap'
}

Kubernetes (Preview)

mqttSettings:
  cloudEventAttributes : Propagate # or CreateOrRemap

Následující části obsahují další informace o nastavení CloudEvents.

Rozšířit nastavení

Vlastnosti CloudEvent se předávají pro zprávy, které obsahují požadované vlastnosti. Pokud zpráva neobsahuje požadované vlastnosti, zpráva se předává tak, jak je.

Název	Požaduje se	Ukázková hodnota	Výstupní hodnota
specversion	Ano	1.0	Předáno tak, jak je
type	Ano	ms.aio.telemetry	Předáno tak, jak je
source	Ano	aio://mycluster/myoven	Předáno tak, jak je
id	Ano	A234-1234-1234	Předáno tak, jak je
subject	No	aio/myoven/telemetry/temperature	Předáno tak, jak je
time	No	2018-04-05T17:31:00Z	Prošlo se tak, jak je. Není převzorkovaná.
datacontenttype	No	application/json	Změna na typ výstupního datového obsahu po volitelné fázi transformace
dataschema	No	sr://fabrikam-schemas/123123123234234234234234#1.0.0	Pokud je v konfiguraci transformace předáno schéma transformace výstupních dat, dataschema změní se na výstupní schéma.

Nastavení CreateOrRemap

Vlastnosti CloudEvent se předávají pro zprávy, které obsahují požadované vlastnosti. Pokud zpráva neobsahuje požadované vlastnosti, vygenerují se vlastnosti.

Název	Požaduje se	Vygenerovaná hodnota, pokud chybí
specversion	Ano	1.0
type	Ano	ms.aio-dataflow.telemetry
source	Ano	aio://<target-name>
id	Yes	Vygenerované UUID v cílovém klientovi
subject	No	Výstupní téma, ve kterém je zpráva odeslána
time	No	Vygenerováno jako RFC 3339 v cílovém klientovi
datacontenttype	No	Změna na typ výstupního datového obsahu po volitelné fázi transformace
dataschema	No	Schéma definované v registru schématu

Další kroky

Další informace o tocích dat najdete v tématu Vytvoření toku dat.