Google Workspace

Integrate Google Workspace with Hudu to sync users and licensing information. This setup uses Google’s Admin SDK API and Enterprise License Manager API for full functionality.  Before setting up the Google Workspace integration, we recommend reviewing our Understanding Integrations article for foundational concepts and helpful tips.

What You'll Need

• Admin access to both Google Cloud Console (console.cloud.google.com) and Google Workspace Admin Console (admin.google.com).
• Admin access to your Hudu instance.
• A designated Google Cloud Project for this integration.

Integration Features

• Sync Google Workspace users into Hudu.
• Automatically pull licensing data to see how many and what types of licenses are in use.

What Hudu Needs from Google Workspace

To successfully integrate with Google Workspace, Hudu requires:

• A Google Cloud project with Admin SDK API and Enterprise License Manager API enabled.
• A configured OAuth 2.0 web application with:
  • Authorized JavaScript origins matching your Hudu domain.
  • Authorized redirect URI ending in /admin/auth/google/oauth/callback.
  • (Optional) https://oauth.pstmn.io/v1/callback for debugging Postman requests.
• A valid Client ID and Client Secret.
• Domain-wide delegation configured in the Google Admin Console using the Client ID and required OAuth scopes.

Obtaining the Google Workspace Information

Enable Google APIs

1. Go to console.cloud.google.com, select or create your project. 

   

2. Navigate to APIs & Services > Library.

   

3. Search for both Admin SDK API and Enterprise License Manager API and enable them.

   

   

   

Configure OAuth Consent and Client Credentials

1. Go to APIs & Services > OAuth consent screen, then click Create Client.
2. Set the client type to Web application.
3. Name the client (e.g., “Hudu Integration”).
4. Add your Hudu domain under Authorized JavaScript origins, e.g.:
   • http://localhost (testing)
   • https://internal.hudu.app/
   • https://staging.huducloud.com/
5. Add redirect URIs matching your origins, appended with /admin/auth/google/oauth/callback.
6. Optionally add https://oauth.pstmn.io/v1/callback for Postman troubleshooting.

Save and note the Client ID and Client Secret from the modal or downloaded JSON. Store these securely.

Enable Domain-Wide Delegation

1. Go to admin.google.com.
2. Navigate: Security > Access and data control > API controls.
3. Select Manage Domain Wide Delegation.

   

4. Add a new client.
5. Paste the Client ID from your JSON.
6. Enter these OAuth scopes (comma-separated):

   openid,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.orgunit.readonly,https://www.googleapis.com/auth/admin.directory.domain.readonly,https://www.googleapis.com/auth/admin.reports.usage.readonly,https://www.googleapis.com/auth/apps.licensing,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/userinfo.profile

   

Finalize Integration

Wait a few minutes for Google to propagate the delegation settings, then plug the Client ID and Secret into Hudu’s integration settings to complete setup.

Enabling the Google Workspace Integration

• Integrations can be enabled at any time, during Hudu environment testing or in production.

• Once enabled, integrations can be merged into existing documentation based on predefined rules.

• This allows you to configure the integration upfront or connect it later as needed.

• To enable the integration:

  • Navigate to the Hudu admin area (Admin → Integrations)

  • Select  from the list

Setting up the Integration in Hudu

Step 1. Connect to Google Workspace

• Select the company for the integration
  • If you have already setup a Google Workspace integration for another company, select New Integration to add another integration.
• Enter Client ID and Client Secret
• Select a default asset layout for your Google Workspace users
  • Please note, the asset layout must be created and active to select it from the drop down.

Step 2. Grant Hudu permission to access Google Workspace.

• Google requires a user to log in and grant Hudu permission to fetch data.
• Save the integration settings and return to the setup page in order to grant permission.

Step 3. Test connection and run an initial sync

• On the integration overview page, click Test Connection
• If successful, start an initial sync to bring in users.