Mission 1: Connect IoT Project

Estimated time: 20 minutes

Learning Objective

Learn how to connect IoT projects to a deployed LOGIBLOX instance using REST API calls. This mission covers obtaining API credentials, establishing IoT connections, and creating simulated devices for testing purposes.

Prerequisites

Refer to the Navigation Guide to familiarize yourself with the platform interface before starting this mission.

Step-by-Step Instructions

1. Obtain Your Account API Key

1. Click on your account name in the top-right corner

2. Select Profile from the dropdown menu

   

3. Select the API tab in the Profile dialog

   

4. If no API keys exist, click Add New API Key to create one

5. Click Save Changes to confirm

2. Establish an IoT Connection

Send a POST request to your deployed LOGIBLOX instance to register a new IoT connection.

Endpoint:

POST {your-logiblox-instance-address}/api/v0/devices/haystack

Headers:

Content-Type: application/json
apiKey: {your-api-key-from-step-1}

Request Body:

{
  "title": "My IoT Connection",
  "id": "unique-connection-id",
  "endpoint": "https://your-iot-endpoint.com",
  "username": "your-username",
  "password": "your-password"
}

3. View Your IoT Connection

1. Click the Devices tab in the left sidebar
2. Locate your newly created IoT connector on this page

   

3. Double-click the connector to open it
4. All zones and devices from your IoT source load automatically

   

4. Create Simulated Devices

For testing purposes, LOGIBLOX allows you to create simulated connections, zones, and devices.

1. In the Devices page, click Add Item → Create Simulated Connection
2. Double-click the new simulated connection to open it
3. Use Add Item to create additional components:
   • Create Simulated Zone — Add a logical grouping for devices
   • Create Simulated Device — Add a virtual device for testing
4. Double-click any simulated device to add or edit its properties

Summary

You've successfully learned how to:

✓ Obtain your account API key from the Profile settings

✓ Establish IoT connections using REST API calls

✓ View and navigate IoT connectors in the Devices tab

✓ Create simulated connections, zones, and devices for testing

Well done! Now let's move on to the next mission!