Release 4

# 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 : The Glasswall Embedded Engine can take a complex file format; expose an internal DOM tree of a file, normalize this content into a simple intermediary format (XML or SISL) and allow external processes to manipulate or analyze 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 a 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 instance 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 sanitization 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).