Sign in

Step 4: Connect Evoko Home to booking system

Last updated

Now that the necessary booking system preparations have been made and Evoko Home is installed we can start integrating the two.

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

Note! For security reasons it might not be possible to upload SSL/TLS certificates or Google Workspace *.p12 key via a remote host.

Step 4a: Office 365

To connect Evoko Home to your Office 365 environment you need to go through the Evoko Home web wizard. Start by selecting Office 365 as your booking system and then click Next.
001-office-365.png

Select if you want Evoko Home to connect to Office 365 via a direct connection or a proxy, then click Next.
EH_Step_2.png

Enter the credentials (e.g. service-account@domain.tld) for your service account granted with application impersonation rights and then click Log In.
003-office-365.png

Important! If you are using modern (oAuth) authentication, please see additional information on how to set it up here.

Enter the https application port you would like to use (default 3002). Additionally, you can opt to upload your own SSL/TLS certificate (this needs to be done from localhost and not a remote host) and then click Next. If no certificate is uploaded, a unique auto generated self-singed certificate will be used.
EH_Step_4.png

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.
EH_Step_5.png

Agree to the conditions of the EULA and then click Accept.
EH_Step_6.png

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.
2018-09-04_10_06_21-Evoko_Home.png

Once successfully done with connecting Evoko Home to Office 365 move on to Step 5: Basic Evoko Home setup

Step 4b: Exchange 2019 / 2016 / 2013

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 2013 and 2019 is the same).
001-exchange-2016.png

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.
002-exchange-2016.png

Enter the https application port you would like to use (default 3002). Additionally, you can opt to upload your own SSL/TLS certificate (this needs to be done from localhost and not a remote host) and then click Next. If no certificate is uploaded, a unique auto generated self-singed certificate will be used.
EH_Step_4.png

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.
EH_Step_5.png

Agree to the conditions of the EULA and then click Accept.
EH_Step_6.png

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.
2018-09-04_10_03_41-Evoko_Home.png

Once successfully done with connecting Evoko Home to Exchange 2019/ 2016 / 2013 / move on to Step 5: Basic Evoko Home setup

Step 4c: 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.

Note! To be able to finish the Evoko Home wizard you will need to have at least one resource room created and then added to Evoko Home in the last step.

  1. Start by selecting Google Workspace (Google G Suite) from the drop down menu and click Next. Screen_Shot_2022-10-18_at_2.43.35_PM.png
  2. 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.
  3. Enter the service account that was created. Screen_Shot_2022-10-18_at_2.47.48_PM.png
  4. Browse to the P12 Key locally from the Evoko Server, press Open.  Screen_Shot_2022-10-18_at_2.49.39_PM.png
  5. The P12 field should show a green check mark like this. Screen_Shot_2022-10-18_at_2.50.52_PM.png
  6. Enter the admin email that was created for Evoko Home like shown here: Screen_Shot_2022-10-18_at_2.52.20_PM.png
  7. Press Log In Screen_Shot_2022-10-18_at_2.53.08_PM.png
  8. 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: Screen_Shot_2022-10-18_at_2.55.05_PM.png
  9. 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. Screen_Shot_2022-10-18_at_2.56.57_PM.png
  10. Next you will need to agree to the conditions of the EULA if you dare!  Press Accept. Screen_Shot_2022-10-18_at_2.57.53_PM.png
  11. 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.  Screen_Shot_2022-10-18_at_2.59.17_PM.png
  12. Press Finish Screen_Shot_2022-10-18_at_3.00.37_PM.png

 

Once successfully done with connecting Evoko Home to Google Workspace move on to Step 5: Basic Evoko Home setup

Step 4d: IBM Domino

To connect Evoko Home to your IBM Domino environment you need to go though the Evoko Home web wizard. Start by selecting IBM Domino as your booking system and then click Next.
001-ibm-domino.png

Enter the IBM Domino server URL (e.g. https://dominoserver.tld/evoko/evoko.nsf/ResourceReservation?OpenWebService) with your credentials and a Evoko Home administration email (e.g. administrator@domain.tld) and then click Log In.
2018-09-05_09_54_35-Evoko_Home.png

Enter the https application port you would like to use (default 3002). Additionally, you can opt to upload your own SSL/TLS certificate (this needs to be done from localhost and not a remote host) and then click Next. If no certificate is uploaded, a unique auto generated self-singed certificate will be used.
EH_Step_4.png

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.
EH_Step_5.png

Agree to the conditions of the EULA and then click Accept.
EH_Step_6.png

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.
2018-09-05_10_58_38-Evoko_Home.png

Once successfully done with connecting Evoko Home to IBM Domino move on to Step 5: Basic Evoko Home setup
Was this article helpful?
21 out of 39 found this helpful
Have more questions? Submit a request