Solution skill
Secret scan path fail on known matches
Complete solution
Shows how to fix secret scan path fail on known matches. Use it when you hit this exact problem. Skip it when your error message or symptom looks different.
TL;DR
Upgrade ggshield to >= 1.41.0; if it still fails after upgrading, report it since the maintainer confirmed the fix in that release. Fixed in ggshield 1.41.0.
Steps
- ggshield 1.39 failed with 'Scanning failed' when running ggshield secret scan path on a file whose only matches were already ignored/known. Fixed in ggshield 1.41.0. Upgrade ggshield to >= 1.41.0; if it still fails after upgrading, report it since the maintainer confirmed the fix in that release.
When to use
You are seeing this: Issue GitGuardian/ggshield#1097 (closed, 5 comments): ## Environment - ggshield version: 1.39 - Operating system (Linux, macOS, Windows): macOS - Operating system version: 15.4.1 - Python version: 3.12 Use this skill when you run into "Secret scan path fail on known matches".
When not to use
If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.
Versions
Versions mentioned in the source: 1.39, 15.4.1, 3.12, ggshield 1.41.0. If you are on something much newer or older, the details may have shifted.
Why this happens
The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.
Evidence
In gh:GitGuardian/ggshield#1097 (GitGuardian), the issue reported was: Issue GitGuardian/ggshield#1097 (closed, 5 comments): ## Environment
- ggshield version: 1.39
- Operating system (Linux, macOS, Windows): macOS
- Operating system version: 15.4.1
- Python version: 3.12
Describe the bug
Running ggshield secret scan path [PATH] where the path is a file with a known (ignored) match fails
Actual result:
❯ ggshield secret scan path src/detections/jsons/event_with_profile/f95088a9-4224-4f81-81e3-619d7b421b67.json
Scanning... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 1 / 1
Error: Scanning failed: {'scan_results': {0: {'policy_breaks': {0: {'detector_name': ['Missing data for required field.'],... The verified resolution from the thread: ggshield 1.39 failed with 'Scanning failed' when running ggshield secret scan path on a file whose only matches were already ignored/known. Fixed in ggshield 1.41.0. Upgrade ggshield to >= 1.41.0; if it still fails after upgrading, report it since the maintainer confirmed the fix in that release. Source: mount the host path https at container path //github.com/GitGuardian/ggshield/issues/1097By @issueatlas · Version 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_R1TPoRPiAA_yPFX7CNcIaA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Secret scan path fail on known matches <span>— Vectle</span></a>