Microsoft 365

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

Name des delegierten Benutzers (bei delegierten Rechten)

This app connects rooms and other resources with Eliona and provides information about their booking status. The most important capability of the app, however, 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 Eliona App Store.

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:

Attribute	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	Building	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	On schedule	x	x

Konfiguration

More information on app configuration 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:

Attribute	Description
tenantId	ID or domain of the company
clientId	ClientID / Azure AD application ID
clientSecret	A "client secret" (for app permissions)
username	Name of the delegated user (for delegated rights)
password	Password of the delegated user (for delegated permissions)
forEliona	Specifies whether the configuration should be used for asset creation
forProxy	Specifies whether the configuration should be used for the app frontend and the proxy API
enable	Flag to activate or deactivate the fetching from this API
refreshInterval	Interval in seconds for collecting data from the API
requestTimeout	API query timeout in seconds
assetFilter	Filter for asset creation, more details can be found in the app's README
projectIDs	List of Eliona project IDs for which this device should collect data. All assets are automatically created in Eliona for each project ID. The mapping to Eliona assets is stored as an asset mapping in the app.

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

[code here]

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

Required Privileges

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

• Place.Read.All

• User.Read.All

• Calendars.Read