Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device.
Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device. Atlassian cookies and tracking notice, (opens new window)
If you are installing ROOMZ sensors only, you can skip this section and go directly to Step 2.
First, verify which configuration is used in your environment, go to the ROOMZ Portal → Settings → Booking Systems and select your booking system. Then open the Settings tab at the top of the page, your booking system can be connected using one of the options below :
Microsoft Exchange / Microsoft 365
Delegation Permission
If your system is configured using delegation, you must: Create new meeting room resources in Exchange / Microsoft 365, or use existing ones. Grant Full Access delegation to the account connected to the ROOMZ portal so ROOMZ can access the room calendars. To do this, select the resource in your exchange server, go to the Delegation tab, and add the user with Full Access permissions. If you cannot find the account in the graphical interface, it is usually because the account does not have a license assigned. In that case you can: Temporarily assign a license so the account appears in the graphical interface Grant the required permissions Remove the license afterwards if needed Alternatively, you can perform the configuration using PowerShell if you do not have an available license. Grant permissions using PowerShell To grant access to the ROOMZ account to the meeting room calendars, you can use PowerShell. Connect to Exchange Online: Connect-ExchangeOnline Grant access per room To grant the ROOMZ account connected to the ROOMZ portal access to a specific meeting room calendar, execute the following command for each room. Replace: roomz-manager with the email adress of your ROOMZ account. my-room with the email adress of your meeting room. Add-MailboxPermission my-room -User roomz-manager -AccessRights FullAccess -InheritanceType All Grant access to all room mailboxes Alternatively, you can grant access to all room mailboxes at once using the following command. Replace roomz-manager with the email adress of your ROOMZ account. Get-Mailbox | Where-Object {$_.RecipientTypeDetails -eq "RoomMailbox"} | Add-MailboxPermission -User r
Application Permission
If your environment uses Application access with RBAC, no action is required. ROOMZ automatically has access to the meeting room calendars. If your configuration uses a Mail-enabled security group, follow the steps below. Mail-enabled security configuration (graphic mode) Go to the Exchange Admin Center. Create the room resources if they are not already created. Navigate to Recipients → Groups → Mail-enabled security. Locate the group authorized for ROOMZ. By default this group is named: RoomzResources However, it may have been renamed. You can search for Roomz in the search bar. Add the new room resources as members of this group.
Exchange On-Premises
The following commands must be executed using the Exchange Management Shell on the Exchange server with administrator privileges. After executing the commands, it may take up to 15 minutes for the permissions to become effective. The ROOMZ service account (e.g. roomz-manager) needs permission to access and manipulate the meeting room calendars. Two configuration options are available: Option 1 — Impersonation (recommended) Option 2 — Full Access permissions We strongly recommend using Option 1 (Impersonation) for better scalability, performance, and easier maintenance. Option 1 — Impersonation (recommended) This configuration only needs to be executed once. Replace roomz-manager with the name of your ROOMZ service account. New-ManagementScope -Name "RoomzScope" -RecipientRestrictionFilter {RecipientTypeDetails -eq "RoomMailbox"}
New-ManagementRoleAssignment -Role ApplicationImpersonation -User roomz-manager -CustomRecipientWriteScope "RoomzScope" This configuration grants the ROOMZ account impersonation rights for all room mailboxes. Option 2 — Full Access permissions This configuration must be executed for each meeting room mailbox. Replace: roomz-manager with the name of your ROOMZ service account my-room with the name of the meeting room mailbox Add-MailboxPermission my-room -User roomz-manager -AccessRights FullAccess -InheritanceType All
Google
Google Workspace (delegation)
If your environment uses Google delegation, please follow the process below. Go to “Your Calendar” by connecting to: https://calendar.google.com. Search for “Other Calendars” on the left side of the screen, and click on the + to “Browse Resources”. Click on the room's name on the left of the screen and open “Share with specific people or groups” Under “Integrate calendar you will find the calendar ID you will need this later to connect the resource with the portal. Click on “Add people and groups”, you will arrive at this page: Share the room with the email address of the Roomz user. Make sure to select “Make changes to events”. Repeat these steps for each resource
If you are using a different booking system, please refer to the corresponding documentation → Others