Skip to main content

User search

The user search is one important feature when managing users. This view gives an overview of current user metrics and provides multiple options to search for user information.

The user search can be accessed via the admin interface:

  1. Log in to the Administrator dashboard.
  2. On the left navigation panel, click Users.
  3. From the Users menu, click User Search.

User Metrics

The table below provides the details of the user metrics:

user search metrics

FieldsDescription
Total UsersThe total number of users registered to the cidaas portal.
Verified UsersThe number of verified users in the system. All verified users are active users and are able to access their user account and log in to applications. In the admin dashboard the administrator can set the user to state verified or declined.
Pending UsersThe number of users who must be verified by the administrator. If the user registration requires an administrator verification, then the user status is set to Pending.
Declined UsersThe number of users who are not in active status. An administrator can temporarily suspend a user account by changing the status of the user account to inactive. Note: The user will not be able to log in to the cidaas portal in the inactive status

Search Panel

The search panel in the user search offers an easy and comprehensible way to search for specific user information, such as name, email address and much more. Both system and custom fields can be applied for the field search. As well, multiple fields can be applied in the user search panel.

Available Fields

Fields represent the searchable attributes of users. Both system fields and custom fields configured in Field Settings can be used for searching.

Field CategoryExamplesData TypeDescription
User Identificationemail, username, subStringUnique identifiers for users
User Profilegiven_name, family_name, middle_name, nicknameStringPersonal information fields
Communicationmobile_number, phone_numberStringContact information
User StatususerStatusEnum/StringStatus values: VERIFIED, PENDING, DECLINED, DELETED
ProviderproviderEnum/StringAuthentication provider (e.g., self, facebook, google)
Date FieldscreatedTime, updatedTime, lastLoggedInTime, birthdateDateTimeTimestamp and date fields
Custom FieldsAny configured custom fieldVariesBusiness-specific fields configured in field settings

Note: Custom fields must be enabled in Field Settings to be searchable.

Operators

Operators define how to compare field values in search queries.

Comparison Operators
OperatorNameDescriptionExample
=EqualsExact matchemail = "[email protected]"
!=Not equalsExcludes exact matchuserStatus != DECLINED
~ContainsPartial text matchgiven_name ~ "John"
!~Does not containExcludes partial matchemail !~ "test"
List Operators
OperatorNameDescriptionExample
INIn listMatches any value in listuserStatus IN (VERIFIED, PENDING)
NOT INNot in listExcludes values in listprovider NOT IN (facebook, google)
Null Check Operators
OperatorNameDescriptionExample
EXISTSExistsChecks if field exists/not emptyemail EXISTS
NOT EXISTSNot existsChecks if field is empty/nullmobile_number NOT EXISTS
Comparison Operators (for Dates/Numbers)
OperatorNameDescriptionExample
>Greater thanValue is greatercreatedTime > "2025-01-01"
>=Greater or equalValue is greater or equalupdatedTime >= "2025-06-01"
<Less thanValue is lesscreatedTime < "2025-12-31"
<=Less or equalValue is less or equalupdatedTime <= "2025-12-31"

Operator Usage by Field Type

The operators available depend on the field's data type:

Field TypeSupported Operators
String=, !=, ~, !~, IN, NOT IN, IS, IS NOT
Enum=, !=, IN, NOT IN
Date=, !=, >, >=, <, <=, IS, IS NOT
Number=, !=, >, >=, <, <=, IN, NOT IN, IS, IS NOT

Logical Operators

Multiple search conditions can be combined using logical operators:

KeywordDescriptionBehavior
ANDLogical AND (default)Both conditions must be true for a result to match
ORLogical OREither condition can be true for a result to match
NOTNegationNegates the following condition

Precedence:

  • NOT has the highest precedence
  • AND has higher precedence than OR
  • Use parentheses () to explicitly group conditions

Examples:

userStatus = VERIFIED AND provider = self
email ~ "example.com" OR mobile_number ~ "+49"
NOT userStatus = DECLINED
(userStatus = VERIFIED OR userStatus = PENDING) AND provider = self

Sorting

Results can be sorted using the ORDER BY keyword:

KeywordDescriptionExample
ORDER BYSort results by specified fieldORDER BY createdTime DESC
ASCAscending order (A-Z, oldest first)ORDER BY given_name ASC
DESCDescending order (Z-A, newest first)ORDER BY updatedTime DESC

Examples

Following example filters can be applied as search criteria:

  • Search user by email: email = "[email protected]" or email ~ "example.com"
  • Search user by email and given name: email ~ "example" AND given_name ~ "John"
  • Filter by provider: provider IN (self, facebook, google)
  • Filter by user status: userStatus = VERIFIED or userStatus IN (VERIFIED, PENDING)
  • Search by date range: createdTime >= "2024-01-01" AND createdTime <= "2024-12-31"
  • Search verified users with email: userStatus = VERIFIED AND email EXISTS

The Group & Role Search panel allows you to search for users by their associated group and role in it.

There are three main types of groups :

  • cidaas (Default group)
  • cidaas Admin
  • custom group:If system-provided groups are not sufficient to organize access, a rightly privileged user can create a custom group the suits the specific requirement. These Groups get then listed in the select groups drop-down.

Note: To add a new group to the search criteria, click the Add Group button.

If group and role are selected and search is sent all users belonging to the filter criteria will be listed.

Note: To remove a group from search criteria, click the Delete Group button.

Search result

The users in the search result are listed in grid or as list, based on the selected mode. In the view basic information of the user is shown, such as registration date, name, email with verification status, mobile number with verification status and providers. If email or mobile number is unverified a quick link provides the option to resend verification link.

Note: By default the top 50 users are listed on the first page. Click the Next or Previous button to view more users and navigate between the pages.

Actions Menu

The Actions menu provides quick access to tasks relevant to an administrator role. You can do any of these actions from the Actions menu:

  • Edit User (Change user information)
  • Deactivate User
  • Resend Verification Email
  • Submit User Data The following screen shows the Actions menu:

Edit user

Using the edit user option, you can modify and update the user account details for a user from the user search.

Before you modify a user the current user details are shown. The user details include:

  • the personal data (e.g. name, email, ...),
  • the group role assignment,
  • the accepted consents
  • further user activities and devices
  • mfa (multi factor settings) like configured verification methods of a user
  • linked accounts

An administrator can take care of the following user settings via the admin interface:

  1. Change the user account information and status such as, activate or suspend a user account
  2. Assign or unassign groups and add or change roles for a user
  3. Reset the password of the user
  4. Delete the user from the system

User Activities

The User Activities panel displays the user activities from the email verification activity till the last activity of the user in the cidaas portal.

Note: The refresh button lists the available user activities.

Login Failures Panel

The Login Failure panel shows the information about the failed login attempts by a user. You can see the following information:

  • Failure Reason: Short description of the reason for the failed login attempt.
  • Address Info: Details about the location of the user from where the login attempt was made. You can view location details such as city, state and country.
  • Browser: Details of the browser used for login by the user.
  • OS Name: The name of the operating system used by a user to attempt login.
  • IP Address: The IP address of the user.
  • Failure Time: Date and time information about the failed login attempt.

The screen below shows the Login Failures panel

Review Device

Here an administrator can track what kinds of devices (mobile/personal computer) can access their account information.

Mobile Devices

A mobile device such as an iPhone, iPad, or Android smartphone will present you with a few details including when it was last synchronized with your account, what web browsers may have been used, and the exact manufacturer and model of the device. You will also be presented with an option to find the device if you have lost it.

Personal Computers

A personal computer such as a Windows PC or Mac will present you with a few details including what web browsers may have been used to access your account and a list of the most recent locations it was used.

Unreviewed Devices

An administrator can view the list of unreviewed devices corresponding to a User from the below screen.

MFA Enabled List:

An Administrator can view all the configured MFA (Multifactor Authentication) methods corresponding to a particular user.

Administrator can find more details on the configured MFA option. In order to get those details, click on MFA method.

Administrator can see the accepted user consent details by logging in to your business portal.

By clicking on the view button, the administrator can view the corresponding accepted consent pages.

Delete User

Click the delete user button to permanently remove the user from the cidaas portal.

Deactivate User

An administrator can temporarily revoke the access to the cidaas portal for a user. The user will not be able to login to the cidaas portal when the account is deactivated.

To deactivate a user, complete these steps:

  1. On the user detail row, from the Actions column, click

  2. Click Deactivate User.

  3. Click Deactivate to confirm.

Note: You can also deactivate a user from the user information panel on the user details screen.

Activate User

An administrator can change a user status from inactive to active status.

To Activate a user, complete these steps:

  1. For the user to be activated, in the actions column.

  2. Click activate. The activate User

  3. Click activate to confirm.

Note: You can also activate a user from the user information panel of the user details screen.

Resend Verification Email

If the user is unable to access a verification email, then an administrator can resend the verification email to the user.

To resend a verification email to a user, do the following:

  1. For the user to be activated, in the actions column.

  2. Click resend verification email.

  3. In the resend verification email screen, select the client id from the list.

  4. Select the redirect URL from the list.

  5. Select the process type (Link or Code).

  6. Click send. The verification email is sent.

Submit User Data

For a registered user, if the required client code/action was not processed during the first webhook trigger, then you can resubmit the webhook.

To submit the user data, complete these steps:

  1. For the user to be activated, in the actions column.

  2. Click submit user data.

  3. Click submit to confirm. The screen below shows the confirmation dialog box

  4. The user data is submitted successfully.

Need Support?

Please contact us directly on our support page. Thank you!