Filter results by

Create a Cloud Connector

This article provides a high-level overview of the steps needed to create your own Cloud Connector. A Cloud Connector is a key ARTIK Cloud feature that bypasses third-party silos and enables true interoperability between devices from different manufacturers.

As a developer, you can build a Cloud Connector for any device that sends data to a third-party cloud. ARTIK Cloud can receive data from and send commands to the Cloud Connector, treating it as another device. Every cloud is now a node in the greater IoT ecosystem. Connected clouds benefit from Rules, analytics, and interactions with every device in the ARTIK Cloud ecosystem.

Whether you have a device that uses your proprietary cloud, or wish to connect your IoT solution to siloed devices, Cloud Connectors save you from developing custom integrations and let you focus on moving the data!

Cloud Connectors

If you already understand the basic steps, you can start instead with one of the following:

Before starting, ensure that the third-party cloud provides subscription/notification APIs and public APIs to read data.

Step 1: Create a new device type

Log into your Developer Dashboard and create a device type. This device type will be configured as a Cloud Connector.

You need to define a Manifest for your device type. See the following for context:

Once this information is saved, navigate to Device Info and set the device data source to "cloud".

Cloud Connector device data source

Step 2: Select the authentication protocol

Cloud Connectors

In the Cloud Authentication tab, define how ARTIK Cloud authenticates with the third-party cloud:

  • OAuth1
  • OAuth2
  • Custom (display a custom UI to manage user credentials)
  • None (the cloud does not require authentication)

Your selection depends on the protocol supported by the third-party cloud, as specified in its documentation.

You will need to provide additional parameters from the third party, e.g. client ID and client secret if using OAuth1 and OAuth2 (this is covered in Step 3).

Step 3: Create an ARTIK Cloud Connector app

Create and configure an ARTIK Cloud Connector application on the third-party cloud, referring to its documentation for the appropriate steps (example).

You may then obtain the client ID and client secret needed for OAuth1 or OAuth2 authentication, if needed, and apply them in Step 2. This third-party application enables your Cloud Connector device type to interact with the third-party cloud.

Step 4: Write and submit your Connector Code

Connector Code is written in Groovy. To implement the code, download the Cloud Connector SDK and JDK 8.

Broadly speaking, Connector Code uses the third-party APIs to:

  1. Subscribe to the third-party cloud
  2. Receive notifications from the cloud
  3. Fetch data from the cloud

In addition, you can send Actions to the Cloud Connector (which sends them to the third-party cloud) and define polling periods to schedule Actions (this can also be done in the Dashboard).

Cloud Connectors

See the following for details:

Please test your Connector Code! After submitting your code with any custom parameters in the Connector Code tab, it will undergo an approval process (usually 24-48 hours).

Cloud Connectors

Step 5: Let us know!

Notify the ARTIK Cloud team about your new Cloud Connector. We will test your Cloud Connector and add it to our Works With page of verified devices.

That's it!

After building the Cloud Connector, any user can connect it to their ARTIK Cloud account.

You might also want to add the Cloud Connector to an application. Here's how: