Skip to content

docs(observability): add threat detection page#6011

Closed
eeee2345 wants to merge 1 commit into
spring-projects:mainfrom
eeee2345:docs/observability-threat-detection
Closed

docs(observability): add threat detection page#6011
eeee2345 wants to merge 1 commit into
spring-projects:mainfrom
eeee2345:docs/observability-threat-detection

Conversation

@eeee2345

Copy link
Copy Markdown

Adds a new docs page under spring-ai-docs/src/main/antora/modules/ROOT/pages/observability/threat-detection.adoc describing 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

  • Adds one new file: pages/observability/threat-detection.adoc (80 lines)
  • Adds one nav entry under existing observability/index.adoc in nav.adoc
  • No source code changes
  • No dependencies added

Honest 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

  • Spring Security Advisories for the May 2026 CVE family
  • Five Eyes "Careful Adoption of Agentic AI Services" joint guidance (2026-04-30)
  • Microsoft MSRC "When prompts become shells" (2026-05-07)

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

Copy link
Copy Markdown
Author

Flagging this one — it is still labelled status: waiting-for-triage, so I do not think it has reached a reviewer yet rather than having been looked at and set aside.

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.

@sdeleuze

Copy link
Copy Markdown
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).

@sdeleuze sdeleuze closed this Jul 20, 2026
@sdeleuze sdeleuze added documentation Improvements or additions to documentation declined and removed status: waiting-for-triage labels Jul 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

declined documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants