Permissions management

Description

The Permissions Management Process type is used to define processes used to grant or remove permissions to an identity.

You can use the default template  Permissions management included on Soffid BPM Editor and customize it with your business needs. Also, you can import a .pardef file with the process definition.

That process is defined by default with 4 steps, but you can add new, delete and update steps to customize your business process. 

• Start
• Grant approval
• Apply changes
• End

We will use two concepts to explain that process, identity, and end-user. Identity will be the identity or user that will be created, updated, or deleted in Soffid Console. The end-user will be the Soffid user who requests processes using the self-service portal.

Process editor

• Process name: identifier name of the workflow. This name will be used to label the workflow for the end-user.
• Process type:  to use this BPM editor you need to select Use management.
• Description: a brief description of the workflow. When an end-user starts a workflow, this text will be displayed in the Actions log tab.
• Initiators: here you could configure the roles or the identities that could start a new workflow from the Console and Selfservice. E.g. "admin" identity, "SOFFID_ADMIN" role, both separated by comma ',' as "admin, SOFFID_ADMIN" or if you want to publish the workflow to everyone, you can use the text "tothom" or the character '*'.  The users who are initiators will be able to request that process from their self-service portal.
• Managers: here you could configure the roles or the identities that could perform tasks in the workflow as approve permissions or cancel the workflow.
• Observers: here you could configure the roles or the identities that could open the workflows in read-only mode.
  

Process steps

To view the detail of each available step, you can visit the Permissions management steps chapter.

Process steps > Start > views

This process allows for two different types of views. You can configure the one that best suits your workflow in the Start node, in the ‘Permission request screen type’ attribute.

The "Self-service request" option allows you to easily select a large number of roles as if you were filling a shopping basket. This view can be more useful when registering a user or changing their profile.

The "List of permissions" option shows you a user's roles and allows you to revoke them one by one, or add new roles one by one. This view may be more useful for maintaining users who only require minor changes.

Attributes

You could add new custom attributes in the Attributes tab. The defined attributes will be used in the Steps tab to be mapped with the Soffid data.

There are customized templates depending on the Process Type selected, for the Process management type there is one attribute defined:

• grants: allows you to select an information system and assign or revoke permissions.

You can customize attributes to adapt the workflow to your business process. You can add new attributes, and update or delete the default attributes. For each new attribute, you need to indicate, at least, the code, the label, and the data type.

The default template selects the user themselves. If you want to be able to select other users, you must add the userSelector attribute and then add it in Start > Fields.

Resources

If your workflow requires the use of extra libraries with their own classes and methods, you can upload a jar file so that Soffid can load it and it can be used from the scripts.

Actions

Process actions

Attribute actions