Skip to content

docs(risk-acceptance): approving risk acceptance requests in ServiceNow - #16934

Open
devGregA wants to merge 1 commit into
DefectDojo:devfrom
devGregA:docs/servicenow-risk-acceptance
Open

devGregA wants to merge 1 commit into
DefectDojo:devfrom
devGregA:docs/servicenow-risk-acceptance

Conversation

@devGregA

Copy link
Copy Markdown
Contributor

Summary

Adds Risk Acceptance Approvals in ServiceNow (docs/content/triage_findings/findings_workflows/PRO__risk_acceptance_servicenow.md), and a short pointer to it from Risk Acceptances. Documents the Pro feature in DefectDojo-Inc/dojo-pro#7622. Please merge this with the release that ships it, not before.

The page covers:

  • how a request becomes a ServiceNow record and how the decision made there comes back
  • approvers: a decision applies only when a superuser has linked the ServiceNow user (by sys_id) to an active DefectDojo user, never by email or name, and that user still needs the Approve permission and passes the self-approval rule. The links are set through the settings API for now
  • a decision applies only while the request still matches what was sent. A request changed after it was sent closes the record as "request changed", and must be sent again or decided in DefectDojo
  • DefectDojo only acts on records it created and never adopts an existing ServiceNow record
  • what happens when things change on either side, including a deleted connection and a decision that fails to apply
  • the ServiceNow setup: the table, the Flow Designer approval flow, the integration account, and the expiry field
  • the DefectDojo setup on System Settings, which shows the section only while Risk Acceptances 2.0 is on
  • the status line in the Review tile, common reasons a decision is not applied, and the API

Translated pages are not touched.

🤖 Generated with Claude Code

The setup on both sides, how ServiceNow approvers are linked to
DefectDojo users, why a decision on a changed request is not applied,
what DefectDojo does with each decision, and the status a request shows
while it waits.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@devGregA devGregA added this to the 3.5.300 milestone Nov 17, 2026
@github-actions github-actions Bot added the docs label Nov 17, 2026

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.

1 participant