Resources and reservations add-on + Microsoft365: Activation guide

The Luckey-Microsoft 365 Outlook integration is designed to bridge the gap between your Outlook calendar and the Luckey access control system. This powerful connection empowers Microsoft 365 users to invite meeting rooms directly from Outlook, eliminating the need for manual booking processes and ensuring a hassle-free experience.

To activate the Bookey Microsoft365 Integration we ask you to follow the following steps.

1. Create and registering an Azure AD Application

If you have administrator privileges, you can reach the Azure AD App registrations page by opening your browser and navigating to https://aad.portal.azure.com.

If you don’t have administrator privileges you will need your IT-Department or whoever is in charge to register the app for you.

This should bring you to the Azure Active Directory admin center of your Microsoft365 or Azure Subscription once you logged in with your administrator account.

Alternatively, you can reach it from either within your Microsoft365 admin center in the navigation on the left, or from the Azure portal by searching for it in the top bar.

Whatever way you choose, once you are there, on the left side click Azure Active Directory and then App registrations.

Next, we’ll have to do 3 things: register the app, then create a client secret and in the end add some permissions to it – which I’ll explain step by step.

You can always adjust the settings later and there is absolutely no risk of creating any costs as registering an app is completely free.

1.1. Registering the Application

1. Click New Registration on the top bar.
Screenshot of the App registration page with a circle on the new registration button

2. Fill out the form with your chosen name and select “Accounts in this organizational directory only” (you can omit the Redirect URI), then hit Register.
Screenshot of the app registration form, the name field is MyTestApplication and the radio button selects Accounts in this organizational directory only

You should see a summary screen of your app from which you will later need the values of the Application (client) id and the Directory (tenant) id. You can copy and store them now or retrieve them again later.

Think of those variables like this:

  • tenant-id: The unique Id of the entire Microsoft365- or Azure-Account.
  • client-id: The username of the technical user our application will use to authenticate.

Now all that is missing for a proper authentication is a password or client-secret – we will create this in the next step.

1.2. Authentication: Create a client-secret

  1. On the left, select Certificates & secrets and click New Client secret.
    Screenshot of the App registration page with red circles around Certificate & secrets and New client secret and an arrow connecting both
  1. Give it any name and choose Never as expiration date.
    Screenshot of the Add a client secret form with the Description input set to TestSecret and the Expires radiobutton selecting Never
  1. You should see the created secret and the value in clear text. 

IMPORTANT: Copy and store this value somewhere now – this will be the only time you can see it.
105_Store_Value

Now we have everything we need to let our application authenticate against Azure AD. However, we didn’t tell Azure-AD what data our application is allowed or authorized to retrieve yet, so lets do this next.

1.3. Authorization: Grant permissions to your app

Still on the Azure AD Application page:

  1. Select API Permissions and hit Add Permissions.
    Screenshot of the app registration page with red circles on the API permissions navigation and the add permissions button and an arrow connecting the two
  2. Select Graph API.
    Screenshot of the  Request API permissions form showing the selection of the microsoft graph api
  3. Select Application permissions.
    Screenshot of the Request API permissions form with a red circle around the Application permissions button
  4. Search and select Calendars.Read and Calendars.ReadWrite. This is the permission that allows us to read and write on calendars.
  1. Click Add Permissions.
  2. Back on the permissions-screen, click Grant admin consent to actually allow those permissions.
    Screenshot of the API permissions overview with a circle on the grant admin consent button

And that’s it. Now we are ready to activate the integration from the Luckey Web Application

2. Activate the Integration on Luckey Web

  • On the Luckey settings open the Microsoft365 section. The following data from the previous step will be required:
  • Client Id
  • Client Secret
  • Tenant Id
  • Additionally, we request the email of the user whose calendar will be synchronized with the Bookey Agenda.

Once inserted the data, you can select the proper calendar to be synchronized. 

After this step, the activation is active on your system!