Skip to content

docs(gcp-wif): add Cloud Asset API enablement as required step - #236

Open
girish-cheedala wants to merge 8 commits into
mainfrom
fix/gcp-wif-cloudasset-api
Open

docs(gcp-wif): add Cloud Asset API enablement as required step#236
girish-cheedala wants to merge 8 commits into
mainfrom
fix/gcp-wif-cloudasset-api

Conversation

@girish-cheedala

Copy link
Copy Markdown
Contributor

Summary

  • Adds Step 6: Enable Cloud Asset API to the GCP WIF integration setup guide
  • The Cloud Asset Inventory API (cloudasset.googleapis.com) must be enabled in the WIF pool/SA project for org-level integration to work — this was missing from the docs
  • Updates troubleshooting: "Google Cloud denied access" now lists API enablement as the first cause, with commands to check and fix using the project number from the WIF provider path

Root Cause

Discovered while debugging a customer issue. The GCP org-level integration uses the Cloud Asset API for all operations (Verify()SearchAllResources, Resources()ListAssets). When using WIF credentials, GCP uses the WIF pool project number (from the audience field in the external_account credentials) as the consumer/quota project. If the Cloud Asset API is not enabled in that project, all calls fail with "Google Cloud denied access" — even though IAM permissions are correctly set.

Test Plan

  • Verified: disabling Cloud Asset API → integration fails with "Google Cloud denied access"
  • Verified: enabling Cloud Asset API → integration passes
  • Project number is always visible in the WIF provider path customers already have

- Revise GCP integration overview for clarity on discovery approaches and authentication methods.
- Introduce a detailed table of supported GCP services.
- Expand on enumeration scope with project-level and organization-level discovery options.
- Add warnings regarding permission requirements for organization-level enumeration.
- Include new authentication methods with descriptions and links.
- Add a new image for GCP integration screen.
The GCP org-level integration uses the Cloud Asset Inventory API for all
discovery operations (Verify and Resources). The API must be enabled in
the WIF pool/SA project (identified by the project number in the WIF
provider path) for the integration to work.

- Add Step 6: Enable Cloud Asset API with check and enable commands
- Renumber Step 6→7 (Provider path) and Step 7→8 (Configure in PDCP)
- Update troubleshooting: list Cloud Asset API enablement as the first
  cause of 'Google Cloud denied access', with the exact commands to
  check and fix using the project number from the WIF provider path
@mintlify

mintlify Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
projectdiscovery 🟢 Ready View Preview Aug 19, 2026, 9:23 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@ehsandeep ehsandeep left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

merge conflict

The GCP org-level integration uses the Cloud Asset Inventory API for all
discovery operations (Verify and Resources). The API must be enabled in
the WIF pool/SA project (identified by the project number in the WIF
provider path) for the integration to work.

- Add Step 6: Enable Cloud Asset API with check and enable commands
- Renumber Step 6→7 (Provider path) and Step 7→8 (Configure in PDCP)
- Update troubleshooting: list Cloud Asset API enablement as the first
  cause of 'Google Cloud denied access', with the exact commands to
  check and fix using the project number from the WIF provider path
- Resolve merge conflict with main
@girish-cheedala

Copy link
Copy Markdown
Contributor Author

merge conflict

this is now fixed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants