Release Notes
Version 4.2.2
Date: 16/12/2025
New Features
Security and Access Control
-
PKI Encryption and Signing Support Introduced PKI-based encryption and digital signing for secure message exchange. Includes support for importing key pairs and configuring default keystore settings. This enables enterprise-grade integrity, confidentiality, and simplified key management.
-
Message API Access Control Added configurable authentication for
/api/v3/message/queue,/api/v4/message/queue/{name}, and/api/v4/message/queue/bulk/{name}. Enforces user and queue-level validation via a system property (authenticate-queue). -
Mongo API Access Control Added configurable authentication for the
/api/v4/mongoendpoint. Set theauthenticate-mongodbproperty to define how users and API keys are validated when accessing collections.
Low-Code and Workflow Enhancements
- NextHop Routing Introduced a "Next Hop" setting in generic plugins for direct, synchronous message routing. This reduces latency by bypassing intermediate queues.
- See: Message Mapper
- Advanced Mapping Functions New functions in the Mapping Editor for advanced transformation:
System and UI Improvements
- Improved Backup and System Handling Enhanced functionality for automatic and manual snapshots of system state (config, logs, audit, plugins). Supports configurable storage locations, retention limits, and high-performance MongoDB streaming exports.
- How to use: Backup
- Show Messages Dialog Enhancements The "Show Messages" section now allows for deep inspection, testing, and reprocessing. Messages can be filtered by Plugin or Message Type for easier debugging.
- See: Show Messages
- Usability Enhancements Application instance names now appear in the browser title, password fields behave consistently, and long text is truncated where needed.
Known Issues
Groovy option.rest and REST mappings don’t respect truststore certificate chain when a proxy is configured. Workaround: Use
option.http
Bug Fixes
- Messaging: Fixed retry functionality during the send phase and resolved race conditions/NPEs in memory queues.
- Security: Sensitive password values are now hidden; 'false' is no longer a valid auth value (defaults to basic).
- Performance: Optimized audit queries and improved content decompression logic.
- Reliability: Upgrading plugins no longer overwrites custom settings; ensured queues are declared before publishing on restart.
- Mapping: Fixed attachment mapping issues and log error message formatting.
- Metrics: Labeled Prometheus metrics consistently as "1Gateway".
Version 4.2.0
Date: 30/09/2025
New Features
- Configuration-based Workflows (No-Code) Introduces internal plugins (Endpoint, Message Mapper, Switch, Timer, Feedback, etc.) that allow building integrations entirely via configuration. This accelerates development by reducing dependency on custom coding.
- Key Plugins: Endpoints, Message Mapper, Switch, Timer.
- Enhanced Groovy Capabilities Expanded low-code access to endpoint configurations and variable substitution. Improved logging now includes accurate file/line numbers and better error visibility via the
ErrorRegistry.- See: Groovy Access
- MongoDB API: Introduced advanced filtering capabilities including date-based filtering, sorting, and limiting results.
- Authentication: Added strict authentication support for bulk operations.
- Webhook Processing: Added support for configured message types within webhook integrations.
- Audit Logging: Extended logging capabilities with additional parameters to improve diagnostics and troubleshooting.
Bug Fixes
- Improved error handling:
- Consistency during message processing
- In regex mappings and auditing.
- HTTP errors and large JSON responses.
- In mappers and plugins tatus reporting.
- General error fixes:
- Server errors when processing batches with a size of one.
- Cache was not cleared when importing support files.
- Poller messages were not displayed correctly.
- Some audit messages appeared as unavailable in the flow view.
- UI freezes during periods of high webhook traffic
- Webhook mappers were not applied correctly.
- Improved:
- Handling of different date data types when interacting with MongoDB.
- Memory usage and thread management under load.
- Groovy sender performance by avoiding repeated compilation of helper libraries.
Version 4.1.9
Date: 27/11/2024
New Features
-
Queue sender plugin Added a queue sender plugin.
-
Queue API availability Introduced a new Queue API to allow programmatic access and management of queues.
-
Improved webhook stability Webhooks now handle missing or empty ID locations more gracefully, preventing runtime errors.
-
Local timezone support in logs Log timestamps can now be configured to use the local timezone via properties configuration, improving log readability and troubleshooting.
Bug Fixes
- Mapper segments (“apply another mapper”) no longer create a null top-level branch.
key2arrayno longer adds extra array nesting during array-to-array conversions.- Corrected JSON sorting behavior for
startTimestampfields. - Fixed webhook handling for bulk message ingestion.
- Fixed Groovy mapping issue where
db.putcould create multiple unintended collections.
Known Issues
-
OAuth authentication via proxy in Groovy mappings OAuth authentication does not function correctly when requests are routed through a proxy in Groovy-based mappings. This issue was fixed in version 4.2.2
Workaround: Manually perform the OAuth2 token request using the same HTTP client instance that has the proxy explicitly configured.
Custom Groovy OAuth2 Example
// Wait until OAuth2 credentials are available from the endpoint configuration
def oauth2 = null
while (!oauth2) {
oauth2 = api
.getAuth(endpoint + "-oauth")
?.properties
?.authentication
sleep(10)
}
// Prepare HTTP client
def http = option.http
// Optional: configure proxy if required by your environment
http.useProxy("proxy.example.com")
// OAuth2 token request configuration
http.content("application/x-www-form-urlencoded")
def authUrl = oauth2.token_url
def authBody =
"grant_type=${oauth2.grant_type}" +
"&client_id=${URLEncoder.encode(oauth2.client_id, 'UTF-8')}" +
"&client_secret=${URLEncoder.encode(oauth2.client_secret, 'UTF-8')}" +
"&username=${URLEncoder.encode(oauth2.user, 'UTF-8')}" +
"&password=${URLEncoder.encode(oauth2.password, 'UTF-8')}"
// Execute token request
def authResponse = http.post(authUrl, authBody)
// Parse response and extract access token
def authResponseMap = parser.asMap(authResponse)
def accessToken = authResponseMap.access_token
// Optional: log token for debugging (disable in production)
if (log) {
println(accessToken)
}
Version 4.1.8
Date: 19-08-2024
Features in this release:
- ONE-207: Send Audit entry as a message with type
AuditMessage. To activate, setapplication.audit.config.message=true/application.audit.record.message=true. - When clicking on TEST in a plugin, show the call and error in the log.
- ONE-156: Properties templates (spring profiles) monitoring, sync, and north.
- ONE-272: Shared data mapping.
Bugfixes:
- ONE-205: Fixed issue with plugins subscribing to existing DLQ queue. Use
##as the topic to subscribe to a predefined queue. - Fixed and refactored audit configuration changes.
- Fixed last Audit entry retrieval when message ID is null.
- ONE-208: Fixed NPE in Groovy function
option.audit().build().record(). - Improved SpringContext startup sequence.
- ONE-257: Fixed submapper issue not mapping fields generated by the mapper.
- ONE-211: Fixed startup sequence issue by retrying
getbeanfor important beans. - ONE-108: Fixed debug logging for plugins.
Known Issues:
- ONE-233: Proxy doesn't work with OAuth in Groovy (workaround available).
Version 4.1.7
Release Date: 09-07-2024
Bugfixes:
- Fixed NPE in plugin installer.
Known Issues:
- Plugin subscribing to existing DLQ doesn't work.
Version 4.1.6
Release Date: 05-07-2024
Features in this release:
- Test Message Management: View and edit selected test messages.
- Message Diagram View: Visual representation of messages.
- Retry Failed Messages: Retry sending previously failed messages.
- API for Full Configuration: Retrieve full plugin and mapper configuration.
- Bulk Message Processing: Process messages in bulk within Sender plugins.
- JSON Schema Validation: Validate messages using JSON Schema in Mapper configuration.
- REST Enrichment Mapping: Enhanced REST enrichment mapping capabilities, including HTTP Patch.
- AI Mapping: Leverage AI for advanced mapping solutions.
- Full Mapper Test Button: Test entire mapper configurations with one button.
- Version Control: Maintain version control and rollback for Plugin and Mapper configurations.
- Queueing System Choice: Choose between external or in-memory message queues.
- Simulation Mode in Sender Plugins: Simulate message handling during configuration.
Performance Improvements:
- Telemetry: Multi-threading for enhanced performance.
- Messages and Mappers: General performance enhancements.
Security Enhancements:
- Property Encryption: Improved property encryption.
- Webservice Authentication: Strengthened web service authentication.
Notable Changes:
- CR-88: Connection timeout settings in properties.
- CR-48: Implemented
deletemethod in Groovy HTTP. - System Exit Update: Changed to
System.exit(1)for Windows systems. - Added all
idmapsto each message.
Bugfixes:
- Audit History: Reintroduced
auditHistoryas an optional feature. - ONE-164: Fixed NPE in Groovy
println. - CR-92: Fixed numeric key sort order in array mapping.
- Improved logging and plugin version visibility.
- CR-84: Performance fixes, including multi-threading and mapper cache improvements.
Known Issues:
- Audit Bug: Ongoing.
- ONE-108: Plugin debug log does not appear.
- Plugin installer doesn't work.
- Plugin subscribing to existing DLQ doesn't work.
Version 4.1.5
Date: 17-04-2024
Features in this release:
- Schema in the mapper editor.
- Added API to get full configuration at
/api/v3/plugin/full. - CR-42: Property encryption feature.
- Accept all messages in a mapper if
fromis left empty. - Feedback feature.
- New REST enrichment mapping and full mapper test button.
Bugfixes:
- Changed to
System.exit(1)for Windows. - Added Mapper API to get configured Mapper.
- CR-67: Reintroduced
auditHistoryas an option.
Known Issues:
- Plugin subscribing to existing DLQ doesn't work.
- OAuth authentication doesn't use proxy.
Version 4.1.4
Date: 04-03-2024
Bugfixes:
- CR-47: Fixed memory leak causing high CPU usage.
- CR-49: Fixed queue webhook issue.
- Added filtered hashmap functionality.
- Generated RabbitMQ host.
Version 4.1.3
Date: 02-02-2024
Features in this release:
- New message display, edit functionality, message collection toggle, message flow diagram, retry failed messages, and test message management.
- AI mapping functionality.
Version 3.4
Date: 11-05-2023
Features in this release:
- Plugin and Mapper configuration version control.
Version 3.2
Date: 20-10-2023
Features in this release:
- Graphic UI.
- Groovy support.