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:
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
The Microsoft 365 app is configured by defining one or more authentication credentials. The following data is required for each configuration:
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.AllUser.Read.AllCalendars.Read
Last updated
Was this helpful?