Skip to content

Commit 41af1ca

Browse files
authored
Merge pull request #294393 from PatAltimore/patricka-data-flow
Update data flow screenshots
2 parents dee0473 + 7fd1064 commit 41af1ca

32 files changed

+9
-12
lines changed

articles/iot-operations/connect-to-cloud/howto-configure-mqtt-endpoint.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,7 @@ You can also create new local MQTT broker endpoints with custom settings. For ex
127127
| Host | The hostname and port of the MQTT broker. Use the format `<hostname>:<port>` |
128128
| Authentication method | The method used for authentication. Choose [*Service account token*](#kubernetes-service-account-token-sat), or [*X509 certificate*](#x509-certificate) |
129129
| Service audience | The audience for the service account token. Required if using *Service account token*. |
130-
| X509 client certificate | The X.509 client certificate used for authentication. Required if using *X509 certificate*. |
130+
| X509 client certificate | The X.509 client certificate used for authentication. Required if using *X509 certificate*. You can upload industry-standard multi-line X509 certificates improving device authentication management, security, and flexibility.|
131131
| X509 client key | The private key corresponding to the X.509 client certificate. Required if using *X509 certificate*. |
132132
| X509 intermediate certificates | The intermediate certificates for the X.509 client certificate chain. Required if using *X509 certificate*. |
133133

@@ -372,7 +372,7 @@ For other MQTT brokers, you can configure the endpoint, TLS, authentication, and
372372
| Host | The hostname of the MQTT broker endpoint in the format `<hostname>.<port>`. |
373373
| Authentication method | The method used for authentication. Choose [*Service account token*](#kubernetes-service-account-token-sat), or [*X509 certificate*](#x509-certificate). |
374374
| Service audience | The audience for the service account token. Required if using *Service account token*. |
375-
| X509 client certificate | The X.509 client certificate used for authentication. Required if using *X509 certificate*. |
375+
| X509 client certificate | The X.509 client certificate used for authentication. Required if using *X509 certificate*. You can upload industry-standard multi-line X509 certificates improving device authentication management, security, and flexibility. |
376376
| X509 client key | The private key corresponding to the X.509 client certificate. Required if using *X509 certificate*. |
377377
| X509 intermediate certificates | The intermediate certificates for the X.509 client certificate chain. Required if using *X509 certificate*. |
378378

@@ -580,7 +580,7 @@ Many MQTT brokers, like Event Grid, support X.509 authentication. Data flows can
580580
The certificate and private key must be in PEM format and not password protected.
581581

582582
> [!TIP]
583-
> PEM format is a common format for certificates and keys. Certificates and keys in PEM format are base64-encoded ASCII files with a headers that look like `-----BEGIN CERTIFICATE-----` and `-----BEGIN EC PRIVATE KEY----`
583+
> PEM format is a common format for certificates and keys. Certificates and keys in PEM format are base64-encoded ASCII files with headers that look like `-----BEGIN CERTIFICATE-----` and `-----BEGIN EC PRIVATE KEY----`
584584
>
585585
> If you have a certificate in another format, you can convert it to PEM format using OpenSSL. To learn more, see [How to convert a certificate into the appropriate format](https://knowledge.digicert.com/solution/how-to-convert-a-certificate-into-the-appropriate-format).
586586

@@ -601,7 +601,7 @@ Before configuring the data flow endpoint, create a secret with the certificate
601601
> To use the operations experience portal to manage secrets, Azure IoT Operations must first be enabled with secure settings by configuring an Azure Key Vault and enabling workload identities. To learn more, see [Enable secure settings in Azure IoT Operations deployment](../deploy-iot-ops/howto-enable-secure-settings.md).
602602

603603
> [!IMPORTANT]
604-
> The operations experience portal currently has a known issue where creating a X.509 secret results in a secret with incorrectly encoded data. To learn more and the workaround, see [known issues](../troubleshoot/known-issues.md).
604+
> The operations experience portal currently has a known issue where creating an X.509 secret results in a secret with incorrectly encoded data. To learn more and the workaround, see [known issues](../troubleshoot/known-issues.md).
605605

606606
In the operations experience data flow endpoint settings page, select the **Basic** tab then choose **Authentication method** > **X509 certificate**.
607607

@@ -614,7 +614,7 @@ If you select **Create new**, enter the following settings:
614614
| Setting | Description |
615615
| ------- | ----------- |
616616
| Secret name | The name of the secret in Azure Key Vault. Pick a name that is easy to remember to select the secret later from the list. |
617-
| Secret value | The certificate, private key, or intermediate certificates in PEM format. |
617+
| Secret value | The certificate, private key, or intermediate certificates in PEM format. You can upload industry-standard multi-line X509 certificates improving device authentication management, security, and flexibility. |
618618
| Set activation date | If turned on, the date when the secret becomes active. |
619619
| Set expiration date | If turned on, the date when the secret expires. |
620620

articles/iot-operations/connect-to-cloud/howto-create-dataflow.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.author: patricka
66
ms.service: azure-iot-operations
77
ms.subservice: azure-data-flows
88
ms.topic: how-to
9-
ms.date: 01/07/2025
9+
ms.date: 02/07/2025
1010
ai-usage: ai-assisted
1111

1212
#CustomerIntent: As an operator, I want to understand how to create a data flow to connect data sources.
@@ -186,7 +186,7 @@ If the default endpoint isn't used as the source, it must be used as the [destin
186186
| Setting | Description |
187187
| -------------------- | ------------------------------------------------------------------------------------------------- |
188188
| Data flow endpoint | Select *default* to use the default MQTT message broker endpoint. |
189-
| Topic | The topic filter to subscribe to for incoming messages. See [Configure MQTT or Kafka topics](#configure-data-sources-mqtt-or-kafka-topics). |
189+
| Topic | The topic filter to subscribe to for incoming messages. Use **Topic(s)** > **Add row** to add multiple topics. For more information on topics, see [Configure MQTT or Kafka topics](#configure-data-sources-mqtt-or-kafka-topics). |
190190
| Message schema | The schema to use to deserialize the incoming messages. See [Specify schema to deserialize data](#specify-source-schema). |
191191

192192
1. Select **Apply**.
@@ -268,7 +268,7 @@ If you created a custom MQTT or Kafka data flow endpoint (for example, to use wi
268268
| Setting | Description |
269269
| -------------------- | ------------------------------------------------------------------------------------------------- |
270270
| Data flow endpoint | Use the **Reselect** button to select a custom MQTT or Kafka data flow endpoint. For more information, see [Configure MQTT data flow endpoints](howto-configure-mqtt-endpoint.md) or [Configure Azure Event Hubs and Kafka data flow endpoints](howto-configure-kafka-endpoint.md).|
271-
| Topic | The topic filter to subscribe to for incoming messages. See [Configure MQTT or Kafka topics](#configure-data-sources-mqtt-or-kafka-topics). |
271+
| Topic | The topic filter to subscribe to for incoming messages. Use **Topic(s)** > **Add row** to add multiple topics. For more information on topics, see [Configure MQTT or Kafka topics](#configure-data-sources-mqtt-or-kafka-topics). |
272272
| Message schema | The schema to use to deserialize the incoming messages. See [Specify schema to deserialize data](#specify-source-schema). |
273273

274274
1. Select **Apply**.
@@ -313,10 +313,7 @@ When the source is an MQTT (Event Grid included) endpoint, you can use the MQTT
313313

314314
# [Portal](#tab/portal)
315315

316-
In the operations experience data flow **Source details**, select **Message broker**, then use the **Topic** field to specify the MQTT topic filter to subscribe to for incoming messages.
317-
318-
> [!NOTE]
319-
> Only one topic filter can be specified in the operations experience. To use multiple topic filters, use Bicep or Kubernetes.
316+
In the operations experience data flow **Source details**, select **Message broker**, then use the **Topic(s)** field to specify the MQTT topic filters to subscribe to for incoming messages. You can add multiple MQTT topics by selecting **Add row** and entering a new topic.
320317

321318
# [Bicep](#tab/bicep)
322319

8.67 KB
Loading
-115 KB
Loading
-122 KB
Loading
-97 KB
Loading
-110 KB
Loading
-45.8 KB
Loading
-53.4 KB
Loading
-143 KB
Loading

0 commit comments

Comments
 (0)