Google FAQ and Troubleshooting

This article contains:

  • A list of frequently asked questions related to onboarding GCP and Google Workspace to Tenable One AI Exposure
  • GCP and Google Workspace status and troubleshooting information

GCP FAQs

This section contains a list of frequently asked questions related to onboarding GCP projects/organizations.

Exclude a Folder or Project from an Organization

Grant Organization-Level Permissions

Project Is Pending Deletion

User in Domain Considered External

Update the Integration Name for the Organization

You can modify the name of your GCP organization integration/s, reflecting how the integration is displayed in AI Exposure. This can be useful for better identification, especially if you have multiple organizations.

To update the name:

  1. In the AI Exposure Console, navigate to Settings > Integrations.
  2. Next to the relevant integration, click the three dots menu, and then Edit.
  3. Navigate to step 2 in the wizard and update the Organization Name field.
  4. Click Next to navigate to the last step in the wizard and then click Update.

Terraform Deployment

Google Workspace FAQs

This section contains a list of frequently asked questions related to onboarding Google Workspace.

Service Account Token Creator Role

Service Account Impersonation vs. Service Account Key

Super Administrator User (Advanced)

Note: Only relevant if you grant permissions via domain-wide delegation (advanced). AI Exposure recommends granting permissions via custom role for most organizations.

Domain-Wide Delegation (Advanced)

Note: Only relevant if you grant permissions via domain-wide delegation (advanced). AI Exposure recommends granting permissions via custom role for most organizations.

Quota Administrator Role (Legacy)

Note: This section is only relevant if you onboarded your Google Workspace before April 27, 2025.

Project Status and Troubleshooting

AI Exposure displays a Status for each project on the Accounts > GCP page, indicating whether Tenable can connect to the project, and helping you troubleshoot potential onboarding issues. For step-by-step guidance on resolving GCP role and permission errors, see Resolve Cloud Onboarding Permission and Role Errors (AWS, Azure, GCP).

Status Description
Connected Tenable successfully connected to the project, and the project is up and running.
Deleting... this may take up to an hour You deleted the project in Tenable, and the process hasn't completed yet.
Failed to connect Tenable failed to connect to the project. This might happen because the project was deleted in GCP, but not deleted from the AI Exposure Console.
Google workspace is not connected The Google workspace is not connected. See Connect a Google Workspace for more information.
Missing permissions One or more of the listed roles are missing, and need to be added to the Tenable service account.
Project is deleted You deleted the project in Tenable. The project will be removed the next time data is synced in Tenable.
Project is pending deletion After you delete a project in GCP, it takes 30 days until the project is fully deleted. After this 30-day period, Tenable will offboard the project automatically from the system. Since Google Cloud allows you to revert the deletion during this time period, Tenable doesn't delete the data from the system until after 30 days, allowing you to restore the project in GCP if you wish. For more information, refer to the relevant Google documentation.
Project is suspended The project is suspended in GCP. The project will remain in this state until changed in GCP.
Some features are disabled Billing is disabled in GCP for the project where you created the Tenable service account. This causes limitations on queries to this account. Some AI Exposure features, such as findings on inactive service accounts and Kubernetes visibility and security, will be disabled until a billing account is connected. Refer to the relevant Google Cloud documentation for more information about project billing.
Subscription is not configured The Pub/Sub subscription used to collect audit logs (activity logs) from the GCP project is not configured. As a result, audit logs are not being sent to AI Exposure. See Connect a GCP Organization.

Workspace Status and Troubleshooting

AI Exposure displays a Status for each Workspace on the Integrations > Google Workspace page, indicating whether Tenable can connect to the Workspace and helping you troubleshoot potential onboarding issues.

Status Description
Service Usage API is not enabled Enable at the project level where the service account was created.
Missing permissions
  • Ensure the Tenable service account has the required permissions.
  • Ensure the AI Exposure principal was granted the Service Account Token Creator role.
Missing label Ensure the label exists and has the relevant key/value pair.
Missing OAuth scopes Ensure all required OAuth scopes are added via domain-wide delegation.