Skip to content

feat(ngts): Add NGTS API reference to SCM docs#1167

Open
rajitshah-ca wants to merge 8 commits intoPaloAltoNetworks:masterfrom
rajitshah-ca:add-ngts-api-docs
Open

feat(ngts): Add NGTS API reference to SCM docs#1167
rajitshah-ca wants to merge 8 commits intoPaloAltoNetworks:masterfrom
rajitshah-ca:add-ngts-api-docs

Conversation

@rajitshah-ca
Copy link
Copy Markdown

@rajitshah-ca rajitshah-ca commented Apr 2, 2026

Description

Adds the full NGTS (Venafi TLS Protect Cloud) API reference under Strata Cloud Manager > NGTS Configuration.

Changes

  • OpenAPI spec: 30 API categories, 183 endpoints (openapi-specs/scm/config/ngts/tlsprotect-cloud.json)
  • Auth scheme: Replaced legacy tppl-api-key with SCM OAuth2 authentication
  • Docusaurus plugin config: new ngts entry in docusaurus.config.ts
  • Sidebar: new "NGTS Configuration" category in products/scm/sidebars.ts
  • Landing page: added NGTS Configuration card in src/pages/strata-cloud-manager/index.js
  • Intro page: products/scm/api/config/ngts/ngts-api.md

Motivation and Context

NGTS (TLS Protect Cloud) APIs need to be documented within the Palo Alto Networks developer portal for Strata Cloud Manager. The OpenAPI spec was generated from the upstream CI pipeline and passed Spectral lint with 0 errors. Auth was updated to use SCM's standard OAuth2 scheme instead of the legacy Venafi API key.

EPIC: VC-50859

Companion internal MR: code.pan.run/dev/dev.docs.pan.run/-/merge_requests/107

How Has This Been Tested

  • prettier formatting passed via pre-commit hook
  • OpenAPI spec validated with Spectral (0 errors)
  • Verified docusaurus config, sidebar, and landing page changes match expected structure

Types of changes

  • New feature (non-breaking change which adds functionality)

Checklist

  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes if appropriate.
  • All new and existing tests passed.

rajitshah-ca and others added 5 commits April 2, 2026 16:03
Adds full NGTS API reference under SCM > NGTS Configuration, mirroring
developer.venafi.com/tlsprotectcloud with all 30 API categories and 183
endpoints. Spec generated from devhub-manager merged OAS, transformed to
meet PANW Spectral standards (0 errors). POC branch — pending proper
workflow through pandev-tools and api-specs MR.

EPIC: VC-50859
Replaces manually generated spec with output from ua-repo CI pipeline
(Generate PANW Spec job, MR-353). Spec is now produced automatically
by devhub-manager + transform-to-panw-spec.py on every siteconf.yaml change.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Update spec to use scmOAuth + scmToken (Bearer JWT) matching other SCM
APIs. Rewrite intro page auth section to describe OAuth2 client
credentials flow instead of API key.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@rajitshah-ca rajitshah-ca changed the title feat(ngts): Add TLS Protect Cloud API reference to SCM docs feat(ngts): Add NGTS API reference to SCM docs Apr 2, 2026
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 6, 2026

Visit the preview URL for this PR (updated for commit cae0a9c):

https://pan-dev-f1b58--pr1167-lrf4kmdy.web.app

(expires Tue, 21 Apr 2026 16:15:56 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: 9359a9fa100d5fdb082f75280473a90b1f96eb51

@sra-hub sra-hub requested a review from a team as a code owner April 14, 2026 15:52
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