|
15 | 15 | * [Direct MQTT with PKCS12 Method](#direct-mqtt-with-pkcs12-method)
|
16 | 16 | * [MQTT over Websockets with Sigv4 authentication](#mqtt-over-websockets-with-sigv4-authentication)
|
17 | 17 | * [MQTT over Websockets with Cognito authentication](#mqtt-over-websockets-with-cognito-authentication)
|
| 18 | + * [Direct MQTT with Windows Certificate Store Method](#direct-mqtt-with-windows-certificate-store-method) |
18 | 19 | * [Adding an HTTP Proxy](#adding-an-http-proxy)
|
19 | 20 | * [Client Lifecycle Management](#client-lifecycle-management)
|
20 | 21 | * [Lifecycle Events](#lifecycle-events)
|
|
26 | 27 |
|
27 | 28 | ## **Introduction**
|
28 | 29 |
|
29 |
| -This user guide is designed to act as a reference and guide for how to use MQTT5 with the Java SDK. This guide includes code snippets for how to make a MQTT5 client with proper configuration, how to connect to AWS IoT Core, how to perform operations and interact with AWS IoT Core through MQTT5, and some best practices for MQTT5. |
| 30 | +This user guide is designed to act as a reference and guide for how to use MQTT5 with the Python SDK. This guide includes code snippets for how to make a MQTT5 client with proper configuration, how to connect to AWS IoT Core, how to perform operations and interact with AWS IoT Core through MQTT5, and some best practices for MQTT5. |
30 | 31 |
|
31 | 32 | If you are completely new to MQTT, it is highly recommended to check out the following resources to learn more about MQTT:
|
32 | 33 |
|
@@ -211,6 +212,19 @@ To create a MQTT5 builder configured for this connection, see the following code
|
211 | 212 |
|
212 | 213 | **Note**: A Cognito identity ID is different from a Cognito identity pool ID and trying to connect with a Cognito identity pool ID will not work. If you are unable to connect, make sure you are passing a Cognito identity ID rather than a Cognito identity pool ID.
|
213 | 214 |
|
| 215 | +#### **Direct MQTT with Windows Certificate Store Method** |
| 216 | +A MQTT5 direct connection can be made with mutual TLS with the certificate and private key in the Windows certificate |
| 217 | +store, rather than simply being files on disk. To create a MQTT5 builder configured for this connection, see the |
| 218 | +following code: |
| 219 | + |
| 220 | +```python |
| 221 | + client = mqtt5_client_builder.mtls_with_windows_cert_store_path( |
| 222 | + cert_store_path="<CurrentUser\\MY\\A11F8A9B5DF5B98BA3508FBCA575D09570E0D2C6>", |
| 223 | + endpoint="<client specific endpoint>") |
| 224 | +``` |
| 225 | + |
| 226 | +**Note**: Windows Certificate Store connection support is only available on Windows devices. |
| 227 | + |
214 | 228 | ### **Adding an HTTP Proxy**
|
215 | 229 | No matter what your connection transport or authentication method is, you may connect through an HTTP proxy
|
216 | 230 | by adding the http_proxy_options keyword argument to the builder:
|
|
0 commit comments