Skip to main content

SCIM provisioning with Google Workspace

Sync users from Google Workspace to Perdoo automatically.

ℹ️ Available on Premium and Supreme.

Connect Google Workspace to Perdoo with SCIM to create, update, and archive users automatically. For what SCIM syncs, see SCIM provisioning.

Before you start, add Perdoo as a SAML app in Google Workspace and set up SAML SSO. See Set up SAML.


Create an API token

ℹ️ This requires Superadmin rights.

  1. Generate an API token and give it a name, for example Google Workspace SCIM.

  2. Copy the token.


Turn on auto-provisioning in Google Workspace

ℹ️ This requires Super Admin rights in Google Workspace.

  1. In the Google Admin console, go to Apps > Web and mobile apps and open your Perdoo SAML app.

  2. In the Auto-provisioning card, click Configure auto-provisioning (1 in Screenshot 1).

Screenshot 1

Then go through the steps of the setup:

  1. App authorisation: Paste your Perdoo API token as the access token.

  2. Endpoint URL: Enter https://eu.perdoo.com/scim/v2. The URL is the same for every organization. Your API token tells Perdoo which organization it is.

  3. Attribute mapping: You can keep Google's default mapping. Perdoo uses Username (the user's primary email) to match users.

  4. Provisioning scope (optional): Choose the groups whose members get a Perdoo account. Without a scope, everyone with access to your Perdoo app gets one.

  5. Deprovisioning: Choose what happens when someone loses access to the app, for example when you suspend them in Google Workspace.

  6. Test connection: Search for a test user who isn't in Perdoo yet (1 in Screenshot 2) and click Test (2 in Screenshot 2). Google creates, updates, and deletes that user in Perdoo. When all three show Success, click Finish (3 in Screenshot 2).

Screenshot 2

Finally, turn on auto-provisioning in the Auto-provisioning card of your Perdoo app.

Important

  • Auto-provisioning for SAML apps is in beta in Google Workspace.

  • The API token must belong to a user who can add and archive users, such as a Superadmin.

  • Google Workspace syncs users, not groups. Teams in Perdoo aren't created from Google groups.


Good to know

Which users does Google Workspace sync?

The users with access to your Perdoo app in Google Workspace. If you set a provisioning scope, only the members of those groups.


Need help?

Start a live chat with our Support team by clicking the question mark at the left or right bottom of your screen.

Did this answer your question?