Help Center/Governance, RBAC & Security Desk/How to assign a role to a subject (user DID)
Governance, RBAC & Security Desk•Last updated: 2026-10-20•3 min read

How to assign a role to a subject (user DID)

The "Assign Role" form bridges a DID to a role with a scope and optional expiry date.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open Assignments

Go to /admin/rbac/assignments (heading "Role Assignments").

2

Click "Assign Role"

The dialog "Assign Role" opens.

3

Enter the subject

Type the full DID in "Subject DID" (placeholder did:i8:...).

4

Select the role

Pick from the "Role" dropdown ("Select a role…", entries shown as "Name (roleKey)").

5

Set scope and expiry

"Scope" is a dropdown of the valid data scopes (GLOBAL, TENANT, WORKSPACE, OWN and so on) and defaults to TENANT; "Valid Until" is an optional end date.

6

Assign

Click "Assign". The button shows "Assigning…" and the new row appears with status ACTIVE.

Expected Operational Outcome

The assignment is recorded with the chosen scope and optional end date, and written to the governance audit chain. Assignments are a governance registry: the roles a member signs in with are the roles on the member record (All Members).

Troubleshooting & Failure Modes

Symptom: Subject DID and role are required.
Likely Cause: One of the two fields is empty.
Resolution: Fill both.
Symptom: Cannot assign unknown role "x"
Likely Cause: The role key no longer exists.
Resolution: Choose a role from the list.

Was this guide helpful?

Help us refine our platform documentation