Step 4: Connect Booking System to Evoko Home

Preparations

• You will need the Mongo Database credentials created during Step 3: Evoko Home Installation. These are the credentials readers are directed to record. 

• To connect Evoko Home to your booking system, you need to complete a wizard in your web browser. The wizard varies slightly depending on the booking system so please see the section that applies for your installation in this article.

• Microsoft M365 Conenction: For connecting to Microsoft M365 you will need to perform the steps in the oAuth Guide here.

• Google Worksplace Connection: We strongly recommend not using a Super Admin account as the admin email when connecting Evoko Workplace to a Google Workspace. This will cause several problems on the Google side. Instead, we recommend creating a new user with admin permissions and assign the sharing rights "make changes to events" or "make changes and manage sharing" for your resource rooms as explained in the Google Workspace Setup Guide. 

Login using OAuth in the Evoko Home Configuration Wizard.

1. Select “Modern (OAuth)” from the drop down on the credentials page.
2. Copy and Paste the Tenant ID and Application ID from the previous steps for the appropriate fields and click “Login”
   • 
3. The wizard will now wait for you to log in using the provided URL (https://microsoft.com/devicelogin) and provided code.
   • 
4. On the provided URL, enter the code from the wizard and click Next
   • 
5. Notice the application name you configured for this and log in with your service account and password.
   • 
6.  Once you sign in using service account credential, it will prompt for the consent dialog. This happens only for first login to this application, subsequent login remembers the consent.  Review the dialog and click "Accept".
   • 
7. ​​​​​​​You should now see the following screen which informs you to safely close this window.
   • ​​​​​​​
8. ​​​​​​​Switch back to the Evoko Home Setup Wizard and continue to the next step.  Your screen should look like this:
   • 
9. ​​​​​​​The Default Port for Evoko Home is 3002 - if you do not wish to change that or upload any of your own certificates, press next.
10. Here you will prompted to enter an NTP Server Address for Evoko Home to use.  We recommend using 0.pool.ntp.org if your organization allows access to it.  Some larger organizations may have their own internal NTP server.  Press next when ready.
    • ​​​​​​​
11. ​​​​​​​Here you will be prompted to accept the Evoko Terms of Service.   Press Accept!
12. Here on the final page you will be presented with the Username and Password that will be used to log into Evoko Home as an Admin.  Its very important that you copy this information to notepad before hitting finish as the text will disappear!
    • 
13. ​​​​​​​Once the information is copied to notepad Press Finish.
14. If you did not upload your own Security Certificates during the wizard you may get a message indicating that your connection is not private.  If you do get this message press Proceed to Localhost.
    • ​​​​​​​
15. ​​​​​​​You will want to log in with the Username and Password that Evoko Home prompted you at the end of the wizard (this should be the information you copied to the notepad).
    • ​​​​​​​
16. ​​​​​​​Success! You have now completed the setup with Modern Auth and you can now move through Setting Up Your Global Organization in Evoko Home!  This will let you add locations, and room resource accounts from O365!
    • ​​​​​​​​​​​​​​​​​​​​​
       

You can now move on to the Basic Evoko Home Setup Steps in the Getting Started Guide.

Connect Evoko Home to Google Workspace 

After successful installation Evoko Home will be ready to connect to the booking system through the wizard. 

 

1. Navigate to the Evoko Home configuration URL, in most hosted cases this will be localhost:3000.

 

2. Select “Google Workspace” from the drop down on the credentials page. 

 

3. Enter the following information in the corresponding fields.

• The service account that was created. 

 

4. Select the Brows button and navigate o the P12 Key locally from the Evoko Server, then press Open. 

 

 

• The P12 field should show a green check mark indicating a successful selection.

 

4. Enter the admin email created for this account.

• We strongly recommend not using the Super Admin as the admin email here. It will cause several problems on the Google side. Instead, we recommend creating a new user with admin permissions and assign the sharing rights "make changes to events" or "make changes and manage sharing" for your resource rooms as explained in the Google Workspace Setup Guide. 

 

5. Press Log In 

 

6. Enter the https application port you wish to use (most customers use the default 3002), then press NEXT to continue.

• Optional: You can upload your own SSL/TLS certificates. 
• If no certificate is uploaded, a unique auto generated self-signed certificate will be used. 
• In this guide we will be using the auto generated certificate.

   

 

7. Next you will need to enter an NTP address to synchronize the Evoko Liso internal clock, then press NEXT.

• If you do not have your own NTP server you can use apublic NTP servers. 

• We default to use 0.pool.ntp.org as shown below. 

 

8. Next you will need to agree to the conditions of the EULA if you wish to continue, then press Accept. 

 

9. The credentials show on the next page are generated for your login to the Evoko Home interface.  Record these credebtials before you click "Finish".

• You will be prompted to validate the recently made credentials.

 

 

10. Select Finish.

 

 

 

Connect Evoko Home to Exchange 2016, 2019

To connect Evoko Home to your Exchange 2019 / 2016 / 2013 environment you need to go through the Evoko Home web wizard.

 

1. Start by selecting your booking system and then click Next. In this example we have chosen Exchange 2016. The steps for Exchange 2019 are identical.

 

2. Enter the credentials (e.g.service-account@domain.tld) for your service account granted with application impersonation along with your Exchange server EWS URL (e.g.https://exchangeserver.tld/EWS/Exchange.asmx) and a administration email (e.g.administrator@domain.tld). Then click Log In.

 

3. Enter the https application port you would like to use (the default is 3002).

• Optional: You can opt to upload your own SSL/TLS certificate at this point. This needs to be done from localhost and not a remote host. After uploading the certificate, click Next.
• If no certificate is uploaded, a unique auto generated self-singed certificate will be used.       

 

4. Enter an NTP server (e.g.pool.ntp.org) that the Evoko Home server and the Evoko Liso units will have access to and then click Next.

5. Agree to the conditions of the EULA if you wish to continue, and then click Accept.

 

6. Important! Please record the credentials that are shown after generating this instance of Evoko Home. Do this before selecting Finish.

• The credentials are only shown this once.