What this connection does
Personnel onboarding syncs your people directory into iCompaas so you can track who has access, who is an admin, and whether 2-step verification is enabled and enforced — evidence your auditors ask for. The connection is authorised through Google's own consent screen with a single read-only scope (admin.directory.user.readonly); iCompaas never sees your password and never gets write access.
Connect the source
- In the app, open Onboarding → Personnel onboarding (or go to Account → Personnel) and click Add source → Google Workspace.
- Enter a Source label (3–60 characters, e.g. Engineering Directory) — a friendly name to identify this source in your dashboard.
- Click Save & authorize. An authorization popup opens — allow pop-ups from the iCompaas site if your browser asks.
- Sign in with a Google Workspace administrator account and approve the read-only access.
- Personnel sync begins automatically — the source moves from Awaiting auth to Syncing and then Synced.
What gets synced
Names, primary and recovery email, phone number, admin status, 2FA enabled/enforced flags, suspension state and employment type. Use View personnel list to see the synced people.
Managing the source
- Sync now — trigger a manual re-sync from the source's row actions.
- Edit — only the label can be changed. To re-authorize, remove the source and add it again.
- Remove — stops future syncs; existing personnel data remains until the next sync cycle.
Troubleshooting
- "Popup was blocked" — allow pop-ups for the iCompaas site and click Save & authorize again.
- Source stuck on Awaiting auth — the OAuth window was closed before finishing. Remove the source and add it again.
- "Google OAuth configuration missing" — contact support; this is a configuration issue on our side, not yours.