Role design principles
Good roles are:- Named for job responsibility.
- Easy to explain.
- Narrow enough to review.
- Broad enough to avoid one-off exceptions for every user.
- Reviewed when features, teams, or responsibilities change.
Create or edit a role
Review impact
Pay special attention to permissions that affect users, security, integrations, organization settings, or shared content.
Permission review questions
Ask these questions before granting access:- Does this role need to view the area?
- Does this role need to create or edit content there?
- Does this role need to delete or archive content?
- Does this role need to manage other users?
- Does this role need to configure organization settings?
- Does this role need connected app administration?
- Does this role need Security Center access?
Orchestration sharing and publishing
Orchestration sharing can be controlled through organization settings and role permissions.| Permission or role | Use it for |
|---|---|
| Share Orchestrations | Let a user share owned Orchestrations when unrestricted sharing is off. |
| Publish Orchestrations | Let a user publish owned Orchestrations to the organization. |
| Publisher | Grant operational publishing access, including Orchestration sharing and publishing. |
Role security policy
Each role can have its own security policy. Use these controls when different user groups need different sign-in or session requirements.| Control | What it does |
|---|---|
| Require users to enroll a passkey | Requires users in the role to set up a passkey before using Sofie normally. |
| Require passkey after magic-link sign-in | Requires a passkey challenge after magic-link sign-in for users in the role. Users without a passkey are sent to Account > Security to enroll one. |
| Idle auto logout | Signs users out after inactivity for the role. Leave it Off to use the current default session behavior. |
15m, 30m, 1h, 4h, 8h, and 24h. Custom values must be between 15 minutes and 24 hours.
System roles cannot be renamed, deleted, or have their permission set changed from Role Management. Administrators can still update the role security policy for system roles when they have permission to edit roles.
Privileged roles
A privileged role can affect other users, security, organization settings, or connected app behavior. Privileged roles should usually:- Have a named owner.
- Require passkeys if your organization uses that policy.
- Use stricter magic-link or idle auto logout controls when your identity policy requires them.
- Be assigned to a small number of users.
- Be reviewed on a regular cadence.
- Be removed when the user no longer needs the access.
Roles versus Workspace membership
Roles control product capabilities. Workspace membership controls access to a specific Workspace. Example:| Need | Use |
|---|---|
| User can create Workspaces | Role permission. |
| User can access one project Workspace | Workspace membership. |
| User can manage all users | Admin role permission. |
| User can review one CoDraft | Share the CoDraft or Workspace. |
Role maintenance
Review roles when:- A new feature is enabled.
- An admin leaves or changes responsibility.
- A group starts using Sofie differently.
- A passkey policy changes.
- A magic-link or idle auto logout policy changes.
- Security review identifies stale access.
- You consolidate duplicate roles.