Installation and setup

Important: The installation steps outlined below must be performed by a domain super administrator.  Before Gopher Buddy can collect data, you must have either a trial or paid license for Gopher for Chrome Premium.  Learn more.

Summary of steps:

1. Authorize and install the Gopher Buddy Service from a super admin account via this sign in / installer button 

btn_google_signin_dark_normal_web.png

2. Configure the Gopher Buddy Service

3. Force install the Gopher Buddy Chrome extension

Authorize and install the Gopher Buddy Service

The Gopher Buddy Service is a G Suite Marketplace App that uses the authority of a designated administrator to make calls to Google's APIs that perform the user and device lookups that are needed to give the Gopher Buddy extension its powers.

Authorize and install the Gopher Buddy Service from a super admin account via this sign in / installer button 

btn_google_signin_dark_normal_web.png

Once authorized, the app will prompt for installation of the Gopher Buddy Service G Suite Marketplace App.  This additional installation step is necessary so the app can act on behalf of a designated admin account.  For simplicity and to accommodate future additions to the tool's functionality, we strongly recommend installing the Marketplace App on the root organization.

Screen_Shot_2018-03-28_at_9.19.17_PM.png

Screen_Shot_2018-03-28_at_9.19.30_PM.png

Configure the Gopher Buddy Service

Once the installation is confirmed, clicking Continue Setup will present a stepwise set of panels requiring configuration.  In the first tab, designate the administrator (either super admin or adequately scoped delegated admin) under whose authority the Gopher Buddy Service should run.

https___script_google_com_a_macros_gafetest_com_s_AKfycbyydVUQwiUwc52YdmBaX32iRWk0frwQ_ImwjFwQl5Q_dev_and_Title.png

Next, indicate your preferences for the behavior of the Gopher Buddy Chrome Extension. The impact of each setting is described below.

https___script_google_com_a_macros_gafetest_com_s_AKfycbyydVUQwiUwc52YdmBaX32iRWk0frwQ_ImwjFwQl5Q_dev.png

-> Allow the Gopher Buddy Extension to remind users when Chrome OS updates are available.

Leaving this feature enabled will produce the icon change and "Fix It" button behavior described in this article, which is useful for nudging users to perform Chrome OS updates if their device hasn't auto-updated for any number of reasons.

Disabling this feature off will cause Gopher Buddy to stop displaying the "Fix It" button, and the unhappy Gopher icon when Chrome devices have fallen behind the latest available Chrome OS version.

---> Display a Chrome notification when device is X or more major versions behind.

This setting allows you to control the threshold at which users will receive a more urgent update message in the form of a Chrome notification, which pops up temporarily over the user's browser in the lower right corner of the screen.

---> Restrict updates to a major Google Chrome version of at most YY.

This setting allows you to set reminders to manually match the limits you may be enforcing via the Chrome Device Settings admin panel.  This will help ensure users are only notified of OS updates when their devices are behind the max defined version for the domain.

Because this max version setting must be adjusted manually (e.g. it doesn't change when your max version changes in Chrome Device Settings), we recommend also enabling monthly email reminders.

-> Allow users to access the device info panel from the Gopher Buddy extension.

This setting allows end users in specified OUs to access either BASIC or FULL device information by clicking the "Show Device Info" button, as described in this article.

To achieve maximum benefit of this feature (and depending on your school context) we usually recommend BASIC for students (with the possible exception of younger students) and FULL for staff.

 

Force install the Gopher Buddy Chrome extension

The Chrome Extension installation steps are provided within the interface.  Depending on your environment, we recommend installing the extension on either the root organization or an organization that encompasses all students.

Screen_Shot_2018-03-28_at_10.27.24_PM.png

Session Data

Gopher Buddy does not use the Admin Console for it's data, but relies on having access to the base URL for the Gopher Buddy API, https://gopher-buddy-prod.appspot.com, in order to report user data and retrieve license information.  If this website is blocked at the content filter or firewall, session data will not be recorded.  (Note:  This endpoint will not display anything if visited in a browser... it's only used by the extension)

Gopher Buddy also only records user activity when they are on a managed Chromebook.  It will not report user sessions on unmanaged devices. 


Updating URL Blacklists

Many organizations utilize the URL Blacklist within the User Settings section of the Admin Console to prevent users from changing settings and accessing other local pages on Chromebooks.  Often this is done using the chrome://* entry in the URL Blacklist setting.

Since Gopher Buddy recommends users navigate to the chrome://help, and chrome://settings/help allow users to update devices and chrome://policy so that they can refresh the policy settings for their device.