Google Workspace Integration Overview

Overview

Google Workspace and Kantata are a perfect project management pair. With this integration, you can do the following:

• Access your Google Drive and share files in any project workspace.
• Invite anyone from your Google Contacts list into Kantata for collaboration.
• Create a Google Contact for each of your projects.
  
  

Getting Started

The Google Workspace integration with Kantata OX allows you to link Google Drive and Contacts across your entire organization or on an individual user basis.

The individual user option allows you to connect your own Google Workspace account to your Kantata OX account. This way, you can work with your Google documents and contacts in your Kantata projects.

The account-wide option is useful for businesses who want all of their account members to access the same Google Drive and Google Contacts data for a more cohesive experience when working in Kantata OX.

How to Activate an Individual Integration Option

This section walks you through connecting your personal Google Workspace to your individual Kantata OX account. To learn how to set up the account-wide integration, see the How to Activate the Account-Wide Google Integration Option section.

1. In the top-right corner of your Kantata account, click your user profile picture and then select Google Workspace from the drop-down menu that appears.
   
2. On the Google Workspace Settings page, select the checkboxes for each Google app you want to integrate with your account.
   
3. Click Activate with Google. You’re redirected to the Google sign-in page.
4. Enter your username and password to sign in to your Google account.
5. You’re redirected to the Google access control page, which lists the data Kantata OX will be accessing in your Google account. Click Allow to complete the integration.
   
6. The integration is activated and you are redirected back to the Google Workspace Settings page in Kantata OX.
   
   Note: To deactivate the individual integration, click Disable your Google integrations on the Google Workspace Settings page. If your Account Administrator has set up the account-wide Google integration, this button will instead read Override Google integrations. Clicking it replaces your individual setup to the account-wide integration.

How to Activate the Account-Wide Integration Option

This section outlines how to set up the account-wide Google Workspace integration for every account member in Kantata OX. If you’re looking to connect an individual Google Workspace for your own account, see the How to Activate an Individual Google Workspace Option section.

Please perform the following steps in the listed order to fully activate the account-wide integration:

1. Configure the Kantata OX Client ID in the Google Workspace Admin Console
2. Define the OAuth scopes in the Google Workspace Admin Console
3. Sign in to Kantata OX via the Google SSO method

Part 1: Configuring the Kantata OX Client ID

1. Sign in to the Google Workspace Admin console.
2. In the left-hand navigation, expand the Security and Access and data control menu options, and then select API controls.
   
3. On the API Controls page, select Manage Third-Party App Access.
4. On the Manage Third-Party App Access page, click Configure new app. A new window opens.
   
5. In the App subtab, enter Mavenlink in the search bar.
   
6. Select the Mavenlink third-party app in the list that appears.
   
7. In the Scope tab, select All in [Domain Name] (all users) and then click Continue.
   
8. In the Access to Google Data subtab, select Trusted and then click Continue.
   
9. In the Review subtab, click Finish. The app is now configured and appears in the Configured Apps table.
10. Proceed to Part 2 of the activation process.

Part 2: Defining the OAuth Scopes

1. Sign in to the Google Workspace Admin console.
2. In the left-hand navigation, expand the Security and Access and data control menu options, and then select API controls.
   
3. In the Domain wide delegation section on the API Controls page, select Manage Domain Wide Delegation.
   
4. On the Domain Wide Delegation page, select Add new.
   
5. In the Add a new client ID modal, enter the following scope URLs in the OAuth scopes fields:
   • https://www.googleapis.com/auth/contacts
   • https://www.googleapis.com/auth/drive
   • https://www.googleapis.com/auth/admin.directory.user.readonly
6. Click Authorize. The Client IDs appear on the Domain Wide Delegation page.
7. Proceed to Part 3 of the activation process. 

Part 3: Log in to Kantata OX via Google SSO

1. Go to the Kantata OX login page.
2. In the 3rd-party service section, click the Google icon. You’re redirected to the Google sign-in page.
   
3. Enter your credentials to sign in to the Google Workspace Admin console. You’re redirected to the Google access control page, which lists the data Kantata OX will be accessing in your Google account.
4. To activate the integration, click Continue.
   
5. If this is your first time signing in via the Google single sign-on (SSO) method, you will be prompted to enter your Kantata OX password in the screen that appears.
   
6. Click Submit to finish. The Google Workspace flag is now set to On and the email address used to set up the account-wide option is now set as the SSO identity in the Kantata OX backend. The account-wide integration is now activated for all account members and you are redirected back to the Kantata OX Google Workspace Settings page.