egnite.de Shop Docs Palamoa Community
Skip to main content

Box2Box

A device can be configured to trigger digital outputs of another device of the egnite 300 series, as long as the other device is reachable over network.

This feature is referred to as Box2Box.

This means, that a device can act as both, the controlling box (which can be configured on the Box2Box configuration page), as well as the controlled box, even simultaneously.

info

For security reasons, the controlling device has to authenticate itself to the controlled device.
This works by means of an API-Key, a text string that is generated on the controlled device. This API-Key has to be provided on the Box2Box configuration page of the other, the controlling device (see below), which will then include it in it's messages to the controlled device.

warning

Please treat the API-Key as a security sensitive secret.
Any party with knowledge of the API-Key and network access to the device, will be able to control the state of its digital outputs.

// TODO

// TODO: Tim, aktiviert enable auch den box2box modus beim slave? Aktiviert das generieren eines apikeys box2box modus beim slave?

Configuring a controlled device​

  1. In the web interface of the device to be controlled, navigate to the Security configuration page in the main menu under System.
warning

If you regenerate or delete an API-Key on the Security configuration page, the old key will be invalid from then on. You will have to repeat the process from step 2.

  1. In the API-Key section click the Button
    The input field above will be populted with the key.

  2. Copy or note the key (and account for the security warning above).

  3. Proceed with Configuring a controlling device on the other device.

Configuring a controlling device​

  1. In the web interface of the controlling device, navigate to the Box2Box configuration page in the main menu under Interfaces.

  2. Fill out the configuration form:

    Enable​

    Checkbox

    Tick the checkbox to fill out the configuration details and enable the interface.

    Scan​

    Optional

    For convenience, the Button will search for compatible controllable devices on the network and after selecting a search result, pupulate some of the form fields below automatically.

    URL​

    RequiredText

    // TODO: root or /path? domains? prefix http/s?
    The URL of the controlled device. This can be an IP address or domain name.

    API-Key​

    RequiredText

    Enter or paste the API-Key of the controlled device from Configuring a controlled device.