Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cloud user investigation #28843

Merged
merged 27 commits into from Aug 14, 2023
Merged
Show file tree
Hide file tree
Changes from 22 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
37f8d33
PB + RM cloud user investigation
OmriItzhak Aug 7, 2023
76a20cc
RN for the Playbooks cloud user investigation
OmriItzhak Aug 7, 2023
87343ba
update skipifunavailable
OmriItzhak Aug 7, 2023
e4143fd
update skipifunavailable
OmriItzhak Aug 7, 2023
84da502
Merged master into current branch.
Aug 8, 2023
f49ef25
Bump pack from version CommonPlaybooks to 2.3.88.
Aug 8, 2023
4a7cf59
Merge remote-tracking branch 'origin/Cloud_User_Investigation' into C…
OmriItzhak Aug 7, 2023
4e708ac
Merged master into current branch.
Aug 8, 2023
e517c67
Bump pack from version CommonPlaybooks to 2.3.89.
Aug 8, 2023
db36047
Merged master into current branch.
Aug 9, 2023
7a483a3
Bump pack from version GCP-Enrichment-Remediation to 1.1.6.
Aug 9, 2023
3fe6bbe
Merge branch 'master' of github.com:demisto/content into Cloud_User_I…
OmriItzhak Aug 13, 2023
1c71b73
Apply suggestions from code review
OmriItzhak Aug 13, 2023
dd4d85f
Apply suggestions from code review
OmriItzhak Aug 13, 2023
fdbaaf9
fix after doc review
OmriItzhak Aug 13, 2023
e751c9c
Apply suggestions from code review
OmriItzhak Aug 13, 2023
fb1a34e
Apply suggestions from code review
OmriItzhak Aug 13, 2023
d70e7b2
Apply suggestions from code review
OmriItzhak Aug 13, 2023
7fb850d
Merge branch 'Cloud_User_Investigation' of github.com:demisto/content…
OmriItzhak Aug 13, 2023
6424fe5
fix after review
OmriItzhak Aug 13, 2023
5db30b0
fix after review
OmriItzhak Aug 13, 2023
141e229
fix after review
OmriItzhak Aug 14, 2023
482ede3
Merged master into current branch.
Aug 14, 2023
3d7cc3a
Bump pack from version CommonPlaybooks to 2.3.90.
Aug 14, 2023
77a61e5
Apply suggestions from code review
OmriItzhak Aug 14, 2023
f2add44
Update Packs/GCP-Enrichment-Remediation/Playbooks/playbook-GCP_-_User…
OmriItzhak Aug 14, 2023
f39765f
Update playbook-AWS_-_User_Investigation.yml
OmriItzhak Aug 14, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view

Large diffs are not rendered by default.

@@ -0,0 +1,64 @@
This playbook performs an investigation on a specific user in AWS environments, using queries and logs from AWS CloudTrail to locate the following activities performed by the user:
- Failed login attempt
- Suspicious activities
- API Access denied
OmriItzhak marked this conversation as resolved.
Show resolved Hide resolved
- Administrative user activities
- Security rules and policies changes
- Access keys and access token activities
- Script-based user agent usage
- User role changes activities
- MFA device changes activities


## Dependencies

This playbook uses the following sub-playbooks, integrations, and scripts.

### Sub-playbooks

This playbook does not use any sub-playbooks.

### Integrations

* AWS - CloudTrail
OmriItzhak marked this conversation as resolved.
Show resolved Hide resolved
OmriItzhak marked this conversation as resolved.
Show resolved Hide resolved

### Scripts

* LoadJSON
* GetTime
* Set

### Commands

* aws-cloudtrail-lookup-events
OmriItzhak marked this conversation as resolved.
Show resolved Hide resolved
OmriItzhak marked this conversation as resolved.
Show resolved Hide resolved

## Playbook Inputs

---

| **Name** | **Description** | **Default Value** | **Required** |
| --- | --- | --- | --- |
| Username | The username to investigate. <br/>Please enter the user's email. | | Optional |
| AwsTimeSearchFrom | The Search Time for the \`GetTime\` task used by the AWS Cloud Trail search query. <br/>This value represents the number of days to include in the search.<br/>Default value: 1. \(1 Day\) | 1 | Optional |

## Playbook Outputs

---

| **Path** | **Description** | **Type** |
| --- | --- | --- |
| AwsMFAConfigCount | The number of MFA configurations performed by the user in the AWS environment. | unknown |
| AwsUserRoleChangesCount | The number of user roles that were changed by the user in the AWS environment. | unknown |
| AwsSuspiciousActivitiesCount | The number of suspicious activities performed by the user in the AWS environment. | unknown |
| AwsScriptBasedUserAgentCount | The number of script-based user agent usages by the user in the AWS environment. | unknown |
| AwsAccessKeyActivitiesCount | The number of access key activities performed by the user in the AWS environment. | unknown |
| AwsSecurityChangesCount | The number of security rules that were changed by the user in the AWS environment. | unknown |
| AwsAdminActivitiesCount | The number of administrative activities performed by the user in the AWS environment. | unknown |
| AwsApiAccessDeniedCount | The number of API accesses denied by the user in the AWS environment. | unknown |
| AwsFailedLogonCount | The number of failed logins by the user in the AWS environment. | unknown |

## Playbook Image

---

![AWS - User Investigation](../doc_files/AWS_-_User_Investigation.png)
7 changes: 7 additions & 0 deletions Packs/AWS-Enrichment-Remediation/ReleaseNotes/1_1_3.md
@@ -0,0 +1,7 @@

#### Playbooks

##### New: AWS - User Investigation

New: This playbook performs an investigation on a specific user in AWS environments, using queries and logs from AWS CloudTrail.
(Available from Cortex XSOAR 6.9.0).
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion Packs/AWS-Enrichment-Remediation/pack_metadata.json
Expand Up @@ -2,7 +2,7 @@
"name": "AWS Enrichment and Remediation",
"description": "Playbooks using multiple AWS content packs for enrichment and remediation purposes",
"support": "xsoar",
"currentVersion": "1.1.2",
"currentVersion": "1.1.3",
"author": "Cortex XSOAR",
"url": "https://www.paloaltonetworks.com/cortex",
"email": "",
Expand Down