# Signify

### Overview

This manual provides instructions for configuring, installing, and using the Signify app to manage resources and synchronize data between Eliona and Signify services.

### Installation

Install the Signify app via the Eliona App Store.

### Configuration

The Signify app requires configuration through the Eliona settings. Below are the general steps and details required to configure the app effectively.

#### Registering the app in the Signify service

Create credentials in the Signify service to connect the Signify services from Eliona. All required credentials are listed below in the configuration section.

Go to the [Interact Lighting website](https://www.developer.interact-lighting.com/) and create an Eliona client to obtain the app key and secret required to access the API. In addition, you must identify the service you want to connect, as this information is provided by Interact Lighting.

#### Configuration of the Signify app

Configurations can be created in Eliona under `Apps > Signify > Settings` created, which opens the [Generic Frontend](https://doc.eliona.io/collection/v/eliona-english/manuals/settings/apps) of the app. Here you can use the corresponding endpoint with the POST method. Each configuration requires the following data:

| Attribute         | Description                                                                              |
| ----------------- | ---------------------------------------------------------------------------------------- |
| `baseURL`         | URL of the Signify [API services](https://www.developer.interact-lighting.com/api-docs). |
| `app_key`         | The app key used to identify the Eliona app.                                             |
| `app_secret`      | The app secret used to authenticate the Eliona app.                                      |
| `service`         | The service name used to identify the Interact Lighting service.                         |
| `service_id`      | The service ID used to identify the Interact Lighting service.                           |
| `service_secret`  | The service secret used to authenticate the Interact Lighting service.                   |
| `assetFilter`     | Filtering of assets during continuous asset creation.                                    |
| `enable`          | Flag to enable or disable this configuration.                                            |
| `refreshInterval` | Interval in seconds for data synchronization.                                            |
| `requestTimeout`  | API query timeout in seconds.                                                            |
| `projectIDs`      | List of Eliona project IDs for data collection.                                          |

Example configuration JSON:

```json
{
  "baseUrl": "https://api.interact-lighting.com/",
  "service": "officeCloud",
  "serviceId": "secret@signify.com",
  "serviceSecret": "secret",
  "appKey": "foo",
  "appSecret": "secret",
  "enable": true,
  "refreshInterval": 120,
  "requestTimeout": 120,
  "active": true,
  "projectIDs": [
    "10"
  ]
}
```

### Continuous asset creation

After configuration, the app starts continuous asset creation (CAC). Discovered resources are automatically created as assets in Eliona, and users are notified via Eliona's notification system.

The created asset structure reflects the grouping of spaces in the Interact Lighting environment. The app supports Signify Space for humidity, occupancy, people counting, and temperature.

### Additional features

#### Dashboard templates

The app provides predefined dashboards that clearly display the most important information. There is a dashboard for each type of Signify Spaces to group all spaces. You can create such a dashboard under `Dashboards > Copy Dashboard > From App > Signify ...` create:

* `Signify People Count`
* `Signify Occupancy`
* `Signify Temperature`
* `Signify Humidity`