Role-Based Access for C4 Diagram Sets
Use this guide to align C4 Diagram Set permissions with the standard Nodinite role model. A C4 Diagram Set holds the Architecture Diagrams for one software system, so who can open it, and who can open runtime diagrams from grouped Log Views, is a governance decision made through Roles.
- Keep architecture governance consistent with existing Roles and permission sets
- Control who can access and modify assigned C4 Diagram Sets
- Control who can create new sets and import diagrams
- Control who can use grouped-log dynamic diagram features
- Keep assignment and permission handling consistent with the Manage Role workflow

Animated walkthrough: in the Role editor, a Diagram Set of the Order-to-Cash demo is assigned to a Role with Access, and a member of that Role then sees the set and its diagrams without Edit, New Diagram, or Designer.
Understanding the Permission Model for C4 Diagram Sets
global and per assigned set"] Role --> Modify["fa:fa-file-pen Modify
global and per assigned set"] Role --> Create["fa:fa-file-plus Create
global only"] Role --> Logging["fa:fa-waveform-lines Logging
global"] Access --> Sets["fa:fa-sitemap C4 Diagram Sets"] Modify --> Sets Create --> NewSets["fa:fa-file-import New sets and Import"] Logging --> Runtime["fa:fa-route Grouped-log dynamic diagrams"]
Rights are evaluated through the user's Roles: Access and Modify control the sets, Create controls new sets and Import, and Logging controls the grouped-log dynamic diagram entry points.
The C4 permission set uses the same role-based model as other repository features. Rights are evaluated through assigned Roles. Permission Set for C4 Diagram Sets is the full reference, including the permission object types.
| Permission | Scope | Recommendation |
|---|---|---|
| Access | Global and per assigned C4 Diagram Set | Grant to architecture consumers and maintainers |
| Modify | Global and per assigned C4 Diagram Set | Grant to the architects who maintain the diagrams |
| Create (Create C4 Diagram Sets) | Global only | Grant only to Roles that create Diagram Sets or Import diagrams |
| Logging | Global | Grant only to users who need grouped-log dynamic diagram capabilities (Inspect Grouped Log Views as Runtime Diagrams) |

The C4 Set Permissions tab in the Role editor: Access, Create, and Modify on the C4 Diagram Sets row and Access on the Logging row under Global permissions, with the per-set assignments below.
The Global Create Right
Create C4 Diagram Sets lives only under Global permissions on the C4 tab of the Role editor, in the Create column of the C4 Diagram Sets row, next to Access and Modify. It is not in the per-set assignment modal, which has only Access and Modify, because a set that doesn't exist yet can't be assigned.
The right gates Import twice: the Import button is shown only to users who have it, and the server rejects the import apply step without it, so API callers can't bypass it.
Assignment Workflow in Manage Role
Administrators assign C4 Diagram Sets from the C4 Set Permissions (x) tab in the Role editor (Add or manage Role):
- The tab count x shows how many C4 Diagram Sets are assigned to the Role.
- Access and Modify are evaluated per assigned set (inheriting from the global value), while Create and Logging are evaluated at global scope.
To give a Role read-only access to a set:
- Open Administration > Roles, open the Role, and select the C4 Set Permissions tab.
- Click Edit. The Assign C4 Diagram Sets to Role dialog has the tabs All and Selected, a filter, and a Tag filter.
- Filter on the set, tick it, and click Confirm and close. The tab lists the set with Access Allow and Modify Inherited, so the Role can't change it.
- Click Save.
A member of the Role now opens the set without Edit and New Diagram, and its diagrams without Edit and Designer. The Role also needs Access on C4 Diagram Sets under Global permissions, and Repository Access (Permission Set for the Repository Model); without Repository Access the Repository menu isn't there. Monitoring on the diagrams follows the member's Monitor View rights: without them, Service nodes show no state pills (Monitoring).
Logging Behavior
Logging permission controls whether users can access grouped-log dynamic diagram capabilities linked to C4 Diagram Sets. Keep this permission limited to Roles that need these log-driven diagram actions.
The Logging right is not about the Log Audits. Every change to a C4 Diagram Set writes a Log Audit entry; reading and exporting write none:
| Written to the Log Audits | Not written |
|---|---|
| Diagram Set: create, edit, delete, restore, permanently delete | Opening a set or a diagram, in the interactive or Mermaid view |
| Diagram: create, edit, delete or permanently delete, Promote | Show in Mermaid, Show in Mapify (Mapify) |
| Nodes, connectors, boundaries, and diagram links: add, change, remove (Designer, Import, Sync, Apply Selected) | Export in any format, single or ZIP, Print, Copy Mermaid source |
| Roles assigned to a set, Custom Metadata on a diagram | Coverage, Impact Inbox, AI questions |
| Diagram Assistance review states (Dismiss, Snooze, Intentional) |
Default Role Assignment on New Sets
From Nodinite 7.6.0 and later, new Diagram Sets can inherit default roles through DefaultRolesInViews. This helps administrators apply a baseline access model when sets are created.
Use this together with the C4 Diagram Set permission set to avoid manual post-creation access fixes.
Next Steps
- Permission Set for C4 Diagram Sets
- Add or manage C4 Diagram Set
- Generate from Integration Landscape
- Import