User search

Administrators or Helpdesk teams will need to perform searches to find users as part of day-to-day administrative operations. OpenIAM provides two ways of finding users:

  • Header search. A search box in the webconsole header section of the that is always available.
  • Advanced search. A form-based search which retrieves users based on a variety of options.

Header search

To find users using the header search, follow the steps below.

  1. Log in to the webconsole.
  2. From the search bar in the header, select Users as shown below.

Header search

  1. Start to type in either the name or identity of the user that you need. OpenIAM uses a starts with algorithm to match users against your input.

Using header search

  1. Click on the user once you find a match. OpenIAM will retrieve the user information and will present it in a template view.

Advanced search

As mentioned above, advanced search allows a greater number of options to perform your search. To use the advanced search option, use either of the two options below:

  • Click the Advanced search button next to the header search as shown below.

Advanced search

  • Go to User Admin > User search from the top menu.

Default search options include the following.

Field NameDescription
Last nameSearch by a person's last name. This field supports a starts with algorithm. If you enter su it will show all users whose last names start with _su.
Principal nameSearch by a user's identity/account. This field also supports a starts with algorithm.
Email addressSearch by a user's email address. This fields supports a starts with algorithm.
Employee IDSearch by an employee's ID. This search is based on an exact match.

Additional search options can be added by selecting them from the Add more search criteria field. Click on the field and select the required search options.

Advanced search - additional options

The table below describes each of the search options.

Field nameDescription
Account statusFilters users based on the any of the following states.
  • DISABLED
  • LOCKED
  • LOCKED_ADMIN
User statusFilters users based on any of the following states
  • ACTIVE
  • APPROVAL_DECLINED
  • DELETED
  • INACTIVE
  • LEAVE
  • PENDING_APPROVAL
  • PENDING_DEACTIVATION
  • PENDING_INITIAL_LOGIN
  • PENDING_START_DATE
  • PENDING_USER_VALIDATION
  • RETIRED
  • TERMINATED
First nameSearch by a user's first name
Extended attributesExtended attributes allow searching by any attribute that has been defined as a custom field.
GroupSearch by group membership.
RoleSearch by role membership.
Job codeSearch by job code. This field is a drop-down containing predefined job codes.
Maiden nameSearch by a user's maiden name.
NicknameSearch by a user's nickname (aka alternate name, preferred name, etc.)
OrganizationSearch by organization object membership, e.g. Organization, Division, Department, etc.