Google Groups Sync

Sync users based on their Google Groups membership to target training for specific teams, projects, or initiatives.

Overview

Google Groups sync allows you to:

  • Select specific Google Groups for user synchronization
  • See how many users will be added or removed before saving
  • Automatically trigger sync after configuration changes

Prerequisites

Before configuring Groups sync, ensure you have:

  1. Completed the Google Workspace setup in the Adding Users section
  2. Granted domain-wide delegation with the required OAuth scopes
  3. Admin access to the INFIMA Dashboard
  4. Google Groups configured in your domain

Configuring Groups Sync

Steps

  1. Log into the INFIMA Dashboard
  2. Navigate to Users and click Sync by Google Groups
  3. The page displays your current Google Groups
  4. Select groups to sync by checking the boxes next to each group name
    • You can select multiple groups
  5. Review the Selected Groups shown on the right

Sync Behavior

When you select specific groups, only users within those groups will remain in INFIMA. Users outside the selected groups will be removed from the platform.

  1. Click Save to apply the configuration
  2. Click Refresh Users Now to update the users after saving
    • Changes will take effect after the refresh completes

Best Practices

Group Selection Strategy

  • Department Groups: Select groups like 'sales@', 'engineering@' for department-wide training
  • Project Groups: Target specific project teams or initiatives
  • Security Groups: Focus on users with elevated access permissions

Switching Sync Methods

You can switch between different sync methods at any time:

Switching Methods

When switching sync methods, your previous selections are deleted but existing users will remain in INFIMA if they are included in the new sync configuration. Users not included in the new configuration will be removed during the next sync.

Troubleshooting

Groups Not Appearing

If your groups aren't showing:

  1. Verify domain-wide delegation includes the admin.directory.group.readonly scope
  2. Try refreshing the page or logging out and back in

Members Not Syncing

If group members aren't being synchronized:

  1. Verify users are direct members (not just nested group members)
  2. Check if members have active Google Workspace accounts
  3. Ensure members aren't suspended or archived

User Count Mismatch

If the displayed user counts seem incorrect:

  1. Note that service accounts and admin accounts may be inactive
  2. Suspended users are not counted in sync totals
  3. Recently created users may take time to appear