To configure a Google Workspace user sync with Kantega SSO Enterprise, you will first have to create a service account, assign the account privileges, then create an impersonation account for the service account and a role for reading users and groups. Follow the steps described below to prepare your Google Workspace for integrating with a Kantega SSO Connector directory. When these steps are finished, you can go to Kantega SSO and paste the values needed.
Start setup in Kantega SSO Enterprise
To add a Workspace Connector/ User Directory in an Atlassian product, navigate to Kantega SSO Enterprise > Cloud user provisioning. Then add a Google Workspace connector.
...
As shown in the screenshot, you will need four some items (which we will grab and make notes of during the setup):
The domain of your Google directory with just the domain name like company.comStatus colour Blue title required
The Google customer ID (may be left blank)Status title optional
A JSON key file created on the service accountStatus colour Blue title required
The email address of the impersonation account to be used by the service account for reading the Google APIsStatus colour Blue title required
Let’s go to Google to get the setup needed!
Configure Google workspace
Status | ||||
---|---|---|---|---|
|
Set up service account in Google Cloud
...
Create a user account for the service account to impersonate
Navigate back to the directory the Directory in the left menu of Google Workspace and click “Add new user”.
...
Suggested values:
First name: jira
Last name: read
Primary email address: "jira-read@<yourdomain.com>"
You do not need to set a password.
Click ADD NEW USER
...
Cut & paste Copy the account username into the "Admin account address" and make a note of it as it email address (e.g. jira-read@yourdomain.com) for later use. It will be needed again later in Kantega SSO.
...
Now you need to choose the correct READ privileges.
Scroll down to Admin API Privileges and select:
Users > Read and
Groups > Read.
Then click CONTINUE
Review that you have got the correct privileges. Then click CREATE ROLE.
...
Search for the impersonation account you created earlier. We have chosen to call the account in this example jira-dev-read. Click ASSIGN ROLE.
...
Complete the setup in Kantega SSO Enterprise
Go back to your Atlassian product and to the form you started in the beginning (If you closed that, just start a new one under Kantega SSO Enterprise > Cloud user provisioning, and clicking add provider > Google Workspace).
Paste the values obtained during the setup in Google. You need:
The domain of your Google directory with just the domain name like http://Status colour Blue title required company.com
The Google customer ID (this may be left blankt, and is only needed if you have a service account across domains)Status title optional
A JSON key file created on the service accountStatus colour Blue title required
The email address of the impersonation account to be used by the service account for reading the Google APIsStatus colour Blue title required
...
Add user directory
You can then add the user directory (which will act like a normal Crowd directory) and start the sync. Once the Crowd user directory has been createscreated, you can view users, groups and group memberships retrieved from Google Workspace.
...
Check “Use nested groups” if you use nested groups in Google Workspace.
...