Viewing: Organization, User, and Role Management > Managing Users

Managing Users

As with organizations, system admins can manage all users in all organizations, as well as create users outside of organizations, as described in Scope of Administrative Privileges. Organization admins can manage only the users in the organizations they administer.

The default installation of JasperReports Server contains the following users:

 

Users in Default JasperReports Server Installation

User Name

Default Password1

Organization Name

Description

superuser

superuser

none

Default system admin

anonymousUser

anonymoususer

none

Allows anonymous login, which is disabled by default

jasperadmin

jasperadmin

Organization

Default organization admin in every organization

joeuser

joeuser

Organization

Default end user in every organization

demo

demo

Organization

Included for use with sample data

CaliforniaUser

CaliforniaUser

Organization

Included for use with sample data

 

You should advise your users to change their passwords regularly. To configure periodic expiration of their passwords, refer to the JasperReports Server Administrator Guide.

To view users:

1.        Log in as jasperadmin.
2. Select Manage > Users or click Users on the Admin Home page.

As shown in the following figure, the Manage Users page displays the users in the organizations over which you have administrative privileges. The organization to which you belong is selected at the root of the organizations hierarchy, and the list of users shows all the users in all the sub-organizations.

 

Manage Users Page

Users are listed alphabetically, and the same username may appear more than once, indicating he is in more than one sub-organization. See "Manage Users Page" shows the default users in the default organization, Organization.

3. To select a user, click the user in the Users panel.

The user’s properties appear in the Properties panel.

4. To filter the list of users or find a specific user, use Search mode and click an organization, enter a search string, or both.

The filtered list shows all the users in the selected organization and sub-organizations and whose username contains the search string. Scroll and page through the new list, or refine your search.

5. To see information about a user, click the user in the Users panel, as in the figure.

The user’s Properties panel shows the user’s name, username (ID), email address, assigned roles, user status, and profile attributes. User status can be Enabled or Disabled; disabled users are displayed in gray text in the list of users. Profile attributes are special user attributes that are added directly in the database, not through this Manage Users page (see JasperReports Server Ultimate Guide). For convenience, there are also links to manage the roles.

 

As the admin of a given organization, you can see the roles defined in your organization and its sub-organizations but not the parent organization (except for certain system-wide roles). For more information, see section Managing Roles.

To create a user:

1.        Select the desired organization in the hierarchy tree view, then click Add User. Admins can create a user in their own organizations and sub-organizations.

Here the user is being added to the default organization (whose name is Organization and ID is organization_1).

The Add User panel appears.

 

Add User Panel

2. Enter the following information for the new user:

    The user ID is the username. This name is used throughout JasperReports Server to identify the user. User IDs must be unique within an organization, but not necessarily among its sub-organizations or any other organization. The panel warns you if the user ID you enter is not unique within the chosen organization. The text under this field explains the character restrictions in the user ID.

    The full name of the person. This is optional; it can be in any format or convention. JasperReports Server displays this name in the top right-hand corner of the screen for each user.

    The email address of the person. The email is optional but the address must be in a valid format.

    Password and confirmation. Enter the user’s default password in each field.

    Select the checkbox to enable the user right away. If a user account is not enabled, the person cannot log in with this username. For example, you may not want to enable the user account until you have assigned its roles.

3. Click Add User to organization_1 to create the user.

 

Properties of New User

The new user appears in the Users Panel (unless you used a search term that excludes it), the user is selected, and the user’s properties are in the Properties panel. JasperReports Server automatically assigned the ROLE_USER.

To edit a user:

1.        Find the user by searching or selecting an organization, then select the user in the Users panel and click Edit in the Properties panel.

In the Properties panel, the user details are editable, except for the user ID and the profile attributes (See "Edit User Panel"). The user ID cannot be modified, it always has the value defined when the user is created. The profile attributes can only be modified in the database (see JasperReports Server Ultimate Guide).

 

Edit User Panel

2. To add a role to the user, use the arrow buttons to move the role into the Roles Assigned list.

To remove a role, move the role into the Roles Available list.

The Roles Assigned list displays the roles currently assigned to the user. The Roles Available list displays all unassigned roles for the user is eligible. The available roles include any role in the organization of the user, any role in a parent organization of the user up to and including the organization of the current administrator, and the special system-wide roles.

3. When done modifying the user’s properties, click Save.
4. Click Login as User to test the user’s permissions, as explained in Testing User Permissions.

Another occasion to log in as a uses is when you are maintaining resources that use absolute references in the repository. The system admin creates absolute references that are not accessible to users within organizations. The system admin must log in as the admin of the organization that wants to use the resource so that it is created with an absolute reference that is valid in the context of the organization. For more information, see Referencing Resources in the Repository.

To delete a user:

   Locate and select the user, then click Delete User.

When you confirm the deletion, the user is removed completely from JasperReports Server.