Setup Data Replication from Google


SherpaDesk provides the ability to import Users from Your Google Domains into the system and automatically synchronize this data in a separate night replication process.

In addition, you can use Organization Units of Your Google Domain to filter what Users are replicated. Review how to manage Organization Units of Your Google Domain in this article.

Log into SherpaDesk web application under an Administrator’s account, go to Configuration->Google page and turn on the Google Directory feature.

You can enter the name of field in Google to sync with User Unique ID in SherpaDesk: specify "organization" for Employee ID, "network" for Network ID, "id" for User Unique Key.

You can enter the name of field in Google to sync with User Location in SherpaDesk: specify "buildingId" for Building id, "floorName" for Floor name, "floorSection" for Floor section.

Click the “Create Token” button.

Once you initiate the Google sync and it is authenticated we are now able to read and update your data.


SherpaDesk provides a nightly sync option to automatically manage your data going forward, but you can turn it on or off.


NOTE: Once this process is started the system will replicate your data into the SherpaDesk on a nightly replication.

Use the View Replication Logs page to monitor the state of the replications.

Review our troubleshooting article if you have are having trouble.

NOTE: If you are having issues please review your Google Admin Console to make sure you are able to setup data replication from Google Enable API access in the G Suite Admin console.


Set Up Data Replication from Google 1.png


Sign in to Google under administrator’s account.


Set Up Data Replication from Google 2.png


Click “Allow” button to grant access to the SherpaDesk.


Set Up Data Replication from Google 3.png


Google configuration page displays the message “Google admin authentication token was created for your instance and will be used for Google authentication”.


Set Up Data Replication from Google 4.png


Select Your Google Domain in “Step 1”. If you have several domains, go to Configuration->Organization Profile page and put the domains separated by comma in Email Suffixes field.


Set Up Data Replication from Google 5.png


Create Organization Unit Filter in “Step 2”. If only 1 Organization Unit exists in Your Domain this step will be hidden.


Set Up Data Replication from Google 6.png


Click “Diagnostics Retrieve Users” hyperlink in “Step 3” to retrieve top 25 Users from Google as example of replication data.


Set Up Data Replication from Google 7.png


To manually import the Users from Your Domain Filtered by Organization Unit click “Import Users” hyperlink in “Step 4”.


Set Up Data Replication from Google 8.png


Now Users are imported and able to log in to SherpaDesk web application using Single Sign-On.

Troubleshoot

In case the replication reported an error please try to reset Google admin authentication token:

  1. Sign in to Google under administrator’s account.

  2. Open "Google Account" from your profile drop menu at the right of the screen.

  3. Open "Data & privacy" left side menu item.

  4. Look for "Third-party apps with account access" and click it.

  5. Click "SherpaDesk" and remove the access to our app.

  6. Go to SherpaDesk and then "Configuration" and open up "Google".

  7. Click "Reset Token" link and grant access to the SherpaDesk.
Back to Home