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.                                                        | value                                    |
| descriptionaccess_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                  | n                                   bool      | Should weOpen-AudIT deletecreate anyan attributesentry thatin arethe notchange presentlog whentable weif audit a device.change is detected.                                                                        |
| discoverycreate_change_create_alertslog_bios               | y                                         | bool   | Should Open-AudIT create an entry in the alertchange log table if a change is detected. in the bios table.                                                  |
   | create_change_log_disk               | |y discovery_ip_exclude               |                         | bool   | Should Open-AudIT create an entry in the change log table if a change  | Populate this list with ip addresses to be excluded from discovery. IPs should be separated by a space.is detected in the disk table.                                                  |
| create_change_log_dns               | | discovery_linux_script_directoryy   | /tmp/                                     | Thebool   directory| theShould scriptOpen-AudIT iscreate copiedan intoentry onin the targetchange device.log table if a change is detected in the dns table.                                                   |
| create_change_log_file               | y          | | discovery_linux_script_permissions | 700                           | bool   | Should Open-AudIT create an entry in the |change Thelog permissionstable setif ona the audit_linux.sh script when it change is copieddetected toin the targetfile devicetable.                                                  |
| create_change_log_ip          | | discovery_nmap_os     | y            | n                            | bool   | Should Open-AudIT create an entry in the change |log Whentable discoveryif runsa Nmap,change shouldis wedetected usein the -Oip flagtable. to capture OS information (will slow down scan and requires SUID on the Nmap binary under Linux). | | discovery_use_dns                  | y             |
| create_change_log_log                | y         | Should we use DNS for looking up the hostname and domain.                     | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the log table.                                                   |
| discoverycreate_change_uselog_ipmimemory             | y   | y                                     | bool   | Should weOpen-AudIT usecreate ipmitoolan forentry discoveringin managementthe portschange iflog ipmitooltable isif installed.a change is detected in the memory table.                                                |
| create_change_log_module            | | display_versiony                    | 2.0.1                    | bool   | Should Open-AudIT create an entry in the change log table if a |change Theis versiondetected shown onin the webmodule pagestable.                                                |
| create_change_log_monitor            | y                                         | bool   | Should Open-AudIT create an entry  |
| download_reports       in the change log table if a change is detected in the monitor table.            | download                                  |
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.| create_change_log_motherboad         | y                        | | graph_days               | bool   | Should Open-AudIT create an entry |in 30the change log table if a change is detected in the motherboard table.                            | The number of days to report on for the Enterprise graphs.    |
| create_change_log_netstat            | y                                         | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the netstat table.         | | homepage                           | groups        |
| create_change_log_netstat_dynamic    | n                     | Any links to the default page should be directed to this endpoint.        | 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 49152 or greater.              |
| create_change_log_netstat_registered | n                            | | internal_version           | bool   | Should Open-AudIT create |an 20170620entry in the change log table if a change 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                        | | logo               | bool   | Should Open-AudIT create an entry in the change log table if | logo-banner-oac-oae      a change is detected in the network table.                 | 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_levelnmap               | y           | 5                             | bool   | Should Open-AudIT create an entry in the |change Tellslog Open-AudITtable whichif severitya ofchange eventis (atdetected least)in shouldthe benmap loggedtable.                                                  |
| create_change_log_optical            | y                | | log_retain_level_0                 | 180     | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the optical table.            | 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_retain_level_1 table if a change is detected in the pagefile table.       | 180                                      |
| Tells Open-AudIT how many days to keep logs with severity 1. create_change_log_partition          | y                                         | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the partition table.                          | | log_retain_level_2                 |
180 | create_change_log_policy             |  y                       | Tells Open-AudIT how many days to keep logs with severity 2.       | bool   | Should Open-AudIT create an entry in the change log table if a change is detected in the policy table.                                                |
| create_change_log_print_queue        | y | | log_retain_level_3                 | 180                    | bool   | Should Open-AudIT create an entry in the change log table if a change is |detected Tellsin Open-AudIT how many days to keep logs with severity 3.the print_queue table.                                           |
| create_change_log_processor          | y                                         | bool   | log_retain_level_4                 | 180Should Open-AudIT create an entry in the change log table if a change is detected in the processor table.                                       | Tells Open-AudIT how many days to|
keep logs with severity 4.| create_change_log_route              | y                                         | 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                 | 90       |
| create_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                         | 7bool   | 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 if a change is detected |in |the mapsserver_api_keyitem 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                     | bool   | nShould 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                        |
| ycreate_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 an entry in |the | match_hostname_dbus          change log table if a change is detected in the user table.      | y                                         | 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                | |y match_hostname_uuid                | y                       | bool   | Should Open-AudIT create an entry in the change log table if a change |is Shoulddetected wein matchthe avideo devicetable. based 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 |detected nin 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| basednumber on| itsThe maclimit address.of rows to show, rather than download when exporting a database table.                                                                      |
| decrypt_credentials                 | | match_mac_vmwarey                   | 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              | | modulesn                            |             | bool   | Should we delete non-current disk data.                    |  The list of installed Opmantek modules.                                                                                    |
| delete_noncurrent_dns                | n        | | nmis                               | nbool   | Should we delete non-current dns data.                                | Enable import / export to NMIS functions.                                                                         |
| delete_noncurrent_file               | n                  | | nmis_url                      | bool    | Should we delete non-current file data.                                     | The web server address of NMIS.                                                                    |
| delete_noncurrent_ip                 | n                               | | oae_license        | bool   | Should we delete non-current ip data.      | none                                      | License status of Open-AudIT Enterprise.                                                               |
| delete_noncurrent_log                | n                            | | oae_product           | bool   | Should we       | Open-AudIT Community delete non-current log data.                     | The name of the installed commercial application.                                                                                    |
| delete_noncurrent_memory               | |n oae_prompt                         | 2017-06-28              | bool   | Should we delete non-current memory data.        | Prompt to activate a license for Open-AudIT Enterprise.                                                                                               |
| oaedelete_noncurrent_urlmodule             |  n             | /omk/open-audit                           | Thebool web server address| ofShould Open-AudIT Enterprisewe delete non-current module data.                                                                                                      | | page_refresh     |
| delete_noncurrent_monitor            | n     | 300                                   | bool   | IntervalShould inwe secondsdelete between autonon-refreshingcurrent themonitor pagedata. Set to 0 to cancel auto-refresh.                                                                | | process_netstat_windows_dns        |                            |
| delete_noncurrent_motherboard        | n    | Should we keep track of Windows netsta ports used by DNS above port 1000.                       | bool   | Should we delete non-current motherboard data.                                            | | rss_enable                         | y                                |
| delete_noncurrent_netstat       | Enable the RSS feed. | y                                         | bool   | Should we delete non-current netstat data.                                                                             | | rss_url                             | https://community.opmantek.com/rss/OA.xml | The RSS feed URL.
| delete_noncurrent_network            | n                                         | bool   | Should we delete non-current network data.                                                                                                            |
| delete_noncurrent_nmap               | n  uuid                                | 980906d2-5994-11e7-a4a3-1c1b0d60813b      | bool  The unique| identfierShould ofwe thisdelete Opennon-AudITcurrent nmap serverdata.                                                                                                        |
+------------------------------------+-------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+       |
| 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.