Roles Overview

The Roles Overview, under Administration → Access Management → Roles in the Web Client, is where a Nodinite Administrator manages all Roles. A Role is a named set of permissions; Nodinite grants nothing to a user except through the Roles they belong to.

• ✅ One list of every Role in your installation
• ✅ Add, edit, delete, and restore Roles, and give them members
• ✅ Show a Role and its relations in Mapify or Mermaid
• ✅ Entry point to the four permission sets each Role holds

Animated walkthrough: a new Role with its first member, ready in the list.

1. Open Administration > Access Management > Roles. The list shows every Role.
2. Click Add Role, name the Role (Contoso: Order Desk), and describe who it is for.
3. Click Edit on the Users card, find CONTOSO\sarah.miller (the filter searches the user name, not the domain), tick the user, and click Confirm and close. The Users card lists the member.
4. Click Save and close. Filter the list on Contoso: the new Role is there.

A Windows AD Group is added the same way, on the Windows AD Groups card. The rights come next, on the permission tabs; see Add or manage Role.

Get started now: Add or manage Role. New to the concept? Read What is a Role? first.

Understanding Roles

Users, groups, or Policies are assigned to a Role, and the Role's permission sets decide which Log Views, Monitor Views, Repository Model entities, and C4 Diagram Sets its members can use.

Blue = who is assigned (Users, Windows AD Groups, or Policies, depending on the authentication mode), orange = the Role, teal = the permission sets on the Role.

The Roles List

The Roles Overview shows a sortable list of all Roles. Type in the Filter the result box to narrow a long list, and sort by Name, Created, or Changed. Check Include deleted to list deleted Roles too.

The Roles list in Windows Authentication mode. Roles have no With Selected menu, no Tags, and no Permanently Delete.

Manage Roles

The available functions are:

• Add new Role
• Edit an existing Role
• Show a Role in Mapify
• Show a Role in Mermaid
• Delete a Role
• Restore a deleted Role (Show deleted records)
• Filter and sort the list of Roles

Roles have no Duplicate, no Export, and no Copy API URI. To move Roles to another Nodinite environment, use the Web API.

Add new Role

Click the Add Role button to open the Role editor and create a new Role. The editor has the same button in its toolbar, next to Mapify, Mermaid, and Save.

The Add Role button sits above the list, to the right.

Edit Role

To Edit an existing Role, click the link in the Name column, or open the Action menu and click Edit.

The Action menu on each Role holds Edit, Show in Mapify, Show in Mermaid, and Delete (Restore on a deleted Role).

Show in Mapify

^{New 7.10}

To explore a Role and its relations as an interactive graph, open the Action menu and click Show in Mapify. This opens the Mapify Rendering view mode with the Role at the center. Requires Nodinite 7.10 or later and a Mapify license.

Show in Mapify sits between Edit and Show in Mermaid.

Show in Mermaid

To see the same relations as a static diagram, open the Action menu and click Show in Mermaid. This opens the Mermaid Rendering view mode, which needs no Mapify license and lets you print, export, or copy the Mermaid source.

Mermaid Rendering shows the same relations as Mapify Rendering, as a static diagram.

Delete Role

To Delete a Role, open the Action menu, click Delete, and confirm with Yes in Confirm intent to Delete. A deleted Role is kept and can be restored. The built-in Administrators Role can't be deleted.

Animated walkthrough: a delete you can take back, from the Action menu.

1. Filter the list on Contoso Temp.
2. Open the Action menu of Contoso Temp Role, click Delete, and confirm with Yes. The Role is gone from the list.
3. Check Include deleted. The Role is listed again, marked Deleted.
4. Open its Action menu, click Restore, and confirm with Yes.
5. Uncheck Include deleted. The Role is back in the list.

Delete is the last entry of the Action menu.

Restore deleted Role

To Restore a deleted Role, first check Include deleted (see Show deleted records); deleted Roles then appear in the list. Open the Action menu, click Restore, and confirm with Yes in Confirm intent to Restore.

On a deleted Role, Restore replaces Delete; Edit, Show in Mapify, and Show in Mermaid stay.

Frequently Asked Questions

How do I create a new Role?

Follow Add or manage Role, or the walkthrough at the top of this page.

How do I make a new Log View visible to a team by default?

Add the team's Role to the DefaultRolesInViews System Parameter. New Log Views, Monitor Views, and C4 Diagram Sets then get the Role pre-selected; existing ones don't change.

Why can't I edit the Administrators Role?

The built-in Administrators Role always has full access. Its name and description are read-only, and it can't be deleted; the Web API refuses both. You can change who is a member, on its Users and Windows AD Groups cards. Grant limited access with user-defined Roles instead.

Can I export Roles or copy their API URI?

No. Roles have no Export and no Copy API URI in 7.12. Read and create Roles with the Web API instead.

Next Steps

Add or manage Role
Permission Set for Log Views
Permission Set for Monitor Views
Permission Set for the Repository Model
Permission Set for C4 Diagram Sets

Related Topics

What is a Role?
Access Management
Users Overview
Windows AD Groups - Overview
Policies Overview
Log Views
Monitor Views
DefaultRolesInViews
Show deleted records
Mapify Rendering
Mermaid Rendering