Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/appendices/comparison-to-other-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ In short, its differentiating factors are:

* Identifying lack of resource ARN constraints for modify-level policies, as well as other risk categories
* Digestible presentation of over-privileged IAM policies in a human readable HTML report
* Workflow is tailor-made for quick assessment, team review, and ticket-opening (as shown in the Triage CSV worksheet)
* Workflow is tailor-made for quick assessment, team review, and ticket-opening (as shown in the triage guidance)
* 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.
* 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.

Expand Down
10 changes: 5 additions & 5 deletions docs/report/triage.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,20 +30,20 @@ To recap: you've followed these steps to generate this report:
- `cloudsplaining create-exclusions-file --output-file exclusions.yml`
* Scanned the Account authorization details
- `cloudsplaining scan --input-file default-account-details.json --exclusions-file exclusions.yml`
- This generates three files: (1) The single-file HTML report, (2) The triage CSV worksheet, and (3) The raw JSON data file
- This generates two files: (1) The single-file HTML report, and (2) The raw JSON data file

## Triaging workflow

An assessor can follow this general workflow:

* Open a ticket in your organization's project management tool of choice (for example, JIRA or Salesforce) in the AWS account owner's project
* Attach the HTML report, JSON Data file, and CSV worksheet
* Ask the service/account owner team to fill out the Triage worksheet
* Attach the HTML report and the raw JSON data file
* Ask the service/account owner team to review the findings and provide a justification for each

When you ask the service/account owner team to fill out the Triage CSV worksheet, you can use some text like the following:
When you ask the service/account owner team to review the findings, you can use some text like the following:

> 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.
> 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.
> 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.


## Triaging Considerations
Expand Down