Skip to content

Releases: google/grr

GRR release 3.4.7.4

28 May 17:11
6c9efa0
Compare
Choose a tag to compare

Regular release.

Removed

  • GRR server Debian package. We stopped providing the GRR server Debian
    package as the main way of distributing GRR server and client binaries.
    Instead we make GRR Docker image a preferred way for running GRR in a
    demo or production environment. See the documentation here.
  • Removed support for Chipsec based flows.
  • Removed ClientArtifactCollector flow and related client actions.
  • Removed indexing endpoints on snapshot uname (searching is still possible
    by individual and combination of system name, release and version).
  • Removed support for foreman rules using uname of an endpoint (this can be
    simulated by using 3 rules for system name, release and version).
  • Removed the provides field from the Artifact message. This change has been
    done in anticipation of the removal of the same field from the official GitHub
    repository (ForensicArtifacts/artifacts#275).
  • Artifact parsers. ArtifactCollector flow supported parsing collected files
    and output of executed commands. Its parsers were not properly maintained,
    were often outdated and fragile. We're converted selected parsers
    into standalone flows (CollectDistroInfo, CollectInstalledSoftware,
    CollectHardwareInfo) and removed the artifact parsing subsystem.
    The ArtifactCollector now works as if "apply_parsers" arguments
    attribute is set to False. At some point the "apply_parsers" attribute will be
    deprecated completely.

Added

  • GRR docker image which contains all grr server components and client
    templates. It is available for every new GRR version for download at
    https://github.com/google/grr/pkgs/container/grr
  • Docker compose configuration file to run all GRR/Fleetspeak components in
    separate Docker containers.
  • Python API was extended by a function (DecodeCrowdStrikeQuarantineEncoding)
    to decode a crowdstrike quarantine encoded file, given as a
    BinaryChunkIterator.

Fixed

  • YARA memory scanning improvements (matching context options, consuming less bandwidth).

API removed

  • GetClientLoadStats API method (/api/clients/<client_id>/load-stats/<metric>).
    Client load stats collection functionality was removed from GRR, as
    it was rarely used and Fleetspeak already collects basic client stats anyway.
    Instead of fixing/maintaining the GRR client load stats logic, we will
    better to invest into Fleetspeak's client load stats enhancements.
  • ApiReportData definition (used by GetReport, /api/stats/reports/<name>)
    changed: support for stack, line and pie charts removed. All stack/line/pie
    chart report plugins removed (namely: GRRVersion1ReportPlugin,
    GRRVersion7ReportPlugin, GRRVersion30ReportPlugin, LastActiveReportPlugin,
    OSBreakdown1ReportPlugin, OSBreakdown7ReportPlugin, OSBreakdown14ReportPlugin,
    OSBreakdown30ReportPlugin, OSReleaseBreakdown1ReportPlugin,
    OSReleaseBreakdown7ReportPlugin, OSReleaseBreakdown14ReportPlugin,
    OSReleaseBreakdown30ReportPlugin, SystemFlowsReportPlugin,
    UserFlowsReportPlugin, MostActiveUsersReportPlugin, UserActivityReportPlugin).
  • GetFileDecoders API method
    (/api/clients/<client_id>/vfs-decoders/<path:file_path>). Getting file
    decoders functionality was removed as it was not used before.
  • GetDecodedFileBlob API method (/api/clients/<client_id>/vfs-decoded-blob/).
    Get decoded file blob functionality was removed as it was unused before. Only
    one decoder for decoding crowdstrike quarantine encoded files was implemented,
    this functionality is now exposed via the Python API.

GRR release 3.4.7.1

25 Oct 21:46
727545a
Compare
Choose a tag to compare

Note: this is the last release containing the following features:

  • Artifact parsers. ArtifactCollector flow supports parsing collected files and output of executed commands. Its parsers are not properly maintained, are often outdated and fragile. We're going to convert selected parsers into standalone flows and remove the artifact parsing subsystem: the ArtifactCollector will always work as if "apply_parsers" arguments attribute is set to False. Afterwards the "apply_parsers" attribute will be deprecated completely. We will provide documentation on integrating GRR and ArtifactCollector with well-maintained parsing frameworks like Plaso.

  • Built-in cron jobs. Built-in cron jobs are primarily used for periodic hunts. We will provide documentation on how to easily replicate the current functionality using external scheduling systems (like Linux cron, for example).

    If your workflow depends on GRR built in cron jobs and you anticipate problems when migrating it to external schedulers, please reach out to us via email or GitHub.

  • GRR server Debian package. We will stop providing the GRR server Debian package as the main way of distributing GRR server and client binaries. Instead we will make GRR Docker image a preferred way for running GRR in a demo or production environment.

If your workflow depends on any of the above, please feel free reach out to us via grr-users Google Group or GitHub.

Added

  • Created a flow for collecting an identifier of the CrowdStrike agent.
  • Podman-based zero-setup development environment.
  • Added StatMultipleFiles and HashMultipleFiles flows to be used in UIv2.

Changed

  • Renamed AdminUI.new_hunt_wizard.default_output_plugin to AdminUI.new_hunt_wizard.default_output_plugins (note the "s" in the end). The new option accepts a comma-separated list of names.
  • Newly interrogated clients now pick up active hunts automatically.
  • Hunts workflow is now available in the new UI: creating hunts from a flow, duplicating existing hunts, monitoring hunt progress and inspecting results.

Removed

  • Fully removed deprecated use_tsk flag.
  • Removed deprecated plugin_args field from OutputPluginDescriptor.
  • Removed deprecated flows: FingerprintFile, KeepAlive, FingerprintFile, FindFiles, SendFile, Uninstall, UpdateClient, CollectEfiHashes, DumpEfiImage.
  • Deprecated GetFile flow in favor of MultiGetFile.
  • Made FileFinder an alias to ClientFileFinder, using ClientFileFinder by default everywhere. Legacy FileFinder is still available as LegacyFileFinder. Fixed several inconsistencies in ClientFileFinder client action. Same for RegistryFinder.
  • Removed deprecated client actions: EficheckCollectHashes, EficheckDumpImage, Uninstall, SendFile.
  • Removed "Checks" functionality.

API removed

  • Deprecated no-op "keep_client_alive" attribute in ApiCreateClientApprovalArgs.
  • Deprecated ListClientActionRequests API call (was no-op after Fleetspeak migration).

GRR release 3.4.6.7

22 Mar 22:25
7f93f8b
Compare
Choose a tag to compare

Updates:

  • Server DEB package now targets Ubuntu 22.04 LTS.
  • Agents are now Python 3.9-based (server deb package is Python 3.10-based).
  • MySQL-based datastore performance considerably improved.
  • UIv2 supports majority of flows and hunts.
  • Third-party dependencies updated.
  • A lot of minor bugfixes and improvements.

GRR release 3.4.6.0

30 May 09:19
c6f3b19
Compare
Choose a tag to compare

Regular release for Q2 2022.

Download the server deb for Ubuntu 18.04 from here.

Please see the release notes.

GRR release 3.4.5.1

23 Aug 09:37
Compare
Choose a tag to compare

Mid-quarter release for Q3 2021.

Download the server deb for Ubuntu 18.04 from here.

Please see the release notes.

GRR release 3.4.3.1

19 May 21:01
Compare
Choose a tag to compare

Regular release for Q2 2021.

Download the server deb for Ubuntu 18.04 from here.

Please see the release notes.

GRR release 3.4.2.4

15 Oct 09:41
Compare
Choose a tag to compare

Minor bug-fix release on top of v3.4.2.3.

Download the server deb for Ubuntu 18.04 from here.

Please see the release notes.

GRR release 3.4.2.3

05 Oct 10:46
Compare
Choose a tag to compare

Quarterly release for Q3 2020.

Download the server deb for Ubuntu 18.04 from here.

Please see the release notes.

GRR release 3.4.2.0

07 Jul 12:58
Compare
Choose a tag to compare

Quarterly release for Q2 2020.

Download the server deb for Ubuntu 18.04 from here.

Please see the release notes.

GRR release 3.4.0.1

18 Dec 19:52
Compare
Choose a tag to compare

First fully Python 3-based release.

Download the server deb from here.

Please see release notes.