How do I integrate with Google Workspace?

The Google Workspace integration allows you to sync your Hook Security, Inc account with a Google Workspace directory.

Integrating with Google Workspace

The Google Workspace integration allows you to sync your Hook Security, Inc account with a Google Workspace directory.

The integration will sync the account or a group with the selected Organizational Unit(s) (OU). The integration will fetch all users under the selected OU(s), including any users in sub-OUs.

Setting up the integration will require a Google Workspace user with Administrator privileges.

The client ID for the application is 110415018621831148079.

Follow the instructions below to integrate with Google Workspace.

  1. Grant Permissions to the App
  2. Integration Store
  3. Create/Edit Group

Grant Permissions to the App

Open the Google Workspace Admin console. Not sure how to access your admin console? Check out Google's article on how to access your admin console here

Navigate to Security > Access and data control > API Controls.

At the bottom of the 'API Controls' page, click the 'MANAGE DOMAIN WIDE DELEGATION' link.

mceclip1.png

On the 'Add a new client ID' form, add the client id 110415018621831148079 and add the scopes https://www.googleapis.com/auth/admin.directory.orgunit.readonly and https://www.googleapis.com/auth/admin.directory.user.readonly, then click the 'AUTHORIZE' button.

mceclip2.png

Integration Store

In the Hook Security, Inc portal, navigate to Administration > Integration Store.

mceclip4.png

Click the 'Setup' button located on the bottom-right of the Google Workspace card.

mceclip5.png

In the 'Edit Integration' form, input a Google Workspace administrator email address then click the 'Test' button to authenticate and fetch the workspace's OUs.

WARNING: The Google Integration pulls over all OUs with no exclusions possible. 

mceclip7.png

If successful, the workspace's OUs will be available for selection. Select the OUs you'd like to sync then click 'Save' to save the integration.

NOTE: '/' is the root OU. If selected, all users in the directory will sync into a single Hook Security, Inc group.

Create/Edit Group

In the Hook Security, Inc portal, navigate to Targets / Groups > Create Group (/group_cu.php). On the 'Create Group' form, input a group name and select 'Google Workspace' in the 'Third-Party Syncing' option menu. Click the 'Create Group' button to create the group.

mceclip3.png

After the group is created, the Google Workspace settings form will appear. Input an admin email from the workspace then click the 'Get Groups' button to fetch the workspace's OUs. Select an OU and click the 'Update Group' button to save the group's integration settings.

NOTE: '/' is the root OU. If selected, all users in the directory will sync into a single Hook Security, Inc group.

mceclip4.png