Releases: cisagov/Malcolm
Malcolm v5.2.9
Malcolm v5.2.9 is a release to fix a regression introduced in v5.2.9 (see idaholab#84), affecting the Malcolm REST API and generation of intelligence files for Zeek. If you don't use those features, you may choose to skip this release. My apologies for putting this out so close to the last release.
- Bug fixes
- Fix idaholab#84 ("upstream incompatibility between python regex library 2022.3.15 and dateparser breaks API")
Malcolm and Hedgehog Linux may be obtained by pulling or building the Docker images and/or building the ISO installer images as described in the documentation. Unofficial ISO installer images for Malcolm and Hedgehog Linux are not hosted on GitHub, but may be downloaded from https://malcolm.fyi/download/.
Malcolm v5.2.8
Malcolm v5.2.8 is a release to patch a major security vulnerability in OpenSSL.
-
Version bumps
- Arkime to v3.4.1
- Spicy to v1.4.0
- Update all docker images' system packages to get latest security updates, including updating OpenSSL to fix CVE-2022-0778
- CVE-2022-0778 can already be detected in network traffic by Malcolm by 0xxon/cve-2020-0601
-
Minor improvements
- Include
gvfs-backends
package in ISO-installed environments to allow mounting SMB shares in the Thunar GUI
- Include
-
Bug fixes
- Fix an issue with "read-only mode" combined with "no SSL mode" (very unlikely to have affected anybody)
- Tweak Logstash pipeline size to make it a little more conservative to avoid Logstash restarts due to running out of heap resources
Malcolm and Hedgehog Linux may be obtained by pulling or building the Docker images and/or building the ISO installer images as described in the documentation. Unofficial ISO installer images for Malcolm and Hedgehog Linux are not hosted on GitHub, but may be downloaded from https://malcolm.fyi/download/.
Malcolm v5.2.7
Malcolm v5.2.7 is a patch release with improvements and bug fixes.
-
Bugs fixed
- fixed instances where
spicy_
will sometimes be prepended tonetwork.protocol
fields (e.g.,spicy_wireguard
is now fixed to just bewireguard
)
- fixed instances where
-
Improvements
- base GitHub workflow files' docker build step on moby/buildkit:master
- added API webhook that can be used as an Alerting destionation for alerts to be indexed back into the OpenSearch database as session records
- added example Alerting monitor and destination using API webhook
- added ability to run Malcolm's
nginx-proxy
container in non-HTTPs mode (not recommended unless running behind a third-party reverse proxy like Traefik or Caddy, in which case it is very useful) - removed performance-analyzer plugin from OpenSearch container to free up resources
- improvements to documentation for Anomaly Detection and Alerting
- added example scripts and Vagrantfile for easily configuring and running Malcolm in a read-only or demo mode on Amazon Linux 2 (useful for AWS)
-
Version bumps
Malcolm and Hedgehog Linux may be obtained by pulling or building the Docker images and/or building the ISO installer images as described in the documentation. Unofficial ISO installer images for Malcolm and Hedgehog Linux are not hosted on GitHub, but may be downloaded from https://malcolm.fyi/download/.
Malcolm v5.2.6
Malcolm v5.2.6 is a patch release with improvements and bug fixes.
-
Bugs fixed
- Fixed Logstash failing to start idaholab#78
- Added tuning options to address Logstash out of memory errors idaholab#79
- Incorporated latest bugfixes in BACnet parser
- Fixed issue with mapping some field types being incorrect for BSAP and OSPF logs
-
Improvements
- Added http-more-files-names plugin to populate files.log filenames entries for HTTP requests
- Normalized bsap_ip_header.type_name to event.action
- Removed unnecessary Logstash field conversions for types already defined in the template
- Improved
logs
andstatus
convenience scripts to allow filtering to a particular service - Improved convenience script for working with GitHub workflows during Malcolm development
Malcolm and Hedgehog Linux may be obtained by pulling or building the Docker images and/or building the ISO installer images as described in the documentation. Unofficial ISO installer images for Malcolm and Hedgehog Linux are not hosted on GitHub, but may be downloaded from https://malcolm.fyi/download/.
Malcolm v5.2.5
Malcolm v5.2.5 is a patch release with improvements and bug fixes.
-
Threat Intelligence
- idaholab#77 - automatically generate Zeek intelligence indicators from MISP
- perform autogeneration of Zeek intel files from TAXII/MISP feeds multithreaded
- allow filtering indicators from TAXII/MISP by date (e.g., "only include those created/modified in the last n days", etc.)
- added intelligence hits as a new severity ranked category
- highlight intel sources more clearly in dashboard
-
Hedgehog Linux (sensor appliance)
- added
sensormonitor
convenience function to monitor services, disk space and logs
- added
-
Bug fixes
- Remove CIP fields no longer supplied by the ICSNPP EtherNet/IP parser and update dashboard accordingly
- idaholab#76 - directory creation race condition starting up zeek on sensor which may cause zeekctl to fail
- #189 - mount destination [/opt/zeek/share/zeek/site/intel] not absolute: unknown
Malcolm and Hedgehog Linux may be obtained by pulling or building the Docker images and/or building the ISO installer images as described in the documentation. Unofficial ISO installer images for Malcolm and Hedgehog Linux are not hosted on GitHub, but may be downloaded from https://malcolm.fyi/download/.
Malcolm v5.2.4
Malcolm v5.2.4 is a patch release with improvements and bug fixes.
-
New features
- idaholab#74 (automatically generate Zeek intelligence indicators from STIX/TAXII)
-
Improvements
- group MAC addresses and OUI (vendors) into
related.mac
andrelated.oui
for easier searching across all fields - improvements to default anomaly detectors
- group MAC addresses and OUI (vendors) into
-
Bug fixes
- Fix idaholab#75 (OpenSearch Dashboards loads slowly without network connectivity)
- Fix idaholab#76 (directory creation race condition starting up zeek on sensor which may cause zeekctl to fail)
Malcolm and Hedgehog Linux may be obtained by pulling or building the Docker images and/or building the ISO installer images as described in the documentation. Unofficial ISO installer images for Malcolm and Hedgehog Linux are not hosted on GitHub, but may be downloaded from https://malcolm.fyi/download/.
Malcolm v5.2.3
Malcolm v5.2.3 is a patch release with component version bumps, bug fixes and improvements.
-
Version bumps
-
Improvements
- Added script and better documentation for putting Malcolm in "read-only" mode
- Improved
Files
dashboard
-
Bug fixes
- Fixed an issue where Logstash wasn't parsing the
ftime
fromfiles.log
correctly (a field added by the Spicy ZIP analyzer) - Fixed idaholab#73 (path for tcpdump changed) for Hedgehog Linux
- Fixed idaholab#72 (better file directory/name parsing and normalization in Logstash)
- Fixed an issue where Logstash wasn't parsing the
Malcolm and Hedgehog Linux may be obtained by pulling or building the Docker images and/or building the ISO installer images as described in the documentation. Unofficial ISO installer images for Malcolm and Hedgehog Linux are not hosted on GitHub, but may be downloaded from https://malcolm.fyi/download/.
Malcolm v5.2.2
Malcolm v5.2.2 is a patch release with some improvements to the API and a fix for using Zeek intelligence files on Hedgehog Linux.
- Added more capabilities to the API
- added
/document/
API - added
filter
ability to/agg/
and/document/
API - added more documentation and examples
- added
- For Zeek intel. files, changed location from
/opt/zeek/share/zeek/site/intel
to/opt/sensor/sensor_ctl/zeek/intel
so that they aren't lost on reboot
Malcolm and Hedgehog Linux may be obtained by pulling or building the Docker images and/or building the ISO installer images as described in the documentation. Unofficial ISO installer images for Malcolm and Hedgehog Linux are not hosted on GitHub, but may be downloaded from https://malcolm.fyi/download/.
Malcolm v5.2.1
Malcolm v5.2.1 is patch release identical to v5.2.0 with the addition of a fix (arkime/arkime@f13e936) for a regression bug introduced in Arkime v3.3.0 which prevented the Arkime viewer from correctly loading some large or XORed packets.
In addition, a minor change was made to the startup scripts for Hedgehog Linux's Zeek configuration to allow Zeek intelligence files to be automatically loaded the same way they are in Malcolm's Zeek container.
Malcolm and Hedgehog Linux may be obtained by pulling or building the Docker images and/or building the ISO installer images as described in the documentation. Unofficial ISO installer images for Malcolm and Hedgehog Linux are not hosted on GitHub, but may be downloaded from https://malcolm.fyi/download/.
Malcolm v5.2.0
Malcolm v5.2.0 is a feature release with a several new features and improvements, version bumps and bug fixes.
EDIT: As of this morning (1/21/2022) I'm tracking a regression in Arkime v3.3.0 with viewing the packet payload of some large sessions. It's likely a patch release will be put out later today to address this. Apologies.
-
New features
- Zeek Intelligence Framework (see idaholab#20)
- To quote Zeek's Intelligence Framework documentation, "The goals of Zeek’s Intelligence Framework are to consume intelligence data, make it available for matching, and provide infrastructure to improve performance and memory utilization. Data in the Intelligence Framework is an atomic piece of intelligence such as an IP address or an e-mail address. This atomic data will be packed with metadata such as a freeform source field, a freeform descriptive field, and a URL which might lead to more information about the specific item." Zeek intelligence indicator types include IP addresses, URLs, file names, hashes, email addresses, and more.
- Malcolm doesn't come bundled with intelligence files from any particular feed, but they can be easily included into your local instance. On startup, Malcolm's
malcolmnetsec/zeek
docker container enumerates the subdirectories under./zeek/intel
(which is bind mounted into the container's runtime) and configures Zeek so that those intelligence files will be automatically included in its local policy. Subdirectories under./zeek/intel
which contain their own__load__.zeek
file will be@load
-ed as-is, while subdirectories containing "loose" intelligence files will be loaded automatically with aredef Intel::read_files
directive.
- New OPCUA Binary protocol parser for Zeek and corresponding dashboard.
- Zeek Intelligence Framework (see idaholab#20)
-
Improvements
- set
ecs.provider
toarkime
for logs from Arkime'scapture
to make categorizing logs by source easier - API
- allow bucketing multiple fields from
/agg/
API - added
/fields/
API to list fields
added documentation
- allow bucketing multiple fields from
- ECS normalization to
related.hosts
field for all applicable protocols - updated documentation, screenshots and slides
- spreadsheet mapping STIX v1.2 fields to Zeek fields and Malcolm normalized fields
- updated MITRE ATT&CK mappings for Capa hits
- added a pseudo-read-only NGINX configuration
- set
-
Version bumps
- Arkime to v3.3.0
- OpenSearch to v1.2.4
- Capa to v3.1.0
- cve-2021-44228 Log4Shell detector plugin for Zeek to v0.5.3 (see corelight/cve-2021-44228#46)
-
Bug Fixes
- fix idaholab#71 (type mismatch for network.vlan.id between Malcolm and Arkime definitions) which prevented vlan traffic from indexing correctly from Arkime's
capture
with Malcolm's field template - fix for ethernet/IP traffic which could lead to Zeek runaway memory allocation until crash: "Fixed bug with Request Paths containing Port Segments" (cisagov/icsnpp-enip@4696a43)
- fix idaholab#71 (type mismatch for network.vlan.id between Malcolm and Arkime definitions) which prevented vlan traffic from indexing correctly from Arkime's
Malcolm and Hedgehog Linux may be obtained by pulling or building the Docker images and/or building the ISO installer images as described in the documentation. Unofficial ISO installer images for Malcolm and Hedgehog Linux are not hosted on GitHub, but may be downloaded from https://malcolm.fyi/download/.