Getting Started with
GAT Labs

Learn how to get the most out of the GAT Labs Suite with practical guides and resources. Follow step-by-step articles on setup, configuration, workflows, security, and troubleshooting to confidently manage and protect your Google Workspace environment.

How to install GAT+

GAT+ is a Google Workspace Audit tool that by default can be installed only by the Super Admin of the Domain.

Install GAT+

How to install GAT+  Video

Step 1:

First login to your domain with Super Admin Account.

Navigate to >  Google Workspace Marketplace   > You can also search for GAT+ in the search bar.

When GAT+ is selected click on Admin install 

A pop-up window will be displayed by clicking on “Continue“.

Then a new pop-up will be shown with all the permissions required.

Scroll down to the bottom.

  • Under: Install the app automatically for the following users
    • Select “Everyone at your organization”
      • Note: installing on certain groups or org. units will not give clear and accurate data stats of the domain data
    • Enable the checkmark – “I agree to the application’s terms…”
  • Click on Finish

Note: You can not install it from an incognito window unless you are signed in to your Super Admin account.

Result

GAT+ will be installed.

When installed, click on the Goole apps button and scroll down to the GAT+ icon

Select Region

When you launch GAT+ for the first time you will have to select a region where data will be stored.

This selection is permanent.

Select the Region where the data will be stored.

  • US Region – 
  • EU Region – 
  • UK Region –

Once the region is selected GAT+ will be opened up for you.

This will be the initial login and the initial scan will be started.

The time for the initial scan to complete will depend on the size of the domain.

  • The number of users
  • The number of Drive files etc


Estimate time of the initial scan

We estimate the initial scan to take 30 min per 1 million files. When the scan is completed an automatic email will be sent to the Admin account.

Note: Subsequent scans will be faster.

When the initial scan has been completed, the data from your domain will be displayed in the GAT+ console.

Data access

To view and access the full domain data (metadata), we recommend that GAT+ be installed domain-wide and all permissions be granted.

Access GAT+ by Super Admins only

By default, the tool can be accessed ONLY by Super Admins of the domain.

Non-admin accounts can see the GAT+ application under their Google Apps option, but CANNOT launch the tool itself.

When the tool is installed domain-wide, it can be launched from the Google Apps menu.

Click on the Google Apps menu button scroll down to third-party apps and click on GAT+

This will launch GAT+ into a new window on your browser.

Grant Access to GAT+ in Google Admin Console

Is GAT+ failing to run? Check these options in your Admin Console

How to make sure GAT+ is running correctly and showing correct information from your domain?

Navigate to the Google Admin console 

Click the Google Apps menu button on the top right corner of your Chrome session and click on the Admin button

In the Google Admin console navigate to Apps > Google Workspace Marketplace apps > Apps list

Click on the GAT+ app

You will need to click and grant access to GAT+

  • Distribution – it has to be Enabled for all organizational units and groups
  • Data Access – status Granted
  • Grant access – click to grant access to GAT+

IMPORTANT NOTE: As Google has deprecated their ‘Google Sites’ product, GAT cannot be granted access to that. You may see that the status is only ‘Partially Granted’ during this step. However, once you have clicked the ‘Grant access’ button you can consider this step finished.

Access by Super Admin Only

By default, the tool can be accessed ONLY by the domain’s super admins. Non-admin accounts cannot log in.

Context-Aware Access

If your domain has Context-Aware Access consider enabling and allowlisting GAT+.

Navigate to Security > Context-Aware Access > Assign access levels and enable the allowlist

Follow the steps required and explained by Google: https://support.google.com/a/answer/7281227?sjid=3600469929573291665-NA

Navigate to Admin console > Security > Access and data control > API control > Manage third-party app access to Google services and then expand “configure new app”.

.

To enable Classroom auditing

Navigate to Apps > Google Workspace > Classroom > Data Access

Make sure that Classroom API – is turned on: ‘Users can authorize apps to access their Google Classroom data’

Troubleshooting GAT+ Initial Run Problems

Typically, these issues are straightforward to resolve. Don’t panic – fixing them is usually simple.

HAS A SUPER ADMIN FROM YOUR DOMAIN EVER USED GAT+?

To check if GAT+ is already installed click on your Google Apps button and navigate to the 3rd party apps section, you should see the GAT+ logo.

Alternatively, you can navigate to your Google Workspace Admin Console.

Navigate to Apps  > Google Workspace Marketplace Apps > Apps list > GAT+ 

You will need to click and grant access to GAT+

  • Distribution – it has to be Enabled for all organizational units and groups
  • Data Access – status Granted
  • Grant access – click to grant access to GAT+

Make sure it’s enabled for everyone and Data access is grantedthis post will guide you through the process.

GAT+ Initial Run Problems

Still, having problems? do you need a fresh trial license?

IS YOUR DOMAIN TRYING GAT+ FOR THE FIRST TIME?

Navigate to the Google Workspace Marketplace the tool can only be installed by a Google Workspace Super Admin via the ADMIN INSTALL button. 

Remember, for addressing GAT+ Initial Run Problems, installation from an incognito window is not possible unless you’re logged into your Super Admin account.

Important Note: To ensure optimal functionality and avoid any GAT+ Initial Run Problems, install GAT+ in the root Organization Unit (marked as ‘On for Everyone’).

Access by Super Admin Only

By default, the tool can be accessed ONLY by Super Admins of the domain.

Non-admin accounts cannot log in to the tool.

Are Some Auditing Areas in GAT+ Empty?

To check this, go to the Security section in your Google Workspace Admin console.

GAT+ Initial Run Problems

Navigate to Apps > Google Workspace > click on Drive and Docs then click on Features and Applications

GAT+ Drive and Docs

Select the root Org. Unit and make sure the Drive SDK is ON

PLANNING ON USING EMAIL DELEGATION WITH GAT UNLOCK?

You can use GAT Unlock to remotely set mail delegation for any user account.

As a Super Admin, you can give any user mail delegation access to another user’s account.

Navigate to Apps > Google Workspace > click on Gmail > then click on User settings

Google Admin

Turn ON the option to set Mail Delegation.

HAVE YOU ENABLED GOOGLE CLASSROOM AUDITING?

Navigate to Apps > Google Workspace > click on Classroom  > then click on Data access

Google Classroom

Click on to enable Classroom API then Save

Accessing GAT labs Suite of Tools

As a Google Workspace Super Admin or a Delegated Auditor, you can access the GATLabs suite of tools from Launching the main product GAT+. Click on Google Apps button > scroll down to third-party apps and select GAT+ application. Once you are in GAT+ to access other tools click on the GAT+ logo at the top left corner. Each tool will be opened on a new browser tab.

Configuring your User Profile Settings and Preferences

Each Google Workspace Super Admin or Delegated Auditor within GAT+ can have their own user profile settings and preferences configured.

Configuring Settings

To configure your settings, navigate to GAT+, and click on your user name at the top right corner of the side menu.

Within the Settings area, you will see the Common, Querying, and  Impersonation tabs.

Common

  • Change Timezone – set up timezone
  • Import/Export date format – select date format for exports
  • UI date format – select the date format to be shown in the UI
    • View the format preview
  • Records Shown per page

Querying – Timeout settings

  • General time-out settings
  • Drive audit time-out setting
  • Gmail/Email audit time-out setting

The above settings influence the waiting time for filter searches within the Drive or Email sections. A time-out error will be shown if time expires while waiting for a search to complete.

Impersonation – Multi-tenancy management for GAT+ Admins

  • Multi-tenancy management for GAT+ Admins –  GAT+ empowers Admins to manage multiple domains within a single account seamlessly.
  • This new Multi-Tenancy Management feature streamlines administration by allowing one Admin to oversee various external domains effortlessly.

Here’s how it works:
  • Centralized Control:
    • A single Admin account serves as the central hub for managing multiple domains.
    • Simplified navigation and oversight for efficient administration.
  • Manager Account Access:
    • Admins of individual domains grant access to Manager accounts for GAT+ control.
    • Collaborate seamlessly with managers without compromising security.
  • Impersonation Feature:
    • External users cannot access a domain unless are granted permission by the Admin using the Impersonation feature.
    • Ensures secure and controlled access to domain-specific functionalities.

This streamlined Multi-Tenancy Management feature in GAT+ enhances efficiency, security, and collaboration for Admins overseeing diverse domains.

Experience the ease of unified administration with GAT+.

More information can be found here.

Drive Clean Up – Duplicated files shared out

GAT+ audit tool can help admins identify files using all sorts of criteria using the ‘Filtering‘ feature available throughout every audit.

In this example, we are looking to identify all of the video files that are duplicated and shared with external users and then manage their access and ownership.

The scenario is to find the duplicate files, remove the external shares, and then delete the duplicate files.

To achieve this, we can break down the task into steps.

Step 1.  Identify duplicated video files that are shared externally

Starting the Drive Clean Up:

  • First, navigate to the Drive audit (1)
  • And then to the Files tab (2).
  • Next, run the filter to find files, select the filter icon (3).
  • Now the filter needs to be defined, select the Type to be Duplicated Files. (4)
  •  Select the minimum number of duplicates you are looking for, so ideally this is 2 and cannot be anything under, because at least 2 files are duplicates.(5)
  • Now we can add more criteria to the definition of the filter to target the files we want.
    • Select the field to be ‘Type’ (6)
  • Select the type to be video (7)
  • Add a rule to the rule definition block (8)
  • Now we want to find these files that are externally shared, select the field to be ‘Sharing flags’ (9)
  • Select the ‘Sharing flags’ to be ‘Shared out’ (10)
  • Apply the filter (11)

Drive Audit - Files Filters

Result of filter

As a result, all the video files that are duplicates and shared externally will be displayed.

Shared Drive result

Some files might be part of Shared Drives, where you cannot change ownership, as Shared Drives do not have owners.

You can exclude Shared Drive files by adding a simple additional filter.

  • Flags – “doesn’t contain” –  Shared Drive

Step 2. Take action to change ownership and delete duplicates

As an Admin or Delegated auditor, you can now change the ownership of those files and then delete them from the Google Drive UI.

For example, remove the permissions of all external shares on the files and transfer ownership to delete the duplicate files.

  • Select all files to be deleted and leave the copies you want to remain

  • Select ‘File management‘. This operation will allow us to change ownership of the files and remove their permissions in the same File management Job.
  • A new window will be displayed with the actions that can be taken
  • Fill in the details for the ownership change
    • General –
      • Change the selected files’ owner – enter the new owner’s email
      • Move file – select to move the files directly, rather than creating shortcuts
      • Custom path – select location where the files will be placed when ownership change occur

  • Next, proceed to the ‘remove permissions‘ tab and choose the option to Remove all external permissions.

  • Next, go to the summary tab and select ‘send request’

Approval of action

The security officer will receive an email to approve the Unlock request.

The email will lead them to GAT+ > Security Officer > File Management

Result in the File management log

When the job is finished, it’s possible to check the status of every file where action was taken by checking the job in the File Management Log tab in the Drive audit.

Step 3. Drive Clean Up- Delete duplicate files

When the change of ownership has finished, as part of the File management, we selected where the files will be located when the ownership change happens.

Because of the change, the files will be located in the new owner’s My Drive under the added folder.

From there, the new owner can delete the duplicate files.

Related Posts

How to find any duplicate files in Google Drive

Transfer Files ownership of a suspended user

Copy Files or Folders from Internal or External Users

Google Workspace Admin Best Practices in GAT Suite

There are many different ways Google Workspace admin can set up Google domain to efficiently protect against possible threats and prevent data loss. The GAT Suite of tools specializes in Security Management and Data Loss Prevention. GAT requires very little setup on installation, but here are a list of some popular actions and best practices you can take as the administrator, to better optimize your domain for DLP.

Best Practices List

FAQ’s – GAT+ Features not available based on Google plan

GAT+ is a third-party Google Workspace app — It offers Super Admins powerful Google Workspace auditing and reporting for their domain.

What Google Plans are covered by GAT+?

By default GAT+ audit covers every Google Workspace plan.

Features not available based on the Google plan

The only feature that is not available in GAT+ based on Google plans is the Drive Events. 

The Drive Events feature is not available for Google’s most basic plans – Business Starter and Education Fundamentals.

The Drive Events (Drive Log Events) are supported in:

  • Business Standard
  • Business Plus
  • Enterprise
  • Education Standard
  • Teaching and Learning Upgrade
  • Education Plus 

Why are Drive Events not available?

This audit is not available because Google does not report on those events and therefore GAT+ cannot report them either.

More information can be found on Google’s end here.

GAT Unlock – First Steps

What is GAT Unlock?

What is a Security Officer?

The Security Officer is a user from your domain that is responsible for approving or denying the changes requested by any Admin.

What do I need to enable my Security Officers?

To enable Security Officers you would need to have a paid licence with the Admin Plan or higher for Enterprise and is included in all the plans for Education.

How can I configure my Security Officers?

To configure your Security Officers you would need to firstly have a paid licence as per the previous question and secondly email us at unlock@gatlabs.com

Only the GAT Labs team can add, remove or change the Security Officers in your domain.

For easier management, it is recommended to have at least two Security Officers in the domain. If you don’t have a second person you can create a service account such as unlock@yourdomain.com

Who can be a Security Officer?

The Security officer can be any user of the domain, it does not matter what Google Workspace privileges they have.

What products require a Security Officer approval?

GAT Unlock within GAT+ and GAT Flow

What type of actions require a Security Officer?


How does the Security Officer workflow approval works in GAT+?

When the Admin sends a request for any action that requires Security officer approval, an email will be sent to the officer.

The email will look similar to the screenshot below, depending on what is the request for.

 

security officer

 

Clicking on the link ‘click here’ will lead to the Security officer tab in GAT+.

security officer

By default selecting the link from the email will lead to the exact field from where the request can be approved or denied.

In each of the section, the Security officer just selects the request and approve or deny it.

 

File management will have the file permission changes required, Folder copy for copying folders, Grants is for view or downloading of files and emails. More information can be checked in the Dashboard section.

How does the Security Officer workflow approval works in GAT Flow?

When the Admin creates a workflow and sends it to the Security Officer for verification, an email will be sent to the officer.

The Security Officer will receive an email notification that the workflow is waiting for verification.

GAT Flow

By default selecting the link from the email will lead to the exact field from where the request can be reviewed and then approved or denied.

During the approval process, a message will appear confirming that the approval is indeed intended.

Once approved, the workflow is scheduled to run.

The workflow Requester receives an email notification about the approval.

security officer

Once completed successfully, another email is sent to the Requester informing them about workflow completion.

By default selecting the link from the emails will lead the workflow Requester to the exact field of GAT Flow from where the results can be reviewed.

NOTE:

  • Only the GAT Labs Staff can enable Security Officers. Please contact us at unlock@generalaudittool.com for more information.
  • For easier management, it is recommended to have at least two Security Officers in the domain.
  • GAT Unlock is not activated during trials for security reasons.

FAQ’s – Security Officers in GAT

What is a Security Officer in GAT?

Security Officers are users of the domain who can approve or deny any requests from any Admin or Delegated Auditor in GAT+ and GAT Flow.

A Security Officer does not necessarily need to be a Google Super Admin or a Delegated Auditor. They can also be a regular user in your domain.

How can I add a Security Officer?

To add a Security Officer you must have a paid licence that includes GAT Unlock and/or GAT Flow

Security Officers can be added, edited, and removed only by GAT+ staff.

For easier management, it is recommended to have at least two Security Officers in the domain.

Check out this document to better understand the enablement process.

Can I test GAT Unlock and/or GAT Flow?

Yes, you can run a trial on a test domain. Otherwise, you’d need a paid licence with a plan that includes these products.

Check out our pricing plans for Enterprise and Education.

Please contact sales@gatlabs.com for more information.

How can I check my Security Officers’ list?

In GAT+ you can check who are the users who are set up as Security Officers.

Navigate to GAT+ > Configuration > General > Domain info > Security officers

How can I update my Security Officers?

Security Officers can be added, edited, and removed only by GAT+ staff.

To make updates to the current list, an existing Security Officer in your domain or the Approver (Senior Manager) can contact us at unlock@generalaudittool.com. We’ll gladly take care of your request from there.

What happens if my Security Officers or Approver left the organisation?

Please contact us at unlock@generalaudittool.com. We’ll need to run the approval process again then.

Check out this document to better understand the enablement process.

Add Users to an OU Depending on Their Department with GAT Flow

GAT Flow is a user management tool. It allows Google Workspace Admins to set conditional workflows for the nesting of actions that will execute when a certain specified condition is met. This paves way for complex workflows that might consider multiple conditions and actions. For such use cases, there is the option to align overlapping actions to tidy up the visual complexity explained in the example below. Let’s see how to set a workflow to add users to an OU depending on their department.

Step 1.

To add users to an OU, it’s best to set a recurring workflow that will run according to the time set by the workflow creator. Every time the workflow runs it will check the department conditions specified and run the following actions.

Step 1. Adding a recurring workflow

Step 2.

For this example, we enable the following options:

  • Recursive OU search – capturing all sub-OUs of selected OU.
  • Active – enable workflow.
  • Preapproved – select to avoid needing the Security Officer’s approval after every time the report runs. A security officer has to only approve initially when this is selected.
  • Conditional Flow – This will enable the conditional functionality in the actions menu.

Step 2. Enabling of four options

Step 3.

Clicking Next will take you to the Choose Actions subtab.

Step 3. Choosing action

Here you can add a Department condition.

Adding a condition

Add action in case the condition is true. For this example, we are adding the action Change organization unit to the /Sales OU.

Adding the action Change organization unit

Repeat the steps until all the departments and relevant OU’s are captured in the Workflow.  There may be many actions and conditions added, notice the align overlapping actions icon at the top right, this can be toggled and will align the view.

Adding many actions and conditions

Remember to end the line graph for each node and then send the approval request.

Results

Once the workflow is approved, it will execute at the set time. To check the actions executed, toggle the results button next to the workflow.

Checking results

 

The tool will navigate you to the workflow Results in the Workflow module. Select the eye icon next to the workflow to see in detail exactly the actions and users affected.

Checking results details

Selecting the figures will show in further detail the status of the actions executed for each user.

Results details

Action details

Related Posts

GAT Flow Settings Configuration

The GAT Flow Configuration section is available only for domain Administrators of Google Workspace and helps configure the tool to be as user-friendly as possible.

A domain Administrator can set up several options according to each domain’s needs under Configuration > Settings > Workflow.

GAT Flow settings

Workflow Settings

You can configure the following available GAT Flow settings accordingly under the Workflow tab:

Send approval reminder

  • Send approval reminder – this option allows an Admin to decide whether the reminder email for the workflows awaiting approval needs to be sent to all of the Security Officers, a reminder will be sent once a day if enabled

GAT Flow settings

An email notification that each of the Security Officers will receive:

GAT FLOW

Enable workflow auto-save

  • Enable workflow auto-save – an Admin can decide whether workflows should be automatically saved during the creation process to avoid losing them when the page is refreshed (useful for complex/advanced workflows that require longer preparation time)

GAT FLOW Autosave

Workflow auto-save frequency

  • Workflow auto-save frequency – set the workflow auto-save frequency in minutes to automatically save the workflow after that time elapses.

GAT Flow WORKFLOW

Workflow changes before auto-save

  • Workflow changes before auto-save – Set the number of changes to the workflow that will trigger an automatic save.

GAT Flow Workflow

Enable advanced workflow auto alignment by default

  • Enable advance workflow auto alignment by default – an Admin can decide whether to enable by default auto aligning of the nodes in the conditional/advanced workflow

Enable advanced workflow

When you turn on auto-alignment, the system places all nodes in their default position.

Workflow type

When you turn off auto-alignment, you can arrange all nodes according to the workflow creator’s needs.

GAT Flow

Enable advanced workflow node preview by default

  • Enable advanced workflow node preview by default – an Admin can decide whether the node preview of the conditional/advanced workflow will be available

Enable advanced workflow node

By default, enabling this option allows you to preview each node in the conditional workflow by hovering over its ‘Edit’ button.

Send notification about “Done” workflow to

  • Define the person who will receive the email notification once the workflow is finished successfully; the workflow requester receives it by default

Send notification about “Failed” workflow to

  • Define the person who will receive the email notification once the workflow is finished unsuccessfully; the workflow requester receives it by default

Send notification about “Partially done” workflow to

  • Define the person who will receive the email notification once the workflow is partially done; the workflow requester receives it by default

Send approval status change notification to

  • Define the person who will receive the email notification once the workflow approval status is changed; the workflow requester receives it by default

Workflow Tags

An Admin can create custom Workflow tags that help with identifying and sorting out workflows.

The default tags are as follows:

  • Workflow – generated automatically by the system for the regular workflow
  • Event – generated automatically by the system for Event-triggered workflow
  • Recurring – generated automatically by the system for Recurring workflow

On top of the above default tags, an Admin can create a tag of their choice to be able to identify the workflows in a quick-for-them way (examples of custom tags are shown in the below screenshot).

Relevant posts

How to Create Workflow Tags in GAT Flow

Managing numerous workflows in your domain can be challenging. GAT Flow introduces a tagging system to simplify this process, allowing you to see what’s happening at a glance.

Creating Workflow Tags in GAT Flow

To create a tag, first go to the Settings section in GAT Flow.

Click the Workflow tags in the top right corner and Create tag.

Workflow Tags in GAT Flow

Enter a name for your tag and click Save.

Workflow tag

That’s it! You have created your new tag and it is ready for immediate use.

GAT Flow Setting

 

Using your custom tag

You can apply your new tag to any new workflow you create. Just click on the ‘Workflow tags’ field when creating any workflow to see your available tags.

You can add multiple tags to a single workflow if you wish.

GAT FLOW wORKFLOW

 

In the Workflow section, you will see all the previously run workflows, alongside the draft workflows. The column labeled workflow tabs will show you the tags that each workflow is given.

Each workflow receives one tag by default.

Standard manual workflows that were made from the ‘Create workflow’ section will be given the green label ‘Workflow’

If the workflow is an Event workflow, it receives a red ‘Event’ label.

Recurring workflows will receive a yellow label that reads ‘Recurring’.

Finding workflows from a specific tag

In the Workflow section, use the filter icon to select the applied tag, helping you quickly find previously tagged workflows.

GAT FLOW FILTERS

Finally, click ‘Apply’ to display the results.

Workflow Tags in GAT Flow

GAT Shield Configuration Instructions

GAT Shield Extension – How to Deploy

Deploying the GAT Shield Chrome Extension

In this document, we will cover the deployment steps of the GAT Shield extension.

To start navigate and login into the Google Admin console 

In the Admin Console click on Devices

From the menu on the left navigate down to Devices >Chrome >Apps & extensions > click on Users & browsers

A new page will be displayed.

Install

To install the GAT Shield extension, choose the root Org Unit or a sub-OU where you want to deploy Shield into. 

On the bottom right side, click on the Yellow + button 

Select the Add the Chrome app or extension by ID option.

NOTE: A pop-up window will be displayed, select the From a custom URL option.

You’ll find both the ID and the URL required for this step in the GAT Shield application under the Extension deployment section.

Enter the Extension ID and URL of the extension.

To access and view the Extension ID and URL, navigate to GAT Shield > Configuration > Extension deployment.

Click Save.

The Shield Extension is now installed.

Click on the newly installed extension. You will see a pop-up window on the side. In the Installation policy, click and select Force install.

Clicking "Force install"

Scroll down on the same window to the bottom of the page to find the Policy for extensions.

Policy for extensions

Enter the Secret key – taken from  GAT Shield under Configuration – Extensions deployment.

Under the Permissions and URL access field, click on and select Allow all permissions (2).

Selecting Allow all permissions

After doing all the changes, click the Save button on the top right.

Result

Shield will be installed for the users of the selected Org. Unit. It would depend on Google when the extension will appear on the end-user accounts.

Given that the users are logged in on Chrome browser with their Google Account, it should take a few minutes to be propagated to the end users.

Deploying GAT Shield Extension using Microsoft Group Policy Objects (GPO)

First, apply the Chrome ADMX Group Policy using the steps found at this Google support article.

Navigate to Computer Configuration> Policies> Extension > Configure the list of force-installed apps and Extension

You are required to specify which Chrome extensions should be automatically installed (force-installed) for the users via Group Policy settings.

Next, you need to enter each extension ID and installation URL  into the Group Policy setting.

You’ll find both the ID and the URL in the GAT Shield application under the Extension deployment section.

After you have configured the Chrome policy to force install the extension in Group Policy, you can assign this policy to particular groups of computers or users within your organization.

 

Recommended settings

User & Browser settings

We recommend enabling some settings on the domain to prevent Users (students) from interfering with Shield and any extensions.

Enable these settings in Devices > Chrome  > Settings Users & browsers

 

Some of these settings are mandatory.

Apps and Extensions

On the above-selected page, scroll down and navigate to the Apps and Extensions area, find the Task Manager setting,s and switch it to Block users from ending processes with the Chrome Task Manager.

Description: Task Manager can be used to tamper with the Chrome browser’s normal operations.

User experience

On the same page, scroll down to User Experience 

User & Browser settings > User Experience

The following settings are highly recommended for schools using enrolled Chromebooks.

These settings prevent students from bypassing the network firewall and installing Android apps like VPNs and other web browsers on their Chromebooks.

  • Multiple Sign-in access – Block multiple sign-in access for users in this organization 
  • Sign in to secondary accounts – Block users from signing in to or out of secondary Google accounts 

In User experience, scroll also to Developer tools and set it to “Never allow use of built-in developer tools”

Description: Developer tools can be used to disable extensions. Google also recommends disabling these tools in most cases.

Security

The following three options are recommended for schools with enrolled Chromebooks. These settings prevent students from bypassing or tampering with the GAT Shield extension.

Scroll down to the Security tab

Find and apply the settings

  • Incognito Mode – Disallow Incognito mode.
    • Description: In incognito mode, the extensions do not work
  • Browser historyAlways save browser history.
    • Description: Saving browser history is recommended so that when incidents occur, there is an audit trail that can be investigated by staff members.
  • Clear Browser History – Do not allow clearing history in the settings menu.
    • Description: The ability to clear browser history on the Chrome Browser may allow users to tamper with GAT Shield Browser reporting features.

Content

Scroll down further to the Content tab

  • Screenshot – set it to Allow users to take screenshots.

Description: Disabling screenshots will cause problems with the GAT Shield Alerting functionality.

When all of the settings are set up, make sure they are saved by clicking on the “Save” button on the top right.

Configure Device Settings

We recommend that these options be configured on your domain for your Chrome devices. Not all are mandatory.

From the Google Admin console, navigate to.

Devices > Chrome > Settings > Devices

In the left sidebar, select the OU that contains your Chromebooks, then configure the following policies to match these values.

Enrollment and access

  • Configure the Enrollment and access
  • Set Forced re-enrollment – automatically re-enroll after a wipe
  • Set Verified access to Enable for content protection.
  • Set Verified mode to require verified mode boot for verified access.

Sign-in settings

On the same page, scroll down to Sign-in settings

  • Guest mode – Disable guest mode
  • Sign-in restrictions – Restrict sign-in to a list of users
    • Add an allowed list

When done with the changes, click on the “Save” button on the top right.

Shield is deployed to all, but only ChromeOS devices are seen?

It could be a case where Shield is deployed domain-wide to all users, and yet the data is only shown on ChromeOS devices. You can check this setting.

Adjust the settings for Chrome management for signed-in users

Navigate to Devices > Chrome > Settings > Users and browsers  > Chrome management for signed-in users 

Set it up to: Apply all user policies when users sign in to Chrome, and provide a managed Chrome experience.

Referring to: Manage user profiles on Chrome browser, and View and configure apps and extensions

When the Shield extension is deployed, every user who logs into their Chrome Browser with their domain credentials will have the extension automatically synchronized.

The Chrome user cannot override this setting.

WebCam capture – Extension URL

If you wish to capture webcam images when Shield rules are triggered, then you will need to enable Video-input-allowed URLs and add the Shield URLs

This setting can be enabled in Devices > Chrome > Settings > Users & browsers 

Then scroll down and navigate to Hardware, then to Video-input-allowed URLs

Add the WebCam URL, then click Save on the top right.

The unique ID and URLs are displayed in the GAT Shield Console – see below (GAT Shield extension ID and URL)

Remove the old WebCam extension

The old Webcam extension is no longer needed. Please remove 

  • webcamID: lncmmomdcmcilmblgmnlinenbinjklgg

Find the extension above and remove

GAT Shield Extension ID and URL

The GAT Shield extension ID and URL information are displayed in the GAT Shield Console that is launched from GAT+

See instructions below

Launch GAT+ on the top left, click on the GAT+ icon, a menu will be displayed – then select GAT Shield

To access and view the Extension ID and URL, navigate to GAT Shield > Configuration > Extension deployment.

Open Configuration > Extension deployment - then select the domain and copy and use the ID and URL and Policy of extension to deploy the Shield extension

Allow GAT Shield Extension via Firewall

Note: Depending on your Firewall setup, there might be restrictions set up and not allow traffic to Shield.
Please check your Firewall settings and allow the following URLs:

To install the extension, you need to whitelist the following domain: https://extension.gattool.com

Additionally need to whitelist domains based on region.

For US (Global) domains (no prefix) – US (default) region


For EU domains (eu-prefix) – EU region


Lastly, for UK domains (uk- prefix) – UK region


These URLs must be reachable and not blocked by the Firewall.

Force Install Extension Org Unit inheritance explained

Note: If you install Shield on “sub.. ou”, make sure it is –  ‘Force install Inherited from the domain‘.
You can click on the extension ID, select “Force install,” and Save.

When it is set up as ‘Default – Inherited from Google default‘, Shield might not be active on the selected OU.

Finally, displaying Serial Numbers within the GAT Shield Console is available only for licensed enterprise-enrolled devices.

How to Install the New GAT Shield MV3 Extension

In this document, we will cover the steps to install the GAT Shield extension. It’s an audit, reporting, and security Chrome Extension for your Google Workspace environment.

Google Changes to Chrome

This June 2024, Google is making major changes to Chrome. They are moving from a standard called Manifest Version 2 (MV2) to one called Manifest Version 3 (MV3). These changes are major architectural changes that Google says will improve performance and security.

GAT Labs has been preparing for these changes for the last 2 years. This change is mandatory and will affect nearly all extensions that are deeply integrated with Chrome, including GAT Shield.

What does this mean for GATShield customers?

Firstly, and this is unavoidable, you will have to deploy a new version of GAT Shield.

We are making this process as seamless as possible and are providing a migration tool to help you move any configuration you may have in your existing GAT Shield to the new GAT Shield.

Install GAT Shield – MV3 extension

GAT Shield is a Chrome extension that the Super Admin of the domain must install via the Google Admin console. Below, we will cover how to deploy the GAT Shield extension to your users.

Step 1.

First, navigate to the Google Admin console.

In the Admin console, from the menu on the left, click on Devices > Chrome > Apps and extensions.

Google Admin console > Devices > Chrome > Apps and extensions

From the top menu, select Users and browsers.

A new page will be displayed with all the Chrome extensions deployed to the domain.

Step 2.

To install the GAT Shield extension, choose the root Org Unit (1) or a sub-OU where you want to deploy Shield (2).

On the bottom right side, click on the Yellow (+) button.

Adding the Chrome app or extension by ID

From the options shown, select Add the Chrome app or extension by ID (3).

Step 3.

Then, you will see a pop-up window. Select the From a custom URL option (1).

You can find the ID, URL, Webcam URL, and Policy for an extension in Shield under Help – Extensions deployment.

Adding the Chrome app or extension by ID - details

Click Save.

The Shield Extension is now installed.

Step 4.

Click on the newly installed extension. You will see a pop-up window on the side. In the Installation policy, click and select Force install.

Clicking "Force install"

Scroll down on the same window to the bottom of the page to find the Policy for extensions.

Policy for extensions

To access and view the Security Key, navigate to GAT Shield > Configuration > Extension deployment.

Under the Permissions and URL access field, click on and select Allow all permissions (2).

Selecting Allow all permissions

After doing all the changes, click the Save button on the top right.

Step 5.

To access and view the Extension ID and URL, navigate to GAT Shield > Configuration > Extension deployment.

Copy the ID, URL, Webcam URL, and Policy for an extension from here and use them in the Google Admin Console

Open Configuration > Extension deployment - then select the domain and copy and use the ID and URL and Policy of extension to deploy the Shield extension

Sentential One users see Note 1

Result

When the Shield extension is deployed, the end-users must be logged into the Google Chrome browser with their domain accounts.

The extension will appear under their Google extensions.

Open the Chrome Extrensions tab on your browser and view the Shield extension avaliable

The browsing activity will then be reported to the GAT Shield console for the Admins to manage.

Note 1

Note that SentinelOne Antivirus blocks access to the GAT Shield plugin. To solve the problem related to that, uncheck the box – visible in Deep visibility, in the SentinelOne console:

Related Posts

How to Remove GAT Shield Extension

 

What happens when your GAT Shield license expires?

GAT Shield consists of two components: the GAT Shield Console and the GAT Shield extension.

If your trial license expires or your paid license is discontinued, we recommend removing the GAT Shield extension from all locations where it was deployed.

Remove the Extension

Log in to Google Admin Console as a Super Admin.

Navigate to  Devices > Chrome > Apps & Extensions > Users & browsers > Overview

In the Overview tab – search for ID – enter a few letters of the Shield ID and Apply.

The result will show all the organization units where this extension is installed.

You can systematically remove it from each Org Unit if you have identified where the GAT Shield extension is deployed. 

Clicking on the extension ID (2) – will display the extension details.

Click on the “bin icon” (3) – it will remove the app from the current org. unit. 

NOTE: This must be done on each of the Org. Units where Shield is deployed, as it could be individually deployed to OUs and not inherited from the top OU etc.

Result

The Shield extension will be removed from your domain org. units and your end-users.

How does Geolocation in GAT Shield Work?


Our first go-to place to get the information is from the browser.

The location is given to the browser by Google, which utilises a variety of methods to determine the location. These methods are based on the WiFi hotspots the device sees.

Google learns this either from mobile devices that have geolocation enabled and are seeing WiFi hotspots or through the Google mapping cars that drive around, picking up WiFi hotspots and matching them to GPS data in the car.

user Geo report - shows the location of all domain users (who have the Shield extensions) using different methods to gather the location and shows it on the map

Sometimes, Google is unable to provide geolocation data to the browser. When that happens, we rely on using IP addresses and tapping databases provided by ISPs.
 
This information is often less accurate and downright incorrect depending on the ISP and their motive for publishing that data; however, in the absence of other data, it is the best that can be obtained (and in most cases, it is pretty OK).

With this guide you can quickly familiarise yourself with our products, making the most out of their powerful features to audit, secure and automate your Google Workspace domain. 

If you’d like a detailed overview or require assistance, feel free to contact us at support@generalaudittool.com.

To explore more resources:

This website uses cookies to ensure you get the best experience on our website