A3 Online Help

This page lists all or a filtered list of users along with several key pieces of information.

The general format and usage of this page is discussed in General GUI Usage.

The view offers selectable columns (with the symbol); the initial default columns are:

User name - the entries are displayed in alphabetic order. Selecting any of the Usernames displays full, editable information about the user; see Editing User Entries.
First name
Last name
Email

Actions

Each list entry has a check box to the left of the user name. Any number of entries may be checked; all of the entries are checked by checking the box to the left of the Username title. The drop-down list is used to choose an action to be applied to all the selected items:


Action	Usage
Clear Security Event	Erases any security event associated with the user.
Register	Registers the devices associated with the user.
Deregister	Deregisters the devices associated with the user.
Reevaluate Access	Use the current authentication settings to reevaluate the user's access.
Refresh Fingerbank	Retry FIngerbank identification of the user's devices.
Apply Role	Associates a role with the user. The roles are those defined in Configuration > Policies and Access Control > Roles.
Apply Bypass Role	Associates a bypass role with the user. The roles are those defined in Configuration > Policies and Access Control > Roles. Bypass roles override the role set during authentication
Apply Security Event	Associates a security event with the user. The security events are: Bandwidth Limit Connection transport change Generic Hostname change Lost or Stolen Nessus Scan OpenVAS scan Parking security event Post Reg System Scan Pre Reg System Scan Provisioning Enforcement Rogue DHCP Spam System Scan Time Expiration Wireless IPS

Simple Searches

The simple search choice offers a straightforward means of searching user entries:

Type any text into the Search by name or email box and press the button. Any user entry whose user name or email address contains the text will be displayed in the list.
The search box and the listing are reset back to the complete list via the button.
Export to CSV - the results of the current search are saved to a file named users.csv. Previous output is not overwritten; new versions are labeled users(1).csv, users(2).csv, etc. The format of the data is defined in a header line in the .csv file.

Advanced Searches

Click the slider to access the advanced searches page. Multiple or conditions are joined together with and conjunctions. Each element of an or set may be deleted with the symbol or reordered by selecting the item's symbol. Reordering may occur across or sets.

Several facilities exist for saving and using saved searches:

In the drop-down:
- Use the Save Search choice to name and save the current search conditions.
- Previously saved searches are available in the list as well.
- Saved searches are available in the left-hand menu below Saved Search.
- The search terms may also be exported or imported in JSON format.
- the results of the current search are saved to a file named users.csv. Previous output is not overwritten; new versions are labeled users(1).csv, users(2).csv, etc.

Each condition requires three parts:

User element - one of the characteristics of the user entry. Choose from the full list of elements in the drop-down list and shown in Editing User Entries.
Compare operation - one of:
- is - matches the comparison string
- is not - does not match the comparison string
- starts with - starts with the comparison string
- ends with - ends with the comparison string
- matches - the user element is matched against a regular expression (regexp). Regexp is a powerful language for expressing string matches. An introduction to regexps is found here. A simple search is the equivalent of using the matches operation with the equivalent text.
Comparison string - the string to match against or use as a regular expression.

Editing User Entries

Several tabs display or edit user entries:


Tab Label	Fields
Profile	Username (PID) Email Sponsor Language Gender Title Firstname Lastname Nickname Company Telephone Number Mobile Phone Number Work Phone Number Apartment Number Building Number Room Number Address Anniversary Birthday Pre-Shared Key Notes
Password	Password - enter a value to change the login password, followed by use of the button. The icon can be used to generate a password that adheres to multiple criteria and the icon can be used to make the password visible. Logins remaining - if a login limit is in effect, the number remaining is displayed here. Otherwise, unlimited logins are available.
Actions	Registration Window - the dates between which a user is considered registered. Actions - the actions to perform when a user registers. Actions are added through the use of the button and deleted through the use of the button. The available actions are discussed in Registration Actions below.
Custom Fields	Nine fields used for new user fields.
Devices	The list of devices associated with the user.
Security Events	The list of security events associated with the user.

Action	Usage	Example
Set tenant ID	Associates the user with a particular tenant in a multi-tenant scenario.	1
Access Duration	Sets the access duration for the user.	12 hours
Access Level	Change the administrative access level. One or more of the default or added administrative roles may be selected. These are discussed in System Configuration > Admin Access.	ALL
Mark as Sponsor	The user may act as a sponsor for guest logins.
Role	Sets the user's role. One of the items defined in Configuration > Policies and Access Control > Roles.	guest
Unregistration Date	The date on which the user will be automatically deregistered.	2020-07-01
Time balance	The aggregate amount of connection time that the user has available until automatic deregistration.	12 hours
Bandwidth balance	The aggregate amount of bandwidth consumption that the user has available until automatic deregistration. <??? units ???>	100MB

Search Users

Actions

Simple Searches

Advanced Searches

Editing User Entries