Creating HTTP connectors - Industrial IoT 5.0.1.1 | BACnet | Modbus | OPC Client | SNMP Manager

Industrial IoT Plugin Guide 5.0.1.1

Applies to
Industrial IoT 5.0.1.1 | BACnet | Modbus | OPC Client | SNMP Manager
Last updated
2023-02-09
Content type
Guides > Plugin and extension guides
Language
English
Product
Industrial IoT
Version
5.0

Before you can add HTTP devices, you must add a connector to the HTTP server to receive data from the devices via HTTP posts.

Before you begin

Make sure port 56789 on the directory computer is open.

What you should know

  • The HTTP server is hosted by the Industrial IoT plugin role, and installed when the HTTP Server protocol is selected during the installation process.
  • HTTP requests are made with the API key, the HTTP server identifier that is generated when you create the HTTP connector.

    This key must be kept secret to protect your system against malicious users.

  • Values that are sent through HTTP requests can be used to raise events, trigger alarms, and so on.

Procedure

  1. From the Config Tool home page, open the Plugins task.
  2. From the entity browser, select the Industrial IoT plugin role and click the Protocols tab.
  3. In the Protocols list, turn on the HTTP Server switch.
  4. Under the HTTP connecters list, click Add HTTP connector ().
  5. In the Add HTTP connector dialog box, do the following:
    'Add HTTP connector' dialog box.
    1. Enter a name for the connector.
    2. Click Copy to clipboard () to copy the API key.
      IMPORTANT: The API key is what identifies your HTTP server and is required by all devices (HTTP clients) to connect to the plugin role (HTTP server). For security reasons, this key is not saved in any registry or database. You cannot access the API key after you close this dialog box. Keep it in a safe place. You will need it every time you add an HTTP device to your system.
    3. Click Add.

Results

The connector is added to the list of HTTP connectors. After you created the HTTP connector, the only information you can change is the connector name in the HTTP Connector section. The only supported device identification mode is URL.

After you finish

Add the HTTP devices.