- 5 minutes to read

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

Assign the Order-to-Cash Diagram Set to a Role with Access only, then open it as a member of that Role, read-only, animated walkthrough (7.12)
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

flowchart LR User["fa:fa-user User"] --> Role["fa:fa-user-shield Role"] Role --> Access["fa:fa-folder-open Access
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)

Role editor C4 Set Permissions tab after Save, with Global permissions for C4 Diagram Sets and Logging, and one assigned C4 Diagram Set with Access Allow and Modify Inherited (7.12)
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:

  1. Open Administration > Roles, open the Role, and select the C4 Set Permissions tab.
  2. Click Edit. The Assign C4 Diagram Sets to Role dialog has the tabs All and Selected, a filter, and a Tag filter.
  3. 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.
  4. 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