Loading
Document dependency_change and dependency_type scanner settings
What does this MR do and why?
Documents the dependency_change and dependency_type scanner settings for merge request approval policies, as part of the stack for #635482.
- Adds both attributes to the scanner object table.
- Adds the "Filter dependency scanning findings by dependency change" section: what each value means, how components are matched against the target branch SBOM, the example policy, and the limitations.
- Adds a troubleshooting pointer for findings that are not introduced by the merge request.
The settings are behind the beta feature flag approval_policy_dependency_scanning_filters, disabled by default.
References
- Closes #635482
- Feature flag rollout: https://gitlab.com/gitlab-org/gitlab/-/work_items/635635
- Follow-ups:
- Rules with only previously existing states: https://gitlab.com/gitlab-org/gitlab/-/work_items/635632
- Rule builder support: #635633
- Container scanning: #635634
Screenshots or screen recordings
Not applicable: documentation only.
How to set up and validate locally
- Preview
doc/user/application_security/policies/merge_request_approval_policies.md, section "Filter dependency scanning findings by dependency change". - Check that the anchors in the scanner table and the troubleshooting link resolve.
- Lint:
markdownlint-cli2 doc/user/application_security/policies/merge_request_approval_policies.md vale --minAlertLevel error doc/user/application_security/policies/merge_request_approval_policies.md
MR stack
This MR is part of a stack of 4 that replaces one 760-line MR. Each MR targets the previous branch (linear chain), so every diff only shows its own change. Merge in order; retarget each MR to master after the one below it merges.
635482-ds-dependency-change-filter(!264451 (merged)): schemas, config plumbing, feature flag. Targetsmaster.635482-ds-dependency-filter-class(!267117 (merged)):DependencyFilterand theSecurity::Findingscope, unreferenced. Targets the branch above.635482-ds-dependency-filter-wiring(!267118 (merged)): wires the filter into evaluation. Targets the branch above.- This MR:
635482-ds-dependency-filter-docs(!267119 (merged)): documentation. Targets the branch above.
MR acceptance checklist
Evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.
Edited by Alan (Maciej) Paruszewski