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.
Signing in: where do you land?
On the SerenForce sign-in page, type your email address: SerenForce sends you to the right place.
- Personal address (Outlook, Hotmail, Gmail, iCloud…): you land in the default space, where you join the organization that invited you by email, or take out a Team subscription to have your own organization.
- Company address whose domain belongs to an organization: you get a choice: your organization (or one of them if there are several) or the Shared space (the default space, where you join an organization or subscribe for one, as above).
- Company address without an organization: click Create my organization to start a trial, type the identifier of your organization if you already have one, or use the Shared space.
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:
- you sign in with a personal Microsoft account (Outlook, Hotmail…), whose address Microsoft vouches for;
- you sign in with the account of your organization’s directory, when the organization only accepts that directory;
- your organization proved to Microsoft that it owns the domain of the address (for example
@your-company.com); - you sign in with Google or Amazon Cognito: these organizations are tied to a single directory.
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.
- To change organization, open the settings menu at the top right and pick the organization under Switch working organization. The page reloads with the data of that organization.
- Your role can differ from one organization to another: administrator in one organization, viewer in another. The administration page only shows the members of your organization, with their roles in that organization.
- The built-in roles are marked Shared by every organization: every organization uses them, so they cannot be changed from inside an organization. To give other permissions, create a role for your organization.
- When you pick a person (participant, reviewer…), only the members of your organization are offered. With a work address, you also find the people of your company directory.
- What existed before the space welcomed organizations goes to its first organization: nothing is lost.
Roles and permissions
- A permission is one precise thing you are allowed to do, for example Edit processes or View my tasks.
- A role is a named set of permissions: Administrator, User, Viewer… or a role created by your organization.
- A person has one or more roles and gets all their permissions together.
- SerenForce only shows and allows what your roles allow: a button or a menu you cannot use is simply hidden.
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.
| Role | What it is for |
|---|---|
| Administrator | Runs 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 Default | The 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. |
| Viewer | The “read only” role: it lets people view processes and Artifacts, process instances, My tasks and Activity, without changing anything. |
| Security administrator | Manages 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.
My tasks
3 assigned to you, the most critical firstUsers and roles
Choose who can do what in this organizationUsers and roles
Choose who can do what in this organizationRoles of Marie Dupont
Users and roles
Choose who can do what in this organizationUsers and roles
Choose who can do what in this organizationNew role
- Open the page
Click the Settings gear at the top right, then, in the Administration section, Users and security (the address ends with
/administration). - 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).
- 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.
- 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 role | Click 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 role | Click Edit, change the check boxes (and the name, except for a Built-in role), then Save. Message: Role saved. |
| Delete a role | Click 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 role | Click View: the Role window followed by the name opens with the boxes ticked but locked, and a Close button. |
- Creating, editing or deleting a role needs the Manage roles permission. Without it, or for the Administrator role, you can only look, and the message You can view this page but you cannot change anything. is shown.
- In the window of a built-in role, The name of a built-in role cannot be changed. reminds you that only its name is fixed.
- For Administrator: The Administrator role always has every permission: it cannot be changed.
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.
| Group | Permission | What it allows |
|---|---|---|
| Processes | View processes | See the list, the details and the content of processes. |
| Create processes | Create a new process. | |
| Edit processes | Save and publish the processes you own or contribute to. | |
| Delete processes | Delete the processes you own or contribute to. | |
| Manage all processes and artifacts | Edit and delete any process or Artifact, even when you are not its owner or a contributor. | |
| Artifacts | View artifacts | See the list, the details and the templates of Artifacts. |
| Create artifacts | Create a new Artifact and upload templates. | |
| Edit artifacts | Save and publish the Artifacts you own or contribute to, and edit their templates. | |
| Delete artifacts | Delete the Artifacts you own or contribute to. | |
| Process instances | View process instances | See process instances, their tasks, documents and activity. |
| Start process instances | Start a new process instance from a published process. | |
| Delete process instances | Delete the process instances you started. | |
| My tasks | View my tasks | Open the My tasks page and read tasks. |
| Work on tasks | Save a task, comment, review, send e-mails and meetings, call APIs, generate documents and add attachments. | |
| Create tasks and Delete tasks | Kept for later: no action needs them yet. | |
| Activity | View activity | Open the Activity page: what the others did on your tasks. |
| Dashboard | View the dashboard | Open the Dashboard page: progress, delays and budget of the process instances, campaigns and routines you can see. |
| Organizations | Manage organizations | Create organizations, invite people and remove members (Settings > Users and security menu). |
| Work units | View work units | See the work units of the organization and their members (Settings > Work units menu). |
| Manage work units | Create, 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). | |
| Projects | View projects | See the projects shared with you or with your work units (Projects tab). |
| Create projects | Create a project, led by your work unit. | |
| Manage all projects | Change and share any project you can see, not only yours. | |
| Routines | View routines | Open the Routines page and see your routines (the process instances started on a schedule). |
| Manage routines | Create, edit, pause and delete your own routines. | |
| Service Hooks | View service hooks | Open the Service Hooks page and see your service hooks. |
| Manage service hooks | Create, edit, pause, renew the secret of and delete your own service hooks (what another tool calls to start process instances). | |
| Assistant | Use the assistant | Chat with the AI assistant to find, explain and draft processes, Artifacts and process instances (each question uses tokens). |
| Feedback | Send feedback | Send 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 parameters | View enterprise parameters | See the enterprise parameters and use them in processes and Artifacts. |
| Create enterprise parameters | Add a new enterprise parameter. | |
| Edit enterprise parameters | Change the type or the value of an enterprise parameter. | |
| Delete enterprise parameters | Delete an enterprise parameter. | |
| Personas | View personas | See the personas (for example “HR director”) and who plays them, and use them in processes. |
| Create personas | Define a new persona. | |
| Edit personas | Change a persona and say who plays it. | |
| Delete personas | Delete a persona. | |
| Users and roles | View users | See the users of the organization and their roles. |
| Manage users | Change the roles of the users. | |
| View roles | See the roles and their permissions. | |
| Manage roles | Create, edit and delete roles. | |
| Encryption | Manage the encryption | See 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 see | Explanation and what to do |
|---|---|
| I do not see Users and security in the Settings menu | You have none of the permissions View users, Manage users, View roles or Manage roles. Ask an administrator. |
| A tab (Users or Roles) is missing | Each 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 page | Your 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 missing | You need Create processes, or Create artifacts. |
| The pencil (edit) or the trash (delete) of a process or an Artifact is missing | Either 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 Publish | You can read this process or Artifact but not change it (same reasons as above). |
| The Work units menu or the Projects tab does not show | You 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 instance | You 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 moves | The 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.