Syniti Migrate

Role Management

This page contains the following sections:

• About Role Management

• Dependencies & Prerequisites

• Working in Role Management

• Add a Role for Security

• Add Users to a Role

• Add Features to a Role

About Role Management

The Role Management section of Security maintains the Roles and attaches Users and Features to these Roles.  The system provides roles that should cover all of the standard positions and activities of users on a project.  Role Management allows the responsible users ability to modify the existing roles as well as assign users to roles.  The role of Administrator contains all roles - that role is the top and Administers to all other roles. 

The user logs into the system with a Syniti Knowledge Platform ID and password setup through the Syniti Support service. This single sign on (SSO) process with authenticate the user's credentials based upon the assigned Tenant and User ID. When a user logs into Syniti Migrate for the first time via SSO, if the user does not have an account within Syniti Migrate they are automatically created. When doing so, the system assigns them roles based on their setup in the SynitiKnowledge Platform

The role mapping from Syniti Knowledge Platform to Syniti Migrate translate as follows:

SKP	Syniti Migrate
admin	MIGRATION_ADMIN
business-admin	MIGRATION_DEVELOPER
member	MIGRATION_MAPPER
user	MIGRATION_DESIGNER
viewer	MIGRATION_READONLY

Dependencies & Prerequisites

Before building and using Role Management, the users must be loaded and activated.  This section of the system aligns the users to the appropriate features for their job role.  Refer to section Administer > Security > Users Management for details of creating and maintaining a User of the Migration application.   

Working in Role Management

View the following page by navigating to Administer > Security > Role Management from the Syniti Migrate Home page.  The Role Management page displays a list of roles available to assign to Users and the Features that are available to each of the Roles.  Roles are not set to Active or Inactive - they are used or not used. 

Role Management: Roles Display

The Roles panel displays the following fields:

Heading	Definition
Name	Name of the Security Role.
Description	The description of the Security Role.

NOTE:  The Administrator role contains all access, and that role can grant access for others to have Administrator access.  USER ADMIN was designed to be given to a Help Desk person, or some other non-ADMIN  so they can create new users.   This role is not provided Administrator access so that they cannot provide Administrator access for themselves or others.

A set of default Roles installs with the system.  The Role Description provides details for the use of each Role.

Each Role comes loaded with Features that provide access to pages within Migration as shown below.  A few of the pages also come with Child security where certain panels may be locked down more than the overall security for the overall page. 

Role Management: Features Display

The Features panel displays the following fields:

Heading	Definition
Page	Page name
Area	Migration Menu - vertical area.
Screen	URL link page name
Read	Toggle to allow read access to page.
Update	Toggle to allow update access to page.
Insert	Toggle to allow insert access to page.
Delete	Toggle to allow delete access to page.

The Users panel displays the following fields:

Heading	Definition
User Name	User ID within Migration.
Full Name	User First and Last Name.

Add a Role for Security

Follow these steps to add a role to security:

1. Click on the Add  icon within the Roles panel to open a window to add the Role. 

2. Enter the Role Name and the Description to proceed.

   NOTE: Role Name is required but Description is optional. 

3. When finished with edits, click the Save  icon to complete.

The new Role displays in the list of Roles. 

Role Management: Add new Role

Add Users to a Role

Follow these steps to add a user to a role:

1. Click the Add  Icon within the Users in role panel. 

   NOTE: A dialog box for selecting users displays. 

2. Toggle as Selected for each User Name to add them to the list of users for this role.  Multiple users may be added at one time. 

3. When finished with edits, click the Save  icon to complete.

Role Management: Add Users to a Role

Add Features to a Role

Follow these steps to add features to a role:

1. Select the appropriate Role within the left panel of the page.

2. Click the Features tab title within the right panel of the page to view the Features for role panel.

3. Toggle the settings for each feature based upon the Area (Menu Path) and the Page (page name) to limit the access to Read, Update, Insert, or Delete actions for this role.

Role Management: Features update

NOTE:  Child Control breaks up the page into sections for security. Currently pages Mapping, Datasources, and Dataset Design are intracate enough to require this more granular security. The page contains more access, and then at the Child Control level the access is reduced.

Refer to the Appendix for a detailed chart of the Syniti default roles.