Office365

Prerequsites

This tutorial assumes that you have already downloaded Roombelt and applied a license as documented on this page.

Create and configure application on Microsoft Azure

Roombelt uses Microsoft Graph to authenticate users and access their calendars. You need to create an application on Microsoft Azure. This way you can be sure that nobody outside of your company has access to your private data.

  1. Create new app using the New registration button. For Supported account types choose Accounts in any organizational directory. Keep Redirect URI empty and click Register.

  2. For the new application go to the Authentication page and add two Redirect URIs of type Web:

    • http://localhost:3000/office365/oauth_callback

    • http://localhost:3000/office365/oauth_callback_admin

  3. Go to the Certificates & secrets page and click button New client secret. Choose Never as an expiration time. Store the created secret somewhere - you will need it in a moment.

  4. In the API permissions tab add two Microsoft Graph application permissions: Calendars.ReadWrite and User.Read.All.

  5. Go to the Overview page and find Application (client) ID. You will need it in a moment.

Running the application

Modify the file roombelt.env with the following content:

OFFICE365_CLIENT_ID=<APPLICATION (CLIENT) ID OF YOUR AZURE APP>
OFFICE365_CLIENT_SECRET=<SECRET OF YOUR AZURE APP>
OFFICE365_REDIRECT_URL=http://localhost:3000/office365/oauth_callback
OFFICE365_REDIRECT_URL_ADMIN=http://localhost:3000/office365/oauth_callback_admin

Next, run Roombelt with one of the following commands:

roombelt.exe - on Windows
./roombelt - on Linux

Roombelt should be available athttp://localhost:3000.

Next steps

For production usage you should setup a PostreSQL database and configure HTTPS certificate. These topics will be covered in this documentation soon. Consider using the Cloud version if you have little experience with securing and provisioning web applications.