Overview
Some vulnerabilities cannot be fixed automatically, but they can still be resolved by a person. Instead of leaving these as a dead-end, Backline creates an Assisted Fix remediation that explains why automation could not proceed and gives you clear, step-by-step guidance to resolve the issue yourself.An Assisted Fix remediation is actionable, not failed. Backline could not safely apply the fix automatically, so it hands you the context and the steps instead.
How an Assisted Fix Remediation Looks
An Assisted Fix remediation has these characteristics:- Mode: Hybrid — resolving it requires your collaboration.
- Status: Assisted Fix.
- Fixability: Review Needed — Backline cannot apply the fix automatically, so a human should review the guidance before acting. See Fixability.
- No pull request: Because the fix cannot be automated, no PR is created.
- Impact: Calculated the same way as any other remediation.
Where to Find It
Open the remediation to see its Assisted Fix details:- Remediation side panel → Overview tab — the summary explaining the automation blocker (why Backline could not remediate automatically). Click See remediation playbook to jump to the guidance.
- Remediation side panel → Remediation Playbook tab — the manual guidance, written as clear steps you can follow.
- Vulnerability side panel — each affected vulnerability shows its remediation and a See full remediation button that opens it.
What the Guidance Explains
The manual guidance is generated for each vulnerability, so the exact steps depend on the specific blocker. It covers:- What Backline attempted, when applicable.
- Why automatic remediation cannot continue (the blocker).
- Which package, dependency, image, Dockerfile, or base image is involved.
- The manual steps to resolve the issue.
- How Backline will verify the fix.
Example. Backline cannot safely upgrade a transitive package that is pinned in place by an npm override policy, because changing that override could affect the rest of your dependency tree. The remediation explains the blocker and offers safe manual paths, such as upgrading the parent package to a version that already depends on a patched release.
Verification
You do not need to close an Assisted Fix remediation manually. After you apply the fix, Backline verifies it automatically on the next scanner ingestion. When the vulnerable package or image is no longer reported at a vulnerable version, all linked vulnerabilities move to Resolved.1
Review the blocker
Open the remediation and read the summary in the Overview tab to understand why automation could not proceed.
2
Follow the guidance
Open the Remediation Playbook tab and apply the recommended manual steps.
3
Let Backline verify
On the next scan, Backline confirms the fix and moves the vulnerabilities to Resolved automatically.
Related Documentation
Remediations Overview
Understand how remediations work in Backline
Fixability
Learn what the Review Needed badge means
Remediation Summary
See how Backline explains what a remediation changed
Vulnerabilities Overview
Understand vulnerability statuses and how to work with them