Microsoft 365: OAuth / Modern Authentication (Delegated Permissions)

This method uses OAuth 2.0 with delegated permissions. You sign in with a Microsoft account directly on each device, and Fishbowl accesses the calendar on behalf of the signed-in user.

You will need to sign in on each device with a user that has access to the Room Mailbox's calendar. There are two ways to achieve this:

• Sign in as the Room Mailbox itself. Set a password for the Room Mailbox and sign in with its email address and password. This is the simplest option.
• Sign in as an existing user with delegated access. Grant an existing user Full Access to the Room Mailbox's calendar, then sign in with that user's credentials.

Before starting, make sure you have a Room Mailbox set up. See Microsoft 365 Configuration for instructions.

Option A: Sign in as the Room Mailbox

The easiest approach is to set a password for the Room Mailbox and sign in with its email address directly. This will not affect your existing bookings. By default, the Room Mailbox password is set to a random value, so it is safe to change.

1. Log into the Microsoft 365 admin center with an Administrator account.
2. Select Users > Active users from the menu on the left.
3. Click on the Room Mailbox.
4. Click on the Reset a Password button (the "key" icon).
5. Make sure that all checkboxes are unticked / not selected, then enter a password.
6. Click on Reset password.

Option B: Delegate access to an existing user

If you prefer to sign in with an existing user account instead of the Room Mailbox itself, you need to grant that user Full Access to the Room Mailbox's calendar.

Please note that it can take up to 5 minutes for the settings to take effect.

1. Log into the Microsoft 365 admin center with an Administrator account.

2. In the menu on the left, click on Show all.

3. Expand the Resources menu item, and click on Rooms & Equipment.

4. Click on the name of the resource (i.e. the meeting room name).

5. A menu will appear on the right. Click on Edit Exchange settings.

6. The Exchange Admin Center will launch. In the window on the right that opens, click on Delegation, scroll down to Read and manage (Full Access) and click on Edit.

7. Click on Add members.

8. Select the user that you will give access to the room, and click Save.

Configure Fishbowl

1. When linking devices on the Fishbowl web dashboard, select Microsoft as the calendar type.
2. Select Log in with Microsoft on Device as the authentication method.
3. On each device, sign in using the email address and password of the Room Mailbox (Option A) or the delegated user (Option B).
4. On the Select a Room page, your Room Mailbox should already be selected. If you signed in with a delegated user, you can search for a specific room. Tap on Next.