Google Workspace

Integrating with Google Workspace

The Google Workspace integration allows you to sync your PhishingBox account with a Google Workspace directory.

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.

NOTE: If you're a Google Sales Partner that manages multiple Google Workspace Tenants, you will need to configure the above settings for each Google Workspace tenant you want to sync users from. 

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 the "Sync sub OUs" option is enabled, any users in sub-OUs of the selected OUs will be included in the sync. If it is not enabled, the sync will contain only the users in the selected 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