Google Workspace

Integrating with Google Workspace

The Google Workspace integration allows you to sync your PhishingBox 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.

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

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

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.

Integration Store

In the PhishingBox portal, navigate to Administration > Integration Store.

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

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.

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 PhishingBox group.

Create/Edit Group

In the PhishingBox 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.

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 PhishingBox group.

Back to top