Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Below are the default values and a description for the configuration of Open-AudIT. These can all be changed to work as you desire.

 

To change these using the GUI in Open-AudIT navigate to menu -> Admin -> Configuration -> All

Image Added


Code Block
| access_token_count                   | 20                                        | number | Allow this many access tokens to be stored in the cookie.                        
Code Block
+------------------------------------+-------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
| name                               | value                                     | description
| access_token_enable                  | y                                         | bool   | Should we enable access tokens for CSRF mitigation.                                                                     |
+------------------------------------+-------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
| blessed_subnets_use                              |
| blessed_subnets_use                  | y                                         | bool   | Should we only accept data from the blessed subnets list.                          | y                                         | Should we only accept data from the blessed subnets list.               |
| collector_check_minutes              | 5                                         | number | The default check interval for collectors.             |
| default_network_address            |                                           | The ip address or resolvable hostname used by external devices to talk to Open-AudIT.                         |
| create_change_log                    | y                  |
| delete_noncurrent                       | nbool   | Should Open-AudIT create an entry in the change log table if a change is detected.                       |   Should we delete any attributes that are not present when we audit a device.                             |
| create_change_log_bios               | y                            |
| discovery_create_alerts            | ybool   | Should Open-AudIT create an entry in the change log table if a change is detected in the bios table.                    | Should Open-AudIT create an entry in the alert table if a change is detected.                |
| create_change_log_disk               | y                                         |
 bool   | discovery_ip_exclude               |   Should Open-AudIT create an entry in the change log table if a change is detected in the disk table.                                        | Populate this list with ip addresses to be excluded from discovery. IPs should be separated by a space.|
| create_change_log_dns                | y                                     |
| discovery_linux_script_directory   | /tmp/bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the dns table.               | The directory the script is copied into on the target device.                         |
| create_change_log_file               | y                                         | bool   |  |
| discovery_linux_script_permissions | 700              Should Open-AudIT create an entry in the change log table if a change is detected in the file table.                         | The permissions set on the audit_linux.sh script when it is copied to the target device.          |
| create_change_log_ip                 | y                                 |
| discovery_nmap_os       | bool   | Should Open-AudIT create an entry in |the nchange log table if a change is detected in the ip table.                              | When discovery runs Nmap, should we use the -O flag to capture OS information (will slow down scan and requires SUID on the Nmap binary under Linux). |
| discoverycreate_change_uselog_dnslog                  | y                                         | Shouldbool we use DNS| forShould lookingOpen-AudIT upcreate thean hostnameentry andin domain.the change log table if a change is detected in the log table.                                                   |
| create_change_log_memory             | y               |
| discovery_use_ipmi                 | y       | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the memory table.           | Should we use ipmitool for discovering management ports if ipmitool is installed.                         |
| create_change_log_module             | y                             |
| display_version           | bool   | Should Open-AudIT create an | 2.0.1             entry in the change log table if a change is detected in the module table.                        | The version shown on the web pages.                 |
| create_change_log_monitor            | y                                         | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the monitor table.                    |
| download_reports                   | download      |
| create_change_log_motherboad         | y                 | Tells Open-AudIT to advise the browser to download as a file or display the csv, xml, json reports. Valid values are download and display.| bool   | Should Open-AudIT create an entry in the |
| graph_days          change log table if a change is detected in the motherboard table.               | 30                           |
| create_change_log_netstat            | They number of days to report on for the Enterprise graphs.                               | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the netstat table.                                      |
| homepage        |
| create_change_log_netstat_dynamic    | n             | groups                           | bool   | Should Open-AudIT create an |entry Anyin linksthe tochange thelog defaulttable pageif shoulda bechange directedis todetected thisin endpoint.the netstat table and the port is 49152 or greater.              |
| create_change_log_netstat_registered | n                                         | bool   | Should Open-AudIT create an entry in the change log table if a |
| internal_version                   | 20170620change is detected in the netstat table and the port is in the range of 1024 to 49151. |
| create_change_log_netstat_well_known | y                                  | The internal numerical version.   | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the netstat table and the port is 1023 or lower.                 |
| create_change_log_network            | y                                         | bool   | Should Open-AudIT create an entry in the change log |
|table logoif a change is detected in the network table.                       | logo-banner-oac-oae                       | The logo to be used in Open-AudIT. Should be a 475x60 .png. Name should not include the file extension. logo-banner-oac-oae is the default.
| create_change_log_nmap               | y              |
| log_level                          | 5bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the nmap table.                   | Tells Open-AudIT which severity of event (at least) should be logged.                    |
| create_change_log_optical            | y                                         | bool   |  |
| log_retain_level_0          Should Open-AudIT create an entry in the change log table if a change is detected in the optical table.       | 180                                       |
| Tells Open-AudIT how many days to keep logs with severity 0.  create_change_log_pagefile           | y                                         | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the pagefile table.                        |
| log_retain_level_1                 | 180   |
| create_change_log_partition          | y                        | Tells Open-AudIT how many days to keep logs with severity 1.      | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the       partition table.                                                        |
| logcreate_retainchange_levellog_2policy             | y   |   180                                   | bool   | TellsShould Open-AudIT howcreate manyan daysentry toin keepthe logschange withlog severitytable 2.if a change is detected in the policy table.                                                |
| create_change_log_print_queue        | y                        |
| log_retain_level_3                 | 180bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the print_queue table.                 | Tells Open-AudIT how many days to keep logs with severity 3.               |
| create_change_log_processor          | y                                         | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the |
| log_retain_level_4processor table.                 | 180                           |
| create_change_log_route           | Tells Open-AudIT how| manyy days to keep logs with severity 4.                                  | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the route table.                                 |
| log_retain_level_5                 |
| 90create_change_log_san                | y                       | Tells Open-AudIT how many days to keep logs with severity 5.       | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the      san table.                                                        |
| logcreate_retainchange_levellog_6scsi               | y  | 30                                      | bool   | TellsShould Open-AudIT howcreate manyan daysentry toin keepthe logschange withlog severitytable 6.if a change is detected in the scsi table.                                                  |
| create_change_log_server             | y                 |
| log_retain_level_7                 | 7     | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the server table.             | Tells Open-AudIT how many days to keep logs with severity 7.                        |
| create_change_log_server_item        | y                                         | bool   | Should Open-AudIT create an entry in the change log table |
| maps_api_key       if a change is detected in the server_item table.                | AIzaSyAhAUqssRASeC0Pfyx1TW1DXRmboG5bdG0   | The API key for Google Maps.                 |
| create_change_log_service            | y                                         | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the service table.                           |
| maps_url                   |
| create_change_log_share       | /omk/open-audit/map      | y                | The web server address of opMaps.                   | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the share table.                                                 |
| create_change_log_software           | y             |
| match_dbus                         | n | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the software table.                 | Should we match a device based on its dbus id.                   |
| create_change_log_software_key       | y                                         | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the software_key table.            |
| match_fqdn                         | y   |
| create_change_log_sound              | y                      | Should we match a device based on its fqdn.          | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the sound table.                                                 |
| create_change_log_task               | y        |
| match_hostname                     | y          | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the task table.        | Should we match a device based only on its hostname.                                |
| create_change_log_user               | y                                         | bool   | Should Open-AudIT create |
| match_hostname_dbus                | yan entry in the change log table if a change is detected in the user table.                                            | Should we match a device based on its hostname and dbus id.|
| create_change_log_user_group         | y                                         | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the user_group table.                      |
| match_hostname_serial              | y      |
| create_change_log_variable           | n                      | Should we match a device based on its hostname and serial.        | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the variable table.                                              |
| create_change_log_video              |
| match_hostname_uuid y                | y                        | bool   | Should Open-AudIT create an entry in the change log table if a |change Shouldis wedetected matchin athe devicevideo basedtable. on its hostname and UUID.                                            |
| create_change_log_vm                 | y                               |
| match_ip         | bool   | Should Open-AudIT create an entry in the change log table if a change |is ndetected in the vm table.                                     | Should we match a device based on its ip.      |
| create_change_log_windows            | y                                         | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the windows table.                         |
| match_mac                     |
| database_show_row_limit    | n         | 1000                               | Should we match a device based on| itsnumber mac| address.The limit of rows to show, rather than download when exporting a database table.                                                                      |
| decrypt_credentials                  |
| match_mac_vmware y                    | n                    | bool   | When we display or export credentials, should we decrypt them.       | Should we match a device based mac address even if it's a known likely duplicate from VMware.                                                         |
| match_serial      |
| default_network_address              |  | yhttp://127.0.0.1./open-audit/             | text   | The URL used by external devices to talk to Open-AudIT.                | Should we match a device based on its serial number.                                                                     |
| delete_noncurrent                    | n       |
| match_serial_type                  | y              | bool   | Should we delete all non-current data.                 | Should we match a device based on its serial and type.                                                                                    |
| delete_noncurrent_bios           |
| match_uuid   | n                     | y                   | bool   | Should we delete non-current bios data.            | Should we match a device based on its UUID.                                                                                          |
| delete_noncurrent_disk                |
| nmisn                               | n         | bool   | Should we delete non-current disk data.                      | Enable import / export to NMIS functions.                                                                                  |
| delete_noncurrent_dns                | n         |
| nmis_url                           |    | bool   | Should we delete non-current dns data.                             | The web server address of NMIS.                                                                             |
| delete_noncurrent_file               | n                         |
| oae_license               | bool   | Should we delete non-current |file nonedata.                                      | License status of Open-AudIT Enterprise.                                                                    |
| delete_noncurrent_ip                 | n                       |
| oae_prompt                 | bool   | Should we delete | 2017-06-28  non-current ip data.                              | Prompt to activate a license for Open-AudIT Enterprise.                                                                             |
| delete_noncurrent_log                  |
| oae_urln                            | /omk/open-audit            | bool   | Should we delete non-current log data.     | The web server address of Open-AudIT Enterprise.                                                                                                      |
| pagedelete_noncurrent_refreshmemory             | n         | 300                               |  bool      | IntervalShould inwe secondsdelete between autonon-refreshingcurrent thememory pagedata. Set  to 0 to cancel auto-refresh.                                                                |
| process_netstat_windows_dns        |                             |
| delete_noncurrent_module             | Shouldn we keep track of Windows netsta ports used by DNS above port 1000.                            | bool   | Should we delete non-current module data.                                        |
| rss_enable                           | y                                         | Enable the RSS feed.
| delete_noncurrent_monitor            | n                                         | bool   | Should we delete non-current monitor data.                                                                     |
| rss_url                            | https://community.opmantek.com/rss/OA.xml | The RSS feed URL.    |
| delete_noncurrent_motherboard        | n                                         | bool   | Should we delete non-current motherboard data.                                                                    |
| uuid                               | 980906d2-5994-11e7-a4a3-1c1b0d60813b   |
| delete_noncurrent_netstat  | The unique identfier of this Open-AudIT server        | y                                         | bool   | Should we delete non-current netstat data.                                                                                                            |
| oae_productdelete_noncurrent_network            | n              | Open-AudIT Community                           | bool   The| nameShould ofwe thedelete installednon-current commercialnetwork applicationdata.                                                                                                         |
+------------------------------------+-------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+



   |
| delete_noncurrent_nmap               | n                                         | bool   | Should we delete non-current nmap data.                                                                                                               |
| delete_noncurrent_optical            | n                                         | bool   | Should we delete non-current optical data.                                                                                                            |
| delete_noncurrent_pagefile           | n                                         | bool   | Should we delete non-current pagefile data.                                                                                                           |
| delete_noncurrent_partition          | n                                         | bool   | Should we delete non-current partition data.                                                                                                          |
| delete_noncurrent_policy             | n                                         | bool   | Should we delete non-current policy data.                                                                                                             |
| delete_noncurrent_print_queue        | n                                         | bool   | Should we delete non-current print_queue data.                                                                                                        |
| delete_noncurrent_processor          | n                                         | bool   | Should we delete non-current processor data.                                                                                                          |
| delete_noncurrent_route              | n                                         | bool   | Should we delete non-current route data.                                                                                                              |
| delete_noncurrent_san                | n                                         | bool   | Should we delete non-current san data.                                                                                                                |
| delete_noncurrent_scsi               | n                                         | bool   | Should we delete non-current scsi data.                                                                                                               |
| delete_noncurrent_server             | n                                         | bool   | Should we delete non-current server data.                                                                                                             |
| delete_noncurrent_server_item        | n                                         | bool   | Should we delete non-current server_item data.                                                                                                        |
| delete_noncurrent_service            | n                                         | bool   | Should we delete non-current service data.                                                                                                            |
| delete_noncurrent_share              | n                                         | bool   | Should we delete non-current share data.                                                                                                              |
| delete_noncurrent_software           | n                                         | bool   | Should we delete non-current software data.                                                                                                           |
| delete_noncurrent_software_key       | n                                         | bool   | Should we delete non-current software_key data.                                                                                                       |
| delete_noncurrent_sound              | n                                         | bool   | Should we delete non-current sound data.                                                                                                              |
| delete_noncurrent_task               | n                                         | bool   | Should we delete non-current task data.                                                                                                               |
| delete_noncurrent_user               | n                                         | bool   | Should we delete non-current user data.                                                                                                               |
| delete_noncurrent_user_group         | n                                         | bool   | Should we delete non-current user_group data.                                                                                                         |
| delete_noncurrent_variable           | y                                         | bool   | Should we delete non-current variable data.                                                                                                           |
| delete_noncurrent_video              | n                                         | bool   | Should we delete non-current video data.                                                                                                              |
| delete_noncurrent_vm                 | n                                         | bool   | Should we delete non-current vm data.                                                                                                                 |
| delete_noncurrent_windows            | n                                         | bool   | Should we delete non-current windows data.                                                                                                            |
| device_auto_delete                   | n                                         | bool   | Should we delete the device data completely from the database when the device status is set to Deleted.                                               |
| discovery_default_scan_option        | 1                                         | number | The default discovery options for Nmap.                                                                                                               |
| discovery_ip_exclude                 |                                           | text   | Populate this list with ip addresses to be excluded from discovery. IPs should be separated by a space.                                               |
| discovery_limit                      | 20                                        | number | The maximum number of concurrent discoveries we should run.                                                                                           |
| discovery_linux_script_directory     | /tmp/                                     | text   | The directory the script is copied into on the target device.                                                                                         |
| discovery_linux_script_permissions   | 700                                       | text   | The permissions set on the audit_linux.sh script when it is copied to the target device.                                                              |
| discovery_linux_use_sudo             | y                                         | bool   | When running discovery commands on a Linux target, should we use sudo.                                                                                |
| discovery_override_nmap              | n                                         | bool   | Override the detction of Nmap to enable discoveries.                                                                                                  |
| discovery_pid                        |                                           | number | The discovery queue process pid.                                                                                                                      |
| discovery_route_retrieve_limit       | 500                                       | number | When discovering a device using SNMP, do not retrieve the route table if it contains more than this number of entries.                                |
| discovery_ssh_timeout                | 300                                       | number | Timeout duration (in seconds) when discovering a device via SSH.                                                                                      |
| discovery_sudo_path                  |                                           | text   | Optional hardcoded path to sudo executable. Comma seperated for multiple paths.                                                                       |
| discovery_sunos_use_sudo             | y                                         | bool   | When running discovery commands on a SunOS target, should we use sudo.                                                                                |
| discovery_use_dns                    | y                                         | bool   | Should we use DNS for looking up the hostname and domain.                                                                                             |
| discovery_use_ipmi                   | y                                         | bool   | Should we use ipmitool for discovering management ports if ipmitool is installed.                                                                     |
| discovery_use_vintage_service        | n                                         | bool   | On Windows, use the old way of running discovery with the Apache service account.                                                                     |
| display_version                      | 3.3.0                                     | text   | The version shown on the web pages.                                                                                                                   |
| download_reports                     | y                                         | bool   | Tells Open-AudIT to advise the browser to download as a file or display the csv, xml, json reports.                                                   |
| graph_days                           | 30                                        | number | The number of days to report on for the Enterprise graphs.                                                                                            |
| gui_trim_characters                  | 25                                        | number | When showing a table of information in the web GUI, replace characters greater than this with "...".                                                  |
| homepage                             | groups                                    | text   | Any links to the default page should be directed to this endpoint.                                                                                    |
| internal_version                     | 20191010                                  | number | The internal numerical version.                                                                                                                       |
| log_level                            | 5                                         | number | Tells Open-AudIT which severity of event (at least) should be logged.                                                                                 |
| log_retain_level_0                   | 180                                       | number | Tells Open-AudIT how many days to keep logs with severity 0.                                                                                          |
| log_retain_level_1                   | 180                                       | number | Tells Open-AudIT how many days to keep logs with severity 1.                                                                                          |
| log_retain_level_2                   | 180                                       | number | Tells Open-AudIT how many days to keep logs with severity 2.                                                                                          |
| log_retain_level_3                   | 180                                       | number | Tells Open-AudIT how many days to keep logs with severity 3.                                                                                          |
| log_retain_level_4                   | 180                                       | number | Tells Open-AudIT how many days to keep logs with severity 4.                                                                                          |
| log_retain_level_5                   | 90                                        | number | Tells Open-AudIT how many days to keep logs with severity 5.                                                                                          |
| log_retain_level_6                   | 30                                        | number | Tells Open-AudIT how many days to keep logs with severity 6.                                                                                          |
| log_retain_level_7                   | 7                                         | number | Tells Open-AudIT how many days to keep logs with severity 7.                                                                                          |
| maps_api_key                         |                                           | text   | The API key for Google Maps.                                                                                                                          |
| maps_url                             | /omk/open-audit/map                       | text   | The web server address of opMaps.                                                                                                                     |
| match_dbus                           | n                                         | bool   | Should we match a device based on its dbus id.                                                                                                        |
| match_dns_fqdn                       | n                                         | bool   | Should we match a device based on its DNS fqdn.                                                                                                       |
| match_dns_hostname                   | n                                         | bool   | Should we match a device based on its DNS hostname.                                                                                                   |
| match_fqdn                           | y                                         | bool   | Should we match a device based on its fqdn.                                                                                                           |
| match_hostname                       | y                                         | bool   | Should we match a device based only on its hostname.                                                                                                  |
| match_hostname_dbus                  | y                                         | bool   | Should we match a device based on its hostname and dbus id.                                                                                           |
| match_hostname_serial                | y                                         | bool   | Should we match a device based on its hostname and serial.                                                                                            |
| match_hostname_uuid                  | y                                         | bool   | Should we match a device based on its hostname and UUID.                                                                                              |
| match_ip                             | n                                         | bool   | Should we match a device based on its ip.                                                                                                             |
| match_ip_no_data                     | y                                         | bool   | Should we match a device based on its ip if we have an existing device with no data.                                                                  |
| match_mac                            | y                                         | bool   | Should we match a device based on its mac address.                                                                                                    |
| match_mac_vmware                     | n                                         | bool   | Should we match a device based mac address even if its a known likely duplicate from VMware.                                                          |
| match_serial                         | y                                         | bool   | Should we match a device based on its serial number.                                                                                                  |
| match_serial_type                    | y                                         | bool   | Should we match a device based on its serial and type.                                                                                                |
| match_sysname                        | y                                         | bool   | Should we match a device based only on its SNMP sysName.                                                                                              |
| match_sysname_serial                 | y                                         | bool   | Should we match a device based only on its SNMP sysName and serial.                                                                                   |
| match_uuid                           | y                                         | bool   | Should we match a device based on its UUID.                                                                                                           |
| nmis                                 | n                                         | bool   | Enable import / export to NMIS functions.                                                                                                             |
| nmis_url                             |                                           | text   | The web server address of NMIS.                                                                                                                       |
| oae_license                          |                                           | text   | License status of Open-AudIT Enterprise.                                                                                                              |
| oae_product                          |                                           | text   | The name of the installed commercial application.                                                                                                     |
| oae_prompt                           | 2001-01-01                                | date   | Prompt to activate a license for Open-AudIT Enterprise.                                                                                               |
| oae_url                              | /omk/open-audit                           | text   | The web server address of Open-AudIT Enterprise.                                                                                                      |
| output_escape_csv                    | y                                         | bool   | Escape CSV output so Excel will not attempt to run contents.                                                                                          |
| page_size                            | 1000                                      | number | The default limit of rows to retrieve.                                                                                                                |
| process_netstat_windows_dns          | n                                         | bool   | Should we keep track of Windows netstat ports used by DNS above port 1000.                                                                            |
| queue_count                          | 0                                         | number | The current number of concurrent device scans running.                                                                                                |
| queue_limit                          | 20                                        | number | The maximum number of concurrent device scans we should run.                                                                                          |
| rss_enable                           | y                                         | bool   | Enable the RSS feed.                                                                                                                                  |
| rss_url                              | https://community.opmantek.com/rss/OA.xml | text   | The RSS feed URL.                                                                                                                                     |
| servers                              |                                           | text   | The servers to report to when using Agent / Collector / Server.                                                                                       |
| server_ip                            |                                           | text   | The locally detected IP Addresses of this server.                                                                                                     |
| uuid                                 | unique per installation                   | text   | The unique identfier of this Open-AudIT server.