G Suite Integration (new)

This article is for the updated OAuth-based integration that was released in August 2023. If you are looking for the legacy integration instructions, you can find them at G-Suite-Integration-legacy.

Step 1: Create an Integration Provider

First, you will need to create an integration connection with Google.

1. Sign in to your Huntress Security Awareness Training (SAT)/Curricula account and navigate to Integration Providers by clicking “Settings” in the top navigation and then clicking “Providers” in the left navigation. 
2. Click “+ Add a provider”
   
3. Select the “Connect” link in the Google tile.
   
4. Log in with your Google Admin account. 
   
5. Authenticate with your Google account and click “Accept” on the Permissions requested.
   

Step 2: Map a SAT group to your Google group(s.)  This is a mandatory step to set up a group sync.

1. If you aren’t automatically sent to the group setup step after connecting your SAT account to Google, click “+ Connect a group” on the Providers detail page.
   
2. Choose whether you want to connect to an existing SAT group or create a new one. Please note that the ‘Staff’ group is created by default in all SAT accounts, and there is a one-to-one mapping between an SAT group and a Google mapping.
   
3. Configure the group settings
   
   
   
   • We recommend the following settings:
     • Enabled:
       
       1. “Automatic Daily Sync” - This setting will schedule updates every 24 hours to keep your learner's list up-to-date. 
       2. Attribute Options - Unless there are fields you explicitly want to ignore, we recommend leaving them all enabled.
       3. Set non-present learners to "Inactive" status - enable - If you ever delete identities in Google Directory without setting them as “Inactive,” this setting will detect that and set learners who no longer appear in Active Directory as “Inactive.”
       4. Create Departments as needed - This will automatically create Departments in the SAT platform once they are seen as part of the sync
     • Disable:
       Set present learners to "Active" status. - By enabling this setting, Curricula will ignore your resource’s “status” field when syncing users. Any users present in your resource will be set to “Active” status in the Curricula app after the sync is complete, even if they are marked as inactive or suspended in your directory.
4. Click “Preview & Sync” for stats and detailed information about how identities would be impacted under the' Log tab.'
   
   
5. If everything looks correct, click “Apply Manual Sync.”
6. After this initial sync, you can view results or download a CSV sync record under the Log tab.
   
7. By running the manual sync, you have completed the configuration and have saved your changes. You can return to Settings->Integrations-> Provider to add more groups within the sync or modify settings.

Note: By setting up the integration, we will automatically mark any domains associated with your Google account as verified.