Skip to content

docs: add Backstage Pro connector reference#15223

Open
devGregA wants to merge 2 commits into
DefectDojo:bugfixfrom
devGregA:docs/backstage-connector
Open

docs: add Backstage Pro connector reference#15223
devGregA wants to merge 2 commits into
DefectDojo:bugfixfrom
devGregA:docs/backstage-connector

Conversation

@devGregA

Copy link
Copy Markdown
Contributor

Summary

Documents the new Backstage Pro asset connector (implemented in DefectDojo-Inc/connectors#689, registered in DefectDojo-Inc/dojo-pro#1837):

  • Adds a Backstage section to the Connectors tool reference: what gets mapped (System → Product Type, Component → Product, owning Group → Product ownership, tags/annotations), the Backstage-side setup (static externalAccess token with catalog-only accessRestrictions, YAML example), the connector configuration reference (all optional fields and their defaults), sync semantics (uid-keyed renames update in place; removed/orphaned components go MISSING, never deleted), and v1 limitations.
  • Notes explicitly that a Backstage frontend plugin showing DefectDojo findings/grades on entity pages is a deliberate out-of-scope follow-on.
  • Adds Backstage to the supported-tools list in "About Connectors".

Docs-only change, targeting bugfix per docs convention.

🤖 Generated with Claude Code

Document the new Backstage asset connector: what it maps (System ->
Product Type, Component -> Product, owning Group -> Product ownership,
tags/annotations), the Backstage-side static externalAccess token setup
with catalog-only accessRestrictions, the connector configuration
reference, sync semantics (uid-keyed renames in place, MISSING on
removal/orphan), v1 limitations, and a note that a Backstage frontend
plugin showing DefectDojo findings on entity pages is a deliberate
out-of-scope follow-on. Also add Backstage to the supported-tools list.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
E2E-verified behavior worth stating explicitly: the connector reconciles
the Product name to the catalog name on every sync, so renames belong in
Backstage, and custom names given at manual-mapping time do not stick.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@devGregA devGregA added this to the 3.1.100 milestone Jul 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant