WEBVTT 1 00:00:02.000 --> 00:00:03.666 Connecting to Google Workspace 2 00:00:06.466 --> 00:00:07.754 In this video 3 00:00:07.755 --> 00:00:11.501 We will show you how to connect the Door Tablet Server to Google Workspace 4 00:00:11.501 --> 00:00:14.599 At this point you should have already installed the Door Tablet server 5 00:00:14.766 --> 00:00:18.010 and have workspaces set up in Google Workspace 6 00:00:18.011 --> 00:00:21.060 We will also show how to check your connection 7 00:00:21.060 --> 00:00:24.365 Finally, we will show how to synchronise and activate your rooms 8 00:00:26.200 --> 00:00:27.214 Before we begin 9 00:00:27.214 --> 00:00:31.066 we recommend that you have consulted the Door Tablet documentation on this subject 10 00:00:31.900 --> 00:00:34.366 Then log in to the Door Tablet web UI 11 00:00:35.800 --> 00:00:38.281 To get Door Tablet to work with Google Workspace 12 00:00:38.281 --> 00:00:42.699 we must secure the Door tablet server so that it runs using HTTPS 13 00:00:43.000 --> 00:00:46.474 In this case Door Tablet already runs with HTTPS 14 00:00:46.474 --> 00:00:49.032 and we will use this server for the purpose of this video 15 00:00:49.300 --> 00:00:53.300 Generally, we recommend using a public CA to obtain certificates 16 00:00:53.300 --> 00:00:55.766 but you may use your own certificate authority 17 00:00:56.166 --> 00:01:02.232 To configure Door Tablet to work securely using HTTPS go to ‘DB and LAN’ 18 00:01:03.366 --> 00:01:05.932 select HTTP sites 19 00:01:06.266 --> 00:01:09.099 we will explain this further in another video 20 00:01:09.900 --> 00:01:11.866 Now go to the ‘System Profile’ 21 00:01:14.833 --> 00:01:16.933 When we begin the fields will be empty 22 00:01:17.633 --> 00:01:21.233 We will now fill them to indicate that we want to connect to Google Workspace 23 00:01:22.300 --> 00:01:26.566 Next to ‘Technology’ select ‘Google Workspace’ 24 00:01:31.166 --> 00:01:33.920 Door Tablet uses three-legged authentication 25 00:01:33.921 --> 00:01:36.057 for the communication between the Door Tablet server 26 00:01:36.057 --> 00:01:38.713 and the Google Workspace server 27 00:01:38.713 --> 00:01:42.379 Three-legged authentication is documented in a variety of places 28 00:01:42.380 --> 00:01:44.332 including on Google.com 29 00:01:44.333 --> 00:01:48.991 We will now switch to the Google Workspace environment to create an application 30 00:01:48.992 --> 00:01:52.382 enable security, enable calendar sharing 31 00:01:52.383 --> 00:01:55.333 and bring data to the Door Tablet server to establish the connection 32 00:01:56.100 --> 00:01:59.719 Again, we recommend that you follow the steps in our documentation 33 00:01:59.719 --> 00:02:02.066 when working on the Google Workspace admin 34 00:02:03.366 --> 00:02:06.432 To find the documentation click on ‘Resources’ 35 00:02:08.300 --> 00:02:10.600 then ‘Documentation’ 36 00:02:12.100 --> 00:02:14.233 and then ‘Product Manual’ 37 00:02:16.133 --> 00:02:19.566 Scroll down on the navigator to the Google Workspace area 38 00:02:24.000 --> 00:02:28.200 In this case the first document shows how to create resources in Google Workspace 39 00:02:28.633 --> 00:02:32.133 Before continuing with this video make sure you have already done this 40 00:02:32.566 --> 00:02:35.730 There is also a link here that takes you to Google Workspace admin 41 00:02:35.731 --> 00:02:37.232 Let’s click on that link 42 00:02:39.200 --> 00:02:40.533 and log in to our account 43 00:02:44.633 --> 00:02:47.133 Let’s go back to the documentation 44 00:02:48.566 --> 00:02:50.799 We need to enable API access 45 00:02:52.366 --> 00:02:54.032 Click on the first link that is shown here 46 00:02:58.300 --> 00:03:01.000 a new window will be opened in the Google Workspace admin 47 00:03:01.966 --> 00:03:05.835 When we open the cloud console, we will see our applications if we have any 48 00:03:05.835 --> 00:03:09.167 If we don’t have any, this screen will look slightly different 49 00:03:09.168 --> 00:03:12.106 We will create a new application by clicking here 50 00:03:12.106 --> 00:03:14.432 Then click on ‘New Project’ 51 00:03:15.466 --> 00:03:17.366 Next, we name the project 52 00:03:20.633 --> 00:03:22.199 Click on ‘Create’ 53 00:03:25.033 --> 00:03:28.633 The Door Tablet training project has been created and we can now edit it 54 00:03:30.733 --> 00:03:34.499 Note that the display has changed, it is now showing ‘Door Tablet Training’ 55 00:03:35.366 --> 00:03:38.132 Now we will click on ‘Enable APIs and services’ 56 00:03:41.933 --> 00:03:46.551 As Google Workspace offers many API’s we should use a filter to narrow the choices 57 00:03:46.551 --> 00:03:48.799 We type ‘Workspace’ here 58 00:03:51.600 --> 00:03:53.433 and click on ‘Google Workspace’ 59 00:03:55.600 --> 00:03:58.066 We need to select the 2 APIs that we require 60 00:03:58.066 --> 00:04:00.366 The first is the 'Google Calendar API' 61 00:04:02.200 --> 00:04:03.000 Let’s click on it 62 00:04:06.533 --> 00:04:07.699 and then click ‘Enable’ 63 00:04:11.733 --> 00:04:13.166 Then repeat the process 64 00:04:21.933 --> 00:04:24.133 but this time we will add the 'Gmail API' 65 00:04:30.766 --> 00:04:32.766 And again, enable it 66 00:04:38.233 --> 00:04:42.633 We can review all the APIs that are enabled for a project by scrolling down 67 00:04:43.200 --> 00:04:45.763 We only require the two we have just mentioned 68 00:04:45.763 --> 00:04:47.566 you can delete the others if you wish 69 00:04:48.266 --> 00:04:50.587 Next, we will enable the authentication 70 00:04:50.587 --> 00:04:54.174 between the Door Tablet server and Google Workspace 71 00:04:54.175 --> 00:04:57.766 The next chapter in the documentation explains how to do this 72 00:05:00.000 --> 00:05:01.500 Click on ‘Credentials’ 73 00:05:02.866 --> 00:05:05.199 and then ‘Configure Consent Screen’ 74 00:05:06.266 --> 00:05:07.532 Select ‘Internal’ 75 00:05:08.566 --> 00:05:09.666 and click ‘Create’ 76 00:05:11.133 --> 00:05:13.533 We type the app name which must be written in this way 77 00:05:13.733 --> 00:05:15.199 door_tablet 78 00:05:16.600 --> 00:05:18.333 Scroll down and click ‘Add Domain’ 79 00:05:19.733 --> 00:05:21.766 This will be the domain of the Door Tablet server 80 00:05:22.233 --> 00:05:24.666 in our case we are using door-tablet.com 81 00:05:26.033 --> 00:05:27.499 Now we can save and continue 82 00:05:28.800 --> 00:05:31.166 If you are prompted to fill in any additional fields 83 00:05:31.766 --> 00:05:32.632 we should do so 84 00:05:39.766 --> 00:05:41.457 We now need to add scopes 85 00:05:41.458 --> 00:05:45.016 These define what the application can do and what access it has 86 00:05:45.016 --> 00:05:46.932 If we go back to the documentation 87 00:05:48.000 --> 00:05:49.400 we can see the scopes listed 88 00:05:49.800 --> 00:05:54.916 These are the 'calendar.events', 'calendar.readonly' and 'gmail.send' scopes 89 00:05:54.916 --> 00:05:57.366 Let’s see how we add them to our application 90 00:05:58.933 --> 00:06:00.899 Click on ‘Add or Remove Scopes’ 91 00:06:02.000 --> 00:06:04.300 The list of scopes may not include the scopes we need 92 00:06:04.700 --> 00:06:08.411 So, the easiest way to find them is to drop the scopes from the documentation 93 00:06:08.411 --> 00:06:10.365 under ‘Manually add scopes’ 94 00:06:13.200 --> 00:06:15.200 Copy the scopes and put them on a clipboard 95 00:06:17.900 --> 00:06:19.900 then paste them in 96 00:06:19.900 --> 00:06:21.466 Click on ‘Add to table’ 97 00:06:26.933 --> 00:06:28.099 And then ‘Update’ 98 00:06:31.200 --> 00:06:32.833 this has now added our scopes here 99 00:06:34.700 --> 00:06:36.400 Click ‘Save and Continue’ 100 00:06:38.233 --> 00:06:40.999 Google Workspace will show us a summary of the application 101 00:06:43.166 --> 00:06:45.432 Now we click on ‘Back to Dashboard’ 102 00:06:47.700 --> 00:06:49.833 And then go to ‘Credentials’ again 103 00:06:50.933 --> 00:06:52.933 Click on ‘Create Credentials’ 104 00:06:54.366 --> 00:06:56.666 We select ‘OAuth client ID’ 105 00:06:58.166 --> 00:07:01.332 The application type will be a Web Application 106 00:07:02.833 --> 00:07:05.933 We will again call it Door Tablet Trainer for consistency 107 00:07:06.666 --> 00:07:10.080 We need to add an authorised redirect URI 108 00:07:10.081 --> 00:07:11.799 Click on ‘Add URI’ 109 00:07:13.900 --> 00:07:16.900 The URI is shown in the Door Tablet system profile 110 00:07:17.833 --> 00:07:20.366 It is here in green, copy it 111 00:07:23.466 --> 00:07:25.766 and then paste it in ‘URI 1’ 112 00:07:26.466 --> 00:07:27.966 Click ‘Create’ 113 00:07:31.533 --> 00:07:35.093 As we can see the OAuth client was created 114 00:07:35.093 --> 00:07:38.568 We now have some of the key items we need to make the connection 115 00:07:38.568 --> 00:07:41.132 Here we have the Client ID and Client secret 116 00:07:41.800 --> 00:07:43.596 We can copy these by clicking here 117 00:07:43.596 --> 00:07:46.365 and paste them directly into the form in the system profile 118 00:07:57.533 --> 00:08:01.399 Our account email for this account is known so we can drop it in too 119 00:08:02.433 --> 00:08:05.333 We are now able to authorise the account by clicking here 120 00:08:06.933 --> 00:08:09.366 We are prompted to continue to Door Tablet 121 00:08:09.366 --> 00:08:12.932 Select the account, and allow access 122 00:08:14.266 --> 00:08:16.834 The authorization code is shown 123 00:08:16.835 --> 00:08:19.733 We click the button that says ‘Use this code’ 124 00:08:21.766 --> 00:08:24.332 This makes the authorization code drop into the system 125 00:08:25.700 --> 00:08:27.500 and we can now submit the form 126 00:08:28.833 --> 00:08:32.399 When we open the system profile again we can test the connection 127 00:08:34.066 --> 00:08:37.666 Our connection works and the system shows us that we have 20 rooms 128 00:08:38.566 --> 00:08:42.004 At this point we have finished setting up access and authentication 129 00:08:42.004 --> 00:08:43.432 from the system profile 130 00:08:43.933 --> 00:08:44.913 The final step 131 00:08:44.913 --> 00:08:48.432 is to authorise the workspace calendars to share information with this application 132 00:08:49.733 --> 00:08:53.866 Again, the documentation shows how to do this, but we will also go through it now 133 00:08:55.633 --> 00:08:58.045 When we log in to the Google workspace calendar 134 00:08:58.046 --> 00:09:02.053 if we have added the calendars before we will see all the appointments as shown here 135 00:09:02.053 --> 00:09:04.299 On the left shrink ‘My calendars’ 136 00:09:06.400 --> 00:09:08.600 and click on 'Other calendars’ 137 00:09:10.166 --> 00:09:12.199 Then click on ‘Browse resources’ 138 00:09:13.533 --> 00:09:17.340 Here resources are grouped together and at this stage they will be unticked 139 00:09:17.340 --> 00:09:20.252 These are ticked as we have had an application before 140 00:09:20.253 --> 00:09:24.366 Click them one by one until all the resources you wish to share have been ticked 141 00:09:25.600 --> 00:09:28.295 Now we have completed the Google Workspace configuration 142 00:09:28.295 --> 00:09:32.599 we can go to the list of spaces and synchronise with Google Workspace 143 00:09:34.800 --> 00:09:38.800 The system tells us it has processed and inserted our workspaces 144 00:09:38.800 --> 00:09:42.800 We can now go and activate each of the workspaces we want to use 145 00:09:42.800 --> 00:09:45.933 Let’s go into one and see if it retrieves the calendar appointments 146 00:09:48.833 --> 00:09:53.666 We tick ‘Active’ and we tick ‘Pro Hardware License’ if we are using professional hardware 147 00:09:53.866 --> 00:09:55.693 Then submit 148 00:09:55.694 --> 00:09:58.697 We can see here that our workspaces are not yet licensed 149 00:09:58.698 --> 00:10:01.851 we have another video about Licensing Door Tablet 150 00:10:01.851 --> 00:10:03.999 We click here to open this workspace 151 00:10:12.333 --> 00:10:14.366 and we can see all the appointments we have there 152 00:10:16.233 --> 00:10:17.333 Thank you for watching