This is an automated email from the ASF dual-hosted git repository.
jsinovassin pushed a commit to branch unomi-3.x
in repository https://gitbox.apache.org/repos/asf/unomi.git
The following commit(s) were added to refs/heads/unomi-3.x by this push:
new 4e2d03734 [UNOMI-1048] Add the 3.1 section to What's new (#964)
4e2d03734 is described below
commit 4e2d037345ff14312a33b72bd9fa024c59bbc8cc
Author: Jonathan SINOVASSIN-NAIK <[email protected]>
AuthorDate: Fri Nov 13 15:42:32 2026 +0100
[UNOMI-1048] Add the 3.1 section to What's new (#964)
---
manual/src/main/asciidoc/whats-new.adoc | 37 +++++++++++++++++++++++++++++++++
1 file changed, 37 insertions(+)
diff --git a/manual/src/main/asciidoc/whats-new.adoc
b/manual/src/main/asciidoc/whats-new.adoc
index 287d7096d..1200f092e 100644
--- a/manual/src/main/asciidoc/whats-new.adoc
+++ b/manual/src/main/asciidoc/whats-new.adoc
@@ -11,6 +11,43 @@
// See the License for the specific language governing permissions and
// limitations under the License.
//
+=== What's new in Apache Unomi 3.1
+
+Apache Unomi 3.1 changes the configuration of GraphQL subscriptions, of the
scripting allow list and of the `matchesRegex` operator.
+Read this section before you upgrade from Apache Unomi 3.0.
+
+==== GraphQL subscription credentials
+
+A GraphQL subscription over WebSocket uses the same Basic credentials as the
GraphQL HTTP endpoint.
+A client sends the credentials in one of two ways:
+
+* In the `Authorization` header of the WebSocket upgrade request.
+* In the `Authorization` key of the `connection_init` payload. A browser
client uses this way, because the browser WebSocket API cannot set request
headers.
+
+The GraphiQL console sends the `Authorization` header of its "Headers" tab in
the `connection_init` payload.
+Update a subscription client that does not send credentials before you upgrade.
+
+==== Scripting allow list
+
+The default value of `org.apache.unomi.scripting.allow` in
`etc/custom.system.properties` no longer contains `org.mvel2.*`.
+If your installation sets `org.apache.unomi.scripting.allow` or the
`UNOMI_ALLOW_SCRIPTING_CLASSES` environment variable, remove `org.mvel2.*` from
your value.
+
+==== Configuration of the matchesRegex operator
+
+The `matchesRegex` condition operator has new limits on the length of the
pattern and on the length of the tested value.
+When a limit is reached, the condition evaluates to `false` and Unomi writes a
warning to the log.
+These system properties set the limits:
+
+[options="header"]
+|===
+|Property |Default value
+|`org.apache.unomi.conditions.regex.maxPatternLength` |`512`
+|`org.apache.unomi.conditions.regex.maxInputLength` |`10000`
+|`org.apache.unomi.conditions.regex.maxCharAccesses` |`1000000`
+|===
+
+If a rule or a segment uses a longer pattern or tests a longer value, raise
the matching limit.
+
=== What's new in Apache Unomi 3.0
Apache Unomi 3 is a new release focused on integrations of the client to
support elasticsearch version 9.