--- title: Google Cloud IAM description: '' slug: /help/docs/platform-services/automation-service/app-central/integrations/google-cloud-iam/ canonical: https://www.sumologic.com/help/docs/platform-services/automation-service/app-central/integrations/google-cloud-iam/ --- import useBaseUrl from '@docusaurus/useBaseUrl'; google ***Version: 1.0 Updated: Oct 17, 2025*** Identity and Access Management (IAM) lets you create and manage permissions for Google Cloud resources. ## Actions * **Add Member to Role** (*Containment*) - Adds new members to the specified role (and keeps existing ones intact). * **Delete Service Account Key** (*Containment*) - Permanently remove an unused or compromised service account key to prevent unauthorized access. * **Get Role** (*Enrichment*) - Get Role returns details of a specific IAM role such as its title, permissions, and description. * **Get Service Account Keys** (*Enrichment*) - Retrieve metadata about keys associated with a service account to audit active credentials and detect old or unused keys. * **List Policies** (*Enrichment*) - View IAM policies that define who has what access to your GCP resources. * **List Role Bindings** (*Enrichment*) - To simplify and extract just the role-to-member relationships from the IAM policy for quick inspection or audits. * **List Roles** (*Enrichment*) - Retrieve all predefined (Google-managed) and custom (project-level) IAM roles available in Google Cloud. * **Remove Member from Role** (*Containment*) - Revoke a user’s or service account’s access to a specific IAM role. * **Set Policy** (*Containment*) - Safely update or modify IAM policies to add or remove access permissions. * **List Service Accounts** (*Enrichment*) - List all service accounts created in a project to maintain an inventory and identify unused identities. ## Google Cloud IAM configuration Our Google Cloud IAM integration support two types of authentication, Service Account and WIF (Workload Identity Federation). We recommend using WIF since it is more secure and easier to manage. For more information, see [Workload Identity Federation](https://cloud.google.com/iam/docs/workload-identity-federation). ## Required AWS details from Sumo Logic To configure the Google Cloud IAM integration using WIF authentication, you need the following AWS details from Sumo Logic. These details are essential for setting up the Workload Identity Federation (WIF) credentials in Google Workspace: * Deployment name is the unique name of your Sumo Logic [deployment](/docs/api/about-apis/getting-started/#documentation), for example, `dub`, `fra`, etc. * Sumo Logic AWS account ID: `926226587429` * Sumo Logic AWS role: `-csoar-automation-gcpiam` * Sumo Logic AWS Lambda function: `-csoar-automation-gcpiam` * Full ARN: `arn:aws:sts::926226587429:assumed-role/-csoar-automation-gcpiam/-csoar-automation-gcpiam` ### Workload Identity Federation (WIF) authentication To [create WIF credentials](https://cloud.google.com/iam/docs/workload-identity-federation) in Google Workspace needed to configure the Google Cloud IAM integration, follow these steps: 1. Log in to the [Google Cloud](https://console.cloud.google.com) portal. 2. Select a Google Cloud project (or create a new one). 3. Go to the **API&Services** 4. In the same page click on **ENABLED API AND SERVICES** and search for Cloud Resource Manager API, IAM Service Account Credentials API, Identity and Access Management (IAM) API, Security Token Service API and enable it all. 5. Go to the **IAM & Admin** > **Service Accounts** page. 6. Click **CREATE SERVICE ACCOUNT** [Service Account](https://cloud.google.com/iam/docs/service-accounts-create) is required to access the Google Cloud IAM. 7. While creating the service account, in **Permissions** add the role **Service Account Token Creator** and click on **DONE**.
Service Account Token Creator 8. Go to the **IAM & Admin** > **Workload Identity Federation** page.
Workload Identity Federation 9. Click **CREATE POOL**, provide the details, and click on **CONTINUE**.
Create pool 10. Add **Provider details**. Select **AWS** as the provider type and provide the details of the AWS Account ID which is provided by Sumo Logic. Click on **CONTINUE** and **SAVE**.
Provider details 11. Now you will see the created pool and provider.
Created pool and provider 12. Now we have to build a principal name to configure in Sumo Logic. The format of the principal name is: `principalSet://iam.googleapis.com/projects/{YourProjectID}/locations/global/workloadIdentityPools/{YourPoolName}/attribute.aws_role/arn:aws:sts::{SumoAWSAccountID}:assumed-role/{SumoAWSRole}/{SumoAWSLambdaFunction}`. 13. Go to the **IAM & Admin** > **IAM** page and click on **Grant Access** to add a new principal. 14. In the **New principals** field, provide the above principal name and select the role **Workload Identity User**. Click on **SAVE**.
Workload Identity User 15. Go to the **IAM & Admin** > **Workload Identity Federation** page and select the pool which was created above. 16. Click on **Grant Access** > **Grant access using service account impersonation**. 17. Select the service account which created above, select the principle as aws_role and provide the arn `arn:aws:sts::{SumoAWSAccountID}:assumed-role/{SumoAWSRole}` and click on **SAVE**.
Provide ARN 18. Again go to **Grant Access** > **Grant access using service account impersonation**. Select the service account which was created above. Select the principle as `aws_role` and provide the arn `arn:aws:sts::{SumoAWSAccountID}:assumed-role/{SumoAWSRole}/{SumoAWSLambdaFunction}`. Click on **SAVE**. 19. Download the WIF `conf.json` file. Make sure you save it in a safe place. Use the JSON content to configure the Google Cloud IAM integration to use WIF authentication in Automation Service and Cloud SOAR. ### Service Account authentication To [create service account credentials](https://developers.google.com/workspace/guides/create-credentials) in Google Workspace needed to configure the Google Cloud IAM integration, follow these steps: 1. Log in to the [Google Cloud](https://console.cloud.google.com) portal. 2. Select a Google Cloud project (or create a new one). 3. Go to the **API&Services** > **Credentials** page. 4. In the same page click on **ENABLES API AND SERVICES** and search for Cloud Resource Manager API, IAM Service Account Credentials API, Identity and Access Management (IAM) API, Security Token Service API and enable it. 5. Click **CREATE CREDENTIALS** and select **Service Account**.
Create credentials 6. Enter a service account name to display in the Google Cloud console. The Google Cloud console generates a service account ID based on this name. 7. (Optional) Enter a description of the service account. 8. Skip two optional grant permissions steps and click **Done** to complete the service account creation.
Complete service account creation 9. Click on the generated service account to open the details.
Generated service details 10. Under the **KEYS** tab, click **ADD KEY** and choose **Create new key**.
Create new key 11. Click on **CREATE** (make sure **JSON** is selected).
Click on create 12. The JSON file is downloaded. Make sure you save it in a safe place. ## Configure Google Cloud IAM in Automation Service and Cloud SOAR import IntegrationsAuth from '../../../../reuse/integrations-authentication.md'; import IntegrationCertificate from '../../../../reuse/automation-service/integration-certificate.md'; import IntegrationEngine from '../../../../reuse/automation-service/integration-engine.md'; import IntegrationLabel from '../../../../reuse/automation-service/integration-label.md'; import IntegrationProxy from '../../../../reuse/automation-service/integration-proxy.md'; import IntegrationTimeout from '../../../../reuse/automation-service/integration-timeout.md'; * * **Authentication Type**. Select the authentication type: **Service Account Private Key Json** or **Workload Identity Federation Private Key json** and provide the selected type Json content. * **scopes**. Default scope is already added as `https://www.googleapis.com/auth/cloud-platform`, if not then add this scope. * **Project ID**. Provide the Google Cloud Project ID where the IAM actions will be performed. * * Google Cloud IAM configuration For information about Google Cloud IAM, see [Google Cloud IAM documentation](https://cloud.google.com/iam/docs/reference/rest). ## Change Log * October 17, 2025 (v1.0) - First upload