- 6 minutes to read

Permission Set for C4 Diagram Sets

Use role-based permissions to control how users interact with C4 Diagram Sets in Nodinite. A C4 Diagram Set holds the Architecture Diagrams for one software system, so the Role decides who can create new sets, who can open a set, and who can change it.

Role editor of Order-to-Cash: Architecture Maintainers, which holds the Repository read rights C4 needs: C4 Set Permissions, Edit, tick Order-to-Cash: operations architecture, Selected, Modify Allow, Confirm and close, Global permissions C4 Diagram Sets Modify left Inherited, Save; then, as a member of the Role, the set opens with Edit and no New Diagram, and Edit, a new description and Save end on Diagram Set Order-to-Cash: operations architecture is now saved, animated walkthrough (7.12)
Animated walkthrough: give a Role Access and Modify on one Diagram Set, with no Modify in Global permissions, then, as a member of the Role, edit that set. The member sees Edit but no New Diagram, which needs Create. The Role also holds the Repository rights a C4 diagram needs.

Understanding the Permission Model

The permission set has two scopes. Global permissions apply to every C4 Diagram Set and hold the only Create right. Per-set assignments grant Access or Modify on individual sets.

Tip

To let a Role edit one set only, give it per-set Modify on that set. A member then gets Edit on that set's page, and can update, delete, and restore it through the Web API. Global Modify instead lets a member change every set the Role has Access to. A Deny on either scope wins. The With Selected batch actions on the Diagram Sets and All Diagrams lists, and Component Types, need global Modify.

flowchart LR Role["fa:fa-user-shield Role"] --> Global["fa:fa-globe Global permissions
C4 Diagram Sets row"] Role --> PerSet["fa:fa-sitemap Per-set assignments
C4 Set Permissions"] Role --> Logging["fa:fa-waveform-lines Logging
global"] Global --> GA["fa:fa-lock Access"] Global --> GC["fa:fa-file-plus Create
Create C4 Diagram Sets"] Global --> GM["fa:fa-file-pen Modify"] PerSet --> SA["fa:fa-lock Access"] PerSet --> SM["fa:fa-file-pen Modify"] style Global fill:#2678BD,color:#fff style PerSet fill:#3F827B,color:#fff style GC fill:#E47528,color:#fff

Blue = global permissions, teal = per-set assignments, orange = the Create right, which exists only at global scope.

Permissions in the Set

Permission Global (C4 Diagram Sets row) Per assigned set What it unlocks
Access ✅ Yes ✅ Yes Open and view the set and its diagrams. The set-level value can inherit from the global value.
Create (Create C4 Diagram Sets) ✅ Yes ❌ No Create new C4 Diagram Sets, and Import diagrams: the Import button only appears for users with this right, and the import apply step on the server requires it too. New 7.12 Every new Draft needs it too: Clone as Draft, the next layer, Create Container Draft and Create Component Draft in the designer, and the assistance panel's Create Draft to apply.
Modify ✅ Yes ✅ Yes Change existing sets and their diagrams, and New 7.12 Delete, Restore, and Permanently Delete sets and diagrams, live or deleted. C4 is user content, so no Administrator Role is needed (see Two delete models).
Logging (own row, Access column) ✅ Yes ❌ No Use grouped-log dynamic diagram entry points (Inspect Grouped Log Views as Runtime Diagrams).

The values follow the standard Nodinite model: Inherited, Allow, or Deny, where a Deny always wins (see Permission Set for the Repository Model).

Repository Rights C4 Also Needs

New 7.12 A C4 diagram shows and changes Repository items, so the C4 Diagram Set rights alone aren't enough. The user's Role also needs these rights in the Permission Set for the Repository Model:

To Also needs, besides the C4 Diagram Set right
Open, view, or export a diagram, and the grouped Log View's runtime diagram Access on Systems, Services, Integrations, Message Types, Endpoints, and Domains, plus Contracts when Contracts are on
Design: save in the Designer, delete diagrams, next layer, Generate from Integration Landscape, C4 Dynamic on the BPM page, clone, promote The read rights above, plus Create and Modify on Systems, Services, Integrations, and Domains (plus Contracts)
Import diagrams The design rights above, plus Create on Systems, Services, and Domains. Import is refused before the wizard opens

Without the read rights, opening a diagram answers 403 Forbidden with C4 needs more Repository rights and one line per missing right. The Diagram Sets list and the sidebar still load. A design or import click without its rights answers with the same message, naming the missing read and create rights. Generate and C4 Dynamic check their rights before they make a new set.

A C4 reader with read access to Systems only: the Order-to-Cash Demo set opens, Import is refused before the wizard with the missing rights, and opening the System Landscape shows 403 Forbidden with one line per missing right, animated walkthrough (7.12)
Animated walkthrough: a Role with read access to Systems only. The set still opens; Import and the diagram each name the Repository rights that are missing. An administrator adds them to the user's Role, and then the diagram opens.

The Import refusal on a Diagram Set page: 403 Forbidden, C4 needs more Repository rights, the read access and the create access the user needs, and Ask an Administrator to add them to one of your Roles (7.12)
The Import refusal lists the missing read rights and the missing create rights.

Where to Find the Create Right

Create is a global right only, because a set that doesn't exist yet can't be assigned to a Role:

  1. Open the Role in the Role editor (Add or manage Role).
  2. Select the C4 Set Permissions (x) tab and find Global permissions.
  3. In the C4 Diagram Sets row, set the Create column, next to Access and Modify. The Logging right is the row below it, with only an Access column.

Role editor C4 Set Permissions tab after Save, with Global permissions for C4 Diagram Sets and Logging, and the assigned set Contoso O2C Operations with Access Allow and Modify Inherited (7.12)
The C4 Set Permissions (1) tab of the Contoso: Architecture Readers Role, right after Save: Access, Create, and Modify on the C4 Diagram Sets row and Access on the Logging row under Global permissions; below, the assigned sets with Access and Modify, and Edit to change them.

The per-set list, and the assignment modal behind Edit, has only Access and Modify. Looking for Create there is the most common reason administrators believe the right is missing.

For API and audit work, the rights use these permission object types:

Right Permission object type
Access C4 Diagram Sets 550
Create C4 Diagram Sets 5600
Modify C4 Diagram Sets 5601
  • Grant Access to architecture consumers.
  • Grant Modify to the architects and maintainers who keep the diagrams current. To limit them to some sets, give Modify per set instead of globally (see the tip above).
  • Grant Create only to the few Roles that set up new Diagram Sets or Import diagrams.
  • Grant Logging to users who need grouped-log dynamic diagram capabilities.
  • Review assignments regularly so only required Roles have Create and Logging enabled.

Role Assignments

In the Role editor, administrators use C4 Set Permissions (x) to manage set assignments and permission values:

  • The value x shows the number of assigned C4 Diagram Sets.
  • Use the Edit flow to add or remove C4 Diagram Sets from the Role: tick the sets, open Selected, set Access and Modify for each, Confirm and close, then Save. Values set on a set ticked in the same visit are saved.
  • Configure Create and Logging at global scope.

The DefaultRolesInViews System Parameter pre-selects Roles on every new C4 Diagram Set New 7.6; you still set their Access and Modify values here.

Logging and Grouped-Log Dynamic Diagrams

When Logging is not allowed for a user's Role, grouped-log dynamic diagram entry points are hidden for that user. Grant Logging only to Roles that should use this capability.

Next Steps