IoT Connector

This repo holds sample code for creating Platform Events via API that can be hosted on various cloud platforms (AWS, GCP, Azure, etc.).

All user documentation with detailed instructions on configuration, deployment and execution are available in this Wiki.

The repository contains two submodules for two unmanaged applications that can be deployed into an Salesforce org (using SFDX 2nd generation package deployment):

1. An Amazon AWS IoT Connector Application

2. A Google GCP IoT Connector Application

For user documentations on these two applications see the Wiki pages for the AWSIoTConnector and GCPIoTConnector respectively.

Quick Start

First, clone this repository:

git clone https://github.com/developerforce/iotconnectors.git

Then go into the sfdx directory and run the bash script

cd iotconnectors
cd sfdx
sh ./projectSetup.sh

Follow the instructions in the script which will require answering some prompts. At the end of the script you will have:

1. A Connected App in a Dev Hub, Sandbox or Production instance.
2. A scratch org with a Platform Event, Context and Orchestration for a Smart Thermostat device
3. A certificate and private key for JWT authentication
4. A node application which can be deployed to Azure or AWS.

See the following for setting up in:

• AWS IoT Hub
• AWS Lambda
• Azure IoT

The manual route

If you want to create the working parts yourself, following these guides:

• IoT Quick Start This Trailhead Quick Start walks through creating the platform event, context and orchestration.
• Connected App and Certificate

Then go into the node directory and update config.json with the correct information. You would then continue with the guide to setting up in the cloud of your choice:

• AWS IoT Hub
• AWS Lambda
• Azure IoT