webmaxru / node-red-contrib-aws-iot-custom-auth

A Node-Red node to support ThingShadow and MQTT protocol with Certificate Store by clientId (thingName) or using Custom Authorizer

A Node-Red node to read and write to the Amazon Web Services AWS IoT using the Custom Authorizer.

Support ThingShadow and MQTT protocol with Certificate Store by clientId (thingName) or using Custom Authorizer

Install

Run the following command in the root directory of your Node-RED install

npm install node-red-contrib-aws-iot-custom-auth

Usage with custom authorizer

Use "Custom Authorizer" type for your device and specify:

• Custom Authorizer Name (optional)
• Token Key
• Token Value
• Custom Authorizer Signature

You don't have to provide certificated in this case.

See more at https://docs.aws.amazon.com/iot/latest/developerguide/custom-auth.html

Usage with certificates

• Install your AWS certificates into your local folder where node-red can reach your directory

  Example:

	/root/.agent/certs/-
					|--YourThingName.private.key
					|--YourThingName.cert.pem
					|--root-CA.crt

YourThingName is the AWS Thing name what is the value you keyin when creating your thing/device.

• Setup the node-red-contrib-aws-iot-custom-auth node with AWS Certs path pointed to /root/.agent/certs/

  Example:

	awsCerts = /root/.agent/certs/

• The final configuration will be used in the node-red-contrib-aws-iot-custom-auth code look likes:

	keyPath : '/root/.agent/certs/YourThingName.private.key',
	certPath : '/root/.agent/certs/YourThingName.cert.pem',
	caPath : '/root/.agent/certs/root-CA.crt',
	clientId : YourThingName,
	host : <YourAWSIoTCustomEndpoint>

See more at https://github.com/aws/aws-iot-device-sdk-js/blob/master/README.md#certificate-configuration

Runtime information

This node was tested to Node.js v7.4.0 and NPM 5.6.0 on Node-Red v0.18.4

Credits

This node is based on iont-node-red-contrib-aws-iot by Darren Chiu.