Microsoft Office 365
- Elliot Dooleysmith
- Julie Kim (Unlicensed)
- Simon Barlow
- Anantha Kumar
Prerequisites
In order to connect your Microsoft Office 365 to ResourceXpress, you will first need the following ready before proceeding:
1. A valid Office 365 account.
2. Access to an Office 365 administrator account to make administrative changes.
3. A ResourceXpress user account created in Office 365 with a mailbox and a valid Office 365 license (minimum E1 - Exchange Online) to access its own email and calendar. Without these, Check-in/Check-out/Extend operations will fail with errors.
4. Resource mailboxes already created under your Office 365 account.
Please refer to Creating Resource Mailboxes in Office 365 for help on this.
The ResourceXpress user account will require Full Access permissions to each resource account in order to create, amend and delete bookings.
To give Full Access permissions to a resource, sign onto your Office 365 admin center with your administrator account. Enter the Exchange admin center. Under Recipients then click on Resources.
Select a resource and click on the edit icon on the toolbar:
Configurable settings for the resource will appear in a new window. Select mailbox delegation on the left-hand side, and scroll down to the third option, Full Access. Click on the + button:
Search for the designated ResourceXpress user as well as any additional users that will have the ability to edit bookings for this resource. Select and Add the account to the list on the bottom. Click OK.
Click Save.
These steps will need to be repeated for each Resource that will be utilized with ResourceXpress.
You can also assign Full Access Permissions via PowerShell with the below cmdlet.
# Assign Full Access Permissions
Add-MailboxPermission -Identity "<Room Name>" -User "<User Name>" -AccessRights 'FullAccess'
Additional settings need to be changed via PowerShell, this is to ensure the correct information is displayed in ResourceXpress.
First, open PowerShell from a Windows computer.
Using Modern Authentication or Multi-Factor Authentication
To connect using Modern Authentication or Multi-Factor Authentication copy and paste the below code
Connect-ExchangeOnline -UserPrincipalName <user.name@domain.com> -ShowProgress $true
Using Basic Authentication
To connect using Basic Authentication copy and paste the code below then press Enter.
# Get user details
$UserCredential = Get-Credential
# Create connection to office 365
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection
# Start session
Import-PSSession $Session
An Authentication screen should pop up. Enter your Office 365 administrator’s username and password.
Once you have successfully logged into PowerShell, enter the code below to view the settings for a specific resource.
Replace the words “Board Room” on the second line of the code with the name of your resource to get the screen below.
By default, RemovePrivateProperty, DeleteSubject, and AddOrganizerToSubject are set to true. AutomateProcessing must be set to AutoAccept if it is not already.
Copy and paste the code below to change the settings for these four options.
Replace “Board Room” with the name of your resource.
To see the changes made, enter the previous code to view the settings of the resource again. Your screen should look similar to the image below.
These steps must be repeated for all resources.
ResourceXpress can connect to Microsoft Office 365 using EWS or Graph API, please follow the section relevant to your requirements.
EWS
To connect ResourceXpress to Microsoft Office 365 using EWS the Exchange Web Service URL is required.
Most commonly, the URL will be: https://outlook.office365.com/EWS/Exchange.asmx
If this does not apply to your O365 account, please refer to this guideFinding the EWS Address for Office 365
Microsoft Graph API
The Microsoft Graph API URL is https://graph.microsoft.com/v1.0
Log onto ResourceXpress in your browser using your given URL and credentials.
Under Administration Settings on the top navigation bar, go to System Settings.
On the first tab you see (Resource Server), you will see the screen below:
Refer to the following table to fill in the information required:
Server Host Name | The EWS or Microsoft Graph API URL from the previous step |
Server Port | 443 |
Use Graph API | To use Microsoft Graph API follow our guide on how to configure. |
Use OAuth | Follow our guide on how to configure OAuth. This is now a required authentication method for Office 365. |
Resource Login User ID | <O365 Service Account email address> |
Resource Login Password | <password for the Service Account> |
Resource Login Domain | outlook.office365.com |
Once the information above is entered, click Save.
To check that ResourceXpress is successfully connected to Microsoft Office 365, enter the CAPTCHA image on the bottom of the page and click Check Server.
A successful connection will display a message similar to the image below:
- style