Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Microsoft 365

This app enables access to the Microsoft 365 platform directly in Eliona using the Microsoft Graph API.

Name of the delegated user (for delegated permissions)

This app connects rooms and other resources with Eliona and provides information about their booking status. However, the app's main capability is the ability to use the entire Graph API directly in Eliona by using the authentication proxy functionality.

Installation

The Microsoft 365 app is installed via the App Store in Eliona.

Assets

The Microsoft 365 app automatically creates all necessary asset types and assets that are accessible via the configured endpoints. The following asset types are created:

  • Room: A room in Azure AD.

  • Equipment: Any piece of equipment that can be booked. Like a room, but generalized.

The following attributes are defined:

Attributes
Description
room
Equipment
Filterable

address

Physical address

x

x

nickname

Nickname

x

x

label

Label

x

x

geo_coordinates

Geo coordinates

x

x

phone

Phone number

x

x

email_address

Email address

x

x

x

booking_type

Booking type

x

x

building

Buildings

x

x

capacity

Capacity

x

x

floor_label

Floor label

x

x

floor_number

Floor number

x

x

is_wheel_chair_accessible

Wheelchair accessibility

x

x

tags

Tags

x

x

display_device_name

Display device name

x

x

audio_device_name

Audio device name

x

x

video_device_name

Video device name

x

x

on_schedule

Scheduled

x

x

Configuration

More information on configuring apps can be found ↗ here.

The Microsoft 365 app is configured by defining one or more authentication credentials. The following data is required for each configuration:

Attributes
Description

tenantId

Company ID or domain

clientId

ClientID / Azure AD application ID

clientSecret

An "app password" (for app permissions)

username

Name of the delegated user (for delegated permissions)

password

Password of the delegated user (for delegated permissions)

forEliona

Indicates whether the configuration should be used for asset creation

forProxy

Indicates whether the configuration should be used for the app frontend and the proxy API

enable

Flag to enable or disable retrieval from this API

refreshInterval

Interval in seconds for collecting data from the API

requestTimeout

API request timeout in seconds

assetFilter

Filter for asset creation, see the app's README for further details

projectIDs

List of Eliona project IDs for which this device should collect data. For each project ID, all assets are automatically created in Eliona. The mapping to Eliona assets is stored in the app as an asset mapping.

The configuration must contain either the client secret for app permissions or the user credentials for delegated permissions. The configuration is done using a corresponding JSON structure. As an example, the following JSON structure can be used to define an endpoint for app permissions:

Endpoints can be created with this structure in Eliona under Apps > Kontakt.io > Settings To do this, select the /configs endpoint with the POST method.

Required privileges

For the basic use case of rooms and devices and their availability, the application requires the following application permissions:

  • Place.Read.All

  • User.Read.All

  • Calendars.Read

Last updated

Was this helpful?