IRIS DFIR
IRIS DFIR Pack.#
This Integration is part of theSupported versions
Supported Cortex XSOAR versions: 6.10.0 and later.
IRIS is a collaborative platform aiming to help incident responders to share technical details during investigations. It's free and open-source. This integration was integrated and tested with version v2.3.6 of IRIS DFIR
#
Configure IRIS DFIR in CortexParameter | Description | Required |
---|---|---|
Server IP or Host Name (e.g., https://192.168.0.1) | True | |
API Key for authentication | True | |
Trust any certificate (not secure) | False | |
Use system proxy settings | False | |
Fetch incidents | False | |
Incidents Fetch Interval | False | |
Incident type | False | |
Incident Last Case ID | Fetch all the cases starting from this value, not including it. | False |
#
CommandsYou can execute these commands from the CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.
#
iris-get-last-case-idIRIS Command to get the last case information
#
Base Commandiris-get-last-case-id
#
InputArgument Name | Description | Required |
---|
#
Context OutputPath | Type | Description |
---|---|---|
IRIS.case_soc_id | string | SOC ID ticket case |
IRIS.case_id | number | case ID ticket number |
IRIS.case_description | string | case description |
IRIS.opened_by | unknown | case opened by |
IRIS.owner | unknown | case owner |
IRIS.classification_id | number | case classification ID |
IRIS.state_name | string | case state name |
IRIS.case_open_date | unknown | case open date |
IRIS.case_name | string | case name |
IRIS.client_name | string | case client name |
IRIS.classification | string | case classification |
IRIS.case_uuid | string | case uuid |
IRIS.state_id | string | case state ID |
IRIS.access_level | string | case access level |
#
Command example!iris-get-last-case-id
#
Context Example#
Human Readable Output#
Command successfully sent to IRIS DFIR"
access_level case_description case_id case_name case_open_date case_uuid classification classification_id client_name opened_by opened_by_user_id owner owner_id state_id state_name 4 TEST 7 32 #32 - TEST 7 12/18/2023 47ae5435-4c25-4408-bf86-98277807b2fa malicious-code:dialer 9 CERT-EU nouser2 1 nouser2 1 3 Opened
#
iris-get-all-casesReturn a list of all IRIS DFIR cases
#
Base Commandiris-get-all-cases
#
InputArgument Name | Description | Required |
---|
#
Context OutputPath | Type | Description |
---|---|---|
IRIS.case_soc_id | unknown | SOC ID ticket case |
IRIS.case_id | number | case ID ticket number |
IRIS.case_description | unknown | case description |
IRIS.opened_by | unknown | case opened by |
IRIS.owner | unknown | case owner |
IRIS.classification_id | number | case classification ID |
IRIS.state_name | unknown | case state name |
IRIS.case_open_date | unknown | case open date |
IRIS.case_name | unknown | case name |
IRIS.client_name | unknown | case client name |
IRIS.classification | unknown | case classification |
IRIS.case_uuid | unknown | case uuid |
IRIS.state_id | unknown | case state ID |
IRIS.access_level | unknown | case access level |
#
Command example!iris-get-all-cases
#
Context Example#
Human Readable Output#
Command successfully sent to IRIS DFIR"
access_level case_close_date case_description case_id case_name case_open_date case_soc_id case_uuid classification classification_id client_name opened_by opened_by_user_id owner owner_id state_id state_name 4 TEST 7 32 #32 - TEST 7 12/18/2023 47ae5435-4c25-4408-bf86-98277807b2fa malicious-code:dialer 9 CERT-EU nouser2 1 nouser2 1 3 Opened 4 TEST 5 31 #31 - TEST 5 12/18/2023 5d5e6bc6-2c83-4c77-9f87-fb12d82e1e35 malicious-code:ransomware 6 CERT-EU nouser2 1 nouser2 1 3 Opened 4 case null 0000f
### dsdsdsd29 #29 - case null 0000f 12/14/2023 e7ed6439-799a-4eaf-b16c-cde8f7a10ffc malicious-code:dialer 9 CERT-EU nouser2 1 nouser2 1 3 Opened 4 malware byte you
test2222228 #28 - malware byte you 12/14/2023 test-eu-111 2aeb9026-7b1d-4caa-a22d-b95e7507eec8 abusive-content:harmful-speech 2 CERT-EU nouser2 1 nouser2 1 4 Containment 4 test jira fields
### 1224443427 #27 - test jira fields 11/30/2023 6b8d5e9a-e27b-4a6a-b27d-059b235f0814 malicious-code:spyware-rat 8 CERT-EU nouser2 1 nouser2 1 3 Opened 4 Evil rootkit
##
machine evil26 #26 - Evil rootkit 11/22/2023 CERT-EU-846327 dec1a169-37cf-44b0-8e9d-78b51efebbc0 malicious-code:rootkit 10 CERT-EU nouser2 1 nouser2 1 5 Eradication 4 mail spam
spam 123444425 #25 - mail spam 11/22/2023 CERT-EU-8213423 83317f2e-72df-4934-a283-500fecd0e758 abusive-content:spam 1 CERT-EU nouser2 1 nouser2 1 4 Containment 4 Evil spyware
dark 123 machine local24 #24 - Evil spyware 11/22/2023 CERT-EU-896492 c63dc059-b8a7-4595-bc2b-833e4798e3ac malicious-code:spyware-rat 8 CERT-EU nouser2 1 nouser2 1 3 Opened 4 Scanning VIP
fdsfdsfsdfsdfsdfsdf23 #23 - Scanning VIP 11/22/2023 CERT-EU-2316346 cd85ed04-fa5a-4f47-8a3f-0280297a3d53 information-gathering:scanner 11 CERT-EU nouser2 1 nouser2 1 3 Opened 4 virus id 2244
testing 123
machine 10.0.0.120 #20 - virus id 2244 11/22/2023 CERT-EU-55 6e71ba63-ad61-4c7e-8b4e-10f16a65cb36 malicious-code:virus 4 CERT-EU nouser2 1 nouser2 1 3 Opened 4 rootkit blabla
machine.dark.local malware baisfldasnfadsf19 #19 - rootkit blabla 09/29/2023 CERT--EU-444 a48eed36-cc03-4a42-a13b-3af41a76dccb malicious-code:rootkit 10 CERT-EU nouser2 1 nouser2 1 3 Opened 4 09/28/2023 Phishing EU member
blabla18 #18 - Phishing EU member 09/28/2023 CERT-EU-77 a9803459-461b-4442-a11e-b6440a91cd85 fraud:phishing 30 CERT-EU nouser2 1 nouser2 1 9 Closed 4 Phishing EU official
test ticket !!!17 #17 - #17 case custom attrib test 08/09/2023 soc_id_demo c034f0fa-d19c-480a-8b1d-045b558915d0 abusive-content:harmful-speech 2 CERT-EU nouser2 1 Natasha Carl 2 4 Containment 4 09/25/2023 spam test ticket
blah16 #16 - spam test ticket 07/13/2023 CERT-EU-21 71636b85-ef58-4d45-a5bf-faa2ac00031a abusive-content:spam 1 CERT-EU nouser2 1 nouser2 1 9 Closed 4 dark.local
testing notes15 #15 - Virus detected on VM dark.local 07/13/2023 CERT-EU-20 94e4a63a-3c8b-4a4e-ae02-b32c0c1b6386 malicious-code:virus 4 CERT-EU nouser2 1 nouser2 1 2 In progress 4 ROOTKIT TEST
THIS IS A TEST FORM13 #13 - ROOTKIT TEST 06/08/2023 CERT-EU-19 6f8a72b5-2c82-4654-b84a-e8e10e9299de malicious-code:rootkit 10 CERT-EU nouser2 1 nouser2 1 3 Opened 4 09/26/2023 Scanning ports machine X
- 1
- 2
- 3
-
## EDITED12 #12 - Scanning ports machine X 06/08/2023 CERT-EU-18 3662a525-d572-495c-9d25-45920c3ad1ce information-gathering:scanner 11 CERT-EU nouser2 1 nouser2 1 9 Closed 4 Code Dialer
### TEST CODE CODE11 #11 - Code Dialer 06/08/2023 CERT-EU-17 f0b3b128-88f3-4a37-a908-58ecb5fc7c89 malicious-code:dialer 9 CERT-EU nouser2 1 nouser2 1 3 Opened 4 spyware test 1 10 #10 - spyware test 1 06/08/2023 CERT-EU-16 38ba94bf-978f-4073-99af-291f79889b0b malicious-code:spyware-rat 8 CERT-EU nouser2 1 nouser2 1 3 Opened 4 Social Eng 9 #9 - Social Eng 06/07/2023 CERT-EU-15 35070554-73c1-421a-bdbb-b840f09411b4 information-gathering:social-engineering 13 CERT-EU nouser2 1 nouser2 1 3 Opened 4 WAF invaded 8 #8 - WAF invaded 06/07/2023 CERT-EU-15 9bab6e73-be89-497c-bfc1-25e213f933eb CERT-EU nouser2 1 nouser2 1 3 Opened 4 A virus has been detected on machine machine.darkside.in
DDOS
| Port | Protocol |Hostname|
|--|--|--|
| 443 | TCP |machine.darkside.in|
```echo Please investigate !```
### HELP !7 #7 - test command 1 06/07/2023 CERT-EU-14 e88efdc4-6811-4c59-aca6-7eeefab72a81 availability:ddos 23 CERT-EU nouser2 1 nouser2 1 6 Recovery 4 A virus has been detected on machine machine.darkside.in
| Port | Protocol |Hostname|
|--|--|--|
| 443 | TCP |machine.darkside.in|
```echo Please investigate !```
### HELP !6 #6 - Malware detected on machine.darkside.in 06/07/2023 CERT-EU-13 4f7d583d-7724-4be3-9137-7ca248630bc0 CERT-EU nouser2 1 nouser2 1 3 Opened 4 Ransomware test 3 #3 - CERT-EU Ransomware test 06/05/2023 CERT-EU-82 7b9ec75f-f194-4d73-a98a-b657b40b2cc4 malicious-code:ransomware 6 CERT-EU nouser2 1 nouser2 1 3 Opened 4 A virus has been detected on machine darkpace.evil
| Port | Protocol |Hostname|
|--|--|--|
| 443 | TCP |darkplace.evil|
```echo Please investigate !```
### HELP !2 #2 - virus-windows-11 06/05/2023 CERT-EU-12 1a5e6534-571f-4788-b4f5-47cc6b0c18bc malicious-code:virus 4 CERT-EU nouser2 1 nouser2 1 3 Opened 4 06/05/2023 This is a demonstration. 1 #1 - Initial Demo 06/05/2023 soc_id_demo 46480e7c-5b78-42c5-8b2e-678991a8a495 CERT-EU nouser2 1 nouser2 1 2 In progress
#
iris-close-case-idClose a specific case by ID.
#
Base Commandiris-close-case-id
#
InputArgument Name | Description | Required |
---|---|---|
case_id | Provide Case ID. | Required |
#
Context OutputPath | Type | Description |
---|---|---|
IRIS.case_name | unknown | case name |
IRIS.case_soc_id | unknown | case soc ID |
IRIS.open_date | unknown | case open date |
IRIS.close_date | unknown | case close date |
#
Command example!iris-close-case-id case_id=9
#
Context Example#
Human Readable Output#
Command successfully sent to IRIS DFIR"
case_customer case_description case_id case_name case_soc_id case_uuid classification_id close_date modification_history open_date owner_id state_id status_id user_id 1 Social Eng 9 #9 - Social Eng CERT-EU-15 35070554-73c1-421a-bdbb-b840f09411b4 13 2024-01-22 1686161424.82484: {"user": "nouser2", "user_id": 1, "action": "created"}
1694445948.238388: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694446268.42952: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694446597.253438: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694446626.551442: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447102.368478: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447187.785556: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447233.805542: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447256.462593: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447324.542543: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447772.724512: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1694448681.95518: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694449204.048061: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694449647.332296: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1694449754.493539: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694450199.853172: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1694452250.114495: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694452672.978887: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1704711697.835427: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1704711700.739643: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1704711947.950361: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1704711950.774661: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1705935117.44055: {"user": "nouser2", "user_id": 1, "action": "case closed"}2023-06-07 1 9 0 1
#
iris-reopen-case-idReopen a specific case by ID.
#
Base Commandiris-reopen-case-id
#
InputArgument Name | Description | Required |
---|---|---|
case_id | case ID. | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
IRIS.case_soc_id | unknown | case soc ID |
IRIS.case_id | unknown | case ID |
IRIS.close_date | unknown | case close date |
IRIS.open_date | unknown | case open date |
IRIS.case_name | unknown | case name |
IRIS.closing_note | unknown | case closing note |
#
Command example!iris-reopen-case-id case_id=9
#
Context Example#
Human Readable Output#
Command successfully sent to IRIS DFIR"
case_customer case_description case_id case_name case_soc_id case_uuid classification_id modification_history open_date owner_id state_id status_id user_id 1 Social Eng 9 #9 - Social Eng CERT-EU-15 35070554-73c1-421a-bdbb-b840f09411b4 13 1686161424.82484: {"user": "nouser2", "user_id": 1, "action": "created"}
1694445948.238388: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694446268.42952: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694446597.253438: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694446626.551442: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447102.368478: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447187.785556: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447233.805542: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447256.462593: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447324.542543: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694447772.724512: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1694448681.95518: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694449204.048061: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694449647.332296: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1694449754.493539: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694450199.853172: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1694452250.114495: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1694452672.978887: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1704711697.835427: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1704711700.739643: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1704711947.950361: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1704711950.774661: {"user": "nouser2", "user_id": 1, "action": "case reopened"}
1705935117.44055: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1705935120.30414: {"user": "nouser2", "user_id": 1, "action": "case reopened"}2023-06-07 1 3 0 1
#
iris-change-case-stateChange case state status
#
Base Commandiris-change-case-state
#
InputArgument Name | Description | Required |
---|---|---|
case_id | Case ID. | Required |
case_name | Case name. | Required |
case_state | Case state. Possible values are: In progress, Opened, Containement, Eradication, Recovery, Post-Incident, Reporting, Closed. | Required |
#
Context OutputPath | Type | Description |
---|---|---|
IRIS.case_id | number | Case ID |
IRIS.case_name | string | Case name |
IRIS.case_state | string | Case state |
#
Command example!iris-change-case-state case_id=1 case_state="In progress" case_name="#1 - Initial Demo"
#
Context Example#
Human Readable Output#
Command successfully sent to IRIS DFIR"
case_customer case_description case_id case_name case_soc_id case_uuid close_date modification_history open_date owner_id state_id status_id user_id 1 This is a demonstration. 1 #1 - Initial Demo soc_id_demo 46480e7c-5b78-42c5-8b2e-678991a8a495 2023-06-05 1685985574.367342: {"user": "nouser2", "user_id": 1, "action": "case closed"}
1704711960.320669: {"user": "nouser2", "user_id": 1, "action": "case info updated"}
1705935129.662093: {"user": "nouser2", "user_id": 1, "action": "case info updated"}2023-06-05 1 2 0 1
#
iris-create-notes-groupCreates notes group
#
Base Commandiris-create-notes-group
#
InputArgument Name | Description | Required |
---|---|---|
case_id | Case ID. | Required |
group_title | Notes group tittle. | Required |
#
Context OutputThere is no context output for this command.
#
Command example!iris-create-notes-group case_id=1 group_title="test group"
#
Context Example#
Human Readable Output#
Command successfully sent to IRIS DFIR"
group_creationdate group_id group_lastupdate group_title group_uuid 2024-01-22T14:52:12.540571 57 2024-01-22T14:52:12.540571 test group 62742497-8cf6-4cea-bac4-5ff50e4bb4e5
#
iris-add-new-note-to-groupAdd a new note to an existing group.
#
Base Commandiris-add-new-note-to-group
#
InputArgument Name | Description | Required |
---|---|---|
case_id | Case ID. | Required |
note_title | Note tittle. | Required |
note_content | Note content. | Required |
group_id | Group ID. | Required |
#
Context OutputThere is no context output for this command.
#
Command example!iris-add-new-note-to-group case_id=1 group_id=55 note_content="test content" note_title="test tittle"
#
Context Example#
Human Readable Output#
Command successfully sent to IRIS DFIR"
note_content note_creationdate note_id note_lastupdate note_title note_uuid test content 2024-01-22T14:52:15.366100 63 2024-01-22T14:52:15.366100 test tittle a2cf6b17-d8be-4ca0-814d-12910aefa2f2
#
iris-get-list-of-groups-and-notesGet a list of the notes and groups.
#
Base Commandiris-get-list-of-groups-and-notes
#
InputArgument Name | Description | Required |
---|---|---|
case_id | Case ID. | Required |
#
Context OutputThere is no context output for this command.
#
Command example!iris-get-list-of-groups-and-notes case_id=1
#
Context Example#
Human Readable Output#
Command successfully sent to IRIS DFIR"
groups state {'group_id': 1, 'group_uuid': '98a49bf1-66a3-4014-94a3-b84f7465129e', 'group_title': 'test group', 'notes': []},
{'group_id': 55, 'group_uuid': '89085dde-aa63-467b-a17a-d78d20bdc794', 'group_title': 'test group', 'notes': [{'note_id': 61, 'note_uuid': '1e7cfa4e-6ce0-4261-ae5d-a70eba2b1462', 'note_title': 'test tittle', 'user': 'nouser2', 'note_lastupdate': '2024-01-08T11:04:41.529018'}, {'note_id': 62, 'note_uuid': 'c1ceef5b-0020-48d7-ac0f-c0c4c40ef396', 'note_title': 'test tittle', 'user': 'nouser2', 'note_lastupdate': '2024-01-08T11:06:05.840447'}, {'note_id': 63, 'note_uuid': 'a2cf6b17-d8be-4ca0-814d-12910aefa2f2', 'note_title': 'test tittle', 'user': 'nouser2', 'note_lastupdate': '2024-01-22T14:52:15.366100'}]},
{'group_id': 56, 'group_uuid': '36da7617-6eca-49d9-bbb6-64737db54aab', 'group_title': 'test group', 'notes': []},
{'group_id': 57, 'group_uuid': '62742497-8cf6-4cea-bac4-5ff50e4bb4e5', 'group_title': 'test group', 'notes': []}object_state: 8
object_last_update: 2024-01-22T14:52:15.373121
#
iris-get-list-of-iocsReturns a list of IOCs as well as any existing linked with other cases.
#
Base Commandiris-get-list-of-iocs
#
InputArgument Name | Description | Required |
---|---|---|
case_id | Case ID. | Required |
#
Context OutputPath | Type | Description |
---|---|---|
IRIS.case_id | number | Case ID. |
IRIS.case_name | string | Case Name. |
#
Command example!iris-get-list-of-iocs case_id=1
#
Context Example#
Human Readable Output#
Command successfully sent to IRIS DFIR"
ioc state {'ioc_id': 5, 'ioc_uuid': '93ca5e50-13a5-4d59-8b92-b99bf4bb70fd', 'ioc_value': 'github-username-example', 'ioc_type_id': 65, 'ioc_type': 'github-username', 'ioc_description': 'This is an example', 'ioc_tags': '', 'ioc_misp': None, 'tlp_name': 'amber', 'tlp_bscolor': 'warning', 'ioc_tlp_id': 2, 'link': [], 'misp_link': None} object_state: 1
object_last_update: 2024-01-08T10:45:20.129696
#
iris-get-ioc-contentFetch the content of an ioc.
#
Base Commandiris-get-ioc-content
#
InputArgument Name | Description | Required |
---|---|---|
case_id | Case ID. | Required |
ioc_id | IoC ID. | Required |
#
Context OutputPath | Type | Description |
---|---|---|
IRIS.case_id | number | Case ID. |
IRIS.ioc_description | string | IoC Description. |
IRIS.ioc_id | number | IoC ID. |
IRIS.ioc_value | string | IoC Value. |
IRIS.ioc_type | string | IoC Type. |
#
Command example!iris-get-ioc-content case_id=1 ioc_id=5
#
Context Example#
Human Readable Output#
Command successfully sent to IRIS DFIR"
ioc_description ioc_id ioc_tlp_id ioc_type ioc_type_id ioc_uuid ioc_value user_id This is an example 5 2 type_description: A github user name
type_taxonomy: null
type_id: 65
type_name: github-username
type_validation_regex: null
type_validation_expect: null65 93ca5e50-13a5-4d59-8b92-b99bf4bb70fd github-username-example 1