Skip to content

Commit e8f36c9

Browse files
kmcquadeclaude
andauthored
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>
1 parent 4aa8c94 commit e8f36c9

2 files changed

Lines changed: 6 additions & 6 deletions

File tree

docs/appendices/comparison-to-other-tools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ In short, its differentiating factors are:
66

77
* Identifying lack of resource ARN constraints for modify-level policies, as well as other risk categories
88
* 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)
1010
* 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.
1111
* 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.
1212

docs/report/triage.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -30,20 +30,20 @@ To recap: you've followed these steps to generate this report:
3030
- `cloudsplaining create-exclusions-file --output-file exclusions.yml`
3131
* Scanned the Account authorization details
3232
- `cloudsplaining scan --input-file default-account-details.json --exclusions-file exclusions.yml`
33-
- 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
3434

3535
## Triaging workflow
3636

3737
An assessor can follow this general workflow:
3838

3939
* 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
4242

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:
4444

4545
> 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.
4747
4848

4949
## Triaging Considerations

0 commit comments

Comments
 (0)