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
