Skip to main content

Microsoft 365

How to add app registration to Microsoft 365​

  1. Navigate to the AAD tenant's app registrations blade. Click New application registration:

  2. Enter a name for the app registration. This is not important to the Offision.

  3. After created, go to Certificates & Secrets

  4. select Client secrets, and click New Client secret.

  5. Typing a name (e.g. Offision Integration) for the client secret, and select the expire time base on your performance

    Expire time & renew client secret

    For restriction of Microsoft 365 for security. The expire time are limited to 2 years in maximum. Before the client secret expire, you need to create a new client secret for it and update the client secret in Offision

  6. Click the Add button, and you will get the Client secret

    caution

    Client secret will only show once, you have to copy it at this moment. If you lost it, you may create a new client secret

  7. Go to Authentication, in Supported account types, select Accounts in any organizational directory(Any Azure AD Directory - Multitenant, and click Save button

  8. Go to API Permissions, click Add a permission, select Microsoft Graph

  9. Click Application permissions, check the following permissions

    1. Calendars -> Calendars.ReadWrite
    2. Group -> Group.Read.All
    3. Mail -> Mail.Send
    4. Place -> Place.Read.All
    5. User -> User.Read.All And click Add permissions

  10. You will see the permissions added to the list but there are a warning Not granted for 'Your organization name' in status. Now you have to click the Grant admin consent for 'Your organization name' to confirm the permission

  11. After that, you will see the permission grant successfully

  12. Finally, go back to the Overview copy the value, Client ID (Application ID), Tenant ID (Directory ID), with the Client secret created in previous step, these are information for Offision to integration.

  1. Navigate to the AAD tenant's app registrations blade. Select your existing app for Offision
  2. Navigate to authentication, click Add platform, click Web
  3. In redirect url fill in the Offision callback url, you may find the url in integration detail
  4. Click Configure

How to apply the Offision policy to Microsoft 365 room​

This setting must be completed without the user booking an O365 room

You can follow the steps below to apply the Offision policy to Microsoft 365 room:

  1. Go to https://admin.exchange.microsoft.com/#/resources
  2. Go to Recipients -> Resources.
  3. Select and click the room that you want to integrate to Offision.
  4. Click the "Booking" tag.
  5. Click Manage delegate settings.
  6. Choose Select delegates who can accept or decline booking requests and add an email address that exists in Offision to the "Select delegates" column. This email will be used to receive system emails for pending system validation purposes, so it is recommended to use a dummy email address for this setting.
  7. Click Manage booking settings on the "Booking" tag
  8. Disable Allow scheduling only during working hours and Automatically decline meetings outside this limit.
  9. Click Save button.
  10. Got to the "Delegation" tab.
  11. Click the Edit button of "Read and manage (Full Access)".
  12. Click the Add members button and include the email address you added in step 6. Please note that it may take a few minutes for the changes to reflect in the settings.