Kavi® Members Help

Chapter 103. Manage Roles

Table of Contents

Overview
Options
Related Topics

Overview

The Manage Roles tool is used to view and manage roles, which are used to control access to the organization's Web site.

Roles

Each role controls access privileges for those areas of the site that are configured to be accessible through this role. This role may be one of several default roles (e.g., 'admin,' 'Editor,' 'superadmin,' etc.), or a role specific to this organization's site (e.g., 'board,' 'steering,' etc).

A role can be associated with one or more Company Types, company administration and contact types, or User Types. When a user is assigned any of these types, the user inherits whatever roles are associated with that type, and in this way gains access permissions for areas of the web site controlled by the role.

For example, the default 'admin' role controls access to the Admin Home page and all admin tool links displayed on that page. If a company administration and contact type of 'Administrator' is defined and associated with the 'admin' role, any users who are assigned the 'Administrator' Company Administration and Contact Type will have access privileges for the Admin Home page and its tool links.

Example of a site-specific role:

  • Role: steering

  • Origin: custom

  • Description: Allows access to the steering committee area

In this example, a custom role of 'steering' is added so that when a steering committee area is created for the site, it can be configured to be accessible only through the 'steering' role. A 'Steering Committee' company or User Type can be defined and associated with the 'steering' role, so that when this type is assigned to steering committee members, they inherit this role and acquire access privileges for the steering committee area of the site.

Important

Protected web site pages require some code-writing skills to establish. Adding a role simply makes it possible to create these areas—it does not actually create any additional web pages. Protected areas can also be created using Kavi Groups without the need to add roles or write code.

There are two general categories of roles:

Application-defined roles

These roles give users access to different Kavi tools. The role description indicates what access each role grants to a user. Roles created automatically by Kavi Members or other applications cannot be edited or deleted, which is why these roles are displayed on the Manage Roles page without Edit or Delete links.

Custom-defined roles

Custom roles are often added when creating special protected areas of the web site meant to be used only by a certain group of users. These custom roles can be edited, and can also be deleted, providing the role is not in use.

Note

If the role is in use, the list of available links in the 'Action' field will not include 'Delete' and it will be necessary to use the Manage User Types and Manage Company Types tools to locate and unclick the checkbox for this role in the 'Associated Roles' field, then return to the Manage Roles page and the 'Delete' link will be available.

Use the Manage Roles page to:

  • View existing roles, their origins and descriptions.

  • Access tools that allow you to edit or delete existing roles.

  • Access the Add a Role tool to add new custom roles.

Back to top

Options

View a tabular list of existing roles and access tools to add, edit or delete a role.

The following fields are displayed:

Role Name

The name assigned to the role.

Origin

This will be the name of the application that automatically created the role, or 'custom' if it is custom to this site.

Description

This describes the kind of access granted by this role, specifically the area(s) of the site to which this role provides access.

Action

If this is a custom role and can be edited or deleted, links to tools to manage this role will be provided in this field.

Back to top

Related Topics

Back to top