Skip to content

docs(sensei): CSPM cloud-posture page, hub views, and fix-quota states - #15684

Merged
Maffooch merged 4 commits into
bugfixfrom
docs/sensei-capability-views
Aug 17, 2026
Merged

docs(sensei): CSPM cloud-posture page, hub views, and fix-quota states#15684
Maffooch merged 4 commits into
bugfixfrom
docs/sensei-capability-views

Conversation

@Maffooch

@Maffooch Maffooch commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Documentation for the Sensei capability-views work.

Cloud Security Posture (CSPM)

New page docs/content/sensei/cloud_posture.md documenting the CSPM capability alongside the existing AppSec Sensei docs:

  • How CSPM works and requirements (Sensei license with a cloud-account quota, the Cloud Posture and Locations features).
  • Cloud connections — one shared credential plus the discover/onboard wizard (Connect → Discover → Onboard) that enumerates and onboards many accounts at once.
  • Onboarding a single account — per-provider account identity and read-only scan credentials for AWS, Azure, and GCP.
  • Scanning with Prowler (including sharding of large accounts) and how each finding maps to a cloud resource.
  • The two remediation paths — an IaC pull request, or a direct, reversible "Fix in Cloud" change to the live resource, with the approval-preview dialog, the v1 reversible actions, and the separate write credentials.
  • The Cloud Remediations ledger and its statuses (Applied in Cloud / Revert in Progress / Reverted / Failed), quotas, and troubleshooting.

Cross-linked from About Sensei and the Reference (cloud statuses, the Onboarded Cloud Accounts quota, and a Cloud specifics section); the section is reweighted so the new page slots in after Fixing findings.

Earlier in this branch

  • Describe the Sensei hub's views and the two fix-quota states (none purchased vs quota exhausted), so the two are not conflated.
  • Explain that a Sensei fix opens a pull request and does not by itself close the finding — the finding closes when the fix is merged and re-scanned.

Docs-only. Base bugfix; brought current with the bugfix line. Screenshots are committed under docs/content/sensei/images/ and referenced from the page, using seeded demo data.

Maffooch and others added 3 commits August 6, 2026 16:40
The Sensei hub's toggle used to mix two questions: "DefectDojo-hosted" and
"In-repo CI" listed onboarded repositories, while "Auto-fix Candidates" and
"Scan Activity" were views across all of them. The hosted/CI choice is now a
scope inside the Repositories view, so document the toggle as the three views it
selects, and say plainly that candidates and activity always cover every
repository.

Also split the two reasons Approve can be disabled. "No fix quota on this
license" and "quota exhausted" are opposite situations with different actions,
and the hub previously reported both as exhaustion — which told a customer with
no quota to wait for a reset that would never come.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016VjaotfrkL2f2QHvhUcbsh
A pull request changes the code, not what is running, so the finding stays open
after Sensei fixes it — and for a finding that came from a cloud account,
merging Terraform changes nothing the scanner reads until the infrastructure
change is applied. The badge now distinguishes "PR open" from "PR merged", so
document both states and what actually closes the finding.

Also note that reappearances of an outstanding fix are recognised as the same
issue and do not consume extra fixes, and add both to the troubleshooting list,
where "why is this still open?" is the question people arrive with.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016VjaotfrkL2f2QHvhUcbsh
@Maffooch Maffooch added this to the 3.2.300 milestone Aug 17, 2026
@Maffooch
Maffooch requested a review from blakeaowens as a code owner August 17, 2026 03:57
@github-actions github-actions Bot added the docs label Aug 17, 2026
Document the CSPM capability alongside the existing AppSec Sensei docs:
cloud connections and the discover/onboard wizard, onboarding a single
account with per-provider identity and read-only scan credentials
(AWS/Azure/GCP), scanning with Prowler, the two remediation paths (IaC
pull request vs. direct 'Fix in Cloud'), the reversible direct-remediation
actions and their write credentials, the Cloud Remediations ledger and its
statuses, cloud-account quota, and troubleshooting.

Cross-link the new page from About Sensei and the Reference (cloud
statuses, the Onboarded Cloud Accounts quota, and a Cloud specifics
section), and reweight the section so the new page slots in.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016m4X7Zqtv74Xg4oLNYgycg
@Maffooch Maffooch changed the title docs(sensei): hub views, fix-quota states, and that a fix PR does not close the finding docs(sensei): CSPM cloud-posture page, hub views, and fix-quota states Aug 17, 2026
@Maffooch
Maffooch added this pull request to the merge queue Aug 17, 2026
Merged via the queue into bugfix with commit 831fde0 Aug 17, 2026
49 checks passed
@Maffooch
Maffooch deleted the docs/sensei-capability-views branch August 17, 2026 23:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants