Skip to content

[PREVIEW COPY] docs(gcp): document VPC Service Controls requirements for GCP integrations - #25887

Merged
3 commits merged into
developfrom
nr-sparsi-docs-gcp-vpc-service-control
Sep 29, 2026
Merged

3 commits merged into
developfrom
nr-sparsi-docs-gcp-vpc-service-control

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Mirror PR Summary

This is a preview copy of PR #25790 from @nr-sparsi, created at 2026-09-28 13:52:25 IST.

Original PR Details


Original PR Description:

Summary

  • Documents the VPC Service Controls (VPC SC) ingress rules required for GCP integrations, for both the Workload Identity Federation and New Relic service account connection methods. This information wasn't documented anywhere previously.
  • WIF requires two additional APIs (sts.googleapis.com, iamcredentials.googleapis.com) beyond the four shared with the service account flow, since WIF uses them for token exchange and short-lived credential generation.
  • Includes the PERMISSION_DENIED ... vpcServiceControlsUniqueIdentifier error signature customers see when the perimeter blocks these calls, so it's searchable.

Context

Raised from a customer support thread where a GCP WIF integration behind a VPC SC perimeter was failing with PERMISSION_DENIED errors. Support (#help-aws-gcp) identified and confirmed the required ingress rules, and the customer separately confirmed neither the WIF nor service account setup docs mention VPC SC at all.

Test plan

  • Verified via web_fetch that neither the current WIF nor service account setup pages mention VPC SC.

  • Docs preview build renders the new sections correctly (Callout, headings, code block).


    This is an automatically generated mirror of a fork PR. Changes here will not be reflected back to the original PR.

sparsi17 and others added 3 commits September 18, 2026 17:14
…tions

Customers with a VPC SC perimeter around their GCP project were hitting
PERMISSION_DENIED errors with no documented way to resolve them, since
neither the WIF nor service account setup guides mentioned VPC SC ingress
rules. Documents the required APIs for each connection method (WIF needs
sts.googleapis.com and iamcredentials.googleapis.com in addition to the
four APIs shared with the service account flow).
The V2 docs split moved this guidance to integrations-custom-roles.mdx
and the service account page links to it, but the WIF page never got
the same cross-reference — flagged in the VPC SC support thread.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Domain restriction constraints (iam.allowedPolicyMemberDomains /
iam.managed.allowedPolicyMembers) only affect the service account
connection method, since it adds New Relic's own service account as
an external IAM member. WIF pools/providers are the customer's own
org resources and are already part of their organization principal
set, so the constraint doesn't apply — remove the misleading
cross-reference from the WIF page instead of describing a no-op.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@svc-docs-eng-opensource-bot

Copy link
Copy Markdown
Contributor

netlify build

@github-actions

Copy link
Copy Markdown
Contributor Author

🚀 Netlify Preview Building!

If the build is successful, the preview for this pull request will be available at the following URL (usually takes 10-20 minutes):

https://nr-sparsi-docs-gcp-vpc-service-control--docs-website-netlify.netlify.app

@tejaswaroop-nr tejaswaroop-nr closed this pull request by merging all changes into develop in 72fb187 Sep 29, 2026
@tejaswaroop-nr
tejaswaroop-nr deleted the nr-sparsi-docs-gcp-vpc-service-control branch September 29, 2026 04:00
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.

4 participants