You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/content/admin/user_management/about_perms_and_roles.md
+19Lines changed: 19 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -71,6 +71,7 @@ Superusers (Admins) have no limitations in the system. They can change all setti
71
71
72
72
By default, the first account created on a new DefectDojo instance will have Superuser permissions. That user will be able to edit permissions for all subsequent DefectDojo users. Only an existing Superuser can add another superuser, or add a Global Role to a user.
73
73
74
+
74
75
## Configuration Permissions
75
76
76
77
Configuration Permissions, although similar, are not related to Products or Roles. They must be assigned separately from Roles. **Regular****users do not have any Configuration Permissions by default, and assigning these configuration permissions should be done carefully.**
@@ -90,3 +91,21 @@ If users are part of a Group, they also have Group Configuration Permissions whi
90
91
If users create a new Group, they will be given the Owner role of the new Group by default.
91
92
92
93
For more information on Configuration Permissions, see our **[Configuration Permissions Chart](../user_permission_chart/#configuration-permission-chart)**.
94
+
95
+
## Manage default permissions
96
+
97
+
When a brand new user is created in DefectDojo — whether manually, via SAML / SSO, or via any social-auth provider — they have **no permissions by default**. They will see zero Product Types, zero Products, and zero Engagements when they first log in. They cannot view or interact with any data until a Superuser grants them access (directly, via a Global Role, via a Product / Product Type membership, or by adding them to a Group).
98
+
99
+
If you want every newly provisioned user to receive a baseline level of access automatically — for example, "every new SSO user should be a Reader on a particular group" — you can configure a **Default group** on the System Settings page.
100
+
101
+
1. Open **⚙️ Configuration → System Settings** (Superuser only).
102
+
2. Set **Default group** to the [User Group](../create_user_group/) that newly created users should join.
103
+
3. Set **Default group role** to the role they should hold in that group (e.g. **Reader**).
104
+
4. Optionally set **Default group email pattern** to a regex (e.g. `.*@yourcompany\.com$`) so the default group is only applied to users whose email matches.
105
+
5. Save.
106
+
107
+
Both **Default group** and **Default group role** must be set — if either is empty, the default group is not applied.
108
+
109
+
This setting applies to every user-creation path: manual creation, SAML, OAuth, and other social-auth providers. It is not applied retroactively — existing users will keep their current group memberships even if you change this setting later.
110
+
111
+
For SSO-specific guidance, see [SAML Configuration](/admin/sso/pro__saml/#default-access-for-sso-provisioned-users) or your provider's section under [SSO Configuration](../configure_sso/).
0 commit comments