Home →
Using LincDoc 3.1+ →
Security →
Managing Security Roles
13.2. Managing Security Roles
Roles can be used to easily provide users or groups with specific rights, which are inherited from the role.
Proceed to one of the following sections below for more information:
About Default Roles
The following default roles are provided.
- admin. Allows members to create, edit, delete, and execute eForms or Document Packages. In addition, the following options are available from the system button:
- auth-provider-admin. Allows member to specify login providers and client login providers via the system button on the main LincDoc interface.
- browse. Allows members to access the browse button on the main LincDoc interface.
- form-admin. Allows members to create, edit, delete, and execute an eForm or Document Package. In addition, the search button is available. No system button options are available.
- guest. Allows guest access (no username/password is required) to the form, often via a direct URL (OpenForm View).
- login. Allows members to log in to LincDoc and use existing eForms or Document Packages as-is. Both the admin and the system buttons are inaccessible.
- report-admin. Allows members to access the reports option via the system button. This role does not grant editing access, so the admin button is not available. This role is the same as the login role, but includes access to the reports option.
- user-admin. Allows members to set up and configure security providers, users, groups, and roles. To support these functions, the following options are available from the system button:
Note: The superuser setting, available via the user settings, allows for full access to all system settings, including all of the system button options listed for the admin role above. In addition, there are several settings that only superusers can access (such as the configure system option).
Viewing Existing Roles
You can view the roles currently defined in LincDoc by selecting security roles from the system button.
The Security roles dialog box appears, with the current roles specified on the left side of the dialog box (highlighted below).
You can click on any existing role to see which users and groups are currently assigned to it. The provider for each user and group is also shown.
In the following example, no users (the user area is blank) and two groups have been assigned to the admin role. In addition, notice that each of the groups uses a different provider.
Creating a Role
You can create custom roles, to compliment the default roles provided by LincDoc.
- Access the Security roles dialog box as described in Viewing Existing Roles above.
- Click the + button.
The New Role dialog box appears.
- Type the role name in the Role name text box, and click OK.
The new role is added to the list on the Security roles dialog box.
- Click save to save the updated roles list.
Adding Users and Groups to Roles
Once the appropriate roles are created, you can add user or groups to them. These added users and groups are then granted the access provided to the roles to which they are assigned.
For more information on creating and working with users, see Managing Users.
For more information on creating and working with groups, see Managing Groups.
Tip: It is recommended that you assign roles to groups instead of individual users. Although you can assign individual users to roles, assigning groups allows for easier administration.
- Access the Security roles dialog box as described in Viewing Existing Roles above.
- Click an existing role. Any currently assigned users or groups appear on the right side of the dialog box.
- Click the + button that corresponds to the user or group list, depending on which type of item you want to add.
The Select dialog box appears. In the following
- Select the correct provider from the Provider drop-down list.
- Type a string in the text box below the Provider drop-down list.
- Click the Search icon.
All users or groups that match the specified string appear.
- Click the appropriate user or group to select it.
The selected item is highlighted.
- Click select.
The specified item is added to the appropriate list on the Security roles dialog box.
Deleting a Role
You can only delete non-default roles that you have added. Default roles cannot be removed.
- Access the Security roles dialog box as described in Viewing Existing Roles above.
- Hover over an existing non-default role.
The delete button appears to the right of the role's name.
- Click the button.
A confirmation message appears.
- Click Yes to confirm that you want to delete the role.
The role is removed.
- Click save at the top of the Security roles dialog box.