Google Workspace Directory Integration with Unifed

You can easily integrate your Google Workspace (GWS) directory with Unifed to sync users automatically. This guide walks you through the step-by-step process.

Before You Begin

• Make sure you are logged in with your Unifed Admin credentials.
• Ensure you have access to your Google Workspace Super Admin account.
• Keep your Google Workspace JSON configuration file, Client ID, and Super Admin email handy.

Steps to Connect Google Workspace Directory

Step 1: Configuration

1. Log in to your Unifed Admin portal.
2. Select the tenant where you want to sync the directory.
3. Under Features, click Directory Sync.
4. Click Add Directory and choose Google Workspace.
5. Upload the Google Workspace JSON configuration file.

6. Enter your Client ID and Google Workspace Super Admin email ID.

   (Optional) Enable Auto Deletion for Users.

   • If a user is deleted from Google Workspace, they will also be deleted from Unifed during the next sync.

👉 How to Get Google Workspace JSON Config & Credentials

1. Go to Google Cloud Console.
2. Create a New Project or select an existing one.
3. Enable the Admin SDK API.
4. Go to APIs & Services > Credentials.
5. Click Create Credentials > Service Account.
6. Assign the Admin SDK API access to the service account.
7. Download the Service Account JSON Key file.
8. Share domain-wide delegation with the service account in Google Admin Console.
9. Copy the Client ID and Super Admin email ID from Google Admin Console.

Step 2: User Mapping

• Map Google Workspace attributes to Unifed schema attributes.
• Only mapped users will be synced into Unifed.

Example:

• primaryEmail → email
• name.givenName → firstName
• name.familyName → lastName

Step 3: Policy

• Define sync conditions (e.g., specific Org Units, groups, or attributes).
• This helps filter only the required users into Unifed.

Step 4: Scheduler

• Choose how you want to sync users:

  • One-time sync (manual).

    Periodic sync:

    • Every hour
    • Daily at a specific time

Step 5: Sync & Manage

• After completing the steps, users will be synced to Unifed and appear in the User List with Onboarded status.

  You can:

  • View the Job List.
  • Perform a Manual Sync anytime by clicking the Sync button.
  • Update the Directory Configuration when needed.