> For the complete documentation index, see [llms.txt](https://ieg4.gitbook.io/edesigner-new/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ieg4.gitbook.io/edesigner-new/building-services/adding-content/microsoft-bookings-items.md).

# Microsoft Bookings items

## Microsoft Bookings

## Configuration required by the customer

This describes the process of getting the credentials required for eDesigner forms to read and write to a customers Microsoft Office 365 Calendars and Bookings APIs

The settings we require are:

* Booking Business                         eg <IEG4Council@ieg4.com>
* Directory (tenant) ID                    eg 9688d675-\*\*\*\*\*\*\*\*\*\*\*\*\*\*
* (Application) client ID                  eg a4db50fe-\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*
* Client secret                                 eg GTa\*\*\*\*\*\*\*\*\*\*\*\*
* Username                                     eg <edesignerbookings@ieg4.com>
* Password                                      eg TN#\*\*\*\*\*\*\*\*\*\*\*

The **Booking Business** is the email of your business in Microsoft Bookings

To create the rest of the settings log in to the Azure portal

### Part 1 – Create an App Registration

For the next three settings you need to create an App registration

*Registering your application establishes a trust relationship between your app and the Microsoft identity platform.*&#x20;

In the Azure Portal go to Azure Active Directory -> App registrations -> New registration

Enter a display Name for your application. Users of your application might see the display name when they use the app, for example during sign-in. You can change the display name at any time and multiple app registrations can share the same name. The app registration's automatically generated Application (client) ID, not its display name, uniquely identifies your app within the identity platform.

Specify who can use the application, sometimes called its *sign-in audience*. Select: Accounts in this organizational directory only

Don't enter anything for Redirect URI (optional). You'll configure a redirect URI later.

Select Register to complete the initial app registration.

Once created, go the the Overview of the App registration where you will find the **(Application) Client ID** and the **Directory (tenant) ID**

<figure><img src="https://2446085776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Xv5e5CMqZNlA8r5Exkm%2Fuploads%2FRVoR9lKoLPtmHvCTijFz%2Fimage.png?alt=media&amp;token=1bfac821-e113-49bb-b31d-e27694b12180" alt=""><figcaption></figcaption></figure>

#### Add a Redirect URI

A *redirect URI* is the location where the Microsoft identity platform redirects a user's client and sends security tokens after authentication.

You just need <https://login.microsoftonline.com/common/oauth2/nativeclient>

<figure><img src="https://2446085776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Xv5e5CMqZNlA8r5Exkm%2Fuploads%2FfFRdiM32ig518UdHkqzq%2Fimage.png?alt=media&amp;token=17e14d8d-ea27-4ba9-bfe5-dc53168f318c" alt=""><figcaption></figcaption></figure>

#### Add a client secret.&#x20;

From Certificates & secrets, and a new Client secret. The secret Value is needed for the **Client Secret** setting

<figure><img src="https://2446085776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Xv5e5CMqZNlA8r5Exkm%2Fuploads%2FV7bZ1Az1D7EpeNqfxe9x%2Fimage.png?alt=media&amp;token=df6c264b-e8a3-4375-89db-a3a8f0c40f34" alt=""><figcaption></figcaption></figure>

#### Configure the permissions

From the API permissions tab, add the following permissions

<figure><img src="https://2446085776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Xv5e5CMqZNlA8r5Exkm%2Fuploads%2Fr7JxpiDUyvvopNNaU1ld%2Fimage.png?alt=media&amp;token=caff8c39-180c-47bf-9c14-a2f9d0a25148" alt=""><figcaption></figcaption></figure>

#### Configure the App roles

From the App roles tab create a role as below

<figure><img src="https://2446085776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Xv5e5CMqZNlA8r5Exkm%2Fuploads%2F8diTmSTHdj6sPV7uIxc5%2Fimage.png?alt=media&amp;token=eee15ff8-dc7a-4dae-90ec-1bb801c36b76" alt=""><figcaption></figcaption></figure>

### Part 2 – Create a User

For the final two settings you need to create a user.

The **Username** setting is the ‘user principal name’ and the **Password** is the login password

<figure><img src="https://2446085776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Xv5e5CMqZNlA8r5Exkm%2Fuploads%2Fh18D3d2gFIBuHkSoR9WY%2Fimage.png?alt=media&amp;token=70fceca5-71ce-4ca7-a3d6-151482a5c139" alt=""><figcaption></figcaption></figure>

For this user, under Applications, add the Graph explorer application

<figure><img src="https://2446085776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Xv5e5CMqZNlA8r5Exkm%2Fuploads%2FYFViouhiY2OuTbTukdOX%2Fimage.png?alt=media&amp;token=175338b8-58af-400d-8cbd-86bac93bffd0" alt=""><figcaption></figcaption></figure>

And for Licenses, add the assignments of Azure Active Directory and Microsoft 365

<figure><img src="https://2446085776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Xv5e5CMqZNlA8r5Exkm%2Fuploads%2F6BgOyvaslQawINFro5w6%2Fimage.png?alt=media&amp;token=63172633-fbad-4974-bbb9-34918c61a5fc" alt=""><figcaption></figcaption></figure>