WAARP GATEWAY 0.13.0

Leslie Lamy
Oct 1
4 min read

Waarp Gateway Update Release Notes

We are pleased to present the Waarp Gateway 0.13.0 update. This version brings many new features and improvements aimed at enhancing the robustness of transfers, permission management, monitoring, and integration with external tools. It also introduces useful additions for PeSIT and task management. Here is an overview of the new features and fixes included in this release.

Main changes

Automatic resumption of transfers

An automatic transfer resumption mechanism has been added in case of errors. For each transfer, it is possible to configure: - a number of attempts, - a delay between each attempt, - an increment factor for this delay. These parameters can be defined at the level of an individual transfer or globally at the level of transfer clients. (see #470 )

Inheriting environment variables for EXEC

External programs called by the EXEC task (and its variants) now inherit their replacement values as environment variables. These variables have the exact same name as their replacement value (e.g., #TRUEFULLPATH#) and can be used directly in the scripts or executables they call. (see #469 )

File and folder permissions

Added FilePermissions and DirectoryPermissions options to specify the permissions assigned to files and folders created by the Gateway. The default permissions remain 0640 for files and 0750 for folders. (see #478 )

Minimal TLS configuration

It is now possible to configure the minimum TLS version for R66-TLS and HTTPS. This minimum version can be specified in the protocol configuration of the relevant clients, servers, and partners. By default, the minimum version remains TLS v1.2. (see #464 )

Output parameter for TRANSFER and new variables

The TRANSFER task now has an output parameter to specify the destination file name/path when it differs from the original name. (see #456 ) In addition, two new override values have been added: #BASEFILENAME# and #FILEEXTENSION#, allowing you to retrieve the file name and its extension, respectively. (see #452 ) The #TIMESTAMP# variable has been added, combining #DATE# and #HOUR# into a single, more convenient value. (see #429 )

PeSIT improvements

Several improvements and fixes regarding PeSIT: - Certain PeSIT attributes (file encoding, file type, file organization, bank ID, and customer ID) are now stored in the transfer information. (see #467 ) - The segmentation of PeSIT transfers into items is now correctly processed and stored. - Correction of the non-standard compatibility mode: correct handling of filenames for sending and receiving. The modes have been renamed 'standard' and 'non-standard'. - The useNSDU option in the PeSIT partner protocol configuration is now true by default.

Server transfer pre-registration

It is now possible to pre-register a server transfer. Pre-registration allows you to save transfer information in case of a bounce to a server transfer and to specify a deadline for a file's availability. A server transfer can be pre-registered using the terminal command 'transfer preregister' or via the new PREREGISTER task. (see #464 )

New task EMAIL

Added an EMAIL task to send an email (particularly useful as an error task to notify of failed transfers). Two new tables allow you to configure SMTP credentials and email templates, along with their REST handlers and CLI commands. (see #448 )

SNMP and monitoring

The Gateway instance name is now included in SNMP traps, making instance identification easier. (see #438 ) A CLI command and a REST handler allow sending test SNMP notifications to validate the SNMP monitor configuration. (see #435 )

Administration web interface

Added a web administration interface, accessible at the address of the existing administration server. It facilitates viewing statuses, managing transfers, and configuration.

Import/Export YAML and raw display of SSH keys

Import/export commands now accept files in YAML format (.yml, .yaml): if the file has the .yml or .yaml extension, the YAML format will be used instead of JSON. (see #449 ) Added -r, --raw options to the commands for displaying SSH certificates and keys, allowing the raw value (PEM file) to be displayed instead of metadata.

Adjusted behavior of the DECRYPT task

The default behavior of the DECRYPT task has been slightly changed: in the absence of an explicit outputFile, if the encrypted filename ends with the .crypt extension, then the destination file will have the same name with this extension removed. If the extension is not present, then the destination file will be suffixed with the .plain extension as before. The behavior when an explicit outputFile is provided remains unchanged.

List of changes

Changes not backward compatible

No additional backward compatibility changes compared to previous versions listed in the main documentation.

New Features

#469 : Inheriting environment variables for external programs called by the EXEC task,
#470 : Automatic resumption of transfers in case of error,
#478 : Added FilePermissions and DirectoryPermissions options.
#464 : Minimum TLS configuration for R66-TLS/HTTPS and pre-registration of server transfers.
#456 : 'output' parameter for the TRANSFER task.
#452 : Added the variables #BASEFILENAME# and #FILEEXTENSION#,
#429 : Added the variable #TIMESTAMP#.
#438 and #435 : Additions related to SNMP notifications and tests.
#448 : Added the EMAIL task and the SMTP/templates tables.
#449 : Support for YAML format for import/export.
Web administration interface.
PeSIT improvements and corrections (segmentation, attributes, compatibility).

Corrections

Fixed a REST server error regarding the 'Server' and 'Waarp-Gateway-Date' headers.
#463 : Empty passwords are now accepted for authentication (if explicitly configured).
#485 : Fixed a permissions error when moving files to a non-existent folder.
Default activation of the useNSDU option for PeSIT partners.
Various REST and PeSIT fixes.