Activating and Editing the iBeacon Plugin

Activate the plugin to manage iBeacons. The RUCKUS IoT Controller securely routes the data to the configured endpoints.

To establish a connection to a partner infrastructure, the administrator must perform the following steps.

  1. From the main menu, select Admin.
  2. Click Plugins.
    The Plugins page is displayed. You can search for a plugin by its name in the Search plugins field to locate it.
  3. Click the Available Plugins tab.
    You will see tiles with plugin names on them. Locate the iBeacon tile.

    Selecting the iBeacon Plugin

    Selecting the iBeacon Plugin
  4. In the iBeacon tile, click + Configure to activate the plugin.
    The iBeacon Configuration sidebar is displayed.
  5. Select either the HTTP or MQTT protocol option.
    If the HTTP option is selected, configure the following parameters.

    Activating the iBeacon Plugin to use HTTP Protocol

    1. Aggregation Interval: Allows you to set the time interval between two packets.
    2. Key: Enter the key.

      The RUCKUS IoT Controller posts the beacon messages using the Key provided. The Vendor application is responsible for authenticating the keys.

    3. API URL : Enter the API URL.

      The RUCKUS IoT Controller connects to the vendor/connector URL to send the beacon messages. The URL can be a DNS-resolvable, FQDN-based address.

      Note: The plugin supports HTTP and HTTPS modes.

    4. Port: Enter the port number.

      This is the port number on which the vendor/connector web server is running.

    5. API Endpoint: Enter the API Endpoint.

      This is the API route where the BLE beacon vendor cloud services receive the beacon payload.

    6. UUID: Enter the UUID Filter.
      The filter allows only the BLE ADV packets with the specified UUID to be passed on to the vendor application.
    7. Enable heartbeat: Click the toggle to enable periodic heartbeat messages, which is useful for monitoring connection health. This option is disabled by default.
    If the MQTT option is selected, configure the following parameters.

    Activating the iBeacon Plugin to use MQTT Protocol

    Activating the iBeacon Plugin
    1. MQTT Broker IP: Enter the IP address or hostname of the broker.
      This is a mandatory field.
    2. MQTT Broker Port: Enter the port number.
      This is a mandatory field.
    3. MQTT Publish Topic: Topic where messages from this device/system will be published.
      This is a mandatory field.
    4. MQTT Username: Enter the username for authenticating with the MQTT Broker.
    5. MQTT Password: Enter the password for authenticating with the MQTT Broker.
      Note: By default the password is hidden, click Show to view the password.
    6. UUID Filter: Enter the required UUID filter.
      The filter allows only the BLE ADV packets with the specified UUID to be passed on to the vendor application.
    7. Enable heartbeat: Click the toggle to enable periodic heartbeat messages, which is useful for monitoring connection health. This option is disabled by default.
  6. Click Activate to save the changes.
    After saving the changes, the iBeacon plugin is added to the Active Plugins tab and is removed from the Available Plugins tab. Under the Active Plugins tab, locate the iBeacon tile. To modify the configurations, click Configure. To delete the plugin, click Delete.
  7. (Optional) Click Configure to edit the existing configuration.
    The iBeacon Configuration page is displayed. You can view the connection status of the plugin in the Status field. Make the required changes and click Update.
  8. (Optional) Click Delete to delete the plugin.

    Deleting the iBeacon Plugin

    Deleting the iBeacon Plugin
Parent topic: Activating and Editing the Plugins