Managing Users

Delegated Administration. Organization admins can manage the users in their own organization and in any of its sub-organizations.

The default installation of JasperReports Server includes the following users:

Default Users in JasperReports Server Installations

User Name

Default Password
(case sensitive)

Organization

Description

superuser

superuser

none

Default system admin (commercial edition only).

anonymousUser

anonymoususer

none

Allows anonymous login; disabled by default. If you do not allow anonymous access, this user can be deleted.

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 passwords, refer to .

Some editions of the server do not include all these users; for example, superuser is not included in the Community edition of the server, and demo and CaliforniaUser are included only if you install the sample data.

Viewing User Properties

1. Log in as an administrator (jasperadmin in the user's organization or any parent organization, or superuser).
2. Select Manage > Users or, on the Admin Home page, click Manage under Users. The Manage Users page displays the users in each organization and properties of the selected user.

Manage Users Page

The list of users includes everyone in the chosen organization and its suborganizations. The same user ID may appear more than once, indicating that users with the same ID were created in different organizations. The third column gives the name of the selected user's organization.

In this example, the system admin can see all users in all organizations by selecting the root of the Organization hierarchy. There are always multiple jasperadmin users in a hierarchy of organizations, because it's the default administrator ID in each organization.

3. To locate a user:
     Browse for users. Expand the organization hierarchy in the left-panel, and select an organization or suborganization.
     Search for a user, Select the organization (or any parent organization) and enter a search string in the Search field of the Users panel. The search results show all usernames in the selected organization and suborganizations that match the search string.
4. Select a user account to view its Properties in the right-hand panel.

User status can be Enabled or Disabled; disabled users are displayed in gray text in the Users list. For convenience, the role names link to the role management page for each role. For information about attributes on the user, see Managing User Attributes.

As the admin of a given organization, you can see the roles defined in your organization and its suborganizations but not the parent organization (except for certain system-wide roles). A user may have roles defined and assigned from a parent organization that are not visible to the administrator of the user’s organization. For more information, see Managing Roles.

Creating a User

1. Log in as an administrator (jasperadmin in the user's intended organization or any parent organization, or superuser).
2. Select Manage > Users or, on the Admin Home page, click Manage under Users.
3. In the Organizations panels, select the organization for the new user and click Add User. For community edition admins, simply click Add User. The Add User dialog appears.

Adding a User

4. Enter the following information:
     User name – The new user's full name. The name is optional but recommended; It will appear in the top right-corner of the UI when the user is logged in.
     User ID – Generated automatically from the user name; you can accept the suggested value or type your own. The user ID is used to log into JasperReports Server, and for administrators to manage users and resources. The User ID must be unique within the organization, but may exist in multiple organizations.
     Email – This is optional but must be in a valid email format.
     Password and confirmation – Enter and confirm a password for the user.
     User is enabled – To enable the user to log in, select this checkbox. Users who are not enabled can't log in. If you implement role-based permissions, you might want to delay enabling the user until you assign more roles. For more information on roles, see Managing Roles.
5. Click Add User to <organization> (Add User for community edition).

The new user is available in the Users panel. To assign roles to the user, click Edit in the user's Properties panel.

Editing a User

One way to assign roles to a user is to edit the user's properties. Alternatively, when you edit a role, you can assign it to any number of users. To edit a user's properties:

1. Log in as an administrator (jasperadmin in the user's organization or any parent organization, or superuser).
2. Click Manage > Users or, on the Admin Home page, click Manage under Users.
3. In the Organizations panel, select the user’s organization (Commercial edition users only).
4. In the Users panel, select the user.
5. In the user's Properties panel, click Edit.

Editing the Properties of a User

6. Edit the user's properties as needed. You can't edit the user ID; it always has the value defined when the user is created originally.
7. To assign or remove roles from the user, select the roles, and use the arrow buttons between the Roles Available and Roles Assigned lists.

The Roles Available list includes any role in the organizations of the current administrator, as well as the special system-wide roles. For more information on creating and adding roles, see Managing Roles.

8. For information about attributes on the user, see Managing User Attributes.
9. Click Save to keep your changes.
10. In the Properties panel, click Login as User to test the user’s permissions, as explained in Testing User Permissions.

Logging in as another user is also necessary when you are maintaining resources that use absolute references in the repository. For more information, see Referencing Resources in the Repository.

Enabling or Disabling Multiple Users

You may sometimes need to disable user accounts. For example, when making configuration changes, you may want to lock out all users until the changes are finished. Administrators can select any number of users in their organization, and the system admins (superuser) can select all users in the server, except themselves.

1. Log in as an administrator (jasperadmin in the user's organization or any parent organization, or superuser).
2. Click Manage > Users or, on the Admin Home page, click Manage under Users.
3. In the Organizations panel, select the users’ organization; to enable or disable users in different organizations, select the common parent organization.
4. In the Users list use Control-click and Shift-click to make multiple selections. If the User list is too long, enter a search term to find users and enable or disable them individually.
5. Click Enable or Disable in the menu bar.

Deleting One or More Users

1. Log in as an administrator (jasperadmin in the user's organization or any parent organization, or superuser).
2. Click Manage > Users or, on the Admin Home page, click Manage under Users.
3. In the Organizations panel, select the user’s organization; to delete users in different organizations, select the common parent organization.
4. In the Users list use Control-click and Shift-click to make multiple selections. If the list of users is too long, enter a search term to find and select the user.
5. In the tool bar of the Users panel, click Delete and confirm the action.
Version: 
Feedback