docs(rbac): document Custom RBAC Roles - #15359
Merged
Merged
Conversation
DefectDojo Pro can now build roles from individual permissions, with the five built-in roles becoming locked, clonable presets. Document that, and correct the existing role docs that describe the five roles as the whole model. - Add admin/user_management/PRO__custom_rbac_roles.md: enabling the feature, who can manage roles, the Roles table, cloning vs starting from scratch, all four permission groups, the grid legend and the View/Manage gate rule, assignment surfaces, how custom global roles map onto the built-in tiers, role history, and the API. - Reframe the built-in roles as locked presets in the permissions overview and the permission charts, and document the union rule for a user holding more than one role on the same object. - Link the new page from the User Management section index.
Contributor
Author
|
[sc-13957] Tracked in Shortcut: https://app.shortcut.com/defectdojo/story/13957 |
Maffooch
approved these changes
Jul 27, 2026
devGregA
approved these changes
Jul 27, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
DefectDojo Pro's RBAC is no longer a fixed set of five roles. Customers can
create their own roles by choosing individual permissions, and the five
built-ins (Reader / Writer / Maintainer / Owner / API Importer) become locked,
clonable presets. This documents the new surface and corrects the existing
role docs, which describe the five roles as the entire model.
Changes
New guide:
admin/user_management/PRO__custom_rbac_roles.mdavailable while it is off (the Roles list remains readable)
Global Feature Permissions (global-role only), and the Additional
Permissions checklist
shaded cells, inherited-View markers, and check/cross icons mean
reassignment via the API
why Owner can never be earned that way
semantics, dropdown limit, propagation delays)
and the read-only permission view
Corrected framing in the existing role docs
locked presets that can be cloned, and the multiple-roles section documents
the union rule, which was not written down anywhere
the definition of the model
Notes
bugfixso the docs land alongside the release that introducescustom roles.
description, which had drifted: the gate is a feature-registry flag rather
than a model column, there are three permission tables rather than two, the
standalone permission list changed, Risk Acceptance is now a normal object
row, and delete-with-reassign is API-only rather than exposed in the UI.