Chapter 4. Administration - Users and Roles
Prev |  |

## Chapter 4. Administration - Users and Roles

### Roy Russo

`<roy@jboss.org>`

## 4.1. Managing Users

### 4.1.1. Introduction

This section covers the administrator functions made available by the UserPortlet. For end-user operation, see: Section 1.2.2.2, “User Portlet” . Adminsitrative functions are available once you are logged in with the proper credentials (admin/admin)

### 4.1.2. Actions

All administrative functions are available after clicking on the ' List of all users ' link.

Managing users using the UserPortlet consists of:

1. Section 4.1.2.1, “Searching for Users”

2. Section 4.1.2.2, “Updating User Profiles”

3. Section 4.1.2.3, “Updating User Roles”

#### 4.1.2.1. Searching for Users

Typing a partial username in the form text field, allows you to search for usernames matching that criteria.

#### 4.1.2.2. Updating User Profiles

Clicking on the Profile link on the search page will allow you to edit a user's profile data, and even reset his password.

#### 4.1.2.3. Updating User Roles

Clicking on the Roles link in the search page allows you to modify the roles the specific user belongs to.

## 4.2. Managing Roles

### 4.2.1. Introduction

The role portlet is dedicated to create and edit roles. A role will be used to grant different permission level to different portlets, pages, or portal instances. A user can have several roles.

The RolePortlet is accessible once logged in as an administrator (admin/admin) from the Admin Page

### 4.2.2. Actions

Managing roles using the RolePortlet consists of:

1. Section 4.2.2.1, “Creating Roles”

2. Section 4.2.2.2, “Edit a role”

3. Section 4.2.2.3, “Editing Role Members”

#### 4.2.2.1. Creating Roles

To create a new role, you need to define a short name that will be used for reference, and a display name for displaying to the user, for example `admin` would be a good name for the display name `Administrators` , changing the display name will not affect the security rules.

#### 4.2.2.2. Edit a role

While editing a role, you just need to pick an exising role then change the display name. Additionally, you can delete existing roles from this screen.

#### 4.2.2.3. Editing Role Members

Allows for an administrator to search and modify the members' assigned roles.

Prev | Up |
Chapter 3. Administration - Content Management System | Home |