The Tunnels tab is used to define tunnels for the thing definition. A tunnel is a communication mechanism supported by the M2M Service that allows a client application to connect to a server application on a gateway. A tunnel is used when the client application needs to remotely access the server application, and does not have the ability to directly connect to the server application. For example, a client application running on a computer in your company's office location needs to connect to a server application on a gateway installed at a remote field location, and the two computers do not have direct LAN connectivity. To define a Tunnel, do the following:
- While Adding or Editing a Thing definition, click on the Tunnels tab
Enter the following field to define the Tunnel:FieldDescription
Key The key for the tunnel definition. For more information on limitations while defining a key, see Field Formats and Limitations Name The name of the tunnel definition that is displayed on Management Portal pages. Desc An optional description for the tunnel definition. Port The port that the server application listens on for new client application connection requests. Security tags Enter any number of tags to the tunnel that control whether a user can use the tunnel. The user must have a role that has the same <update> security tag associated with it in order to use the tunnel.
- Click Update
For things that are gateways a tunnel definition for the Workbench, named deviceWISE Workbench, is automatically defined for the gateway's thing definition by the M2M Service.