Configuration via Frontend
For setting up the AWS integration, use the Cloud Integration Wizard in the 1NCE OS portal.
Click 'New Integration' and select AWS integration as integration type.
Use a descriptive name and select the event types that you would like to receive.
Be aware that integration with status ROLLOUT_STARTED will be created in the Cloud Integrator and you will be taken to AWS to complete the configuration over there.
This generate a JWT that is only valid for an hour. Once the JWT becomes invalid the rollout has to be restarted.
After the configuration click proceed and you will be prompted to go to the AWS console. Continue and now AWS should be open on the 'Quick Create Stack' page. Here you will see things such as the name that was previously given, integration token, etc. If this information is correct, acknowledge AWS requirements and press 'create stack'.
It will take some time for the stack to be created. Nested stacks are shown by the filter option 'view nested' on the top. Once it is done, it should look like this in AWS and 1nceOS portal respectively:
A device being able to send data is a prerequisite for this step. For more information refer to the cloud integrator documentation.
Once your stack has been rolled out, you can test your integration using one of your devices. In AWS go to the IoT Core service. Navigate to the MQTT test client and subscribe to # as shown below:
Doing this will subscribe to all topics so if the stack was successfully rolled out, you should see data show up from your device as shown below:
If the integration was succesfully created, rolled out and actived, Integration Active will appear.
Edit AWS integration
It is possible to edit the 1nceOS integration options through the front-end by clicking the edit-button as shown below:
Restart AWS integration
There is a possibility that your integration fails. When this happens, it will be visible in the 1nceOS portal as shown below:
By clicking the restart button, there will be an attempt to verify the integration. During that time an event of type TEST_MESSAGE will be sent out. For more information refer to event-type documentation
Delete AWS Integration
There are two ways to delete the integration:
You can delete your AWS Integration in the front-end of 1NCE OS or using API. In this case, you need to delete your AWS stack manually.
When the deletion is initiated from your AWS stack, there are no further actions needed. The callback function will automatically trigger the deletion of the AWS Integration in 1NCE OS.
Updated 6 days ago