Introduction

With version 4.3 of TDM a new authentication method will be used for creating Office365 data sources, this method is based on the Oauth2.0 protocol. In case any Office365 data sources have already been created in an earlier version  the data sources will continue to pull the data from the Office365 API based on the old authentication method. Once these data sources are edited and resaved they will use the new authentication method.

Please notice that from October 13th, 2020 Microsoft will stop supporting Basic Authentication for Exchange Web Services (EWS) to access Office365 // Exchange Online. Please make sure to change the authentication method before this time.

Requirements

If you want to add an Office365 data source based on the Oauth2.0 protocol to TDM you need to meet the following requirements:

• Administrator access to the TDM designer
• Have a service account available which is delegated to the rooms you want to add

How To configure delegated users   

1. Login with an administrator account into: https://login.microsoftonline.com
   
   
2. Please open the menu from the left corner and then select "Admin"
   
   
   
3. Please select "Show all" on the menu on the left side
   
   
   
4. Then select "Resources > Rooms & Equipment"
   
   
   
5. Select the room, for example: room01@tdmsignage.com
   
   
   
6. Please select “Edit” beneath “Delegates”:
   
   
   
7. Please add the service account you want to use for your data sources and add it as a delegated user and select “Save Changes”.
   
   Now you have successfully configured a delegated user for your room resource, please note that it might take up to 24 hours before the changes are fully active and processed by Office365.

How To add Office365 datasource with the default TDM Azure application

1. Login to the designer with an administrator account: https://designer.tdmsignage.com/
   
   
2. Open the “Config panel”. This can be selected in the menu on the left side of the designer.
   
   
   
3. Open the tab called “External Data” to open the overview of your data sources.
   
   
   
4. Select the “+” button on the right side to create a new data source.
   
   
   
5. In the pop-up window you will see all the data sources that can be configured in TDM. Please use the name of the calendar/room as the name of the data source. This way it can be easily traced in the future. Afterwards please select “Office365 Calendar” and select “Next”.  
   
   
   
6. You will be re-directed to the Microsoft login page. Here you can login using your service account which has permissions to the room/calendar.
   
   In case this is the first Office365 datasource you create you will see an administrator approval page, this is the part where an administrator needs to grant TDM access to your Office365 environment. Once this has been granted you will be able to configure the room/calendar for your datasource.
   
   Once you have successfully approved the permissions the window will close and you will return to the designer page.
   
   
7. Select the type of resource you want to add:
   
   Rooms: In case you want to add a resource created within the admin part of Office365 please use this type.
   
   Calendars: In case you want to add a personal calendar from a specific user please select this type.
   
   
   
8. A: In case rooms is selected please fill in the email address of the room. For example: meetingroom1@tdmsignage.com. The email address of the room can be retrieved from the admin panel of Office365. Once the email address has been filled in please select “Save” to save the data source.
   
   
   B: In case calendars is selected please choose the calendar you want to use from the dropdown, for example: Calendar. Once the calendar has been selected please select “Save” to save the data source.
   
   
   Once you have finished these steps you have successfully created your Office365 data source.
   You can now use your data source within your template design or use it for your meeting room solution.