Skip to content

Commit e4cc34d

Browse files
idovandijkContent BotShirleyDenkberg
authored andcommitted
Bug fixes related to usernames in Account Enrichment (demisto#29024)
* - Fixed playbook input from malware to account enrichment - Fixed account enrichment username input to support domain\user format too - Fixed the XDR task in the account enrichment playbook to accept both username and domain\username - Added playbooks and formatted them - Added XDR to the account enrichment test in conf.json - Updated the account enrichment test playbook to be from 6.8.0 (lowest supported version) - Generated docs - Updated accont enrichment playbook image * Added RNs for both packs * Bump pack from version CommonPlaybooks to 2.3.94. * Fixed description * description fixes * Bump pack from version CortexXDR to 5.0.10. * Updated description for username input * Updated playbook readme with the new playbook input description * Fixed a small typo * Update Packs/CortexXDR/ReleaseNotes/5_0_10.md Co-authored-by: ShirleyDenkberg <[email protected]> * Update Packs/CommonPlaybooks/ReleaseNotes/2_3_95.md Co-authored-by: ShirleyDenkberg <[email protected]> --------- Co-authored-by: Content Bot <[email protected]> Co-authored-by: ShirleyDenkberg <[email protected]>
1 parent 4630ffb commit e4cc34d

10 files changed

+378
-180
lines changed

Packs/CommonPlaybooks/Playbooks/playbook-Account_Enrichment_-_Generic_v2.2.yml

Lines changed: 300 additions & 117 deletions
Large diffs are not rendered by default.

Packs/CommonPlaybooks/Playbooks/playbook-Account_Enrichment_-_Generic_v2.2_README.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -26,27 +26,28 @@ This playbook does not use any integrations.
2626

2727
* IsIntegrationAvailable
2828
* Set
29+
* SetAndHandleEmpty
2930

3031
### Commands
3132

32-
* pingone-get-user
33-
* identitynow-get-accounts
34-
* ad-get-user
35-
* identityiq-search-identities
36-
* msgraph-user-get
3733
* okta-get-user
38-
* iam-get-user
34+
* msgraph-user-get
35+
* identityiq-search-identities
3936
* aws-iam-get-user
40-
* xdr-list-risky-users
37+
* ad-get-user
38+
* pingone-get-user
4139
* msgraph-user-get-manager
40+
* iam-get-user
41+
* xdr-list-risky-users
42+
* identitynow-get-accounts
4243

4344
## Playbook Inputs
4445

4546
---
4647

4748
| **Name** | **Description** | **Default Value** | **Required** |
4849
| --- | --- | --- | --- |
49-
| Username | The username to enrich. | Account.Username | Optional |
50+
| Username | The usernames to enrich. This input supports multiple usernames.<br/>Usernames can be with or without a domain prefix, in the format of "username" or "domain\\username".<br/>Domain usernames will only be enriched in integrations that support them. | Account.Username | Optional |
5051
| Domain | Optional - This input is needed for the IAM-get-user command \(used in the Account Enrichment - IAM playbook\). Please provide the domain name that the user is related to.<br/>Example: @xsoar.com | | Optional |
5152

5253
## Playbook Outputs
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
2+
#### Playbooks
3+
4+
##### Account Enrichment - Generic v2.1
5+
6+
Fixed an issue where the playbook would fail to enrich accounts in the form of "domain\username". The playbook now makes a distinction and enriches usernames with or without a domain prefix.

Packs/CommonPlaybooks/TestPlaybooks/playbook-Account_Enrichment_-_Generic_v2.1_-_Test.yml

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
id: Account Enrichment - Generic v2.1 - Test
22
version: -1
3-
fromversion: 5.0.0
3+
fromversion: 6.8.0
44
name: Account Enrichment - Generic v2.1 - Test
55
description: A test for the Account Enrichment - Generic v2 playbook.
66
starttaskid: "0"
77
tasks:
88
"0":
99
id: "0"
10-
taskid: 628ddf6f-d859-4b9b-8679-10571ea848fe
10+
taskid: 938ee2b5-dae1-443e-8b36-b87b09db6ff2
1111
type: start
1212
task:
13-
id: 628ddf6f-d859-4b9b-8679-10571ea848fe
13+
id: 938ee2b5-dae1-443e-8b36-b87b09db6ff2
1414
version: -1
1515
name: ""
1616
iscommand: false
@@ -37,10 +37,10 @@ tasks:
3737
isautoswitchedtoquietmode: false
3838
"8":
3939
id: "8"
40-
taskid: 42e5ac7e-2b61-48d7-8988-16de9960f7f4
40+
taskid: 648f1602-68e5-4e44-8783-2e1547e24d17
4141
type: regular
4242
task:
43-
id: 42e5ac7e-2b61-48d7-8988-16de9960f7f4
43+
id: 648f1602-68e5-4e44-8783-2e1547e24d17
4444
version: -1
4545
name: Users with a domain
4646
description: 'Will create an array object in context from given string input '
@@ -53,7 +53,7 @@ tasks:
5353
- "10"
5454
scriptarguments:
5555
arrayData:
56-
simple: DEM449982,DEM531065
56+
simple: DEM449982,DEM531065,desktop-s2455r8\demisto,Administrator
5757
contextKey:
5858
simple: Account.Username
5959
separatecontext: false
@@ -74,10 +74,10 @@ tasks:
7474
isautoswitchedtoquietmode: false
7575
"10":
7676
id: "10"
77-
taskid: be320151-f8bd-43c2-8dd6-b64f706a3462
77+
taskid: 69c06083-9dd2-4286-8bbb-42cab5d95a6a
7878
type: playbook
7979
task:
80-
id: be320151-f8bd-43c2-8dd6-b64f706a3462
80+
id: 69c06083-9dd2-4286-8bbb-42cab5d95a6a
8181
version: -1
8282
name: Account Enrichment - Generic v2.1
8383
description: |-
@@ -124,10 +124,10 @@ tasks:
124124
isautoswitchedtoquietmode: false
125125
"13":
126126
id: "13"
127-
taskid: 372ee57a-43b3-4ace-8088-ddc94f526a3f
127+
taskid: bbc74893-7273-4a63-8077-6f37627774ad
128128
type: title
129129
task:
130-
id: 372ee57a-43b3-4ace-8088-ddc94f526a3f
130+
id: bbc74893-7273-4a63-8077-6f37627774ad
131131
version: -1
132132
name: Checking with a Domain
133133
type: title
@@ -155,10 +155,10 @@ tasks:
155155
isautoswitchedtoquietmode: false
156156
"14":
157157
id: "14"
158-
taskid: a8b08f80-3b3b-4c97-8ac1-786542cfb260
158+
taskid: c7223b7b-93f3-4b51-8a44-1895a5be5328
159159
type: regular
160160
task:
161-
id: a8b08f80-3b3b-4c97-8ac1-786542cfb260
161+
id: c7223b7b-93f3-4b51-8a44-1895a5be5328
162162
version: -1
163163
name: Delete Context
164164
description: Clear the context for a fresh start of the test.
@@ -191,10 +191,10 @@ tasks:
191191
isautoswitchedtoquietmode: false
192192
"15":
193193
id: "15"
194-
taskid: 9cffe0a3-76f9-4f91-81f9-cdc868cd6cf2
194+
taskid: 7b0d6394-6784-4500-8f45-30f750c05f3c
195195
type: condition
196196
task:
197-
id: 9cffe0a3-76f9-4f91-81f9-cdc868cd6cf2
197+
id: 7b0d6394-6784-4500-8f45-30f750c05f3c
198198
version: -1
199199
name: Was the account enriched?
200200
description: Checks whether the account was enriched.
@@ -239,10 +239,10 @@ tasks:
239239
isautoswitchedtoquietmode: false
240240
"16":
241241
id: "16"
242-
taskid: 3088d8ca-4179-4815-8780-b53d275a2add
242+
taskid: c19e900b-d8b0-48a6-897a-87c27e76e97e
243243
type: regular
244244
task:
245-
id: 3088d8ca-4179-4815-8780-b53d275a2add
245+
id: c19e900b-d8b0-48a6-897a-87c27e76e97e
246246
version: -1
247247
name: Make test fail
248248
description: Prints an error entry with a given message.
@@ -275,10 +275,10 @@ tasks:
275275
isautoswitchedtoquietmode: false
276276
"17":
277277
id: "17"
278-
taskid: f2c3b038-ac2b-4661-8f9f-1535fa5dba98
278+
taskid: 1c9bcc76-5564-41e1-86bc-81fb64d94bb0
279279
type: title
280280
task:
281-
id: f2c3b038-ac2b-4661-8f9f-1535fa5dba98
281+
id: 1c9bcc76-5564-41e1-86bc-81fb64d94bb0
282282
version: -1
283283
name: Checking with a Domain
284284
type: title
@@ -303,10 +303,10 @@ tasks:
303303
isautoswitchedtoquietmode: false
304304
"18":
305305
id: "18"
306-
taskid: 6ada5f2c-bba8-423d-86e8-404b8df7658b
306+
taskid: f1d64a8a-3589-4201-80ec-b87b7024bf93
307307
type: regular
308308
task:
309-
id: 6ada5f2c-bba8-423d-86e8-404b8df7658b
309+
id: f1d64a8a-3589-4201-80ec-b87b7024bf93
310310
version: -1
311311
name: Delete Context
312312
description: Clear the context for a fresh start of the test.
@@ -339,10 +339,10 @@ tasks:
339339
isautoswitchedtoquietmode: false
340340
"19":
341341
id: "19"
342-
taskid: f84b83dc-6451-4fdd-8eea-8e91279ea045
342+
taskid: 582a5630-c097-46ac-8760-d370ad922477
343343
type: playbook
344344
task:
345-
id: f84b83dc-6451-4fdd-8eea-8e91279ea045
345+
id: 582a5630-c097-46ac-8760-d370ad922477
346346
version: -1
347347
name: Account Enrichment - Generic v2.1
348348
description: |-
@@ -381,10 +381,10 @@ tasks:
381381
isautoswitchedtoquietmode: false
382382
"20":
383383
id: "20"
384-
taskid: 43bec4b2-8eec-49bc-8059-cc9d0da80ca5
384+
taskid: 71ace41d-837c-4b8b-8238-0c7bd6ba71f4
385385
type: title
386386
task:
387-
id: 43bec4b2-8eec-49bc-8059-cc9d0da80ca5
387+
id: 71ace41d-837c-4b8b-8238-0c7bd6ba71f4
388388
version: -1
389389
name: Test Without any Inputs
390390
type: title
Loading

Packs/CommonPlaybooks/pack_metadata.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"name": "Common Playbooks",
33
"description": "Frequently used playbooks pack.",
44
"support": "xsoar",
5-
"currentVersion": "2.3.94",
5+
"currentVersion": "2.3.95",
66
"author": "Cortex XSOAR",
77
"url": "https://www.paloaltonetworks.com/cortex",
88
"email": "",

Packs/CortexXDR/Playbooks/playbook-Cortex_XDR_Malware_-_Incident_Enrichment.yml

Lines changed: 27 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,8 @@ tasks:
5656
isoversize: false
5757
nexttasks:
5858
'#none#':
59-
- '2'
59+
- "27"
60+
- "2"
6061
note: false
6162
quietmode: 0
6263
separatecontext: false
@@ -1047,14 +1048,14 @@ tasks:
10471048
complex:
10481049
root: UserManagerEmail
10491050
filters:
1050-
- - operator: isNotEmpty
1051-
left:
1052-
value:
1053-
simple: UserManagerEmail
1054-
iscontext: true
1051+
- - operator: isNotEmpty
1052+
left:
1053+
value:
1054+
simple: UserManagerEmail
1055+
iscontext: true
10551056
transformers:
1056-
- operator: uniq
1057-
- operator: FirstArrayElement
1057+
- operator: uniq
1058+
- operator: FirstArrayElement
10581059
separatecontext: false
10591060
continueonerror: true
10601061
continueonerrortype: ""
@@ -1074,40 +1075,38 @@ tasks:
10741075
isautoswitchedtoquietmode: false
10751076
"29":
10761077
id: "29"
1077-
taskid: 456021f6-5586-4e7d-871d-e5f074c0a666
1078+
taskid: 779567f1-efb5-4c7c-86e8-47217bd39bef
10781079
type: playbook
10791080
task:
1080-
id: 456021f6-5586-4e7d-871d-e5f074c0a666
1081+
id: 779567f1-efb5-4c7c-86e8-47217bd39bef
10811082
version: -1
10821083
name: Account Enrichment - Generic v2.1
10831084
playbookName: Account Enrichment - Generic v2.1
10841085
type: playbook
10851086
iscommand: false
10861087
brand: ""
1087-
description: ''
1088+
description: |-
1089+
Enrich accounts using one or more integrations.
1090+
Supported integrations:
1091+
- Active Directory
1092+
- SailPoint IdentityNow
1093+
- SailPoint IdentityIQ
1094+
- PingOne
1095+
- Okta
1096+
- AWS IAM
1097+
- Cortex XDR (account enrichment and reputation)
1098+
1099+
Also, the playbook supports the generic command 'iam-get-user' (implemented in IAM integrations. For more information, visit https://xsoar.pan.dev/docs/integrations/iam-integrations.
10881100
nexttasks:
10891101
'#none#':
10901102
- "28"
10911103
scriptarguments:
10921104
Username:
10931105
complex:
1094-
root: incident.users
1095-
filters:
1096-
- - operator: isNotEmpty
1097-
left:
1098-
value:
1099-
simple: incident.users
1100-
iscontext: true
1106+
root: incident
11011107
transformers:
11021108
- operator: uniq
1103-
- operator: FirstArrayElement
1104-
- operator: splitAndTrim
1105-
args:
1106-
delimiter:
1107-
value:
1108-
simple: \
1109-
- operator: uniq
1110-
- operator: LastArrayElement
1109+
accessor: users
11111110
separatecontext: true
11121111
continueonerrortype: ""
11131112
loop:
@@ -1303,11 +1302,11 @@ view: |-
13031302
}
13041303
}
13051304
tests:
1305+
- Test Playbook - Cortex XDR Malware - Incident Enrichment
13061306
- Test XDR Playbook general commands
13071307
- Test XDR Playbook
1308-
- Test Playbook - Cortex XDR Malware - Incident Enrichment
13091308
fromversion: 6.5.0
13101309
description: |-
13111310
This playbook is part of the 'Malware Investigation And Response' pack. For more information, refer to https://xsoar.pan.dev/docs/reference/packs/malware-investigation-and-response.
13121311
This playbook enriches the Cortex XDR incident. The enrichment is done on the involved endpoint and Mitre technique ID information, and sets the 'Malware-Investigation and Response' layout.
1313-
system: true
1312+
system: true
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
2+
#### Playbooks
3+
4+
##### Cortex XDR Malware - Incident Enrichment
5+
6+
Fixed an issue where usernames tied to specific domains were not enriched as expected.

Packs/CortexXDR/pack_metadata.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"name": "Cortex XDR by Palo Alto Networks",
33
"description": "Automates Cortex XDR incident response, and includes custom Cortex XDR incident views and layouts to aid analyst investigations.",
44
"support": "xsoar",
5-
"currentVersion": "5.0.9",
5+
"currentVersion": "5.0.10",
66
"author": "Cortex XSOAR",
77
"url": "https://www.paloaltonetworks.com/cortex",
88
"email": "",

Tests/conf.json

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2824,7 +2824,10 @@
28242824
},
28252825
{
28262826
"playbookID": "Account Enrichment - Generic v2.1 - Test",
2827-
"integrations": "Active Directory Query v2",
2827+
"integrations": [
2828+
"Active Directory Query v2",
2829+
"Cortex XDR - IR"
2830+
],
28282831
"instance_names": "active_directory_80k",
28292832
"has_api": false
28302833
},

0 commit comments

Comments
 (0)