You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: remove stale triage CSV worksheet references (#597)
The scan no longer emits a separate triage CSV worksheet (it produces the HTML
report and the raw JSON data file); the report contains read-only triage
guidance, not a fillable worksheet. Update the triage workflow to ask reviewers
to justify findings against the HTML report directly, and fix the comparison doc.
Follow-up (needs a JS rebuild, out of scope here): the in-report guidance asset
cloudsplaining/output/src/assets/2-triage-guidance.md carries the same stale CSV
worksheet wording.
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: docs/appendices/comparison-to-other-tools.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ In short, its differentiating factors are:
6
6
7
7
* Identifying lack of resource ARN constraints for modify-level policies, as well as other risk categories
8
8
* Digestible presentation of over-privileged IAM policies in a human readable HTML report
9
-
* Workflow is tailor-made for quick assessment, team review, and ticket-opening (as shown in the Triage CSV worksheet)
9
+
* Workflow is tailor-made for quick assessment, team review, and ticket-opening (as shown in the triage guidance)
10
10
* The detailed triage, remediation, and validation guidance allows technical individuals who are not experts in AWS IAM to handle most issues with account owner teams when triaging and identifying exclusions.
11
11
* If you've ever wondered "does this role *truly deserve* to have these privileges or can we scope the permissions down to reduce blast radius in the case of a breach?" Cloudsplaining is tailor-made for addressing this issue.
- This generates three files: (1) The single-file HTML report, (2) The triage CSV worksheet, and (3) The raw JSON data file
33
+
- This generates two files: (1) The single-file HTML report, and (2) The raw JSON data file
34
34
35
35
## Triaging workflow
36
36
37
37
An assessor can follow this general workflow:
38
38
39
39
* Open a ticket in your organization's project management tool of choice (for example, JIRA or Salesforce) in the AWS account owner's project
40
-
* Attach the HTML report, JSON Data file, and CSV worksheet
41
-
* Ask the service/account owner team to fill out the Triage worksheet
40
+
* Attach the HTML report and the raw JSON data file
41
+
* Ask the service/account owner team to review the findings and provide a justification for each
42
42
43
-
When you ask the service/account owner team to fill out the Triage CSV worksheet, you can use some text like the following:
43
+
When you ask the service/account owner team to review the findings, you can use some text like the following:
44
44
45
45
> As part of our security assessment, our team ran Cloudsplaining on your AWS account. Cloudsplaining maps out the IAM risk landscape in a report, identifies where resource ARN constraints are not in use, and identifies other risks in IAM policies like Privilege Escalation, Data Exfiltration, and Resource Exposure/Permissions management. Remediating these issues, where applicable, will help to limit the blast radius in the case of compromised AWS credentials.
46
-
> We request that you review the HTML report and fill out the "Justification" field in the Triage worksheet. Based on the corresponding details in the HTML report, provide either (1) A justification on why the result is a False Positive, or (2) Identify that it is a legitimate finding.
46
+
> We request that you review the HTML report and, for each finding, provide either (1) A justification on why the result is a False Positive, or (2) Identification that it is a legitimate finding.
0 commit comments