Google User Sync - Open Beta

This article describes the Google user sync integration, how to enable it, and the considerations for its use.

Google User Sync enables admins to connect company-level accounts to Google Workspace accounts and automatically import users from Google to Phin, similar to the Azure User Sync for Microsoft users. Our privacy policy is here.

How Do I Enable Google User Sync?

1. Navigate to the integration page using the sidebar at the company level.
2. Click the 'Google User Sync' tile.
3. Carefully read the necessary permissions related to how Phin will use the connection established between the Phin application and Google Workspace.
4. Click Continue, at which point you will be redirected to the Google permissions page. Once you've selected and confirmed the Google permissions, you will be redirected back to the integration within Phin.
5. Congrats! You should now see the Google User Sync page, where you can manage groups or organizational units that will be automatically synced from Google Phin.

Managing Users in Google User Sync

1. Select your source type: groups or organizational units (OUs).
   1. You can only sync users from one source type at a time. Switching from groups to organizational units after enabling auto sync will end the sync, and it must be re-established.
2. Use the drop-down menu to add one or more groups/OUs. The table below the drop-down menu will display employee information, including their name, email, and source location.
   1. You will see the total number of users staged above the table on the right side update as you add and remove groups.
   2. This number reflects staged users prior to enabling the auto sync.
3. Click 'Enable Auto Sync' once you are ready to sync users into Phin.
   1. A notification will appear, letting you know if enabling auto sync was successful. After a successful sync, you can navigate to the user management page to see the users that were synced.
   2. If it is not successful, you will be prompted to retry. If the sync repeatedly fails, here are the steps you should take:
      
      1. Disconnect and reconnect the feature
      2. Re-select groups/OUs and click 'Enable Auto Sync' to re-attempt the sync.
      3. If the sync continues to fail, you can reach out to our support team.
4. After enabling the auto sync, when you add and remove users, the integration will save your choices automatically for the next time the sync runs.
   1. Alternatively, you can choose 'Sync Now' to push changes immediately.

Considerations after enabling auto-sync

1. Auto-sync runs every 6 hours, and you can identify the next run time at the bottom left of the user table on the Google User Sync page.
2. If you have already enabled automatic welcome emails for the company, new users who have been synced will receive one without any further configuration.
3. The same goes for campaigns.
   1. For example, if a continuous campaign was set up prior to enabling Google user sync, and the newly synced users match the audience filter for segments such as full company or department, these users will automatically be enrolled in that campaign without any further configuration.
   2. If users were imported manually and are found during the sync process, the data being pulled from Google user sync and the manual input data will be merged, with the sync data acting as the source of truth for the user going forward.
4. Users who have been slept prior to turning on Google user sync will remain slept after enabling the sync and must be unslept on the user management page.
5. Users who are deleted from Google Workspace will be slept in Phin.
6. If a user's information changes in Google Workspace, that will be reflected in Phin during the next scheduled sync.

Knowledge Base

Phin works to update our Knowledge Base with new features with every release. You can read about the platform and its updates here: https://www.phinsec.io/knowledge.

Thanks for using our product!

We use all provided feedback to help drive Phin's development direction. Please keep reaching out and helping us shape the product's future! All ideas are welcome; please keep them coming!

The Dev Team @ Phin

Need help or have an idea for us? Click here!