The service account enables communication between Surfsight® and MyGeotab. This is done through Polling or Webhook.
For more information about service accounts, see here.
Note
You can create a service account automatically. For more information, see Create a service account automatically.
Note
When creating the service account, make sure to follow the requirements as outlined by Geotab. Read here for more details.
To configure the rules:
-
Click Administration from the navigation bar, and then select Users from the sub-menu.
-
Click Clearances from the top of the Users window.
-
From the Security Clearances page that loads, scroll down and click View only.
The Security Clearance Edit page loads.
-
From the Security Clearance Edit page, click Add Sub-Clearance from the top.
-
In the Name field, type ViewOnlyAPI.
-
From the Access to feature list, scroll down and select Edit notification template to enable alerts for events.
-
From the top of the page click Save to save the new ViewOnlyAPI configuration in the Security Clearance list.
Now apply the new ViewOnlyAPI security clearance to enable a new user with these permissions.
-
Click Administration from the navigation bar, and then select Users from the sub-menu.
-
From the top of the window, click Add.
-
From the Add User page that loads, create a new user with the following details:
-
Enter a username in the User field
-
Enter a name in the First name field
-
Click No for Force password change on next login
-
Scroll down and change Security Clearanceto ViewOnlyAPI
-
Enter a password in the Password field
Note
Read here for more information about username and password requirements.
-
-
Click Save from the top of the page to save the new user.
Once you've created the new user, configure communication between Surfsight®and MyGeotab. In order to maintain updated events in Surfsight®, the add-in can communicate with MyGeotabin one of two ways:
-
Polling: Surfsight® sends a request for new events to MyGeotabat a predetermined frequency
-
Webhook: whenever a new event occurs, MyGeotab posts the event data to Surfsight®, updating it in real-time whenever changes are made
Note
We recommend setting the event management to Polling.
To configure communication:
-
From the Surfsight® add-in, go to the Recordings area.
-
Click Update Settings from the top of the window.
-
Select Polling or Webhook from the drop-down menu.
-
If you choose Webhook, enter the Username and Password, using the username and password of the new user you have created for ViewOnlyAPI.
After creating a service account, you can configure the video event rules.