Documentation › Users and roles

Users and roles: who can do what

In SerenForce, what you see and what you can do depends on your roles. A role is a set of permissions. The administrators of your organization give roles on the Users and roles page.

⏱ 4 minutes📍 Settings menu › Users and roles🎯 Result: give a role to a person

Signing in: where do you land?

On the SerenForce sign-in page, type your email address: SerenForce sends you to the right place.

The very first person who signs in to a new platform (personal or company address) lands in the default space and creates the first organization before entering: they administer that organization and can give roles to its members (see below). The default space itself is shared by everybody, so nobody becomes its administrator just by signing in first: only the people the platform names (or invites as administrators) are.

An invitation is recognized when you sign in with the address it was sent to. With a company address on the Shared space, your organization must also have proved to Microsoft that it owns the domain of the address; if the invitation does not appear, ask the person who invited you to check with your IT department.

Invited without a license? You sign in and belong to the space, but you stay inactive: a page Your access is not active yet offers you, with the Team plan, to buy your own license (Buy my license, then Check my access again after the payment) and, with every plan, to ask an administrator for one (Ask an administrator for a license: the administrators see your request at once). You get into the app as soon as you have a license. See Sign up and set up your organization.

Verification of your email address

Anybody can create an account somewhere and show any email address on it. SerenForce therefore trusts your address only when it is proven by whoever signs you in. An address counts as verified when:

A verified address gives you what was prepared for it: the invitation sent to that address (with its role), the administrator role if the platform named you, and the account you already have in the organization under the same address.

If somebody picked you in a process before your first sign-in (as a participant, reviewer or validator, by your email address or in the company directory), SerenForce had already prepared a guest account for you. At your first sign-in it becomes yours: you enter the application with the User role and find in My tasks the tasks waiting for you. This also holds in an organization that only accepts invited people: being picked in a process counts as an invitation. When you were picked by your email address, the address must be verified (see above). On the shared space, where no address is verified, the task email you receive carries a personal link instead: open it and sign in with the account of your choice to get the tasks (see A task given to your email address).

If your address is not verified, you can still sign in as long as nobody uses that address in the organization. If it is already registered there (an invitation or another account), the This email is already in use page appears: sign in with your organization’s directory account (Sign in with another account), or ask its administrator to have the domain of your address verified.

Administrators the platform invites when an organization is created are recognized at their very first sign-in when they already signed in to the administration of the platform: they do not need a verified address. If the sign-in fails for another reason, the We could not sign you in page offers Try again: nothing is lost, try again in a moment.

In a space open to every organization (the Shared space, or a space that welcomes the accounts of any directory), an address proves nothing, so it never blocks you: if another account already uses your address there, you still sign in, with an account of your own. An administrator the platform invites there and does not know yet receives a link in the invitation email: open it and sign in with the account of your choice to receive the role. The link works once, for a week; whoever opens it first receives the role, so do not forward the email. If the wrong person used it, the administrator of the platform removes the role from that account and invites you again.

Organizations: each one is a world of its own

On the Pro, Business and Enterprise plans, a company has one organization: its dedicated tenant, created for it. Its people enter it at their first sign-in, without an invitation, and a personal address only enters it when invited. The shared space of the Team plan holds several organizations, fully separated from each other: one per Team subscription. A new organization is not created in the application: you get it by taking out a new Team subscription (see Need another organization?).

In a space that welcomes personal addresses (such as the default space), each organization is a separate world. You work in one organization at a time and only see and change its data: processes, Artifacts, process instances, routines, campaigns, hooks, enterprise parameters, personas, roles and people.

Roles and permissions

MarieKarimLea UserViewer View, create, edit…processes, artifacts, tasksView onlynothing can be changed PeopleRolesPermissions
A person has one or more roles; each role groups permissions.

The word “role” has three meanings in SerenForce. Here it means what a person may do in the application. Do not mix it up with the role in a step (Assigned, Reviewer, Signer…) or with Member / Admin in an organization.

The four built-in roles

Every organization has four Built-in roles. They cannot be renamed or deleted.

RoleWhat it is for
AdministratorRuns the organization: it has every permission, including those of the Users and roles page, except managing the encryption (see the next role). This role is locked: it cannot be changed.
User DefaultThe role given to every new user. It lets people work: view, create, edit and delete processes and Artifacts (within the limits described below), start process instances and work on their tasks. It gives no access to administration.
ViewerThe “read only” role: it lets people view processes and Artifacts, process instances, My tasks and Activity, without changing anything.
Security administratorManages the encryption of the organization (Business plan): sees how its secrets are protected, chooses how their key is renewed and renews it (Administration › Encryption, see Encryption and your own key). It is given on purpose, in addition to another role: not even the Administrator role has it.

The permissions of User and Viewer can be adjusted by the people who manage roles; those of Administrator never change.

The first administrator of your organization is named by the SerenForce platform administrator. If nobody has the Administrator role yet, ask them; that person can then give the role to others.

1. Give a role to a person

The Users and roles page is only visible if you have at least one of the permissions View users, Manage users, View roles or Manage roles.

Users and roles in action
My tasksActivity…⚙ Settings

My tasks

3 assigned to you, the most critical first
My tasksActivity…⚙ Settings

Users and roles

Choose who can do what in this organization
UsersRoles
Search users by name or e-mail
UserE-mailRolesLast access
Marie Dupontmarie.dupont@example.comUserOct 12Edit roles
Karim Benalikarim.benali@example.comViewerNeverEdit roles
My tasksActivity…⚙ Settings

Users and roles

Choose who can do what in this organization
UsersRoles
UserE-mailRolesLast access
Marie Dupontmarie.dupont@example.comUserOct 12Edit roles
Karim Benalikarim.benali@example.comViewerNeverEdit roles
Roles of Marie Dupont
The user gets every permission of the selected roles.
Administrator
✓User
✓Viewer
CancelSave
✓ Roles saved
My tasksActivity…⚙ Settings

Users and roles

Choose who can do what in this organization
UsersRoles
+ New role
RoleUsersPermissions
Administrator Built-in1 userAllView
User Built-in Default14 users12 permissionsEdit
Artifact designer2 users7 permissionsEdit Delete
My tasksActivity…⚙ Settings

Users and roles

Choose who can do what in this organization
UsersRoles
RoleUsersPermissions
Administrator Built-in1 userAllView
User Built-in Default14 users12 permissionsEdit
Artifact designer2 users7 permissionsEdit Delete
New role
Name
Artifact designer
Processes
✓View processes
Create processes
Edit processes
Artifacts
✓View artifacts
✓Create artifacts
✓Edit artifacts
My tasks
✓View my tasks
✓Work on tasks
CancelCreate role
  1. Open the page

    Click the Settings gear at the top right, then, in the Administration section, Users and security (the address ends with /administration).

  2. Find the person

    In the Users tab, type a name or an e-mail in Search users by name or e-mail. The table shows User, E-mail, Roles and Last access (Never if the person has never signed in).

  3. Click Edit roles

    This button needs the Manage users permission. A Roles of window followed by the person’s name opens, with one check box per role.

  4. Tick and save

    Tick the roles you want, then click Save. The message Roles saved confirms it. The rights apply right away; if the person is already signed in, they only need to reload SerenForce to see their menus updated.

An organization always keeps at least one Administrator: if you remove the role from the last administrator, the change is refused. The groups of your company directory that the person belongs to are not touched by this setting.

If the list is empty, No user found is shown (people appear the first time they sign in); if the search finds nothing, No user matches your search.

2. Create, edit or delete a role

A custom role is useful when the four built-in roles are not enough: for example a role that lets people design Artifacts without touching processes. It all happens in the Roles tab, whose table shows Role, Users (how many people have it) and Permissions (how many it contains). The Built-in and Default badges mark the roles that come with SerenForce and the role given to new users.

I want to…I do
Create a roleClick New role. In the New role window, type a Name (1 to 100 characters, different from the other roles), tick the permissions you want in each group, then click Create role. Message: Role created.
Edit a roleClick Edit, change the check boxes (and the name, except for a Built-in role), then Save. Message: Role saved.
Delete a roleClick Delete and confirm in the Delete role window. Message: Role deleted. Not possible while people still have the role, and not possible for a Built-in role.
Only look at a roleClick View: the Role window followed by the name opens with the boxes ticked but locked, and a Close button.

The permissions, group by group

In the window of a role, permissions are shown by group, in the order below. The view permissions (View …) are the base: the others come on top of them.

GroupPermissionWhat it allows
ProcessesView processesSee the list, the details and the content of processes.
Create processesCreate a new process.
Edit processesSave and publish the processes you own or contribute to.
Delete processesDelete the processes you own or contribute to.
Manage all processes and artifactsEdit and delete any process or Artifact, even when you are not its owner or a contributor.
ArtifactsView artifactsSee the list, the details and the templates of Artifacts.
Create artifactsCreate a new Artifact and upload templates.
Edit artifactsSave and publish the Artifacts you own or contribute to, and edit their templates.
Delete artifactsDelete the Artifacts you own or contribute to.
Process instancesView process instancesSee process instances, their tasks, documents and activity.
Start process instancesStart a new process instance from a published process.
Delete process instancesDelete the process instances you started.
My tasksView my tasksOpen the My tasks page and read tasks.
Work on tasksSave a task, comment, review, send e-mails and meetings, call APIs, generate documents and add attachments.
Create tasks and Delete tasksKept for later: no action needs them yet.
ActivityView activityOpen the Activity page: what the others did on your tasks.
DashboardView the dashboardOpen the Dashboard page: progress, delays and budget of the process instances, campaigns and routines you can see.
OrganizationsManage organizationsCreate organizations, invite people and remove members (Settings > Users and security menu).
Work unitsView work unitsSee the work units of the organization and their members (Settings > Work units menu).
Manage work unitsCreate, change and delete work units and manage the members of any of them (the manager of a work unit already manages the members of their own).
ProjectsView projectsSee the projects shared with you or with your work units (Projects tab).
Create projectsCreate a project, led by your work unit.
Manage all projectsChange and share any project you can see, not only yours.
RoutinesView routinesOpen the Routines page and see your routines (the process instances started on a schedule).
Manage routinesCreate, edit, pause and delete your own routines.
Service HooksView service hooksOpen the Service Hooks page and see your service hooks.
Manage service hooksCreate, edit, pause, renew the secret of and delete your own service hooks (what another tool calls to start process instances).
AssistantUse the assistantChat with the AI assistant to find, explain and draft processes, Artifacts and process instances (each question uses tokens).
FeedbackSend feedbackSend feedback to the SerenForce team (bug, idea, question) from the help button, the satisfaction question and the assistant thumbs. The three built-in roles have it; a role created by your organization only has it when you tick it (Give feedback).
Enterprise parametersView enterprise parametersSee the enterprise parameters and use them in processes and Artifacts.
Create enterprise parametersAdd a new enterprise parameter.
Edit enterprise parametersChange the type or the value of an enterprise parameter.
Delete enterprise parametersDelete an enterprise parameter.
PersonasView personasSee the personas (for example “HR director”) and who plays them, and use them in processes.
Create personasDefine a new persona.
Edit personasChange a persona and say who plays it.
Delete personasDelete a persona.
Users and rolesView usersSee the users of the organization and their roles.
Manage usersChange the roles of the users.
View rolesSee the roles and their permissions.
Manage rolesCreate, edit and delete roles.
EncryptionManage the encryptionSee how the secrets of the organization are protected, choose its key (dedicated key or your own key), renew it, revoke it or ask for its destruction (Business plan; see Encryption and your own key). Given only to the Security administrator role.

After an update of SerenForce, a new permission is given automatically to the built-in roles: Administrator gets all of them, User and Viewer the ones they have by default (for example View work units and View projects). It is never added to the roles your organization created: open them with Edit and tick it if their members need it. Otherwise those people do not see the new feature.

The notice of the new permissions. When you open with Edit a role your organization created, a New permissions since this role was last saved notice lists the permissions an update brought since this role was last saved, each with its group, for example View projects (Projects). They are not ticked: tick the ones the people with this role need, then click Save. As soon as the role is saved, ticked or not, the notice goes away and does not come back: a permission you left unticked stays unticked. A role nobody opened again keeps its notice. The built-in roles never have one (they get their new permissions by themselves), and the read-only window (View) does not show it.

Owner and contributors: the rule for processes and Artifacts

To edit or delete a process or an Artifact, the permission is not enough: you must also be its owner (the person who created it) or one of its contributors (the people or groups added when it was created). Only the Manage all processes and artifacts permission lifts this limit.

Rights on processes and on Artifacts are separate: a person who designs Artifacts (Create artifacts, Edit artifacts…) cannot edit a process, and the other way round, even as a contributor. SerenForce then shows a message such as “You do not have permission to do this.”.

For the same person to design both, give them the permissions of both the Processes and the Artifacts groups (the User role has them).

Why can’t I…?

What you seeExplanation and what to do
I do not see Users and security in the Settings menuYou have none of the permissions View users, Manage users, View roles or Manage roles. Ask an administrator.
A tab (Users or Roles) is missingEach tab has its own permissions (View users / Manage users for Users, View roles / Manage roles for Roles).
A screen shows You do not have access to this pageYour role does not allow you to view it. The Go to an available page button takes you to a page you can use.
The New process or New artifact button is missingYou need Create processes, or Create artifacts.
The pencil (edit) or the trash (delete) of a process or an Artifact is missingEither you lack the permission (Edit / Delete of the right group), or you are neither the owner nor a contributor of that item. Ask the owner to add you as a contributor, or an administrator to give you Manage all processes and artifacts.
In the editor, I cannot find Save draft or PublishYou can read this process or Artifact but not change it (same reasons as above).
The Work units menu or the Projects tab does not showYou need View work units or View projects. The built-in roles have them; a role created by your organization does not get them by itself: an administrator must tick them (see above); the New permissions since this role was last saved notice points them out.
I cannot start a process instanceYou need Start process instances and also View processes, because the form lists the processes.
A task shows You can read this task but you do not have the permission to change it.You lack Work on tasks: the Save, Send and Generate buttons, adding attachments and comments are hidden; reading and downloading remain possible.
An action is refused with You do not have permission to do this.Your role does not allow it (or, for a process or an Artifact, you are not its owner or a contributor). Contact an administrator of your organization.
I changed a person’s role and nothing movesThe rights apply right away, but their menus are only up to date after SerenForce is reloaded.

The restrictions apply everywhere: even if a page were opened another way, SerenForce would refuse the action. Hiding buttons is only a help so that you are not offered what you cannot do.