docs: document API-component and semantic-header triage scope; add Security to user-manual nav#23253
Merged
oscerd merged 2 commits intoMay 15, 2026
Conversation
…rity model Clarifies two recurring security-triage questions in the project security model so the PMC and reporters apply a consistent position: - Camel-prefixed API-component headers (CamelFhir.*, CamelBox.*, ...) reaching an API producer from an untrusted source: in scope is conditional on the inbound consumer's case-insensitive Camel* HeaderFilterStrategy, not the API producer; it is not always out of scope. - Non-prefixed semantic headers a component reads (To, Cc in camel-mail, ...): one uniform rule (framework auto-filtering covers only the internal Camel*/org.apache.camel.* namespace; the rest is route-author responsibility and a per-component documented contract), with the inbound-filter and path-traversal classes still applying independently. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The Security and Security Model pages were reachable only by direct link. Add a top-level Security group to the user-manual left navigation so both are discoverable from the docs site. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
|
🌟 Thank you for your contribution to the Apache Camel project! 🌟 🐫 Apache Camel Committers, please review the following items:
|
davsclaus
approved these changes
May 15, 2026
Contributor
|
🧪 CI tested the following changed modules:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Context
The ASF Security Team (Piotr) asked us to make the project security model more
prominent for reporters and to clarify two recurring triage questions so future
reports are handled consistently. This PR is the
apache/camelside; acompanion PR against
apache/camel-websiteadds a prominent "Security model andreport scope" section at the top of https://camel.apache.org/security/ linking
the canonical model page.
Changes
security-model.adoc— two triage clarifications folded into the model:CamelFhir.*,CamelBox.*,CamelOlingo4.*,CamelAs2.*, ...) reaching an API producer from anuntrusted source. Documented position: not always out of scope — it is
conditional, and the condition is at the inbound consumer, not the API
producer. These prefixes live in the
Camel*namespace, so the protectingboundary is the inbound consumer's case-insensitive
Camel*HeaderFilterStrategy(the CVE-2025-27636 family mechanism). Added to theCamel-header / bean-dispatch abuse in-scope class.
To,Ccincamel-mail, ...). Documented position: one uniform rule — frameworkauto-filtering is scoped to the internal
Camel*/org.apache.camel.*namespace only; the rest is the route author's responsibility and a
per-component documented contract; the inbound-filter class
(e.g. CVE-2026-33454) and path-traversal class (e.g. CVE-2018-8041) still
apply independently. Added as a Known limitations bullet.
nav.adoc— discoverability: the Security and Security Model pages werereachable only by direct link. Added a top-level Security group to the
user-manual left navigation.
Notes
being written into the model.
Claude Code on behalf of Andrea Cosentino