Plumber Score
Plumber Score
What is a Plumber Score?
Plumber Score is a single A-E grade for your CI/CD security. The open-source Plumber CLI produces it on every run, locally or in your CI pipeline. The score is contextual: Plumber assembles its findings into attack paths and grades the worst realistic consequences, not a flat count of findings. Only what Plumber can prove moves the grade: a fact it had to assume or could not read is shown in the report, never priced.
| Grade | Points | What it means |
|---|---|---|
| A | ≥ 90 | Excellent: no significant exposure found |
| B | 71 – 89 | Good: minor exposure |
| C | 51 – 70 | Moderate: exposure worth fixing |
| D | 31 – 50 | Poor: significant accumulated exposure |
| E | < 31 | Critical: a Critical attack path remains, or heavy accumulated losses |
A grade from A to D says nothing about the number of paths. An E needs a Critical item: a Critical attack path keeps the score at 30 points or below. How Plumber gets from your files to the grade, and how the points add up, is on How the analysis works.
Publish your score
A CI run can publish your score to score.getplumber.io, where it becomes a live badge for your repo.
Publishing is opt-in and never sends your source code: once enabled, Plumber sends its analysis JSON output to score.getplumber.io after each run. Every run that has score push enabled publishes its result for its branch. The public badge and the project’s score follow the default branch only: a merge-request or pull-request run is stored under its branch and never changes the badge.
Example of pushed output
{"projectPath": "getplumber/plumber","projectId": 0,"defaultBranch": "main","ciConfigSource": "local","ciValid": true,"ciMissing": false,"pipelineOriginMetrics": { "jobTotal": 14, "originAction": 7, "originActionTrustedExempt": 35, "originActionUnpinned": 0, "originReusableWorkflow": 0, "originReusableWorkflowSecretsInherit": 0, "originTotal": 7, "workflowsTotal": 5},"pipelineImageMetrics": { "total": 0},"minPoints": 100,"passed": true,"plumberScore": { "profileId": "scoring-v4", "counts": { "critical": 0, "high": 0, "medium": 0, "low": 0 }, "rawPoints": 100, "rawPointsUnclamped": 100, "finalPoints": 100, "score": "A", "criticalMalusApplied": false, "losses": [], "codeLosses": [], "situation": "Repository: public. Default branch: main, protected. Workflows: 14 jobs in 5 workflows."},"actionPinningResult": { "ciMissing": false, "ciValid": true, "immutableReleaseRefs": [], "issues": [], "metrics": { "actionRefsExempt": 35, "actionRefsImmutableRelease": 0, "actionRefsTotal": 7, "actionRefsUnpinned": 0 }, "skipped": false, "version": "0.1.0"},"archivedActionsResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "actionRefsArchived": 0, "actionRefsTotal": 7 }, "skipped": false, "version": "0.1.0"},"authorizedActionSourcesResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "actionRefsTotal": 42, "actionRefsUnauthorized": 0 }, "skipped": false, "version": "0.1.0"},"branchProtectionResult": { "data": [ { "allowForcePush": false, "branchName": "main", "codeOwnerApprovalRequired": true, "default": true, "protected": true, "protectionDetailsKnown": true } ], "enabled": true, "metrics": { "branches": 24, "branchesToProtect": 1, "nonCompliantBranches": 0, "projectsCorrectlyProtected": 1, "totalProtectedBranches": 1, "unprotectedBranches": 0 }, "version": "0.2.0"},"dangerousTriggersResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "workflowsScanned": 5, "workflowsWithDangerousTrigger": 0 }, "skipped": false, "version": "0.1.0"},"debugTraceResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "forbiddenFound": 0, "totalVariablesChecked": 20 }, "skipped": false, "version": "0.1.0"},"dockerInDockerResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "dindServicesFound": 0, "insecureDaemonFound": 0, "totalJobsChecked": 14 }, "skipped": false, "version": "0.1.0"},"excessivePermissionsResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "jobsTotal": 14, "jobsWithWriteAll": 0 }, "skipped": false, "version": "0.1.0"},"imageForbiddenTagsResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "ciInvalid": 0, "ciMissing": 0, "notPinnedByDigest": 0, "pinnedByDigest": 0, "total": 0, "usingForbiddenTags": 0 }, "mustBePinnedByDigest": true, "skipped": false, "version": "0.4.0"},"knownVulnerableActionsResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "actionRefsTotal": 7, "actionRefsVulnerable": 0 }, "skipped": false, "version": "0.1.0"},"permissionsResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "workflowsMissingPermissions": 0, "workflowsTotal": 5 }, "skipped": false, "version": "0.1.0"},"pullRequestTargetHeadCheckoutResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "headCheckoutsUnderPrTarget": 0, "workflowsScanned": 5 }, "skipped": false, "version": "0.1.0"},"refConfusionResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "actionRefsAmbiguous": 0, "actionRefsTotal": 7 }, "skipped": false, "version": "0.1.0"},"requiredActionsResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "anySatisfiedGroup": false, "satisfiedGroups": 0, "totalGroups": 0 }, "requirementGroups": [], "skipped": true, "version": "0.1.0"},"reusableSecretsResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "reusableCalls": 0, "reusableCallsSecretsInherit": 0 }, "skipped": false, "version": "0.1.0"},"securityJobsWeakenedResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "securityJobsFound": 1, "weakenedJobs": 0 }, "skipped": false, "version": "0.1.0"},"templateInjectionResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "scriptLinesChecked": 26, "templateInjectionsFound": 0, "workflowsScanned": 5 }, "skipped": false, "version": "0.1.0"},"unverifiedScriptsResult": { "ciMissing": false, "ciValid": true, "issues": [], "metrics": { "jobsChecked": 14, "totalScriptLinesChecked": 26, "unverifiedScriptsFound": 0 }, "skipped": false, "version": "0.1.0"},"headCommitSha": "18a82651361aae6b23a12694d5954fef28569bd9","rawConfig": { "version": "2.0", "github": { "controls": { "actionsMustBePinnedByCommitSha": { "enabled": true, "trustedOwners": ["actions", "github"] }, "actionsMustNotBeArchived": { "enabled": true }, "actionsMustNotCarryKnownCVEs": { "enabled": true }, "githubActionMustComeFromAuthorizedSources": { "enabled": true, "trustGithubOfficialActions": true, "trustSameOrgActions": true, "minimumStars": 0, "trustedGithubActions": ["jdx/mise-action"] }, "containerImageMustNotUseForbiddenTags": { "enabled": true, "tags": ["latest", "dev", "development", "staging", "main", "master"], "containerImagesMustBePinnedByDigest": true }, "pipelineMustNotEnableDebugTrace": { "enabled": true, "forbiddenVariables": ["ACTIONS_STEP_DEBUG", "ACTIONS_RUNNER_DEBUG"] }, "pipelineMustNotUseDockerInDocker": { "enabled": true, "detectInsecureDaemon": true }, "reusableWorkflowsMustNotInheritSecrets": { "enabled": true }, "securityJobsMustNotBeWeakened": { "enabled": true, "securityJobPatterns": [ "*codeql*", "*dependency-review*", "*trufflehog*", "*gitleaks*", "*osv-scanner*", "*-sast", "*-sast-*", "*-scan", "*scan*", "*-security", "*-security-*", "*-audit", "*-audit-*" ], "allowFailureMustBeFalse": { "enabled": true }, "rulesMustNotBeRedefined": { "enabled": true }, "whenMustNotBeManual": { "enabled": true } }, "pipelineMustNotExecuteUnverifiedScripts": { "enabled": true, "trustedUrls": [] }, "workflowMustNotInjectUserInputInScripts": { "enabled": true }, "workflowMustNotUseDangerousTriggers": { "enabled": true }, "workflowsMustDeclarePermissions": { "enabled": true }, "workflowMustNotGrantPermissionsWriteAll": { "enabled": true }, "workflowMustIncludeRequiredActions": { "enabled": false } } }}}A few things to keep in mind
- All published scores are public
- The score always reflects the latest analysis on your default branch
- Publishing never fails your pipeline: if the push doesn’t go through, your analysis still succeeds
How to publish with GitHub
- Add the GitHub Action to your workflow with the correct workflow
permissionsandscore-pushenabled in the actionpermissions:contents: readsecurity-events: writeid-token: writejobs:plumber:steps:- uses: getplumber/plumber@ec8cb3a7edd6a324b33e85109b627b2df6023d94 # pinned plumber version: v0.7.23with:score-push: true - Add a badge in your
README.md(replaceOWNERandREPO)[](https://score.getplumber.io/github.com/OWNER/REPO)
How to publish with GitLab
- Add the GitLab CI component to your
.gitlab-ci.ymlwith thescore_pushinput enabledinclude:- component: gitlab.com/getplumber/plumber/plumber@9c5cf80845a125494764d1531994e3ce1fbf3534 # pinned plumber version: v0.7.23inputs:score_push: true - Add a badge in your repo: Settings → General → Badges
- Link:
https://score.getplumber.io/gitlab.com/%{project_path} - Badge image URL:
https://score.getplumber.io/gitlab.com/%{project_path}.svg
- Link:
Gate your CI on the score
The score is what passes or fails a plumber analyze run (exit code 1 on failure).
--min-score <A-E>is the main gate: the run fails when the letter is below the one you set.--min-score Bfails on C, D, E.--min-points <0-100>is the fine-grained variant for gating on exact points. Without any flag, the default is 100 points: any finding fails.- Set both and both must pass.
plumber analyze --min-score BThe same gate is available as min-score / min-points inputs on the GitHub Action and min_score / min_points on the GitLab component. The legacy --threshold flag (percentage of passing controls) is deprecated: it still works with a warning, and its old default is equivalent to the default score gate.