GUI Settings

The GUI Settings section involves settings that impact the Axonius user interface behavior.

To open the GUI Settings, from the top right corner of any page, click . The System Settings page opens. Then, click the GUI Settings tab.

System Settings

• Auto-refresh rate (required, default: 60 seconds) - Dictates the GUI auto refresh rate in seconds. Auto refresh forces the GUI to update the presented data.
• Default number of query results displayed per page (required, default: 20) - Dictates the default number of results displayed per page in the Devices page and the Users page.
• When no column sort is applied, sort by count of adapters (required, default: True)
  • If enabled, when no sort is applied for the Device/Users table, the data will be sorted by the count of adapters correlating the device, meaning devices with more adapters are shown at the top of the table.
  • If disabled, when no sort is applied for the Device/Users table, the default sorting in those pages is based on the order the data was retrieved from the database.
• Perform a query every keypress (required, default: True)
  • If enabled, the filter expression configured in the Query Wizard filters the devices or the users as you are writing the query.
  • If disabled, the filter expression configured in the Query Wizard filters the devices or the users only when you click Search.
• • Display Decimal accuracy for Pie charts (required, default: False) - Set this value to not round up the values for pie charts (display the exact value).
• Use exact match for assets search (required, default: True)
  • If enabled, searching for assets will be faster, as when you use the search bar to find assets in the Devices/Users page or from the Dashboards page, Axonius runs the following search logic on the specified value:
    • 'Case sensitive exact match' search in any of the selected columns.
    • 'Case insensitive words within text' search (any of the words in a string) in the following columns:
      • Devices page: Host Name, Network Interfaces: MAC, Device Manufacturer Serial, Last Used Users.
      • Users page: User Name, Email.
  • If disabled, when you use the search bar to find assets in the Devices/Users page or from the Dashboards page, Axonius runs 'contains' search to find the specified value in any of the selected columns.
• Require Connection Label on each adapter connection (required, default: False)
  • If enabled, the Connection Label field will be mandatory on each adapter connection.
  • If disabled, the Connection Label field will be optional on each adapter connection.
• Number of values displayed in each column (required, default: 2) - Select whether Device and User multi-value fields display a single or two values. If such fields have more values than the selected option, those values can be viewed by hovering over the "+x" indication.
• Export CSV delimiter to use for multi-value fields (optional, default: empty) - Specify a delimiter to separate between values within the same field of an exported CSV file.
  • If supplied, values within the same field will be separated by the specified delimiter once the CSV file has been generated.
  • If not supplied, values within the same field will be separated by "\n" (new line) once the CSV file has been generated.
• Date format (required, default: YYYY-MM-DD) - Select the date format to be displayed in all Axonius pages. You can choose between:
  • YYYY-MM-DD (for example: 2020-12-31)
  • DD-MM-YYYY (for example: 31-12-2020)
  • MM-DD-YYYY (for example: 12-31-2020)
• Custom logo for reports (optional, default: empty) - This setting lets you define a custom logo to be used in the reports PDF files.
  • If a logo is uploaded, the created report file will include that logo in the header and footer of every page of the report.
  • If a logo is not uploaded, the created report file will include the Axonius logo.
  • When no file is set - the default Axonius logo will be used.
  • The supported formats are: JPG, JPEG, PNG.
  • The max file size is 5MB.

Login Page Settings

• Custom message (optional, default: empty) - This setting lets you define a custom message that will appear on the Login page.

  • If supplied, the Login page will display that message on the Login page.
  • If not supplied, the Login page does not display a custom message.
  • The maximum number of characters a custom message can display is 3000 characters.

• No Access custom message (optional, default: empty) - Use this setting to define a custom message that appears when someone who is not authorized tries to log in to Axonius. An example of a message could be, 'You are not authorized to access this application'.

• Default login page - Set the default login page, either Axonius, or LDAP.
  If you chose 'Allow LDAP login' in Identity Provider settings you can set which login page will appear as default for LDAP users.
  To set SAML-Based Login Settings as default, select Automatically redirect all logins to the identity provider in SAML-Based Login Settings.
  
  

  

• LDAP Login title - Use this setting to set a custom title to display for the LDAP login message.

  • If supplied, the LDAP Login title will display that message as the title for LDAP login.
  • If not supplied, the LDAP Login title displays 'LDAP LOGIN'.
  • The maximum number of characters a custom title can display is 26 characters.

• Axonius Login button text - Use this setting to set a custom name for the Axonius link button on the LDAP login page.

  • If supplied, this will be the name of the Axonius link button on the LDAP login page.
  • If not supplied, the Axonius link button is named 'Switch to Axonius Login'.
  • The maximum number of characters the custom link button can display is 25 characters.

Timeout Settings

• Enable session timeout (required, default: switched off) - Select whether to enable user session timeout.
  • If switched on, session timeout will apply for all users based on the Session idle timeout (minutes) configuration.
  • If switched off, no session timeout will apply.
• Disable 'Remember me' (required, default: False) - Select whether to disable the remember me option on the login page.
  • If enabled, the Remember me checkbox will not be displayed on the login page.
  • If disabled, the Remember me checkbox will be displayed on the login page.
• Session idle timeout (minutes) (required, default: 1440) - Configure user idle duration (in minutes) before the system automatically ends a user session and logs that user off the system.
  • This setting is displayed only if Enable session timeout is switched on.
  • This setting is ignored if a specific user has checked the Remember me option in the Axonius Login dialog.
  • A session timeout modal that warns the user is displayed 1 minute before their session is about to timeout.
• Display browser push notifications to warn about session expiry when session is not in an active tab (required, default: False) - Select whether the browser will send a push notification 1 minute before an Axonius session is about to expire. This notification is sent when the Axonius session is not in an active tab. Click the notification to continue working with Axonius. In order to receive the browser notification you have to enable notifications on your browser for the Axonius IP address.

Cache Settings

• Enable caching on recently used queries (required, default: switched off) - Select whether to cache recently used queries.
  • If switched on, each executed query will be cached for the time specified in the Cache Time-to-Live (TTL) in minutes field. This means that a query that was recently executed will not be executed again. The results for that query will be loaded from the previous query execution.
  • If switched off, apart from the last executed query, queries will not be cached, and the query results will not be retrieved from cache.
  • When Enable caching on recently used queries is switched on, the Perform a query every keypress settings checkbox will be disabled.
  • When Enable caching on recently used queries is switched on, the dashboard charts that use this query will load the cached query, and not run a new query.
• Cache Time-to-Live (TTL) in minutes (required, default: 60) - Configure the time for which the cache of each query will be kept. Once this time has passed, the query will be executed again and will not load previous results.