Huddle for G Suite Admin installation guide

Follow

This article is for G Suite Administrators who want to know more about how to install the Huddle for G Suite add-on for their users. 

If you are an end user who is already allowed to install add-ons yourself, read our guide to using the add-on here.

  

I) Installation options

 

Option A: Let users install the Huddle add-ons themselves


There are 2 ways that end users can install the Huddle add-ons for Docs and Sheets themselves.

  1. If whitelisting is enabled, and you've added the Huddle add-ons to your whitelist or if whitelisting is disabled completely, users can install the add-ons from the G Suite Marketplace.
  2. If you've allowed installation of add-ons in Google Drive settings, users can install them via the "Add-ons Store" accessed via the menu in Docs or Sheets ("Add-ons" -> "Get add-ons"). Please note: whitelists are are also enforced for the add-ons store.

 

Option B: Install the add-on on behalf of users

 

If many will be using the Huddle add-ons it would be far easier to install it for them. Google lets you install add-ons across the whole domain or within specific organizational units.

This article (by Google) explains the exact procedures you'll need to follow to implement your preferred installation option.

TIP: Please ensure you install or authorise the correct add-ons for your organisation (see below)

 

 

II) Ensure you install or authorise the correct add-ons

 

We have separate add-ons that can be installed for Google Docs or Sheets and they can connect to either the Huddle Global instance (login.huddle.net) or the Huddle US instance (login.huddle.com):

  1. Google Docs add-on for our Global instance (hosted in the UK)
  2. Google Sheets add-on for our Global instance (hosted in the UK)
  3. Google Docs add-on for our US Gov & Healthcare instance (hosted in the USA)
  4. Google Sheets add-on for our US Gov & Healthcare instance (hosted in the USA)

When whitelisting or installing add-ons on behalf of your users please ensure that you select both the Docs and Sheets add-ons for the correct instance otherwise users will not be able to sign in to the add-on.

 

 

III) Add-on Permissions

 

Our add-ons use the following Google permissions to allow the add-on to link and publish copies of your Google documents to Huddle:

  • "View your email address" - basic permission required to use add-ons.
  • "View your basic profile info" - basic permission required to use add-ons.
  • "View and manage your documents in Google Drive" - allows us to view data for the Google documents that users publish to Huddle.
  • "View and manage your spreadsheets in Google Drive" - allows us to view data for the Google sheets that users publish to Huddle.
  • "View and manage the files in your Google Drive" - allows us to export documents and sheets to Huddle in compatible formats. E.g. Docs format to PDF or Word.
  • "Connect to an external service" - allows the add-on to communicate with Huddle's servers.
  • "Allow this application to run when you are not present" - allows the add-on to refresh OAuth 2.0 tokens in the background.
  • "View and manage data associated with the application" - allows us to save and retrieve the unique document reference for the linked document in Huddle.
  • "Publish this application as a web app or a service that may share your data" - allows us to publish the add-on in the Add-ons Store & Marketplace so that it can be installed by users and managed by administrators.

Please note: Data is sent to directly from Google Drive to Huddle via this add-on. All users of this add-on are required to sign into Huddle using valid Huddle credentials and have been granted permissions to access or upload documents to the target Workspace and folder in Huddle.

 

Back to top.