Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

adding notes about security on readme file #1498

Merged
merged 11 commits into from
Nov 13, 2020
14 changes: 13 additions & 1 deletion sdk/samples/iot/docs/how_to_iot_hub_esp8266_nodemcu.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ _The following was run on Windows 10 and Ubuntu Desktop 20.04 environments, with

This will create a local file named `azure-sdk-for-c.zip` containing the entire [Azure SDK for Embedded C](https://github.com/Azure/azure-sdk-for-c) repository as an Arduino library.

NOTE: If you are using WSL, do not run these commands from the Windows system drive (e.g. `/mnt/c/`).
NOTE: If you are using WSL, do not run these commands from the Windows system drive (e.g. `/mnt/c/`).

2. Run the Arduino IDE.

Expand Down Expand Up @@ -265,6 +265,18 @@ _The following was run on Windows 10 and Ubuntu Desktop 20.04 environments, with
</p>
</details>

## Certificates - Important to know

The Azure IoT service certificates presented during TLS negotiation shall be always validated, on the device, using the appropriate trusted root CA certificate(s).

For the Node MCU ESP8266 sample, our script `generate_arduino_zip_library.sh` automatically downloads the root certificate used in the United States regions (Baltimore CA certificate) and adds it to the Arduino sketch project.

For other regions (and private cloud environments), please use the appropriate root CA certificate.

### Additional Information

For important information and additional guidance about certificates, please refer to [this blog post](https://techcommunity.microsoft.com/t5/internet-of-things/azure-iot-tls-changes-are-coming-and-why-you-should-care/ba-p/1658456) from the security team.

## Troubleshooting

- The error policy for the Embedded C SDK client library is documented [here](https://github.com/Azure/azure-sdk-for-c/blob/master/sdk/docs/iot/mqtt_state_machine.md#error-policy).
Expand Down