Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 15 Next »

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 Office 365 - Creating Resource Mailboxes for help on this.


 Office 365 Resource Mailbox Permissions

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'
 Connecting to PowerShell

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.

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 popup. Enter your Office 365 administrator’s username and password.

 Modifying Resource Mailbox Settings

Once you have successfully logged into PowerShell, enter the code below to view the settings for a specific resource.

# View resource current settings
Get-Mailbox “Board Room” | Get-CalendarProcessing | FL

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.

# Specific settings for the resource
Set-CalendarProcessing “Board Room” -AddOrganizerToSubject $false -DeleteSubject $false -RemovePrivateProperty $false -AutomateProcessing AutoAccept

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.

 Configure Impersonation Roles in Office 365

Configure Impersonation Roles in Office 365 (Push Service & OAuth)

Impersonation Roles are required for the ResourceXpress Push Service when 20 or more profiles are in use, it is also required to use Modern Authentication to EWS (OAuth).

The Push Service is an add-on to the ResourceXpress application and will be enabled by default for any Exchange/O365 integrated SaaS deployments. The benefit of using the Push Service is to reduce the number of requests made from ResourceXpress to the Exchange/Office 365 environment. Instead of the ResourceXpress server polling every 60 seconds any new bookings or updates are automatically pushed by the Exchange/Office 365 service to ResourceXpress.

Starting in October 2020 Microsoft will begin retiring Basic Authentication to EWS. When this happens the method of authentication used by ResourceXpress must be OAuth. Please refer to Office 365 OAuth 2.0 Configuration for further instructions on configuring OAuth.

Create a new Management Scope for Resource Mailboxes

Use the above ‘Connecting to PowerShell’ instructions to establish a PowerShell connection to your Tenant.

Copy and paste the code below, change the -Name value to suit your environment.

# Create Management Scope
New-ManagementScope -Name "RXResourceMailboxes" -RecipientRestrictionFilter {RecipientTypeDetails -eq "RoomMailbox"}

Log into your O365 tenant as an Admin and navigate to Admin - Admin Centers - Exchange.

Create a new role under Permissions - Admin Roles.

The Write scope will be the new Management Scope created in PowerShell.

The Members should include the ResourceXpress service account that has already been granted Full Access Permissions to the resource mailboxes.

Click Save.

 EWS URL

To connect ResourceXpress to Microsoft Office 365, the Exchange Web Service URL is needed.

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 guideOffice 365 - Finding the EWS Address

 Configuring ResourceXpress System Settings

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

https://outlook.office365.com/EWS/Exchange.asmx

Server Port

443

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.

Note: The use of OAuth authentication requires different fields to be populated. Please see Office 365 OAuth 2.0 Configuration for further information.

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:

 Creating & Connecting a Profile

To create a profile and connect it to an O365 resource, under Administration Settings go to Resource List.

On the top, right-hand corner, click on + Create and you should see the screen below.

Before connecting the profile, you will first be required to fill out some basic information in this Resource Info tab. Required fields are noted with an *. Once completed, click Save.

Once changes are successfully saved, click on the Connection Properties tab.

Most of the fields should already be filled in based on the information entered previously in the Systems Settings.

For the final step, enter the email address of the O365 resource you want to connect this profile to in the Resource Email line.

Click Save.

  • No labels