Integrate Google Workspace with Access Management, Access Reviews, & HR On/Offboarding for JSM

This guide walks you through connecting your Google Workspace domain using a service account and domain-wide delegation so you can automate the complete user access management lifecycle while maintaining audit-ready compliance.

Pre-requisites

Before you begin, make sure the following are in place:

  • Super Admin access to both Google Cloud Console and Google Workspace Admin Console.

Step 1: Create a Google Cloud Project

  • Go to console.cloud.google.com.
  • Click the project dropdown at the top and select New Project.
  • Name it anything recognisable (e.g., jira-workflow-provisioning) and click Create.

Step 2: Enable the Admin SDK API

  • Inside your new project, go to APIs & Services → Library.
  • Search for Admin SDK API and select it from the results.
  • Click Enable.

Step 3: Create a Service Account

  • Go to IAM & Admin → Service Accounts → + Create Service Account.
  • Give it a clear name (e.g., jira-provisioning).
  • Skip the optional role and user access steps and click Done.
  • Click on the newly created service account → Keys tab → Add Key → Create new key → JSON.
  • A JSON file will download. Keep this secure. You will need to upload it in Step 5.
Note: the client_id value from the JSON, you will need it in Step 4.

Step 4: Configure Domain-Wide Delegation

  • Go to admin.google.com and sign in as Super Admin.
  • Navigate to Security → Access and data controls → API Controls.
  • Under Domain-wide delegation, click Manage Domain Wide Delegation → Add new.
  • Paste the client_id from Step 3 into the Client ID field.
  • In the OAuth Scopes field, paste the following scopes exactly:
    • https://www.googleapis.com/auth/admin.directory.user
    • https://www.googleapis.com/auth/admin.directory.group
    • https://www.googleapis.com/auth/admin.directory.group.member
  • Click Authorize.

The three scopes grant the following permissions:

OAuth Scope Permission Granted
admin.directory.user Create, update, suspend, and delete user accounts
admin.directory.group Read and list Google Groups in your domain
admin.directory.group.member Add and remove members from Google Groups

Step 5: Connect Google Workspace to the App

  • Open the Identity Governance, Auditing & Access Control via JSM app and navigate to App Connections from the sidebar.
  • Google Workspace JSM Access Governance Guide
  • Click + Add Integration and select Google Workspace from the list.
  • Google Workspace JSM Access Governance Guide

Enter the following details in the Connect Google Workspace panel:

Google Workspace JSM Access Governance Guide
  • Connection Name: To identify this Google Workspace connection for other admins (e.g., "My Google Workspace").
  • Primary Domain: Your Google Workspace primary domain (e.g., company.com).
  • Admin Email: The Super Admin account email used for impersonation.
  • Service Account JSON: Upload or paste the contents of the JSON file downloaded in Step 3.
  • Application Admin: Select a licensed Atlassian user who will manage this connection.
Note: Credentials are encrypted in transit and at rest, and are only used for provisioning, synchronization and access governance operations.

Once all fields are filled in, click Connect Google Workspace to save the integration.

Once the connection is saved, your Google Groups will be available in the Role Catalog and Rule Builder, and user provisioning actions (create, suspend, delete, group assignment) will be immediately available in your workflows.

Next Steps: Configure Automation Rules

With both connections saved, configure automation rules to define how access requests are routed, approved, and provisioned:

  • Application Access Automation Rule
  • Group Membership Automation Rule
  • Identity Lifecycle Management: HR Onboarding and Offboarding
  • Privileged Access Automation Rule

Did this page help you?

miniOrange Atlassian Contact Us

Book a Free Consultation with
Our Experts Today!

Schedule a call now!


Contact Us