Step 1: Configure Booking System

To connect your Microsoft 365 environment with the Naso ecosystem there is some preparation needed, which this article will cover. 

• Add groups
• Add service account
• Add rooms
• Configure rooms

Add groups

To manage access of Naso features two Active Directory groups are used:

• Admin group (EvokoNasoCompanyWebAdmin) to manage access to the Naso Admin Panel and Evoko SetApp
• User group (EvokoNasoUserGroup) to enable role-based access for the Evoko Naso Mobile App.

Important! The names of these groups need to be exactly EvokoNasoCompanyWebAdmin and EvokoNasoUserGroup, respectively.

Add admin group

1. In the Microsoft 365 admin center navigate to Groups.
2. Press Add a group
3. Select Security > Next.
4. Set the group Name to EvokoNasoCompanyWebAdmin and press Next > Create group.
5. Once the admin group is created, assign the relevant admin users to the group who will need access to the Naso Admin Panel.

   Note! Any users in the EvokoNasoCompanyWebAdmin security group will be able to log on to the Naso Admin Panel using their Microsoft 365 credentials.

Note! Before users added in the admin group can access the Naso Admin Panel, you need to allow active directory to synchronize across your system. This may take some time.

Add user group

1. In the Microsoft 365 admin center navigate to Groups.
2. Press Add a group.
3. Select Security > Next.
4. Set the group Name to EvokoNasoUserGroup and press Next > Create group.
5. Once the user group is created, assign the relevant users to the group who will need access to licensed Evoko Naso features.

Add service account

In order to later claim Naso devices using SetApp a user needs to be created. This user does not require a Microsoft 365 license. However, the username needs to follow this format: evoko.naso@domain.tld.

1. In the Microsoft 365 admin center navigate to Users > Active users.
2. Press Add a user and enter:
   
   • Display Name: e.g. Evoko Naso
   • Username: evoko.naso@domain.tld
3. Add the user to the EvokoNasoCompanyWebAdmin and the EvokoNasoUserGroup
4. Log in to the evoko.naso@domain.tld account in Microsoft 365 portal.

Important! The service account user name needs to be evoko.naso (@yourdomain.tld).

Add rooms

Next let's add rooms (also known as "resource accounts" or "room mailboxes") in Microsoft 365. It's the calendars of these rooms your organization and Naso devices will use when booking the rooms.

1. In the Microsoft 365 admin center navigate to Resources > Rooms & Equipment.
2. Press Add and enter the following:
   
   • Type: Room
   • Name: e.g. Fika room
   • Email: e.g. fika-room@domain.tld
3. Press Add.
4. Repeat the above step for all the rooms you'd like to add.

Already have all your rooms setup in Microsoft 365? Then there is no need to create new ones, instead skip to the next step of configuring your rooms.

Configure rooms

To ensure information on Naso is displayed properly some configuration of your rooms in Microsoft 365 has to be done using PowerShell. Being somewhat familiar with a CLI is recommended but not required.

Connect to Microsoft 365 via PowerShell

1. Set execution policy:

   Set-ExecutionPolicy RemoteSigned

   On the “Execution Policy Change” question type A and press Enter.

2. Enter credentials:

   $UserCredential = Get-Credential

   This will prompt a pop-up asking for credentials. Enter the username and password for a Microsoft 365 admin account and click Ok.

3. Create session:

   $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection

4. Import session:

   Import-PSSession $Session

Set room timezone

This is necessary to ensure time and date is displayed properly on Naso. To find the value for your timezone, please see the following list of timezones provided by Microsoft.

Set-MailboxRegionalConfiguration -identity fika-room@domain.tld -TimeZone “W. Europe Standard Time”

Note! Replace fika-room@domain.tld and W. Europe Standard Time in the above command with the equivalent for your room.

To get the current configured timezone of a room you may use:

Get-MailboxRegionalConfiguration -identity fika-room@domain.tld

Set room calendar processing

This is necessary to ensure the meeting subject and organizer name is properly display on Naso.

• For a single room:

  Set-CalendarProcessing -Identity fika-room@domain.tld -DeleteSubject $False -AddOrganizerToSubject $False -RemovePrivateProperty $False

• For all rooms:

  Get-MailBox | Where {$_.ResourceType -eq "Room"} | Set-CalendarProcessing -DeleteSubject $False -AddOrganizerToSubject $False -RemovePrivateProperty $False

Splendid! Now that you've made the necessary configurations in your booking system, move on to Step 2: Register Organization