Release 4
    • PDF

    Release 4

    • PDF

    Article summary

    Date of Release: 19 January 2023

    General Remarks

    • Embedded Engine Release 4 is the first production release of our consolidated SDK, where the Glasswall Rebuild and Editor SDKs have been merged. Release 4 and future releases of the Glasswall Embedded Engine will henceforth supersede standalone releases of the Glasswall Rebuild and Editor SDKs.
    • CLI: gwcli now replaces GWQtCLI and should be used in place of the deprecated Rebuild glasswall.classic.cli / glasswallCLI command line interface tool.
    • For distribution purposes, evaluation builds are now synced with production builds.

    Components / Services Released

    • Glasswall Embedded Engine (Glasswall_core2): v2.414.1
    • Word Search And Redact (libglasswall.word.search): v1.34
    • Archive Manager (libglasswall.archive.manager): v0.78
    • Glasswall Command Line Tool (gwcli): v2.26
    • SDK Editor Wrappers: v0.9

    New Features

    • Content Export & Import (Transformation): The Glasswall Embedded Engine can take a complex file format; expose an internal DOM tree of a file, normalise this content into a simple intermediary format (XML or SISL) and allow external processes to manipulate or analyse this data. Once exported, the Embedded Engine can reimport and reconstitute these streams into a newly reconstructed file.
    • Word Search & Redaction (beta): Glasswall now provides the ability to search and redact (or block) office documents that contain forbidden words.
    • Analysis reports now include input SHA256 hash in 'rebuildonly' run mode.
    • Engine run mode now defaults to 'rebuildonly'. File processing will be routed via the rebuild plug-in without the need to specify this in the policy xml.
    • A license key file is now included in the release package. Engine activation is now permitted based on license validity (including expiration date).
    • New API to retrieve license information.
    • New APIs to create text dumps during the export process.
    • Word Search analysis report now includes document summary.
    • SHA file hash is now captured in the analysis reports (editoronly mode).
    • Macho .bundle extensions are now supported.
    • SVG files are no longer removed as embedded files within office documents.
    • Binary camera code migrations from Rebuild to Editor (editoronly mode).
    • Media camera code migrations from Rebuild to Editor (editoronly mode).
    • Configuration to enable/disable standard CDR when exporting/importing internal dom tree to XML or SISL.
    • Sisl 'minifier' configuration option to reduce sisl output size during content export.
    • Microsoft Office XML specification updates (rebuildonly mode). There is now support up to the following protocol revisions:

      Doc Type
      Date
      Protocol Revision
      MS-PPTX
      2/15/2022
      19.2
      MS-XLSX
      5/17/2022
      23.1
      MS-DOCX
      3/4/2022
      18.0
      MS-ODRAWXML
      5/17/2022
      29.2

    Fixes & Improvements

    • Significant performance improvements made to the export and import (transformation to XML/SISL) capability.
    • Fixed inconsistent CLI behavior when using relative paths to specify input and output directories.
    • Memory management improved when processing numerous files through a single of the embedded engine.
    • Extended Archive Manager APIs to simply unpack or pack archive files without invoking engine protect mode automatically.
    • Fixed issue where some sanitisation IDs were reported as 0.
    • Updates to all SDK wrappers.

    Known Issues or Limitations

    • Analysis report layout_format still defaults to the 'v1' setting. Manually set this sysConfig flag to 'v2' in the policy file to:
      • Populate an allowed items content group in the analysis report for items allowed under policy.
      • Remove redundant contentItem elements:
        • AverageSizeInBytes
        • MinSizeInBytes
        • MaxSizeInBytes
      • Remove Issue Item riskLevel from the report (other work in progress to replace this).

    Was this article helpful?