- Issues
- ISSUE-505
CI/CD provider
Branch protection configuration not compliant
Control:CTRL-501Branch must be protected
📋 What is this?
The branch protection configuration does not meet the security requirements defined in your Policy controls. The branch settings allow unauthorized access levels, force push capabilities, or bypass code owner approval requirements.
⚠️ Impact
Misconfigured branch protection settings can lead to unauthorized code changes, security vulnerabilities, and policy violations. This includes risks such as loss of commit history through force push, unauthorized code merges, and direct pushes to protected branches without proper validation.
🔧 How to fix
Update the branch protection settings to match your Policy controls requirements by enforcing proper access controls, disabling force push, and requiring code owner approvals for all changes.
# GitLab settings - ❌ Protection exists but is too permissive# Branch: main# Allowed to push: Developers + Maintainers (too permissive)# Allow force push: Yes (dangerous)# Code owner approval required: No (missing review)
# Required by the policy:# minPushAccessLevel: 40 (Maintainer only)# allowForcePush: false# codeOwnerApprovalRequired: true# GitLab settings: ✅ Protection meets requirements# Branch: main# Allowed to merge: Developers + Maintainers# Allowed to push: Maintainers only# Allow force push: No# Code owner approval required: Yes💡 Tips
- Plumber checks each setting independently - the output shows exactly which settings violate the policy.
- Access levels: 0 = No one, 30 = Developer, 40 = Maintainer.
- Force push should almost always be disabled on production branches.
⚙️ Configure this control
On the Plumber Platform: open the Policies page and set control CTRL-501 on the policy that governs the project.
With the CLI alone: set it in your configuration file. Every field and default is in the controls configuration reference, CTRL-501.
Branch protection configuration not compliant
Control:CTRL-501Branch must be protected
📋 What is this?
A protected branch exists but the effective settings, after merging classic Branch Protection and every Repository or Organization Ruleset covering the branch, don't match the policy. Force-push may still be allowed, code-owner approval may be missing, or required status checks may be absent.
⚠️ Impact
A protected-but-misconfigured branch creates a false sense of safety. Reviewers see the green check, the workflow runs, and the UI shows a protection rule, but a critical safeguard (force-push prevention, code-owner review, required checks) is disabled in practice.
🔧 How to fix
Update whichever source carries the offending setting (the classic rule, a Repository Ruleset, or an inherited Organization Ruleset) so the merged effective configuration matches the policy. Every setting that violates the policy is listed individually in Plumber's output so you know exactly what to change.
# GitHub repo settings - ❌ Protection too permissive# Settings > Rules > Rulesets > `main` ruleset:# Block force pushes: OFF ← required by policy# Require pull request reviews: ON# Required approvals: 0 ← policy requires >= 1# Require review from Code Owners: OFF ← required by policy# GitHub repo settings: ✅ Settings match policy# Settings > Rules > Rulesets > `main` ruleset:# Block force pushes: ON# Require pull request reviews: ON# Required approvals: 1# Require review from Code Owners: ON💡 Tips
- Plumber reports each policy violation individually so you can see exactly what to change.
- Settings are checked against the merged effective configuration. A rule disabled in classic Branch Protection but enforced by a Ruleset is treated as enforced. Stricter wins.
- Force push should be disabled on every long-lived branch.
codeOwnerApprovalRequiredonly takes effect when aCODEOWNERSfile exists in the repository.
⚙️ Configure this control
On the Plumber Platform: open the Policies page and set control CTRL-501 on the policy that governs the project.
With the CLI alone: set it in your configuration file. Every field and default is in the controls configuration reference, CTRL-501.