Step 4: Connect Booking System to Evoko Home

Connect Evoko Home to M365 using oAuth 

1. Navigate to the Evoko Home configuration URL, in most hosted cases this will be localhost:3000.
2. To connect Evoko Home to your Microsoft 365 environment you need to go through the Evoko Home web wizard. Start by selecting “Modern (OAuth)” from the drop down on the credentials page.
3. Add the created service account and copy/paste the Tenant ID and Application ID from the previous steps for the appropriate fields.  Once done click “Login”. 
4. The wizard will now wait for you to log in using the provided URL (https://microsoft.com/devicelogin) and provided code. 
5. On the provided URL, enter the code from the wizard and click Next 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!

Connect Evoko Home to Google Workspace 

After successful installation Evoko Home will be ready to connect to the booking system through the wizard.  Select your booking system from the drop down menu and continue with the details below for Google Workplace.

1. Navigate to the Evoko Home configuration URL, in most hosted cases this will be localhost:3000.
2. To connect Evoko Home to your Microsoft 365 environment you need to go through the Evoko Home web wizard. Start by selecting “Google Workspace” from the drop down on the credentials page. 
3. We strongly recommend not to use the Super Admin as the admin email here as it will cause you a lot of problems on the Google side.  Instead - we recommend you create 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. 
4. Enter the service account that was created. 
5. Browse to the P12 Key locally from the Evoko Server, press Open. 
6. The P12 field should show a green check mark like this. 
7. Enter the admin email that was created for Evoko Home like shown here: 
8. Press Log In 
9. Enter the https application port you like to use (most customers use the default 3002).  Additionally you can upload your own SSL/TLS certificates and hit next.  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.   Press Next to continue: 
10. Next you will need to enter an NTP address to synchronize the Evoko Liso internal clock.  If you do not have your own NTP server you can try using public NTP servers.  We default to use 0.pool.ntp.org as shown below.  Press Next when done. 
11. Next you will need to agree to the conditions of the EULA if you dare!  Press Accept. 
12. The credentials show on the next page are generated for your login to the Evoko Home interface.  You will want to make note of these as when you click "Finish" you will be prompted to validate the recently made credentials. 
13. Press Finish 

Connect Evoko Home to Exchange 2016, 2019

1. To connect Evoko Home to your Exchange 2019 / 2016 / 2013 environment you need to go through the Evoko Home web wizard. Start by selecting your booking system and then click Next. (In this example we have chosen Exchange 2016, the steps for Exchange 2019 is the same). 

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 (default3002). Additionally, you can opt to upload your own SSL/TLS certificate (this needs to be done fromlocalhost and not a remote host) and then 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 and then click Accept. 

6. Credentials should have been generated for your instance of Evoko Home, please make note of these credentials since they are shown only once and then click Finish.                                                                     

Further reading