This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch docs/CAMEL-24416-lts-guides
in repository https://gitbox.apache.org/repos/asf/camel.git

commit c4700edd1847fea45fb876b64711544512a9ddea
Author: Claus Ibsen <[email protected]>
AuthorDate: Mon Nov 16 10:13:23 2026 +0100

    CAMEL-24416: camel-core - upgrade guide notes for the XmlConverter SAX 
parser factory in 4.22.3 and 4.18.6
    
    Co-Authored-By: Claude Opus 5.5 <[email protected]>
    Signed-off-by: Claus Ibsen <[email protected]>
---
 .../modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc  | 16 ++++++++++++++++
 .../modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc  | 16 ++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git 
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc 
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
index 4ee0ff879304..d5febfaaa3f4 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
@@ -77,6 +77,22 @@ at `DEBUG` level with the message only. Checkpoint failures 
triggered by batch s
 The webhook consumer still logs the body it validates at `DEBUG`, but no 
longer the signature from the `X-Signature` header, nor the signature it 
calculates.
 The `InvalidMessageSignatureException` of a failed check no longer carries the 
calculated signature: `getCalculatedSignature()` returns `null` and is 
deprecated, as is the constructor that takes it.
 
+=== camel-core - XmlConverter SAX parser factory
+
+`XmlConverter.createSAXParserFactory()` now also disables external parameter 
entities and external
+DTD loading:
+
+* `http://xml.org/sax/features/external-parameter-entities` = `false`
+* `http://apache.org/xml/features/nonvalidating/load-external-dtd` = `false`
+
+It previously set only `FEATURE_SECURE_PROCESSING` and 
`external-general-entities=false`, while
+`createDocumentBuilderFactory()` in the same class already blocked external 
resource resolution more
+thoroughly.
+
+Documents carrying an internal DTD subset still parse. Routes that genuinely 
need to resolve
+an external DTD or parameter entity through this converter must supply their 
own
+`SAXParserFactory`.
+
 === camel-file - idempotent consumer with an idempotent read lock
 
 With `idempotent=true` (or `noop=true`) and `readLock=idempotent`, 
`idempotent-changed` or `idempotent-rename`, the
diff --git 
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc 
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
index c8b2e6771340..e9730d046a54 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
@@ -98,6 +98,22 @@ configurations are not affected.
 The webhook consumer still logs the body it validates at `DEBUG`, but no 
longer the signature from the `X-Signature` header, nor the signature it 
calculates.
 The `InvalidMessageSignatureException` of a failed check no longer carries the 
calculated signature: `getCalculatedSignature()` returns `null` and is 
deprecated, as is the constructor that takes it.
 
+=== camel-core - XmlConverter SAX parser factory
+
+`XmlConverter.createSAXParserFactory()` now also disables external parameter 
entities and external
+DTD loading:
+
+* `http://xml.org/sax/features/external-parameter-entities` = `false`
+* `http://apache.org/xml/features/nonvalidating/load-external-dtd` = `false`
+
+It previously set only `FEATURE_SECURE_PROCESSING` and 
`external-general-entities=false`, while
+`createDocumentBuilderFactory()` in the same class already blocked external 
resource resolution more
+thoroughly.
+
+Documents carrying an internal DTD subset still parse. Routes that genuinely 
need to resolve
+an external DTD or parameter entity through this converter must supply their 
own
+`SAXParserFactory`.
+
 === camel-file - idempotent consumer with an idempotent read lock
 
 With `idempotent=true` (or `noop=true`) and `readLock=idempotent`, 
`idempotent-changed` or `idempotent-rename`, the

Reply via email to