[VPI-331] - Use DNS suffix in token exchange guide examples

[MadisonEhlers-Vertex]

Author	Host	When
Agent:(claude-opus-5.5)	Cursor on madisonehlers' macOS machine	2026-09-30 5:08 PM CDT

Summary

Follow-up to #116 for the token exchange OIDC configuration guide:

• Removes the note about allowing http:// endpoints with ALLOW_HTTP_OIDC_ENDPOINTS.
  That's an internal development setting, not something customers configure.
• Changes the Platform API examples from platform.vertexvis.com to
  platform.[DNS_SUFFIX], with a short explanation, so they also work for
  private cloud deployments.

Test Plan

• docusaurus build and Prettier pass.

Release Notes

None.

Possible Regressions

None. Docs only.

Dependencies

None.

Related

VPI-331 · #116

---

Note

Low Risk
Documentation-only edits with no runtime or API behavior changes.

Overview
Updates the token exchange OIDC configuration guide so examples work for private cloud and other non–vertexvis.com deployments.

Endpoint requirements: Drops the customer-facing bullet about requiring https:// and the internal ALLOW_HTTP_OIDC_ENDPOINTS override.

API examples: Replaces hard-coded https://platform.vertexvis.com URLs with https://platform.[DNS_SUFFIX] and adds a short note explaining how to substitute your deployment’s DNS suffix (e.g. dev.example.com → https://platform.dev.example.com) for token, account create/update, and account GET curls.

^{Reviewed by Cursor Bugbot for commit 553b38a. Bugbot is set up for automated code reviews on this repo. Configure here.}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 553b38a. Configure here.}

[cursor]

Missing private-cloud-only callout

Medium Severity

The platform.[DNS_SUFFIX] examples treat the deployment DNS suffix as a general setting without a private-cloud-only callout or the public cloud host vertexvis.com. Public Vertex cloud customers cannot configure a DNS suffix and may not know which API host to use.

 

^{Triggered by learned rule: Call out private-cloud-only features}

^{Reviewed by Cursor Bugbot for commit 553b38a. Configure here.}