Google User Sync (GUS) provides a seamless, automated way for Google Workspace clients to synchronize their user data with the NINJIO platform. By utilizing Just-In-Time (JIT) provisioning, GUS eliminates the need for manual user management and ensures your training audience is always up-to-date.
Key Highlights
Automated Provisioning: Synchronize users automatically from Google Workspace to NINJIO.
Easy Integration: Connect directly to your Google Admin directory without complex application setups.
Real-time Updates: User changes are reflected on the platform approximately every 20 minutes.
Key Behaviors
Source of Truth: All user modifications must be made directly within the Google Workspace Admin panel.
Status Syncing: Suspending a user in Google Workspace acts as a disable function, setting the user to "inactive" in NINJIO.
Automatic Enrollment: By default, GUS coordinates an auto-sync mechanism for all active users not specifically filtered.
Known Limitations
Basic Configuration: Advanced configuration options beyond basic credentials are not supported in the initial release.
Scoping Filters: Currently, there is no mechanism to scope or filter specific users in the initial sync; GUS typically pulls all active users.
Manager Field: Synchronization of the "Manager" field is currently unavailable in the Early Access version.
-
Field Mapping Discrepancies:
Google does not have a dedicated "Branch" field; NINJIO maps the Google Cost Center field to the Branch field in our platform.
Google lacks a specific "Country" field; NINJIO pulls this from the last line of the formatted address field.
Field Mapping Reference
The following table describes how Google Workspace fields map to NINJIO platform fields:
| NINJIO Field | Google Workspace Field |
|---|---|
| User ID | id |
| Username / Email | primaryEmail |
| First Name | name.givenName |
| Last Name | name.familyName |
| Created At | creationTime |
| Active Status |
!suspended (Not suspended)
|
| Phone Number | recoveryPhone |
| Job Title | organizations[primary].title |
| Department | organizations[primary].department |
| Branch | organizations[primary].costCenter |
| Preferred Language | languages[preferred].languageCode |
| Country | addresses[0].formatted.lastLine |
| Manager Email |
relations[type=manager].value (Coming Soon)
|
How to Set Up Google User Sync
Navigate to Settings: In the NINJIO platform, click Settings in the top right corner.
Select Sync Type: Under the Sync drop-down menu, select Google User Sync.
Group Configuration: Choose to Create new group. It is highly recommended to create a dedicated group for GUS (e.g., "GUS_Sync") to avoid conflicts with manual entries.
Connect to Google: Click the Connect Google button.
Authorize: You will be redirected to the Google accounts page. Select your Google Workspace admin account, enter your credentials (including 2FA if prompted), and click Allow to grant NINJIO permission to see user info.
Verify: Once redirected back to NINJIO, the status should show as "Enabled".
To see a quick How to video and detailed step by step instructions, please see our How-to Set up Google User Sync Guide
Best Practices
Avoid Deleting Users: Do not delete users in Google Workspace to remove them from NINJIO. This can break the sync and leave "zombie" active users on our platform. Always suspend the user first.
Address Formatting: To ensure the "Country" field populates correctly, place the country name on the very last line of the address field in Google Workspace.
Initial Setup: Use a new group during setup to ensure the automation takes full control of user provisioning without inheriting issues from existing groups.
FAQ
Q: How often does the sync run?
A: The provisioning cycle runs approximately every 20 minutes.
Q: Can I sync specific departments or branches only? A: Currently, GUS does not support scoping filters. It is designed to sync all active users in your directory.
Q: Why isn't my branch information showing up?
A: Because Google doesn't have a "Branch" field, make sure you have entered the branch name into the Cost Center field in Google Workspace.
Q: What is the difference between "Suspended" and "Deleted"?
A: Suspending a user correctly marks them as inactive in NINJIO. Deleting a user prevents NINJIO from receiving the update, which may result in the user appearing as "Active" on our platform even though they no longer exist in your directory.
Comments
0 comments
Please sign in to leave a comment.