- Standards adherence dashboard
- Compliance violations report
- Compliance frameworks report
Compliance center
Renamed from Compliance report in GitLab 16.3.
See report and manage standards adherence, violations, and compliance frameworks for the group
Standards adherence dashboard
-
Introduced GraphQL APIs in GitLab 16.2 with a flag named
compliance_adherence_report
. Disabled by default. -
Introduced standards adherence dashboard in GitLab 16.3 with a flag named
adherence_report_ui
. Disabled by default.
compliance_adherence_report
and adherence_report_ui
. On GitLab.com, this feature is not available.
This feature is not ready for production use.Standards adherence dashboard lists the adherence status of projects complying to GitLab standard.
View the standards adherence dashboard
Prerequisites:
- You must be an administrator or have the Owner role for the group.
To view the standards adherence dashboard for a group:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
GitLab standard
GitLab standard consists of three rules:
- Prevent authors as approvers.
- Prevent committers as approvers.
- At least two approvals.
Prevent authors as approvers
To comply with GitLab standard, you must prevent users from approving their own merge requests. For more information, see Prevent approval by author.
On self-managed GitLab, when instance-level setting for prevent approval by author is updated, the adherence status for all the projects on the instance is not updated automatically. To update the adherence status for these projects, the group-level or the project-level setting must be updated.
Prevent committers as approvers
To comply with GitLab standard, you must prevent users from approving merge requests where they’ve added commits. For more information, see Prevent approvals by users who add commits.
On self-managed GitLab, when instance-level setting for prevent approvals by users who add commits is updated, the adherence status for all the projects on the instance is not updated automatically. To update the adherence status for these projects, the group-level or the project-level setting must be updated.
At least two approvals
To comply with GitLab standard, you must have at least two users approve a merge request to get it merged. For more information, see Merge request approval rules.
Compliance violations report
- Introduced in GitLab 12.8 as Compliance Dashboard.
- Compliance violation drawer introduced in GitLab 14.1.
- Renamed to compliance report in GitLab 14.2.
-
Replaced by merge request violations in GitLab 14.6 with a flag named
compliance_violations_report
. Disabled by default. - GraphQL API introduced in GitLab 14.9.
-
Generally available in GitLab 14.10. Feature flag
compliance_violations_report
removed. - Renamed to compliance violations report in GitLab 15.9.
- Ability to create and edit compliance frameworks introduced in GitLab 16.0.
With compliance violations report, you can see a high-level view of merge request activity for all projects in the group.
When you select a row in the compliance report, a drawer appears that provides:
- The project name and compliance framework label, if the project has one assigned.
- A link to the merge request that introduced the violation.
- The merge request’s branch path in the format
[source] into [target]
. - A list of users that committed changes to the merge request.
- A list of users that commented on the merge request.
- A list of users that approved the merge request.
- The user that merged the merge request.
View the compliance violations report for a group
Target branch search introduced in GitLab 16.0.
Prerequisites:
- You must be an administrator or have the Owner role for the group.
To view the compliance violations report:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
You can sort the compliance report on:
- Severity level.
- Type of violation.
- Merge request title.
You can filter the compliance violations report on:
- Project.
- Date range of merge.
- Target branch.
Select a row to see details of the compliance violation.
Severity levels
Each compliance violation has one of the following severities.
Icon | Severity level |
---|---|
Critical | |
High | |
Medium | |
Low | |
Info |
Violation types
From GitLab 14.10, these are the available compliance violations.
Violation | Severity level | Category | Description |
---|---|---|---|
Author approved merge request | High | Separation of duties | Author of the merge request approved their own merge request. For more information, see Prevent approval by author. |
Committers approved merge request | High | Separation of duties | Committers of the merge request approved the merge request they contributed to. For more information, see Prevent approvals by users who add commits. |
Fewer than two approvals | High | Separation of duties | Merge request was merged with fewer than two approvals. For more information, see Merge request approval rules. |
The following are unavailable compliance violations that are tracked in epic 5237.
Violation | Severity level | Category | Description |
---|---|---|---|
Pipeline failed | Medium | Pipeline results | Merge requests pipeline failed and was merged. |
Pipeline passed with warnings | Info | Pipeline results | Merge request pipeline passed with warnings and was merged. |
Code coverage down more than 10% | High | Code coverage | Code coverage report for the merge request indicates a reduction in coverage of more than 10%. |
Code coverage down between 5% to 10% | Medium | Code coverage | Code coverage report for the merge request indicates a reduction in coverage of between 5% to 10%. |
Code coverage down between 1% to 5% | Low | Code coverage | Code coverage report for the merge request indicates a reduction in coverage of between 1% to 5%. |
Code coverage down less than 1% | Info | Code coverage | Code coverage report for the merge request indicates a reduction in coverage of less than 1%. |
Separation of duties
GitLab supports a separation of duties policy between users who create and approve merge requests. Our criteria for the separation of duties is:
- A merge request author is not allowed to approve their merge request.
- A merge request committer is not allowed to approve a merge request they have added commits to.
- The minimum number of approvals required to merge a merge request is at least two.
Chain of Custody report
- Introduced in GitLab 13.3.
- Chain of Custody reports sent using email introduced in GitLab 15.3 with a flag named
async_chain_of_custody_report
. Disabled by default. -
Generally available in GitLab 15.5. Feature flag
async_chain_of_custody_report
removed. - Chain of Custody report includes all commits (instead of just merge commits) introduced in GitLab 15.9 with a flag named
all_commits_compliance_report
. Disabled by default. -
Generally available in GitLab 15.9. Feature flag
all_commits_compliance_report
removed.
The Chain of Custody report provides a 1 month trailing window of all commits to a project under the group.
To generate the report for all commits, GitLab:
- Fetches all projects under the group.
- For each project, fetches the last 1 month of commits. Each project is capped at 1024 commits. If there are more than 1024 commits in the 1-month window, they are truncated.
- Writes the commits to a CSV file. The file is truncated at 15 MB because the report is emailed as an attachment (GitLab 15.5 and later).
The report includes:
- Commit SHA.
- Commit author.
- Committer.
- Date committed.
- Group.
- Project.
If the commit has a related merge commit, then the following are also included:
- Merge commit SHA.
- Merge request ID.
- User who merged the merge request.
- Merge date.
- Pipeline ID.
- Merge request approvers.
Generate Chain of Custody report
To generate the Chain of Custody report:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
- Select List of all merge commits.
Depending on your version of GitLab, the Chain of Custody report is either sent through email or available for download.
Generate commit-specific Chain of Custody report
- Introduced in GitLab 13.6.
- Support for including all commits instead of only merge commits added in GitLab 15.10.
You can generate a commit-specific Chain of Custody report for a given commit SHA. This report provides only the details for the provided commit SHA.
To generate a commit-specific Chain of Custody report:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
- At the top of the compliance report, to the right of List of all commits, select the down arrow ().
- Enter the commit SHA, and then select Export commit custody report.
Depending on your version of GitLab, the Chain of Custody report is either sent through email or available for download.
Alternatively, use a direct link: https://gitlab.com/groups/<group-name>/-/security/merge_commit_reports.csv?commit_sha={optional_commit_sha}
,
passing in an optional value to the commit_sha
query parameter.
Compliance frameworks report
Introduced in GitLab 15.10.
With compliance frameworks report, you can see the compliance frameworks that are applied to projects in a group. Each row of the report shows:
- Project name.
- Project path.
- Compliance framework label if the project has one assigned.
The default framework for the group has a default badge.
View the compliance frameworks report for a group
Prerequisites:
- You must be an administrator or have the Owner role for the group.
To view the compliance frameworks report:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
- On the page, select the Frameworks tab.
Apply a compliance framework to projects in a group
- Adding compliance frameworks using bulk actions introduced in GitLab 15.11.
- Adding compliance frameworks without using bulk actions introduced in GitLab 16.0.
You can apply a compliance framework to projects in a group.
Prerequisites:
- You must have the Owner role for the group.
To apply a compliance framework to one project in a group:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
- On the page, select the Frameworks tab.
- Next to the project you want to add the compliance framework to, select Add framework.
- Select an existing compliance framework or create a new one.
To apply a compliance framework to multiple projects in a group:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
- On the page, select the Frameworks tab.
- Select multiple projects.
- From the Choose one bulk action dropdown list, select Apply framework to selected projects.
- Select framework to apply.
- Select Apply.
Remove a compliance framework from projects in a group
- Removing compliance frameworks using bulk actions introduced in GitLab 15.11.
- Removing compliance frameworks without using bulk actions introduced in GitLab 16.0.
You can remove a compliance framework from projects in a group.
Prerequisites:
- You must have the Owner role for the group.
To remove a compliance framework from one project in a group:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
- On the page, select the Frameworks tab.
- Next to the compliance framework to remove from the project, select on the framework label.
To remove a compliance framework from multiple projects in a group:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
- On the page, select the Frameworks tab.
- Select multiple projects.
- From the Choose one bulk action dropdown list, select Remove framework from selected projects.
- Select Remove.
Export a report of merge request compliance violations on projects in a group
Introduced in GitLab 16.4 with a flag named compliance_violation_csv_export
. Disabled by default.
compliance_violation_csv_export
. On GitLab.com, this feature is not available. The feature is not ready for production use.Export a report of merge request compliance violations on merge requests belonging to projects in a group. Reports:
- Do not use filters on the violations report.
- Are truncated at 15 MB so the email attachment is not too large.
Prerequisites:
- You must be an administrator or have the Owner role for the group.
To export a report of merge request compliance violations for projects in a group:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
- On the page, select the Violations tab.
- On the Violations tab, select the Export full report as CSV action in the top right corner
A report is compiled and delivered to your email inbox as an attachment.
Export a report of compliance frameworks on projects in a group
Introduced in GitLab 16.0.
Export a report of compliance frameworks that are applied to projects in a group. Reports:
- Do not use filters on the framework report.
- Are truncated at 15 MB so the email attachment too large.
Prerequisites:
- You must be an administrator or have the Owner role for the group.
To export a report of compliance frameworks on projects in a group:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
- On the page, select the Frameworks tab.
- On the Frameworks tab, select the Export as CSV action in the top right corner
A report is compiled and delivered to your email inbox as an attachment.
Filter the compliance frameworks report
Introduced in GitLab 15.11.
To filter the list of compliance frameworks:
- On the left sidebar, select Search or go to and find your group.
- On the left sidebar, select Secure > Compliance center.
- On the page, select the Frameworks tab.
- In the search field:
- Select the attribute you want to filter by.
- Select an operator.
- Select from the list of options or enter text for the search.
- Select Search ().
Repeat this process to filter by multiple attributes.