docs(observability): add threat detection page#6011
Closed
eeee2345 wants to merge 1 commit into
Closed
Conversation
Add a new docs page under observability/ describing the runtime threat surface for Spring AI applications (vector-store filter injection, ChatMemory cross-user leakage, memory poisoning) — referencing the May 2026 Spring AI CVE family (CVE-2026-41705 / 41712 / 41713) and pointing at open-source detection-rule infrastructure builders can plug in. References open-source corpora as plural alternatives (ATR, garak, HarmBench, OWASP A-S-R-H) — no single-vendor endorsement. Honest about scope limits (regex doesn't catch paraphrase bypass, multilingual coverage gap, complements rather than replaces framework patches and architectural controls). Registers the new page in nav.adoc under the existing observability section. Signed-off-by: Adam Lin <adam@agentthreatrule.org>
eeee2345
force-pushed
the
docs/observability-threat-detection
branch
from
May 17, 2026 22:44
6bfe068 to
7192b71
Compare
Author
|
Flagging this one — it is still labelled It adds an observability docs page on threat detection. Docs only, mergeable against main. Whoever handles observability docs triage: happy to adjust scope, move the page, or split it if the placement is wrong. And if agent threat detection is out of scope for the Spring AI docs, a close is a fine outcome — I would just rather have a direction than leave it in the triage queue indefinitely. |
Contributor
|
Thanks for the ping, I prefer to decline such contribution to our documentation that seems a bit out of topics and looks too much AI generated (unless I am mistaken). |
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.
Adds a new docs page under
spring-ai-docs/src/main/antora/modules/ROOT/pages/observability/threat-detection.adocdescribing the runtime threat surface for Spring AI applications and pointing at open-source detection-rule infrastructure that downstream builders can plug into their deployments.Why now
Three CVE family entries against Spring AI were disclosed on 2026-05-08:
All three are patched in Spring AI 1.0.0 and above. The added page documents the threat shape, sketches a minimal CallAroundAdvisor integration pattern for detection-rule loading, and lists multiple open-source detection-rule corpora as plural starting points (ATR, garak, HarmBench, OWASP A-S-R-H). No single-vendor endorsement.
Scope
pages/observability/threat-detection.adoc(80 lines)observability/index.adocinnav.adocHonest about limits
The page explicitly documents what detection rules do not catch (paraphrase bypasses, multilingual coverage gap, configuration / authentication issues) and frames the layer as defense in depth rather than replacement for framework patches.
Maintainer voice
I am the maintainer of one of the referenced corpora (Agent Threat Rules, github.com/Agent-Threat-Rule/agent-threat-rules) — disclosed as a conflict of interest in the page text. The reference list is intentionally plural and includes peer projects to avoid single-vendor framing.
Happy to revise scope, structure, or tone per maintainer feedback. If a threat-detection section fits better as additions to existing pages (advisors.adoc / chat-memory.adoc / vectordbs.adoc) rather than a new page, I can rework.
Sources cited in the page