Skip to content

Add draft threat model + AGENTS.md and link from SECURITY.md for security-model discoverability#457

Open
potiuk wants to merge 1 commit into
apache:mainfrom
potiuk:asf-security/threat-model-2026-05-31
Open

Add draft threat model + AGENTS.md and link from SECURITY.md for security-model discoverability#457
potiuk wants to merge 1 commit into
apache:mainfrom
potiuk:asf-security/threat-model-2026-05-31

Conversation

@potiuk

@potiuk potiuk commented May 31, 2026

Copy link
Copy Markdown
Member

This is a draft proposal for the CXF PMC to review — please correct, reject, or discuss as needed. Nothing here is a requirement; the maintainers are the decision-makers.

Companion to the apache/cxf umbrella PR — Fediz's WS-Federation / SAML-SSO trust surface is distinct, so it gets its own model. This PR adds THREAT_MODEL.md + AGENTS.md and a Threat Model section in the existing SECURITY.md, wiring AGENTS.md -> SECURITY.md -> THREAT_MODEL.md.

The model's pivot: in SSO the security-relevant work is token validation at the RP and issuance at the IdP, around a token that travels through the untrusted browser. Draft-first, mostly inferred (~12 documented / 0 maintainer / ~46 inferred); every *(inferred)* claim routes to a numbered §14 question.

The wave-1 rulings are the SSO crux:

  • By default, does the RP require a valid signature from a trusted IdP cert and reject unsigned/untrusted tokens?
  • Are audience/wtrealm, Conditions (timestamps + skew), and a replay cache enforced by default?
  • Does SAML processing defend signature-wrapping (XSW) by binding the verified signature to the consumed assertion?

Also flagged: wreply reply-URL allow-listing (open redirect / token forwarding) and XXE/DoS on token parse (inherited from CXF/WSS4J).

Context: the ASF Security team is preparing the project for an automated agentic security scan we're piloting. Drafted via the threat-model-producer rubric. If you'd rather author it yourselves, close this PR and we'll regroup.

…ecurity-model discoverability

Adds a draft (v0) threat model for the Fediz WS-Federation/SAML-SSO IdP + RP
plugins, plus an AGENTS.md, and links the model from the existing SECURITY.md so
an automated scan agent can discover it via AGENTS.md -> SECURITY.md ->
THREAT_MODEL.md. The model is a proposal for the PMC to review; most claims are
(inferred) and route to open questions in its section 14.

Generated-by: Claude Code (Claude Opus 4.8)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant