Skip to content

docs(triage-engine): webhook receivers and Jira two-way sync - #16060

Open
blakeaowens wants to merge 9 commits into
bugfixfrom
docs/jira-bidirectional-webhook-receiver
Open

blakeaowens wants to merge 9 commits into
bugfixfrom
docs/jira-bidirectional-webhook-receiver

Conversation

@blakeaowens

@blakeaowens blakeaowens commented Sep 23, 2026 •

Copy link
Copy Markdown
Contributor

Description

Documents Triage Engine webhook receivers and two-way sync for the Jira Downstream Connector (DefectDojo Pro).

  • New page: automation/triage_engine/webhook_receivers.md. It covers how a delivery is handled, turning on two-way sync from a Jira connection, what Jira changes do to linked Findings, pushing notes to Jira as comments (private notes never leave), building a rule for a custom webhook, authentication modes, receipts, the webhook gateway, and permissions.
  • Node Reference: entries for On an Inbound Webhook, Find Findings by a Value, Apply the Ticket's Status, and Add a Ticket Comment as a Note. The If / Filter entry no longer claims to be the only node with two outputs.
  • Building Rules: a "Referring to webhook data" section for webhook.* and the new ctx.* paths.
  • Configuration: the receiver limits (body size, dedupe window, rate limit, receipt retention) and the webhook gateway settings.
  • Inbound Webhooks flag: a new "Turning inbound webhooks off" section on the Webhook Receivers page covers the kill switch. It explains what refusing deliveries does, the warnings on the Receipts and Gateway tabs, and how nothing captured is lost. Configuration now says the gateway is on by default in the compose bundles and the Helm chart.
  • Jira connector reference: the inbound status lists on the status mapping ("Coming Back From Jira"), Push Notes as Comments, and a Two-way Sync section.
  • Jira (Legacy) guide: the classic migration notes no longer say reverse sync and Push Notes do not carry over. Push Notes now becomes Push Notes as Comments, and the classic resolution mappings carry over to the connector's status mapping.

English only. The translated pages are regenerated on the usual schedule (docs/TRANSLATIONS.md).

Test results

Docs only. Every label and setting named here was checked against the running Pro UI and the Pro settings.

🤖 Generated with Claude Code

blakeaowens and others added 2 commits September 23, 2026 02:56
New Webhook Receivers page, node reference entries for the webhook trigger,
the Finding lookup and the two ticket-sync nodes, webhook paths in Building
Rules, receiver and gateway settings in Configuration, and push notes and
two-way sync on the Jira connector pages. The classic Jira migration notes
no longer say reverse sync and push notes do not carry over.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@blakeaowens blakeaowens added this to the 3.3.300 milestone Sep 23, 2026
@github-actions github-actions Bot added the docs label Sep 23, 2026
blakeaowens and others added 2 commits September 23, 2026 22:21
@blakeaowens

Copy link
Copy Markdown
Contributor Author

[sc-15550]

blakeaowens and others added 5 commits September 24, 2026 04:24
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… key

Documents DD_WEBHOOK_GATEWAY_SECRET_KEY beside the admin token, says that
dojo-compose-cli and the Helm chart generate both per installation, and describes
the startup warnings an installation still on the Docker Compose defaults gets.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
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.

3 participants