Skip to content

Commit 59ccd56

Browse files
committed
Add links
1 parent eda84a2 commit 59ccd56

File tree

5 files changed

+11
-0
lines changed

5 files changed

+11
-0
lines changed

articles/iot-operations/manage-mqtt-broker/howto-configure-authentication.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -331,6 +331,9 @@ For more information about enabling secure settings by configuring an Azure Key
331331

332332
## X.509
333333

334+
> [!TIP]
335+
> For an end-to-end example of how to configure X.509 authentication, see [Tutorial: TLS, X.509 client authentication, and attribute-based access control (ABAC) authorization](./tutorial-tls-and-x509.md).
336+
334337
With X.509 authentication, the MQTT broker uses a **trusted CA certificate** to validate client certificates. This trusted CA can be a root or intermediate CA. The broker checks the client certificate chain against the trusted CA certificate. If the chain is valid, the client is authenticated.
335338

336339
To use X.509 authentication with a trusted CA certificate, the following requirements must be met:
@@ -604,6 +607,8 @@ To get a TLS-enabled listener port, see [Enable TLS manual certificate managemen
604607
> - **Server validation**: Clients (like mosquitto or MQTTX) check the MQTT broker's server certificate against the trusted CA certificate in their trust store. For mosquitto clients, use the `--cafile` parameter to specify the CA certificate file. For MQTTX, add the CA certificate to the trust store in the settings.
605608
>
606609
> So, after enabling X.509 authentication, ensure that clients trust the broker's server certificate by having the *server-side* CA certificate in their trust store. Don't confuse this with the *client-side* CA certificate used for client authentication, which is specified in the `trustedClientCaCert` field.
610+
>
611+
> For a full example, see [Tutorial: TLS, X.509 client authentication, and attribute-based access control (ABAC) authorization](./tutorial-tls-and-x509.md).
607612

608613
### Connect mosquitto client to MQTT broker with X.509 client certificate
609614

@@ -889,3 +894,4 @@ Successful reauthentication updates the client's credential expiry with the expi
889894

890895
- About [BrokerListener resource](howto-configure-brokerlistener.md)
891896
- [Configure authorization for a BrokerListener](./howto-configure-authorization.md)
897+
- [Tutorial: TLS, X.509 client authentication, and attribute-based access control (ABAC) authorization](./tutorial-tls-and-x509.md)

articles/iot-operations/manage-mqtt-broker/howto-configure-authorization.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -786,3 +786,4 @@ With MQTT 3.1.1, when a publish is denied, the client receives the PUBACK with n
786786

787787
- About [BrokerListener resource](howto-configure-brokerlistener.md)
788788
- [Configure authentication for a BrokerListener](./howto-configure-authentication.md)
789+
- [Tutorial: TLS, X.509 client authentication, and attribute-based access control (ABAC) authorization](./tutorial-tls-and-x509.md)

articles/iot-operations/manage-mqtt-broker/howto-configure-brokerlistener.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -921,3 +921,4 @@ From here, follow the same steps as previously to create a server certificate wi
921921

922922
- [Configure MQTT broker authorization](howto-configure-authorization.md)
923923
- [Configure MQTT broker authentication](howto-configure-authentication.md)
924+
- [Tutorial: TLS, X.509 client authentication, and attribute-based access control (ABAC) authorization](./tutorial-tls-and-x509.md)

articles/iot-operations/manage-mqtt-broker/howto-test-connection.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -615,3 +615,4 @@ spec:
615615

616616
- [Configure TLS with manual certificate management to secure MQTT communication](howto-configure-tls-manual.md)
617617
- [Configure authentication](howto-configure-authentication.md)
618+
- [Tutorial: TLS, X.509 client authentication, and attribute-based access control (ABAC) authorization](./tutorial-tls-and-x509.md)

articles/iot-operations/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -189,6 +189,8 @@ items:
189189
href: connect-to-cloud/tutorial-mqtt-bridge.md
190190
- name: Send data to Data Lake Storage
191191
href: connect-to-cloud/tutorial-opc-ua-to-data-lake.md
192+
- name: TLS/X.509/ABAC
193+
href: manage-mqtt-broker/tutorial-tls-and-x509.md
192194
- name: Troubleshoot
193195
items:
194196
- name: Troubleshoot

0 commit comments

Comments
 (0)