Creating an extended integration for Google Workspace users

Let Oomnitza be your single source of truth!

You'll get visibility of your Google Workspace users as data from Google Workspace is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Google Workspace in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key user information
• Configurable reports to share information about users with your colleagues and management

Navigation

Prerequisites

Integration Google Workspace users with Oomnitza

Creating custom mappings

Authentication

Google Workspace REST API uses OAuth2 based authentication. Instructions on how to setup an OAuth2 App and add your credentials to the Oomnitza vault can be found here: Adding Google (OAuth 2.0) credentials.

When creating these credentials, the following scope is required:

https://www.googleapis.com/auth/admin.directory.user.readonly

Integrate Google Workspace users with Oomnitza

To configure the integration, complete the following steps:

1. In Oomnitza, click Configuration > Integrations.
2. Click Integrations List View .
3. On the Integrations page, scroll down to the Extended section for users.
4. Click NEW INTEGRATION.
5. In the New Asset Integration sidebar, click Google.
6. To integrate Oomnitza with the Google Workspace User Load, click APPLY and then click NEXT twice.

On the connect page, complete the following steps to connect the integration:

1. Enter a descriptive name for the integration such as Google Workspace Users. This name will be displayed on the Integrations page once the setup is complete.
2. From the User Selection list, select User plus SaaS User or User only.
3. If you select User plus SaaS User and you have multiple instances of the same SaaS application, select the application from the SaaS Selection list. If you have a single instance of the SaaS application, skip this step.
4. From the installation type list, select Cloud.
5. Enter the Credentials that you created in Adding Google (OAuth 2.0) credentials.
6. From the Integration Preferences list, select Create & Update. 
7. Enter the name of the user of the integration.
8. Click Next.

Creating custom mappings

Map the Google Workspace user fields to Oomnitza fields and create custom mappings to get the user information that you need.

Complete these actions:

1. Click Smart Mapping.
2. Create custom mappings to map any other field that you want to add to Oomnitza:
   1. Click the down arrow on the field that you want to map.
   2. Select Add new Oomnitza users field.
   3. Change the name of the field.
   4. Click CREATE. 
3. Assign a sync key to the Email field.
4. Click NEXT. 

Custom mappings

Agreed to Terms
Archived
Change Password at Next Login
Creation Time
Customer ID
Enforced in 2-Step Verification
Enrolled in 2-Step Verification
Etag
Family Name
Full Name
Given Name
ID
IP whitelisted
Include in Global Address List
Is Admin
Is Delegated Admin
Is Mailbox Setup
Kin
Last Login Time
Org Unit Path
Primary Email
Suspended

 Learn more about mapping

When you've completed mapping GCP instances fields to Oomnitza fields, click NEXT.   

Schedule

By default, data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Configure your schedule.
2. Click FINISH.

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN NOW.

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings.

 

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your users and software
• Configure custom reports about your users and software
• Create workflows to automate tasks

See  Getting started

For further information see:
Creating workflows for Google Workspace users