UAC is a Live Response collection script for Incident Response that makes use of native binaries and tools to automate the collection of AIX, Android, ESXi, FreeBSD, Linux, macOS, NetBSD, NetScaler, OpenBSD and Solaris systems artifacts.
--debug option now does not remove the uac-data.tmp directory created in the destination directory. This is the location where temporary and debugging data is stored during execution.
Artifacts
files/applications/box_drive.yaml: Renamed to box.yaml.
files/applications/box.yaml: Added collection support for Box log files [macos].
files/applications/wget.yaml: Added collection support for wget hsts file. This file is used to store the HSTS cache for the wget utility [aix, esxi, freebsd, linux, macos, netbsd, openbsd, solaris] (by firexfly).
files/browsers/brave.yaml: Updated collection support for Flatpak version [linux].
files/browsers/chrome.yaml: Updated collection support for Flatpak version [linux].
files/browsers/edge.yaml: Updated collection support for Flatpak version [linux].
files/browsers/opera.yaml: Updated collection support for Flatpak version [linux].
files/browsers/vivaldi.yaml: Updated collection support for Flatpak version [linux].
files/packages/pkg_contents.yaml: Added collection support for package table of contents files [openbsd] (by Herbert-Karl).
files/system/desktop.yaml: Added collection support for GUI shortcut files (.desktop) of users [freebsd, linux, netbsd, openbsd] (by Herbert-Karl).
files/system/etc.yaml: Added "master.passwd" and "spwd.db" to the exclude_name_pattern list as they contain the hashed passwords of local users [freebsd, netbsd, netscaler, openbsd] (by Herbert-Karl).
files/system/etc.yaml: Added exclusion for the group shadow files 'gshadow' and 'gshadow-'. Those files contain password hashes for groups [linux] (by Herbert-Karl).
files/system/xsession_errors.yaml: Updated collection support for OpenBSD systems [openbsd] (by Herbert-Karl).
live_response/network/ndp.yaml: Added collection support for kernel's IPv6 network neighbor cache [freebsd, netbsd, openbsd] (by Herbert-Karl).
live_response/network/nft.yaml: Added collection support for complete nftables ruleset [linux] (by sanderu).
live_response/network/ss.yaml: Updated collection support for processes listening on UDP ports/sockets [android, linux].
live_response/vms/vmctl.yaml: Added collection support for information about running virtual machines on the OpenBSD using the native virtualization system [openbsd] (by Herbert-Karl).
Fixes
Offline disk image mount point path was part of the file structure in [root] (by maxspl).
Collected data was not being properly archived by tar in AIX systems.
Profiles
profiles/offline.yaml: New 'offline' profile that can be used during offline collections (by randomaccess3).
files/applications/findmy.yaml: Added the collection of the list of user's items/devices and items/devices info registered within the Find My application [macos].
files/applications/rclone.yaml: Added the collection of rclone application configuration and log files [freebsd, linux, macos, netbsd, openbsd, solaris].
files/applications/rustdesk.yaml: Added the collection of RustDesk application access logs and screen recording files [linux, macos].
files/applications/splashtop.yaml: Added the collection of Splashtop application artifacts [linux, macos].
files/applications/steam.yaml: Added the collection of Steam browser artifacts, avatar pictures, configuration and log files [linux, macos].
files/applications/teamviewer.yaml: Added the collection of TeamViewer application artifacts [linux, macos].
files/applications/thinlinc.yaml: Added the collection of ThinLinc application configuration files, connections and post-session logs [linux, macos].
files/package/installed_applications: Added the collection of Info.plist from installed applications [macos].
files/system/netscaler.yaml: Added the collection of '/var/vpn', '/var/netscaler/logon', and '/netscaler/ns_gui' system files and directories [netscaler].
files/system/nsconfig.yaml: Deprecated. All artifacts were moved to 'files/system/netscaler.yaml' [netscaler].
live_response/storage/mdadm.yaml: Added the collection of information on Linux software RAID [linux].
live_response/storage/zpool.yaml: Added the collection of the command history of all pools [aix, freebsd, linux, macos, netbsd, netscaler, openbsd, solaris].
Tools
AVML updated to v0.12.0.
v2.6.0
1 year ago
Changelog
2.6.0 (2023-05-31)
Artifacts
live_response/containers/lxc.yaml: Added the collection of information about all active and inactive Linux containers and virtual machines (LXD), including their configuration, network, and storage information [linux].
live_response/containers/pct.yaml: Added the collection of information about all active and inactive Linux containers (LXC) running on Proxmox VE [linux].
live_response/containers/pct.yaml: Added the collection of the current configuration of Linux containers (LXC) running on Proxmox VE [linux].
live_response/containers/pct.yaml: Added the collection of the list of assigned CPU sets for each Linux container (LXC) running on Proxmox VE [linux].
live_response/process/deleted.yaml: Added the collection of files being hidden in a memfd socket [linux].
live_response/storage/arcstat.yaml: Added the collection of ZFS ARC and L2ARC statistics [freebsd, linux, netbsd, openbsd, solaris].
live_response/storage/findmnt.yaml: Added the collection of all mounted filesystems in the tree-like format [linux].
live_response/storage/iostat.yaml: Updated the collection of device I/O statistics [aix, freebsd, linux, openbsd, solaris].
live_response/storage/iscsiadm.yaml: Added the collection of information about iSCSI connected devices [linux].
live_response/storage/ls_dev_disk.yaml: Added the collection of the mapping of logical volumes with physical disks [linux].
live_response/storage/pvesm.yaml: Added the collection of status for all Proxmox VE datastores [linux].
live_response/system/ha-manager.yaml: Added the collection of information about Proxmox VE HA manager status [linux].
live_response/system/hidden_directories.yaml: Updated max_depth value to 6 [all].
live_response/system/hidden_files.yaml: Updated max_depth value to 6 [all].
live_response/system/kernel_tainted_state.yaml: Added the collection of the kernel tainted state [linux].
live_response/system/kernel_tainted_state.yaml: Added the collection of the list of what modules are marked at tainting the kernel [linux].
live_response/system/pvecm.yaml: Added the collection of information about Proxmox VE local view of the cluster nodes [linux].
live_response/system/pvecm.yaml: Added the collection of information about Proxmox VE local view of the cluster status [linux].
live_response/system/pvesubscription.yaml: Added the collection of Proxmox VM subscription information [linux].
live_response/system/pveum.yaml: Added the collection of Proxmox VE users and groups list [linux].
live_response/system/pveversion.yaml: Added the collection of version information for Proxmox VE packages [linux].
live_response/system/sgid.yaml: Updated max_depth value to 6 [all].
live_response/system/socket_files.yaml: Updated max_depth value to 6 [all].
live_response/system/suid.yaml: Updated max_depth value to 6 [all].
live_response/system/world_writable_directories.yaml: Updated max_depth value to 6 [all].
live_response/system/world_writable_files.yaml: Updated max_depth value to 6 [all].
live_response/vms/qm.yaml: Added the collection of information about all active and inactive virtual machines running on Proxmox VE [linux].
live_response/vms/qm.yaml: Added the collection of the current configuration of virtual machines running on Proxmox VE [linux].
Artifacts File
'loop_command' property was renamed to 'foreach'. Don't forget to update your custom artifacts files as 'loop_command' property name will be removed in the next release.
Tools
AVML updated to v0.11.2.
v2.5.0
1 year ago
Features
Added extraction of memory sections and strings from '/proc/[pid]/mem' using the data available in '/proc/[pid]/maps', even if processes are shown up as being (deleted). This functionality is enabled via 'tools/linux_procmemdump.sh' script.
Artifacts file: Added a new option to define a custom output file name where the standard error messages (stderr stream) will be stored in. Please check the project's documentation page for more information.
Artifacts
files/applications/anydesk.yaml: Added the collection of AnyDesk configuration, chat transcript, screenshot, session recording and trace files [freebsd, linux, macos].
files/applications/box_drive.yaml: Added the collection of Box Drive client configuration and sqlite database files [macos].
files/applications/qnap_qsync.yaml: Added the collection of QNAP Qsync client configuration and log files [linux, macos].
files/applications/spotlight_shortcuts.yaml: Added the collection of searches that a user performed in the Spotlight application [macos].
files/applications/synology_drive.yaml: Added the collection of Synology Drive client configuration, database and log files [linux, macos].
files/system/coreanalytics.yaml: Added the collection of information about the system usage and application execution history [macos].
files/system/powerlog.yaml: Added the collection of Powerlog archive files [macos].
live_response/network/ip6tables.yaml: Added the collection of firewall rules information using ip6tables tool [android, linux].
live_response/network/iptables.yaml: Updated command parameters to support legacy iptables versions [android, linux].
live_response/network/lsof.yaml: Added the listing of UNIX domain socket files.
live_response/packages/synopkg.yaml: Added the collection of installed packages on Synology DSM systems [linux].
live_response/process/deleted.yaml: Added the collection of process memory sections and strings (for processes shown up as being deleted) from '/proc/[pid]/mem' [linux].
live_response/system/lastlog.yaml: Added the collection of the last login log '/var/log/lastlog' file [linux].
live_response/system/timedatectl.yaml: Added the collection of current settings of the system clock and RTC, including whether network time synchronization is active or not [linux].
memory_dump/process_memory_sections_strings.yaml: Added the collection of process memory sections and strings from '/proc/[pid]/mem' [linux].
memory_dump/process_memory_strings.yaml: Added the collection of process memory strings only from '/proc/[pid]/mem' [linux].
Profiles
full.yaml: Updated the artifacts collection order. 'bodyfile/bodyfile.yaml' artifact is now collected sooner.
ir_triage.yaml: Updated the artifacts collection order. 'bodyfile/bodyfile.yaml' artifact is now collected sooner.
Tools
AVML updated to v0.11.0.
v2.4.1
1 year ago
Fixed
macOS FSEvents were not being collected from additional volumes located at '/System/Volumes' (files/logs/macos.yaml).
macOS Timesync files location was fixed (files/logs/macos_unified_logs.yaml).
v2.4.0
1 year ago
New Features
Added '--ibm-cos-url' switch which allows for pushing the output file to IBM Cloud Object Storage (if curl is available) (#106).
Added '--ibm-cos-url-log-file' switch which allows for pushing the output log file to IBM Cloud Object Storage (if curl is available) (#106).
Added '--ibm-cloud-api-key' switch which is required for transferring files to IBM Cloud Object Storage (#106).
Added '--azure-storage-sas-url' switch which allows for pushing the output file to Azure Storage using shared access signature (SAS) URLs (if curl is available) (#62).
Added '--azure-storage-sas-url-log-file' switch which allows for pushing the output log file to Azure Storage using shared access signature (SAS) URLs (if curl is available) (#62).
AVML was updated to v0.9.0.
New Artifacts
New artifact that collects macOS Biome data files (if SIP is disabled) (files/system/biome.yaml).
New artifact that collects macOS saved application state files (files/system/saved_application_state.yaml).
New artifact that collects macOS Unified Logs UUID and Timesync files (files/logs/macos_unified_logs.yaml).
New artifact that collects macOS System Integrity Protection (SIP) status (live_response/system/csrutil.yaml).
New artifact that collects macOS login items installed using the Service Management framework (files/system/startup_items.yaml).
New artifact that collects macOS installed updates history information (live_response/packages/softwareupdate.yaml).
New artifact that collects SSH rc files (files/ssh/rc.yaml).
New artifact that collects Google Earth KML files (files/applications/google_earth.yaml).
New artifact that collects the status of firewall and ufw managed rules (live_response/network/ufw.yaml).
New artifact that collects kernel audit status and rules on Linux systems (live_response/system/auditctl.yaml).
New artifact that collects installed packages on Gentoo Linux systems (live_response/packages/qlist.yaml).
New artifact that collects the values of parameters in the EEPROM on Solaris systems (live_response/system/eeprom.yaml).
New artifact that collects information about installed zones on Solaris systems (live_response/system/zoneadm.yaml).
Updated Artifacts
'files/system/var_db_diagnostics.yaml' was moved and renamed to 'files/logs/macos_unified_logs.yaml'.
v2.4.0-rc1
1 year ago
New Features
Added '--ibm-cos-url' switch which allows for pushing the output file to IBM Cloud Object Storage (if curl is available) (#106).
Added '--ibm-cos-url-log-file' switch which allows for pushing the output log file to IBM Cloud Object Storage (if curl is available) (#106).
Added '--ibm-cloud-api-key' switch which is required for transferring files to IBM Cloud Object Storage (#106).
Added '--azure-storage-sas-url' switch which allows for pushing the output file to Azure Storage using shared access signature (SAS) URLs (if curl is available) (#62).
Added '--azure-storage-sas-url-log-file' switch which allows for pushing the output log file to Azure Storage using shared access signature (SAS) URLs (if curl is available) (#62).
AVML was updated to v0.9.0.
New Artifacts
New artifact that collects macOS Biome data files (if SIP is disabled) (files/system/biome.yaml).
New artifact that collects macOS saved application state files (files/system/saved_application_state.yaml).
New artifact that collects macOS Unified Logs UUID and Timesync files (files/logs/macos_unified_logs.yaml).
New artifact that collects macOS System Integrity Protection (SIP) status (live_response/system/csrutil.yaml).
New artifact that collects macOS login items installed using the Service Management framework (files/system/startup_items.yaml).
New artifact that collects macOS installed updates history information (live_response/packages/softwareupdate.yaml).
New artifact that collects SSH rc files (files/ssh/rc.yaml).
New artifact that collects Google Earth KML files (files/applications/google_earth.yaml).
New artifact that collects the status of firewall and ufw managed rules (live_response/network/ufw.yaml).
New artifact that collects kernel audit status and rules on Linux systems (live_response/system/auditctl.yaml).
New artifact that collects installed packages on Gentoo Linux systems (live_response/packages/qlist.yaml).
New artifact that collects the values of parameters in the EEPROM on Solaris systems (live_response/system/eeprom.yaml).
New artifact that collects information about installed zones on Solaris systems (live_response/system/zoneadm.yaml).
Updated Artifacts
'files/system/var_db_diagnostics.yaml' was moved and renamed to 'files/logs/macos_unified_logs.yaml'.
v2.3.0
1 year ago
New Features
You can now use as many --artifacts (-a) and --profile (-p) as you want to build an even more customized collection. Artifacts will be collected in the order they were provided in the command line. Please check the project's documentation page for more information.
UAC now collects copies of '/proc/[pid]/fd/*' from deleted processes even if they are not shown up as being (deleted).
AVML was updated to v0.7.0.
New Artifacts
New artifact that collects the contents of /dev/shm (files/system/dev_shm.yaml) (#68).
New artifact that collects the contents of /run/shm (files/system/run_shm.yaml) (#68).
New artifact that collects the contents of /var/tmp (files/system/var_tmp.yaml) (#68).
New artifact that lists hidden files created outside of user home directories (live_response/system/hidden_files.yaml) (#69).
New artifact that lists hidden directories created outside of user home directories (live_response/system/hidden_directories.yaml) (#69).
New artifact that lists world writable files (live_response/system/world_writable_files.yaml).
New artifact that lists world writable directories (live_response/system/world_writable_directories.yaml).
New artifact that lists loaded kernel modules from /sys/module directory (live_response/system/sys_module.yaml).
New artifact that collects last logins and logouts (live_response/system/last.yaml).
New artifact that collects unsuccessful logins (live_response/system/lastb.yaml).
New artifact that lists all socket files (live_response/system/socket_files.yaml).
New artifact that collects sessions files from /run/systemd/sessions (files/system/systemd.yaml).
New artifact that collects scope files from /run/systemd/transient (files/system/systemd.yaml).
New artifact that collects Vivaldi browser artifacts (files/browsers/vivaldi.yaml).
New artifact that collects Linux terse runtime status information about one or more logged in users, followed by the most recent log data from the journal (live_response/system/loginctl.yaml).
New artifact that collects fish shell history files (files/shell/history.yaml).
New artifact that collects Tracker database files (files/system/tracker.yaml).
New artifact that collects macOS .DS_Store files (files/system/ds_store.yaml).
New artifact that collects macOS network and application usage database files (files/system/network_application_usage.yaml).
New artifact that collects macOS Powerlog files (files/system/powerlog.yaml).
New artifact that collects macOS recovery account information files (files/system/recovery_account_info.yaml).
New artifact that collects macOS system keychain file (files/system/keychain.yaml).
New artifact that collects macOS system version file (files/system/system_version.yaml).
New artifact that collects macOS unified logging and activity tracing files (files/system/var_db_diagnostics.yaml).
New artifact that collects macOS time machine information (live_response/system/tmutil.yaml).
New artitact that collects macOS Photos application database files (files/applications/photos.yaml).
New artifact that collects AIX failed login attemtps from /etc/security/failedlogin (live_response/system/who.yaml).
Updated Artifacts
/dev was removed from the exclusion list during deleted process collection (#65).
files/system/time_machine.yaml, files/system/wifi.yaml, files/applications/macos_dock.yaml are no longer available because the same artifacts are been collected by files/system/library_preferences.yaml.
Deprecated Command Line Option
'-o' command line switch is no longer available because it was replaced by '-s'.
Deprecated Profiles
'full-with-memory-dump' profile is no longer available because '-a memory_dump/avml.yaml -p full' can be used instead.
'memory-dump-only' profile is no longer available because '-a memory_dump/avml.yaml' can be used instead.
Fixed
UAC now copies all collected artifacts to a destination directory if 'tar' tool is not available (#63).
v2.2.0
2 years ago
New Features
VMware ESXi is now fully supported as an operating system. Note that ESXi is not built upon the Linux kernel, and uses its own VMware proprietary kernel (the VMkernel) and software. So it misses most of the applications and components that are commonly found in all Linux distributions (#33).
UAC now collects copies of '/proc/[pid]/exe' and their related '/proc/[pid]/fd/*' if they are shown up as being (deleted). They are copied using 'dd conv=swab' tool in order to avoid UAC output file being flagged and quarantined by any antivirus tool (#36).
Added '--s3-presigned-url' switch which allows for pushing the output file to S3 presigned URLs (if curl available) (#38).
Added '--s3-presigned-url-log-file' switch which allows for pushing the output log file to S3 presigned URLs (if curl available) (#38).
Added '--delete-local-on-successful-transfer' switch which will delete both local output and log files after they are successfully transferred either via sftp or to a presigned S3 URL.
New artifact to collect ESXi running processes information (live_response/process/esxcli.yaml).
New artifact to collect ESXi network connections information (live_response/network/esxcli.yaml and live_response/network/vim-cmd.yaml).
New artifact to collect ESXi hardware information (live_response/hardware/esxcli.yaml).
New artifact to collect ESXi system information (live_response/system/esxcli.yaml).
New artifact to collect ESXi packages information (live_response/packages/esxcli.yaml).
New artifact to collect ESXi storage information (live_response/storage/esxcli.yaml and live_response/storage/ls_vmfs_devices.yaml).
New artifact to collect ESXi running virtual machines information (live_response/vms/esxcli.yaml, live_response/vms/vm-support.yaml and live_response/vms/vim-cmd.yaml).
New artifact to collect ESXi log files located in /var/run/log directory (files/logs/var_run_log.yaml).
New artifact to collect the binary of (malicious) processes after they have been deleted (live_response/process/deleted.yaml).
New artifact to collect files of (malicious) processes after they have been deleted (live_response/process/deleted.yaml).
New artifact to collect Linux NetworkManager files (files/system/networkmanager.yaml).
New artifacts added to 'live_response/process/procfs_information.yaml' (#35):
ls -l /proc/[pid]/cwd
cat /proc/[pid]/stack
cat /proc/[pid]/status
New artifact was added to 'live_response/containers/docker.yaml':
docker stats --all --no-stream --no-trunc
docker network ls
docker network inspect [network_id]
docker volume ls
docker volume inspect [volume_name]
docker diff [container_id]
New artifact was added to 'live_response/containers/podman.yaml':
podman stats --all --no-stream
podman network ls
podman network inspect [network_id]
podman volume ls
podman volume inspect [volume_name]
podman diff [container_id]
Updated Artifacts
ESXi support was added to the following artifacts:
live_response/process/ps.yaml
live_response/process/lsof.yaml
live_response/process/hash_running_processes.yaml
live_response/network/hostname.yaml
live_response/network/ifconfig.yaml
live_response/network/lsof.yaml
live_response/network/netstat.yaml
live_response/storage/mount.yaml
'files/applications/icloud_drive.yaml' was renamed to 'files/applications/icloud.yaml'.
A new artifact to collect iCloud accounts information files was added to 'files/applications/icloud.yaml'.
Deprecated
'-o' command line switch was replaced by '-s', and will be removed in the next release. So don't forget to update your documentation.
'--sftp-delete-local-on-success' command line switch was replaced by '--delete-local-on-successful-transfer'.
Fixed
Issue that was preventing UAC to collect files from home directories when executing it via EDR and the system HOME variable was not set by the current shell (#47).
v2.2.0-rc1
2 years ago
New Features
VMware ESXi is now fully supported as an operating system. Note that ESXi is not built upon the Linux kernel, and uses its own VMware proprietary kernel (the VMkernel) and software. So it misses most of the applications and components that are commonly found in all Linux distributions (#33).
UAC now collects copies of '/proc/[pid]/exe' and their related '/proc/[pid]/fd/*' if they are shown up as being (deleted). They are copied using 'dd conv=swab' tool in order to avoid UAC output file being flagged and quarantined by any antivirus tool (#36).
Added '--s3-presigned-url' switch which allows for pushing the output file to S3 presigned URLs (if curl available) (#38).
Added '--s3-presigned-url-log-file' switch which allows for pushing the output log file to S3 presigned URLs (if curl available) (#38).
Added '--delete-local-on-successful-transfer' switch which will delete both local output and log files after they are successfully transferred either via sftp or to a presigned S3 URL.
New artifact to collect ESXi running processes information (live_response/process/esxcli.yaml).
New artifact to collect ESXi network connections information (live_response/network/esxcli.yaml and live_response/network/vim-cmd.yaml).
New artifact to collect ESXi hardware information (live_response/hardware/esxcli.yaml).
New artifact to collect ESXi system information (live_response/system/esxcli.yaml).
New artifact to collect ESXi packages information (live_response/packages/esxcli.yaml).
New artifact to collect ESXi storage information (live_response/storage/esxcli.yaml).
New artifact to collect ESXi running virtual machines information (live_response/vms/esxcli.yaml, live_response/vms/vm-support.yaml and live_response/vms/vim-cmd.yaml).
New artifact to collect ESXi log files located in /var/run/log directory (files/logs/var_run_log.yaml).
New artifact to collect the binary of (malicious) processes after they have been deleted (live_response/process/deleted.yaml).
New artifact to collect files of (malicious) processes after they have been deleted (live_response/process/deleted.yaml).
New artifacts added to 'live_response/process/procfs_information.yaml' (#35):
ls -l /proc/[pid]/cwd
cat /proc/[pid]/stack
cat /proc/[pid]/status
New artifact was added to 'live_response/containers/docker.yaml':
docker stats --all --no-stream --no-trunc
docker network ls
docker network inspect [network_id]
docker volume ls
docker volume inspect [volume_name]
docker diff [container_id]
New artifact was added to 'live_response/containers/podman.yaml':
podman stats --all --no-stream
podman network ls
podman network inspect [network_id]
podman volume ls
podman volume inspect [volume_name]
podman diff [container_id]
Updated Artifacts
ESXi support was added to the following artifacts:
live_response/process/ps.yaml
live_response/process/lsof.yaml
live_response/process/hash_running_processes.yaml
live_response/network/hostname.yaml
live_response/network/ifconfig.yaml
live_response/network/lsof.yaml
live_response/network/netstat.yaml
live_response/storage/mount.yaml
Deprecated
'-o' command line switch was replaced by '-s', and will be removed in the next release. So don't forget to update your documentation.
'--sftp-delete-local-on-success' command line switch was replaced by '--delete-local-on-successful-transfer'.