Advertisement
Quick Links
INGICS
AP NOTE
Ver.5
Introduction
This application note provides a step-by-step setup to connect iGS01S/iGS02E/iGS03 with Azure IoT Hub.
Azure-IoT allows Symmetric Key or X.509 Certificates for internal authorization
(https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-security).
Both should work with IGS01S/iGS02E/iGS03.
Prerequisites
Before using iGS01s/iGS02E with Azure Iot, you have to create an IoT hub with your Azure subscription.
See
Create an IoT hub
Example By Using Symmetric Key
IoT Hub can use security tokens to authenticate devices and services to avoid sending keys on the wire. To
use a security token, create a device with authentication type "Symmetric key".
INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM
TECHNOLOGY
for detailed steps.
iGS01S/iGS02E/iGS03
Azure IoT Hub Guide
1
Advertisement
Subscribe to Our Youtube Channel
Related Manuals for Ingics iGS01S
Summary of Contents for Ingics iGS01S
- Page 1 Azure-IoT allows Symmetric Key or X.509 Certificates for internal authorization (https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-security). Both should work with IGS01S/iGS02E/iGS03. Prerequisites Before using iGS01s/iGS02E with Azure Iot, you have to create an IoT hub with your Azure subscription. Create an IoT hub for detailed steps. Example By Using Symmetric Key IoT Hub can use security tokens to authenticate devices and services to avoid sending keys on the wire.
- Page 2 You can download the mosquitto tool to test connecting Azure IoT Hub with mqtt. https://mosquitto.org/download/ Below shows an example to publish a “hello” message to Azure IoT using mosquitto command line tool. $ mosquitto_pub -h igs-test.azure-devices.net -p 8883 -i igs01s -t devices/igs01s/messages/events/ -u igs-test.azure-devices.net/igs01s -P "SharedAccessSignature sr=igs-test.azure-devices.net%2Fdevices%2Figs01s&sig=12bF1jJ%2FQWg8XYJPzfne1vWN5HEp02VvIBDEcc1...
- Page 3 ● MQTT PUBTOPIC: devices/<Device ID>/messages/events/ ● MQTT CLIENTID: <Device ID> ● MQTT USERNAME: <IoT Hub Name>.azure-devices.net/<Device ID> ● MQTT PASSWORD: <SAS Token of the Device> ● Enable MQTTS ● Select Azure-IoT-Hub RootCA ● Disable use certificate INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM...
- Page 4 Configuration for iGS03 Series Users can use the ‘Cloud Iot Helper’ to set up the iGS03. The application settings will be filled by ‘Cloud Iot Helper’, or users can fill the configuration manually. INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM...
- Page 5 $ openssl req -new -key primary.key -sha256 -out primary.csr $ openssl x509 -req -days 365 -in primary.csr -signkey primary.key -sha256 -out primary.cert $ openssl x509 -in primary.cert -out primary.cert.pem -outform PEM $ openssl rsa -in primary.key -out primary.key.pem -outform PEM INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM...
- Page 6 -i <device_id> --cert primary.cert.pem --key primary.key.pem -u <hub_name>.azure-devices.net/<device_id> -d -V mqttv311 -q 0 --capath /etc/ssl/certs/ -m 'hello' Configuration for iGS01S/iGS02E The application configurations: ● MQTT HOST: <IoT Hub Name>.azure-devices.net ● MQTT PORT: 8883 INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM...
- Page 7 INGICS TECHNOLOGY ● MQTT PUBTOPIC: devices/<Device ID>/messages/events/ ● MQTT CLIENTID: <Device ID> ● MQTT USERNAME: <IoT Hub Name>.azure-devices.net/<Device ID> ● Enable MQTTS ● Select Azure-IoT-Hub RootCA ● Enable use certificate INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM...
- Page 8 INGICS TECHNOLOGY Upload the primary.key.pem as key and primary.cert.pem as certificate via webUI advanced page. Configuration for iGS03 Series Users can use the ‘Cloud Iot Helper’ to set up the iGS03. INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM...
- Page 9 INGICS TECHNOLOGY The application settings will be filled by ‘Cloud Iot Helper’, or users can fill the configuration manually. INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM...
- Page 10 INGICS TECHNOLOGY Don’t forget to upload the device certificate and private key in the SECURITY tab (Using the ‘Cloud IoT Helper’, the files should already be uploaded). INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM...
-
Page 11: Verify Configuration
$ az extension add --name azure-iot Monitor events on your iot hub. You should see events sent from iGS03 to the IoTHub. $ az iot hub monitor-events --output table -p all -n {YourIoTHubName} Example: INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM... - Page 12 2. Choice your IoT Hub -> IoT device -> Telemetry Make sure "Use built-in event hub" is YES, click "Start" button to monitor the events 3. If everything works fine, the message will show up INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM...
-
Page 13: Revision History
Initial release Mar 28, 2019 Update reference documents Dec 24, 2019 Update example for using X-509 certificates Update for iGS03 series support Jul 22, 2021 Update Azure-CLI usage for verification Jul 15, 2022 INGICS TECHNOLOGY CO., LTD. • SUPPORT@INGICS.COM • WWW.INGICS.COM...
Need help?
Do you have a question about the iGS01S and is the answer not in the manual?
Questions and answers