2022 Update Rollup 2

Check Virus ScanPermanent link for this heading

It is possible to block malware in Fabasoft Folio, which was found by an Antivirus software. Therefore, affected documents will be marked as infected and the current content is replaced (the primary content will not get lost). Additionally, these objects can no longer be opened or edited and the user receives a warning.

This feature can be used independently from any kind of Antivirus software but the output must be prepared in a certain structure.

Requirements and ConfigurationPermanent link for this heading

The scan output must be provided in JSON format and must be structured as follows.

Example

{
  "checkstartat": "2021-10-12T11:23:00",

  "checkendat": "2021-10-12T11:23:45",

  "virusdocumenthashes": [

    {

      "hash":"cb0b4f7eca5c318724eb001d8099632f_c8f8",
      "detail":"Virus 1"

    },

    {

      "hash":"894d83bf6934c1ee6c989d91ca596995_ee54",

      "detail":"Virus 2"

    }

  ]

}

In the JSON, hash indicates the affected document name (without extension) found by the Antivirus software and detail contains the virus information.

Fabasoft Folio Configuration

In Fabasoft Folio direct access must be configured for the MMC area (see chapter “Direct Access to a CAS area”).

The generated JSON file must be placed in the dedicated MMC area in a pre-defined directory called logscans and must have the name latest.json.

Example

[root@foliofileserver MMCSVC1]# pwd
/var/opt/fabasoft/lib/mmc/1.506/MMCSVC1
[root@foliofileserver MMCSVC1]# ls -l logscans/
total 4
-rwxr-xr-x. 1 fscsrv fsc 190 Oct 19 09:29 latest.json

ExecutionPermanent link for this heading

If the JSON file is placed in the logscans directory and direct access is configured, the execution of COOSYSTEM@1.1:CheckVirusScans initializes/updates the attribute COOSYSTEM@1.1:objscaninfo based on the JSON input. All files in the CAS area of all versions referenced by objects in Fabasoft Folio are checked.  

The execution can be accomplished by the AT service. Therefore, a new AT service task must be created and placed in a list of automated tasks.

The object is the current domain and the action is COOSYSTEM@1.1:CheckVirusScans.

Handle Infected DocumentsPermanent link for this heading

In case of a virus, the objects in Fabasoft Folio, which reference this content are marked as infected and consequently cannot be edited or opened by the end user.

The infected document can be handled using the “Handle Infected Documents” context menu command.

This way the user can download, scan and clean the file with an own virus scanning software. The cleaned file can be uploaded again. If the file has been mistakenly classified as a potential threat, the warning can be removed. Alternatively, the document can be deleted.