Skip to main content

Step 2 — Role

For the full editor reference, see the Role Editor.

Connecting to the Privileges from Step 1

In Step 1 we created three privileges:

PrivilegeDescription
submit_recordCreate a new record
approve_recordApprove
view_recordView

In this step we define two roles and distribute the privileges:

RolePrivileges
Makersubmit_record + view_record
Checkerapprove_record + view_record
info

view_record is in both — both must be able to see the record. Only the approve/create permission differs.

Step by Step

1. Add New → New Role

From + Add New, click New Role. Name the model — usually roles.

info

As with privileges, this is the role collection name, not the role itself. An application can hold several role collections.

Create New Role dialog

Confirm with CREATE → the empty Role Editor opens.

2. Add the first role (Maker)

In the list view, press ADD NEW → the role detail page opens. It has these sections:

SectionWhat to enter
Role NameThe unique role name (Maker)
Parent RoleThe parent to inherit from (optional — left empty here)
RBAC SetResource-based CRUD permissions (left empty in this example)
PrivilegesThe privileges assigned to this role

For Maker:

  1. Type Maker into Role Name.
  2. Under Privileges, press ADD NEW.
  3. From the Select Privilege dropdown, choose submit_record.
  4. Press ADD NEW again and choose view_record for the second row.

Maker role detail — privileges assigned

  1. Press DONE → you return to the list view; the "Maker" row appears.

3. Add the second role (Checker)

Repeat the same steps:

  1. Press ADD NEW again → an empty detail page opens.
  2. Role Name = Checker.
  3. Add approve_record + view_record under Privileges.

Checker role detail — privileges assigned

  1. DONE → back to the list.

4. Save

Click the disk icon in the toolbar, enter a short summary, and confirm with SAVE CHANGES. Both Maker and Checker now appear side by side.

Role list — saved

Good to Know

  • Parent Role. If filled in, the parent's privileges/RBAC are inherited and the child adds its own. We did not use a parent here because Maker and Checker do different jobs — no common ancestor.
  • RBAC Set is covered in Step 7. In this example all access is distributed through privileges only, which is simpler.
  • The privilege dropdown fills automatically from the privileges defined in Step 1 (you must have saved the privilege model first).
  • Renaming a role updates the personas and swimlanes that reference it. Check the usages before renaming.

So Far in Our Scenario

  • ✅ 3 privileges (Step 1)
  • ✅ 2 roles: Maker and Checker (Step 2)

No user is bound to these roles yet. That is the job of the Persona, next.