From a592bbb575a38369dc5fbc5befe632d7d98087f6 Mon Sep 17 00:00:00 2001 From: kzuchowska Date: Fri, 6 Sep 2024 10:05:29 +0200 Subject: [PATCH 01/40] add update email action --- office365.json | 557 +++++++++++++++++++++++++++++++++++++++++ office365_connector.py | 28 +++ 2 files changed, 585 insertions(+) diff --git a/office365.json b/office365.json index 38b781c..69bae6d 100644 --- a/office365.json +++ b/office365.json @@ -7130,6 +7130,563 @@ }, "output": [], "versions": "EQ(*)" + }, + { + "action": "update email", + "description": "Update an email on the server", + "verbose": "Currently, this action only updates the category and subject of an email. To set multiple categories, please pass a comma-separated list to the category parameter.
NOTE: If the user tries to update the categories, then the existing categories of the email will be replaced with the new categories provided as input.", + "type": "generic", + "identifier": "update_email", + "read_only": false, + "parameters": { + "id": { + "description": "Message ID to delete", + "data_type": "string", + "required": true, + "primary": true, + "contains": [ + "msgoffice365 message id" + ], + "order": 0 + }, + "email_address": { + "description": "Email address of the mailbox owner", + "data_type": "string", + "required": true, + "primary": true, + "contains": [ + "email" + ], + "order": 1 + }, + "category": { + "description": "Categories to set", + "data_type": "string", + "order": 2, + "allow_list": true + } + }, + "render": { + "type": "table" + }, + "output": [ + { + "data_path": "action_result.status", + "data_type": "string", + "example_values": [ + "success", + "failed" + ] + }, + { + "data_path": "action_result.parameter.category", + "data_type": "string", + "example_values": [ + "Yellow, Blue, Purple, red" + ] + }, + { + "data_path": "action_result.parameter.email", + "data_type": "string", + "example_values": [ + "test@sample.com" + ], + "contains": [ + "email" + ] + }, + { + "data_path": "action_result.parameter.id", + "data_type": "string", + "example_values": [ + "AAMkAGIyMTUxYTkzLWRjYjctNDFjMi04NTAxLTQzMDFkNDhlZmI5MQBGAAAAAACxQSnX8n2GS4cunBIQ2sV7BwCQhMsoV7EYSJF42ChR9SCxAAAAYCbsAACQhMsoV7EYSJF42ChR9SCxAAAAjh8bAAA=" + ], + "contains": [ + "msgoffice365 message id" + ], + "column_name": "Message ID", + "column_order": 1 + }, + { + "data_path": "action_result.parameter.subject", + "data_type": "string", + "example_values": [ + "Both value are modified" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_AttachmentId.@Id", + "data_type": "string" + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_ContentType", + "data_type": "string", + "example_value": "application/pdf" + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_IsContactPhoto", + "data_type": "string", + "example_value": "false" + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_IsInline", + "data_type": "string", + "example_value": "false" + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_LastModifiedTime", + "data_type": "string", + "example_value": "2010-07-30T10:52:32" + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_Name", + "data_type": "string" + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_Size", + "data_type": "string", + "example_value": "23433" + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_AttachmentId.@Id", + "data_type": "string", + "example_values": [ + "AAMkAGIyMTUxYTkzLWRjYjctNDFjMi04NTAxLTQzMDFkNDhlZmI5MQBGAAAAAACxQSnX8n2GS4cunBIQ2sV7BwCQhMsoV7EYSJF42ChR9SCxAAAAYCbsAACQhMsoV7EYSJF42ChR9SCxAAAAjh8bAAABEgAQAHAXDtZM8ItNnDTtvcd6IAo=" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_ContentId", + "data_type": "string", + "example_values": [ + "7518226202D21C4397EE1CB1E2E540C7@sample.com" + ], + "contains": [ + "email" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_ContentType", + "data_type": "string", + "example_values": [ + "application/octet-stream" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_IsContactPhoto", + "data_type": "string", + "example_values": [ + "false" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_IsInline", + "data_type": "string", + "example_values": [ + "false" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_LastModifiedTime", + "data_type": "string", + "example_values": [ + "2017-10-03T21:31:05" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_Name", + "data_type": "string", + "example_values": [ + "test.msg" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_Size", + "data_type": "string", + "example_values": [ + "55360" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_AttachmentId.@Id", + "data_type": "string", + "example_values": [ + "AAMkAGFmNTRhODA4LWIxMjQtNDJjYy05NDM2LWQ5MzY1MGFhMTkzYwBGAAAAAADRlY7ewL4xToKRDciQog5UBwBvUzMoUJx2S4nbgxzZWx2PAAEHZktbAABvUzMoUJx2S4nbgxzZWx2PAAEnqxyTAAABEgAQAN3G1cBjf8hIhr55ziP1DBI=" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_ContentId", + "data_type": "string", + "example_values": [ + "9C14EE4B699D7349B0403C3CDF3F8729@namprd17.prod.outlook.com" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_ContentType", + "data_type": "string", + "example_values": [ + "message/rfc822" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_IsInline", + "data_type": "string", + "example_values": [ + "false" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_LastModifiedTime", + "data_type": "string", + "example_values": [ + "2019-11-08T11:46:32" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_Name", + "data_type": "string", + "example_values": [ + "Test user added you to the test-h1 group" + ] + }, + { + "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_Size", + "data_type": "string", + "example_values": [ + "69852" + ] + }, + { + "data_path": "action_result.data.*.t_Body.#text", + "data_type": "string", + "example_values": [ + "Attached .msg file. Hello" + ] + }, + { + "data_path": "action_result.data.*.t_Body.@BodyType", + "data_type": "string", + "example_values": [ + "Text" + ] + }, + { + "data_path": "action_result.data.*.t_Categories", + "data_type": "string", + "example_values": [ + "red" + ] + }, + { + "data_path": "action_result.data.*.t_CcRecipients.t_Mailbox.t_EmailAddress", + "data_type": "string", + "example_value": "abc@xyz.com" + }, + { + "data_path": "action_result.data.*.t_CcRecipients.t_Mailbox.t_MailboxType", + "data_type": "string", + "example_value": "OneOff" + }, + { + "data_path": "action_result.data.*.t_CcRecipients.t_Mailbox.t_Name", + "data_type": "string", + "example_value": "abc@xyz.com" + }, + { + "data_path": "action_result.data.*.t_CcRecipients.t_Mailbox.t_RoutingType", + "data_type": "string", + "example_value": "SMTP" + }, + { + "data_path": "action_result.data.*.t_DateTimeCreated", + "data_type": "string", + "example_values": [ + "2017-10-05T20:19:58Z" + ] + }, + { + "data_path": "action_result.data.*.t_DateTimeReceived", + "data_type": "string", + "example_values": [ + "2017-10-03T21:31:05Z" + ] + }, + { + "data_path": "action_result.data.*.t_DateTimeSent", + "data_type": "string", + "example_values": [ + "2017-10-03T21:31:20Z" + ] + }, + { + "data_path": "action_result.data.*.t_ExtendedProperty.t_ExtendedFieldURI.@PropertyTag", + "data_type": "string", + "example_values": [ + "0x7d" + ] + }, + { + "data_path": "action_result.data.*.t_ExtendedProperty.t_ExtendedFieldURI.@PropertyType", + "data_type": "string", + "example_values": [ + "String" + ] + }, + { + "data_path": "action_result.data.*.t_ExtendedProperty.t_Value", + "data_type": "string", + "example_values": [ + "MWHPR18MB1519.namprd18.prod.outlook.com" + ] + }, + { + "data_path": "action_result.data.*.t_From.t_Mailbox.t_EmailAddress", + "data_type": "string", + "example_values": [ + "test@sample.com" + ], + "contains": [ + "email" + ] + }, + { + "data_path": "action_result.data.*.t_From.t_Mailbox.t_MailboxType", + "data_type": "string", + "example_values": [ + "OneOff" + ] + }, + { + "data_path": "action_result.data.*.t_From.t_Mailbox.t_Name", + "data_type": "string", + "example_values": [ + "Test" + ] + }, + { + "data_path": "action_result.data.*.t_From.t_Mailbox.t_RoutingType", + "data_type": "string", + "example_values": [ + "SMTP" + ] + }, + { + "data_path": "action_result.data.*.t_HasAttachments", + "data_type": "string", + "example_values": [ + "true" + ] + }, + { + "data_path": "action_result.data.*.t_InternetMessageId", + "data_type": "string", + "example_values": [ + "<81c761fe-caa8-f924-f65d-079382c1ad0b@sample.com>" + ] + }, + { + "data_path": "action_result.data.*.t_IsAssociated", + "data_type": "string", + "example_values": [ + "false" + ] + }, + { + "data_path": "action_result.data.*.t_IsDeliveryReceiptRequested", + "data_type": "string", + "example_values": [ + "false" + ] + }, + { + "data_path": "action_result.data.*.t_IsRead", + "data_type": "string", + "example_values": [ + "true" + ] + }, + { + "data_path": "action_result.data.*.t_IsReadReceiptRequested", + "data_type": "string", + "example_values": [ + "false" + ] + }, + { + "data_path": "action_result.data.*.t_ItemId.@ChangeKey", + "data_type": "string", + "example_values": [ + "CQAAABYAAACQhMsoV7EYSJF42ChR9SCxAAAAj9UU" + ] + }, + { + "data_path": "action_result.data.*.t_ItemId.@Id", + "data_type": "string", + "example_values": [ + "AAMkAGIyMTUxYTkzLWRjYjctNDFjMi04NTAxLTQzMDFkNDhlZmI5MQBGAAAAAACxQSnX8n2GS4cunBIQ2sV7BwCQhMsoV7EYSJF42ChR9SCxAAAAYCbsAACQhMsoV7EYSJF42ChR9SCxAAAAjh8bAAA=" + ] + }, + { + "data_path": "action_result.data.*.t_LastModifiedTime", + "data_type": "string", + "example_values": [ + "2017-10-31T01:09:20Z" + ] + }, + { + "data_path": "action_result.data.*.t_MimeContent.#text", + "data_type": "string", + "example_values": [ + "RnJvbTogUGhhbnRvbSBVc2VyIDxwaGFudG9t..." + ] + }, + { + "data_path": "action_result.data.*.t_MimeContent.@CharacterSet", + "data_type": "string", + "example_values": [ + "UTF-8" + ] + }, + { + "data_path": "action_result.data.*.t_ResponseObjects.t_ForwardItem", + "data_type": "string" + }, + { + "data_path": "action_result.data.*.t_ResponseObjects.t_ReplyAllToItem", + "data_type": "string" + }, + { + "data_path": "action_result.data.*.t_ResponseObjects.t_ReplyToItem", + "data_type": "string" + }, + { + "data_path": "action_result.data.*.t_Sender.t_Mailbox.t_EmailAddress", + "data_type": "string", + "example_values": [ + "test@sample.com" + ], + "contains": [ + "email" + ] + }, + { + "data_path": "action_result.data.*.t_Sender.t_Mailbox.t_MailboxType", + "data_type": "string", + "example_values": [ + "OneOff" + ] + }, + { + "data_path": "action_result.data.*.t_Sender.t_Mailbox.t_Name", + "data_type": "string", + "example_values": [ + "test" + ] + }, + { + "data_path": "action_result.data.*.t_Sender.t_Mailbox.t_RoutingType", + "data_type": "string", + "example_values": [ + "SMTP" + ] + }, + { + "data_path": "action_result.data.*.t_Sensitivity", + "data_type": "string", + "example_values": [ + "Normal" + ] + }, + { + "data_path": "action_result.data.*.t_Size", + "data_type": "string", + "example_values": [ + "56353" + ] + }, + { + "data_path": "action_result.data.*.t_Subject", + "data_type": "string", + "example_values": [ + "Both value are modified" + ], + "column_name": "Subject", + "column_order": 0 + }, + { + "data_path": "action_result.data.*.t_ToRecipients.t_Mailbox.*.t_EmailAddress", + "data_type": "string", + "example_values": [ + "test@sample.com" + ], + "contains": [ + "email" + ] + }, + { + "data_path": "action_result.data.*.t_ToRecipients.t_Mailbox.*.t_MailboxType", + "data_type": "string", + "example_values": [ + "Mailbox" + ] + }, + { + "data_path": "action_result.data.*.t_ToRecipients.t_Mailbox.*.t_Name", + "data_type": "string", + "example_values": [ + "Test User" + ] + }, + { + "data_path": "action_result.data.*.t_ToRecipients.t_Mailbox.*.t_RoutingType", + "data_type": "string", + "example_values": [ + "SMTP" + ] + }, + { + "data_path": "action_result.summary.create_time", + "data_type": "string", + "example_values": [ + "2017-10-05T20:19:58Z" + ] + }, + { + "data_path": "action_result.summary.sent_time", + "data_type": "string", + "example_values": [ + "2017-10-03T21:31:20Z" + ] + }, + { + "data_path": "action_result.summary.subject", + "data_type": "string", + "example_values": [ + "Both value are modified" + ] + }, + { + "data_path": "action_result.message", + "data_type": "string", + "example_values": [ + "Create time: 2017-10-05T20:19:58Z\nSubject: Both value are modified\nSent time: 2017-10-03T21:31:20Z" + ] + }, + { + "data_path": "summary.total_objects", + "data_type": "numeric", + "example_values": [ + 1 + ] + }, + { + "data_path": "summary.total_objects_successful", + "data_type": "numeric", + "example_values": [ + 1 + ] + } + ], + "versions": "EQ(*)" } ], "pip_dependencies": { diff --git a/office365_connector.py b/office365_connector.py index 45fc1fd..07063b3 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3263,6 +3263,31 @@ def _paginator(self, action_result, endpoint, limit=None, params=None, query=Non return phantom.APP_SUCCESS, list_items + def _handle_update_email(self, param): + self.save_progress("In action handler for: {}".format(self.get_action_identifier())) + action_result = self.add_action_result(ActionResult(dict(param))) + + email_addr = param["email_address"] + message_id = param["id"] + category = param["category"] + category = [x.strip() for x in category.split(',')] + endpoint = "/users/{0}".format(email_addr) + + endpoint += "/messages/{0}".format(message_id) + + data = {'categories': category} + + ret_val, _ = self._make_rest_call_helper( + action_result, endpoint, method="patch", data=json.dumps(data) + ) + + self.save_progress(str(ret_val)) + + if phantom.is_fail(ret_val): + return action_result.get_status() + + return action_result.set_status(phantom.APP_SUCCESS, "Successfully updated email") + def handle_action(self, param): ret_val = phantom.APP_SUCCESS @@ -3335,6 +3360,9 @@ def handle_action(self, param): elif action_id == 'send_email': ret_val = self._handle_send_email(param) + elif action_id == 'update_email': + ret_val = self._handle_update_email(param) + return ret_val def _get_token(self, action_result): From 7b4152d98d1195d568bb8dee243d486890cbc7ab Mon Sep 17 00:00:00 2001 From: kzuchowska Date: Fri, 6 Sep 2024 10:19:05 +0200 Subject: [PATCH 02/40] add action result --- office365.json | 393 ++++++++++------------------------------- office365_connector.py | 12 +- 2 files changed, 104 insertions(+), 301 deletions(-) diff --git a/office365.json b/office365.json index 69bae6d..f7fa554 100644 --- a/office365.json +++ b/office365.json @@ -7208,460 +7208,257 @@ "column_order": 1 }, { - "data_path": "action_result.parameter.subject", - "data_type": "string", - "example_values": [ - "Both value are modified" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_AttachmentId.@Id", - "data_type": "string" - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_ContentType", - "data_type": "string", - "example_value": "application/pdf" - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_IsContactPhoto", - "data_type": "string", - "example_value": "false" - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_IsInline", - "data_type": "string", - "example_value": "false" - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_LastModifiedTime", - "data_type": "string", - "example_value": "2010-07-30T10:52:32" - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_Name", - "data_type": "string" - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.*.t_Size", - "data_type": "string", - "example_value": "23433" - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_AttachmentId.@Id", - "data_type": "string", - "example_values": [ - "AAMkAGIyMTUxYTkzLWRjYjctNDFjMi04NTAxLTQzMDFkNDhlZmI5MQBGAAAAAACxQSnX8n2GS4cunBIQ2sV7BwCQhMsoV7EYSJF42ChR9SCxAAAAYCbsAACQhMsoV7EYSJF42ChR9SCxAAAAjh8bAAABEgAQAHAXDtZM8ItNnDTtvcd6IAo=" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_ContentId", + "data_path": "action_result.data.*.@odata.context", "data_type": "string", "example_values": [ - "7518226202D21C4397EE1CB1E2E540C7@sample.com" + "https://test.abc.com/v1.0/$metadata#users('user%40.abc.com')/messages(internetMessageHeaders,body,uniqueBody,sender,subject)/$entity" ], "contains": [ - "email" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_ContentType", - "data_type": "string", - "example_values": [ - "application/octet-stream" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_IsContactPhoto", - "data_type": "string", - "example_values": [ - "false" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_IsInline", - "data_type": "string", - "example_values": [ - "false" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_LastModifiedTime", - "data_type": "string", - "example_values": [ - "2017-10-03T21:31:05" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_Name", - "data_type": "string", - "example_values": [ - "test.msg" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_FileAttachment.t_Size", - "data_type": "string", - "example_values": [ - "55360" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_AttachmentId.@Id", - "data_type": "string", - "example_values": [ - "AAMkAGFmNTRhODA4LWIxMjQtNDJjYy05NDM2LWQ5MzY1MGFhMTkzYwBGAAAAAADRlY7ewL4xToKRDciQog5UBwBvUzMoUJx2S4nbgxzZWx2PAAEHZktbAABvUzMoUJx2S4nbgxzZWx2PAAEnqxyTAAABEgAQAN3G1cBjf8hIhr55ziP1DBI=" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_ContentId", - "data_type": "string", - "example_values": [ - "9C14EE4B699D7349B0403C3CDF3F8729@namprd17.prod.outlook.com" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_ContentType", - "data_type": "string", - "example_values": [ - "message/rfc822" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_IsInline", - "data_type": "string", - "example_values": [ - "false" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_LastModifiedTime", - "data_type": "string", - "example_values": [ - "2019-11-08T11:46:32" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_Name", - "data_type": "string", - "example_values": [ - "Test user added you to the test-h1 group" - ] - }, - { - "data_path": "action_result.data.*.t_Attachments.t_ItemAttachment.t_Size", - "data_type": "string", - "example_values": [ - "69852" + "url" ] }, { - "data_path": "action_result.data.*.t_Body.#text", + "data_path": "action_result.data.*.@odata.etag", "data_type": "string", "example_values": [ - "Attached .msg file. Hello" + "W/\"CQAAABYAAABBKXVvwEWISZupmqX4mJS3AAO8DBJl\"" ] }, { - "data_path": "action_result.data.*.t_Body.@BodyType", + "data_path": "action_result.data.*.body.content", "data_type": "string", "example_values": [ - "Text" + "`Have a good time with these.\\r\\n`" ] }, { - "data_path": "action_result.data.*.t_Categories", + "data_path": "action_result.data.*.body.contentType", "data_type": "string", "example_values": [ - "red" + "html" ] }, { - "data_path": "action_result.data.*.t_CcRecipients.t_Mailbox.t_EmailAddress", - "data_type": "string", - "example_value": "abc@xyz.com" - }, - { - "data_path": "action_result.data.*.t_CcRecipients.t_Mailbox.t_MailboxType", - "data_type": "string", - "example_value": "OneOff" - }, - { - "data_path": "action_result.data.*.t_CcRecipients.t_Mailbox.t_Name", - "data_type": "string", - "example_value": "abc@xyz.com" - }, - { - "data_path": "action_result.data.*.t_CcRecipients.t_Mailbox.t_RoutingType", - "data_type": "string", - "example_value": "SMTP" - }, - { - "data_path": "action_result.data.*.t_DateTimeCreated", + "data_path": "action_result.data.*.bodyPreview", "data_type": "string", "example_values": [ - "2017-10-05T20:19:58Z" - ] + "Have a good time with these." + ], + "column_name": "Body Preview", + "column_order": 2 }, { - "data_path": "action_result.data.*.t_DateTimeReceived", + "data_path": "action_result.data.*.changeKey", "data_type": "string", "example_values": [ - "2017-10-03T21:31:05Z" + "CQAAABYAAADTteE6Q2eCQKSqg19j6T+NAAYzSv5R" ] }, { - "data_path": "action_result.data.*.t_DateTimeSent", + "data_path": "action_result.data.*.conversationId", "data_type": "string", "example_values": [ - "2017-10-03T21:31:20Z" + "AAQkAGYxNGJmOWQyLTlhMjctNGRiOS1iODU0LTA1ZWE3ZmQ3NDU3MQAQAORC3aOpHnZMsHD4-7L40sY=" ] }, { - "data_path": "action_result.data.*.t_ExtendedProperty.t_ExtendedFieldURI.@PropertyTag", + "data_path": "action_result.data.*.conversationIndex", "data_type": "string", "example_values": [ - "0x7d" + "AQHZopYz5ELdo6kedkywcPj/svjSxg==" ] }, { - "data_path": "action_result.data.*.t_ExtendedProperty.t_ExtendedFieldURI.@PropertyType", + "data_path": "action_result.data.*.createdDateTime", "data_type": "string", "example_values": [ - "String" + "2023-06-19T10:09:58Z" ] }, { - "data_path": "action_result.data.*.t_ExtendedProperty.t_Value", + "data_path": "action_result.data.*.flag.flagStatus", "data_type": "string", "example_values": [ - "MWHPR18MB1519.namprd18.prod.outlook.com" + "notFlagged" ] }, { - "data_path": "action_result.data.*.t_From.t_Mailbox.t_EmailAddress", + "data_path": "action_result.data.*.from.emailAddress.address", "data_type": "string", "example_values": [ - "test@sample.com" + "test@test.com" ], "contains": [ "email" ] }, { - "data_path": "action_result.data.*.t_From.t_Mailbox.t_MailboxType", - "data_type": "string", - "example_values": [ - "OneOff" - ] - }, - { - "data_path": "action_result.data.*.t_From.t_Mailbox.t_Name", + "data_path": "action_result.data.*.from.emailAddress.name", "data_type": "string", "example_values": [ - "Test" + "Ryan Edwards" ] }, { - "data_path": "action_result.data.*.t_From.t_Mailbox.t_RoutingType", - "data_type": "string", + "data_path": "action_result.data.*.hasAttachments", + "data_type": "boolean", "example_values": [ - "SMTP" - ] + true, + false + ], + "column_name": "Has Attachments", + "column_order": 3 }, { - "data_path": "action_result.data.*.t_HasAttachments", + "data_path": "action_result.data.*.id", "data_type": "string", "example_values": [ - "true" - ] + "AQMkADU3NDk3MzJlLTY3MDQtNDE2Ny1iZDk1LTc4YjEwYzhmZDc5YQBGAAADyW3X5P7Hb0_MMHKonvdoWQcAQSl1b8BFiEmbqZql_JiUtwAAAgEMAAAAQSl1b8BFiEmbqZql_JiUtwADu9Tv8QAAAA==" + ], + "contains": [ + "msgoffice365 message id" + ], + "column_name": "Message ID", + "column_order": 0 }, { - "data_path": "action_result.data.*.t_InternetMessageId", + "data_path": "action_result.data.*.importance", "data_type": "string", "example_values": [ - "<81c761fe-caa8-f924-f65d-079382c1ad0b@sample.com>" + "normal" ] }, { - "data_path": "action_result.data.*.t_IsAssociated", + "data_path": "action_result.data.*.inferenceClassification", "data_type": "string", "example_values": [ - "false" + "focused" ] }, { - "data_path": "action_result.data.*.t_IsDeliveryReceiptRequested", + "data_path": "action_result.data.*.internetMessageId", "data_type": "string", "example_values": [ - "false" + "" + ], + "contains": [ + "msgoffice365 internet message id" ] }, { - "data_path": "action_result.data.*.t_IsRead", - "data_type": "string", + "data_path": "action_result.data.*.isDeliveryReceiptRequested", + "data_type": "boolean", "example_values": [ - "true" + true, + false ] }, { - "data_path": "action_result.data.*.t_IsReadReceiptRequested", - "data_type": "string", + "data_path": "action_result.data.*.isDraft", + "data_type": "boolean", "example_values": [ - "false" + true, + false ] }, { - "data_path": "action_result.data.*.t_ItemId.@ChangeKey", - "data_type": "string", + "data_path": "action_result.data.*.isRead", + "data_type": "boolean", "example_values": [ - "CQAAABYAAACQhMsoV7EYSJF42ChR9SCxAAAAj9UU" + true, + false ] }, { - "data_path": "action_result.data.*.t_ItemId.@Id", - "data_type": "string", + "data_path": "action_result.data.*.isReadReceiptRequested", + "data_type": "boolean", "example_values": [ - "AAMkAGIyMTUxYTkzLWRjYjctNDFjMi04NTAxLTQzMDFkNDhlZmI5MQBGAAAAAACxQSnX8n2GS4cunBIQ2sV7BwCQhMsoV7EYSJF42ChR9SCxAAAAYCbsAACQhMsoV7EYSJF42ChR9SCxAAAAjh8bAAA=" + true, + false ] }, { - "data_path": "action_result.data.*.t_LastModifiedTime", + "data_path": "action_result.data.*.lastModifiedDateTime", "data_type": "string", "example_values": [ - "2017-10-31T01:09:20Z" + "2023-06-19T10:09:58Z" ] }, { - "data_path": "action_result.data.*.t_MimeContent.#text", + "data_path": "action_result.data.*.parentFolderId", "data_type": "string", "example_values": [ - "RnJvbTogUGhhbnRvbSBVc2VyIDxwaGFudG9t..." + "AQMkAGYxNGJmOWQyLTlhMjctNGRiOS1iODU0LTA1ZWE3ZmQ3NDU3MQAuAAADeDDJKaEf4EihMWU6SZgKbAEA07XhOkNngkCkqoNfY_k-jQAAAgEPAAAA" + ], + "contains": [ + "msgoffice365 folder id" ] }, { - "data_path": "action_result.data.*.t_MimeContent.@CharacterSet", + "data_path": "action_result.data.*.receivedDateTime", "data_type": "string", "example_values": [ - "UTF-8" + "2020-06-18T09:11:31Z" ] }, { - "data_path": "action_result.data.*.t_ResponseObjects.t_ForwardItem", - "data_type": "string" - }, - { - "data_path": "action_result.data.*.t_ResponseObjects.t_ReplyAllToItem", - "data_type": "string" - }, - { - "data_path": "action_result.data.*.t_ResponseObjects.t_ReplyToItem", - "data_type": "string" - }, - { - "data_path": "action_result.data.*.t_Sender.t_Mailbox.t_EmailAddress", + "data_path": "action_result.data.*.sender.emailAddress.address", "data_type": "string", "example_values": [ - "test@sample.com" + "notifications@testdomain.com" ], "contains": [ "email" ] }, { - "data_path": "action_result.data.*.t_Sender.t_Mailbox.t_MailboxType", - "data_type": "string", - "example_values": [ - "OneOff" - ] - }, - { - "data_path": "action_result.data.*.t_Sender.t_Mailbox.t_Name", - "data_type": "string", - "example_values": [ - "test" - ] - }, - { - "data_path": "action_result.data.*.t_Sender.t_Mailbox.t_RoutingType", - "data_type": "string", - "example_values": [ - "SMTP" - ] - }, - { - "data_path": "action_result.data.*.t_Sensitivity", + "data_path": "action_result.data.*.sender.emailAddress.name", "data_type": "string", "example_values": [ - "Normal" + "notifications@testdomain.com" + ], + "contains": [ + "email" ] }, { - "data_path": "action_result.data.*.t_Size", + "data_path": "action_result.data.*.sentDateTime", "data_type": "string", "example_values": [ - "56353" + "2023-06-19T10:09:58Z" ] }, { - "data_path": "action_result.data.*.t_Subject", + "data_path": "action_result.data.*.subject", "data_type": "string", "example_values": [ - "Both value are modified" + "test html" ], "column_name": "Subject", - "column_order": 0 + "column_order": 1 }, { - "data_path": "action_result.data.*.t_ToRecipients.t_Mailbox.*.t_EmailAddress", + "data_path": "action_result.data.*.toRecipients.*.emailAddress.address", "data_type": "string", "example_values": [ - "test@sample.com" + "test@test.com" ], "contains": [ "email" ] }, { - "data_path": "action_result.data.*.t_ToRecipients.t_Mailbox.*.t_MailboxType", - "data_type": "string", - "example_values": [ - "Mailbox" - ] - }, - { - "data_path": "action_result.data.*.t_ToRecipients.t_Mailbox.*.t_Name", - "data_type": "string", - "example_values": [ - "Test User" - ] - }, - { - "data_path": "action_result.data.*.t_ToRecipients.t_Mailbox.*.t_RoutingType", - "data_type": "string", - "example_values": [ - "SMTP" - ] - }, - { - "data_path": "action_result.summary.create_time", - "data_type": "string", - "example_values": [ - "2017-10-05T20:19:58Z" - ] - }, - { - "data_path": "action_result.summary.sent_time", + "data_path": "action_result.data.*.toRecipients.*.emailAddress.name", "data_type": "string", "example_values": [ - "2017-10-03T21:31:20Z" + "Ryan Edwards" ] }, { - "data_path": "action_result.summary.subject", + "data_path": "action_result.data.*.webLink", "data_type": "string", "example_values": [ - "Both value are modified" + "https://outlook.office365.com/owa/?ItemID=AAkALgAAAAAAHYQDEapmEc2byACqAC%2FEWg0A07XhOkNngkCkqoNfY%2Bk%2FjQAGNNQOowAA&exvsurl=1&viewmodel=ReadMessageItem" ] }, { diff --git a/office365_connector.py b/office365_connector.py index 07063b3..88eb668 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3277,15 +3277,21 @@ def _handle_update_email(self, param): data = {'categories': category} + self.save_progress("Updating email") ret_val, _ = self._make_rest_call_helper( action_result, endpoint, method="patch", data=json.dumps(data) ) - - self.save_progress(str(ret_val)) - if phantom.is_fail(ret_val): return action_result.get_status() + self.save_progress("Getting sent email details with id: {}".format(message_id)) + ret_val, message_details = self._get_message(action_result, email_addr, message_id) + if phantom.is_fail(ret_val): + return action_result + self.save_progress("Got sent email details.") + + action_result.add_data(message_details) + return action_result.set_status(phantom.APP_SUCCESS, "Successfully updated email") def handle_action(self, param): From e9267b9cf63102737ccf8ab8043ef5521cacc7fe Mon Sep 17 00:00:00 2001 From: kzuchowska Date: Fri, 6 Sep 2024 10:51:43 +0200 Subject: [PATCH 03/40] add changing subject --- office365.json | 25 +++++++++++++++++++------ office365_connector.py | 24 +++++++++++++++++++----- 2 files changed, 38 insertions(+), 11 deletions(-) diff --git a/office365.json b/office365.json index f7fa554..81f2978 100644 --- a/office365.json +++ b/office365.json @@ -7152,17 +7152,21 @@ "email_address": { "description": "Email address of the mailbox owner", "data_type": "string", - "required": true, "primary": true, "contains": [ "email" ], "order": 1 }, + "subject": { + "description": "Subject to set", + "data_type": "string", + "order": 2 + }, "category": { "description": "Categories to set", "data_type": "string", - "order": 2, + "order": 3, "allow_list": true } }, @@ -7186,7 +7190,7 @@ ] }, { - "data_path": "action_result.parameter.email", + "data_path": "action_result.parameter.email_address", "data_type": "string", "example_values": [ "test@sample.com" @@ -7203,9 +7207,14 @@ ], "contains": [ "msgoffice365 message id" - ], - "column_name": "Message ID", - "column_order": 1 + ] + }, + { + "data_path": "action_result.parameter.subject", + "data_type": "string", + "example_values": [ + "Both value are modified" + ] }, { "data_path": "action_result.data.*.@odata.context", @@ -7461,6 +7470,10 @@ "https://outlook.office365.com/owa/?ItemID=AAkALgAAAAAAHYQDEapmEc2byACqAC%2FEWg0A07XhOkNngkCkqoNfY%2Bk%2FjQAGNNQOowAA&exvsurl=1&viewmodel=ReadMessageItem" ] }, + { + "data_path": "action_result.summary", + "data_type": "string" + }, { "data_path": "action_result.message", "data_type": "string", diff --git a/office365_connector.py b/office365_connector.py index 88eb668..0a333ae 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3267,15 +3267,29 @@ def _handle_update_email(self, param): self.save_progress("In action handler for: {}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) - email_addr = param["email_address"] + email_addr = param.get("email_address") message_id = param["id"] - category = param["category"] - category = [x.strip() for x in category.split(',')] - endpoint = "/users/{0}".format(email_addr) + + if email_addr: + endpoint = "/users/{0}".format(email_addr) + else: + endpoint = "/me" endpoint += "/messages/{0}".format(message_id) - data = {'categories': category} + category = param.get('category') + subject = param.get('subject') + + if subject is None and category is None: + return action_result.set_status(phantom.APP_ERROR, "Please specify one of the email properties to update") + + data = {} + if category is not None: + category = [x.strip() for x in category.split(',')] + data['categories'] = category + + if subject is not None: + data['subject'] = subject self.save_progress("Updating email") ret_val, _ = self._make_rest_call_helper( From 1db4feeb291440145c34e4677b36e6a6f079e349 Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Fri, 6 Sep 2024 08:52:29 +0000 Subject: [PATCH 04/40] Update README.md --- README.md | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 64 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index cd1ecbc..f9553c3 100644 --- a/README.md +++ b/README.md @@ -350,6 +350,7 @@ VARIABLE | REQUIRED | TYPE | DESCRIPTION [get folder id](#action-get-folder-id) - Get the API ID of the folder [send email](#action-send-email) - Sends an email with optional text rendering. Attachments are allowed a Content-ID tag for reference within the html [on poll](#action-on-poll) - Ingest emails from Office 365 using Graph API +[update email](#action-update-email) - Update an email on the server ## action: 'test connectivity' Use supplied credentials to generate a token with MS Graph @@ -1523,4 +1524,66 @@ PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS **artifact_count** | optional | Parameter Ignored in this app | numeric | #### Action Output -No Output \ No newline at end of file +No Output + +## action: 'update email' +Update an email on the server + +Type: **generic** +Read only: **False** + +Currently, this action only updates the category and subject of an email. To set multiple categories, please pass a comma-separated list to the category parameter.
NOTE: If the user tries to update the categories, then the existing categories of the email will be replaced with the new categories provided as input. + +#### Action Parameters +PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS +--------- | -------- | ----------- | ---- | -------- +**id** | required | Message ID to delete | string | `msgoffice365 message id` +**email_address** | optional | Email address of the mailbox owner | string | `email` +**subject** | optional | Subject to set | string | +**category** | optional | Categories to set | string | + +#### Action Output +DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES +--------- | ---- | -------- | -------------- +action_result.status | string | | success failed +action_result.parameter.category | string | | Yellow, Blue, Purple, red +action_result.parameter.email_address | string | `email` | test@sample.com +action_result.parameter.id | string | `msgoffice365 message id` | AAMkAGIyMTUxYTkzLWRjYjctNDFjMi04NTAxLTQzMDFkNDhlZmI5MQBGAAAAAACxQSnX8n2GS4cunBIQ2sV7BwCQhMsoV7EYSJF42ChR9SCxAAAAYCbsAACQhMsoV7EYSJF42ChR9SCxAAAAjh8bAAA= +action_result.parameter.subject | string | | Both value are modified +action_result.data.\*.@odata.context | string | `url` | https://test.abc.com/v1.0/$metadata#users('user%40.abc.com')/messages(internetMessageHeaders,body,uniqueBody,sender,subject)/$entity +action_result.data.\*.@odata.etag | string | | W/"CQAAABYAAABBKXVvwEWISZupmqX4mJS3AAO8DBJl" +action_result.data.\*.body.content | string | | `Have a good time with these.\\r\\n` +action_result.data.\*.body.contentType | string | | html +action_result.data.\*.bodyPreview | string | | Have a good time with these. +action_result.data.\*.changeKey | string | | CQAAABYAAADTteE6Q2eCQKSqg19j6T+NAAYzSv5R +action_result.data.\*.conversationId | string | | AAQkAGYxNGJmOWQyLTlhMjctNGRiOS1iODU0LTA1ZWE3ZmQ3NDU3MQAQAORC3aOpHnZMsHD4-7L40sY= +action_result.data.\*.conversationIndex | string | | AQHZopYz5ELdo6kedkywcPj/svjSxg== +action_result.data.\*.createdDateTime | string | | 2023-06-19T10:09:58Z +action_result.data.\*.flag.flagStatus | string | | notFlagged +action_result.data.\*.from.emailAddress.address | string | `email` | test@test.com +action_result.data.\*.from.emailAddress.name | string | | Ryan Edwards +action_result.data.\*.hasAttachments | boolean | | True False +action_result.data.\*.id | string | `msgoffice365 message id` | AQMkADU3NDk3MzJlLTY3MDQtNDE2Ny1iZDk1LTc4YjEwYzhmZDc5YQBGAAADyW3X5P7Hb0_MMHKonvdoWQcAQSl1b8BFiEmbqZql_JiUtwAAAgEMAAAAQSl1b8BFiEmbqZql_JiUtwADu9Tv8QAAAA== +action_result.data.\*.importance | string | | normal +action_result.data.\*.inferenceClassification | string | | focused +action_result.data.\*.internetMessageId | string | `msgoffice365 internet message id` | +action_result.data.\*.isDeliveryReceiptRequested | boolean | | True False +action_result.data.\*.isDraft | boolean | | True False +action_result.data.\*.isRead | boolean | | True False +action_result.data.\*.isReadReceiptRequested | boolean | | True False +action_result.data.\*.lastModifiedDateTime | string | | 2023-06-19T10:09:58Z +action_result.data.\*.parentFolderId | string | `msgoffice365 folder id` | AQMkAGYxNGJmOWQyLTlhMjctNGRiOS1iODU0LTA1ZWE3ZmQ3NDU3MQAuAAADeDDJKaEf4EihMWU6SZgKbAEA07XhOkNngkCkqoNfY_k-jQAAAgEPAAAA +action_result.data.\*.receivedDateTime | string | | 2020-06-18T09:11:31Z +action_result.data.\*.sender.emailAddress.address | string | `email` | notifications@testdomain.com +action_result.data.\*.sender.emailAddress.name | string | `email` | notifications@testdomain.com +action_result.data.\*.sentDateTime | string | | 2023-06-19T10:09:58Z +action_result.data.\*.subject | string | | test html +action_result.data.\*.toRecipients.\*.emailAddress.address | string | `email` | test@test.com +action_result.data.\*.toRecipients.\*.emailAddress.name | string | | Ryan Edwards +action_result.data.\*.webLink | string | | https://outlook.office365.com/owa/?ItemID=AAkALgAAAAAAHYQDEapmEc2byACqAC%2FEWg0A07XhOkNngkCkqoNfY%2Bk%2FjQAGNNQOowAA&exvsurl=1&viewmodel=ReadMessageItem +action_result.summary | string | | +action_result.message | string | | Create time: 2017-10-05T20:19:58Z +Subject: Both value are modified +Sent time: 2017-10-03T21:31:20Z +summary.total_objects | numeric | | 1 +summary.total_objects_successful | numeric | | 1 \ No newline at end of file From 07fb4509eb0f8f0e01eea074897b979a0e58d512 Mon Sep 17 00:00:00 2001 From: kzuchowska Date: Fri, 6 Sep 2024 10:54:41 +0200 Subject: [PATCH 05/40] min phantom version 6.1.1 -> 6.2.1 --- office365.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/office365.json b/office365.json index 81f2978..4d28903 100644 --- a/office365.json +++ b/office365.json @@ -37,7 +37,7 @@ "utctime_updated": "2023-10-12T11:20:32.000000Z", "package_name": "phantom_msgraphoffice365", "main_module": "office365_connector.py", - "min_phantom_version": "6.1.1", + "min_phantom_version": "6.2.1", "latest_tested_versions": [ "Cloud 9 January, 2024" ], From 3cb3fe50fc9c3c766cff81eb5bbbefcbaa5c6a21 Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Fri, 6 Sep 2024 08:58:13 +0000 Subject: [PATCH 06/40] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index f9553c3..cfdf4da 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Connector Version: 3.0.0 Product Vendor: Microsoft Product Name: Office 365 (MS Graph) Product Version Supported (regex): ".\*" -Minimum Product Version: 6.1.1 +Minimum Product Version: 6.2.1 This app connects to Office 365 using the MS Graph API to support investigate and generic actions related to the email messages and calendar events From f4fc621cbd7fd8068c2084220b6cd85980992b79 Mon Sep 17 00:00:00 2001 From: kzuchowska Date: Mon, 9 Sep 2024 09:46:15 +0200 Subject: [PATCH 07/40] make email parameter required --- office365.json | 1 + office365_connector.py | 8 ++------ 2 files changed, 3 insertions(+), 6 deletions(-) diff --git a/office365.json b/office365.json index 4d28903..9136e3a 100644 --- a/office365.json +++ b/office365.json @@ -7152,6 +7152,7 @@ "email_address": { "description": "Email address of the mailbox owner", "data_type": "string", + "required": true, "primary": true, "contains": [ "email" diff --git a/office365_connector.py b/office365_connector.py index 0a333ae..0f7db53 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3267,14 +3267,10 @@ def _handle_update_email(self, param): self.save_progress("In action handler for: {}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) - email_addr = param.get("email_address") + email_addr = param["email_address"] message_id = param["id"] - if email_addr: - endpoint = "/users/{0}".format(email_addr) - else: - endpoint = "/me" - + endpoint = "/users/{0}".format(email_addr) endpoint += "/messages/{0}".format(message_id) category = param.get('category') From c4defa0811154057b12dcecc3b8a501dfb67762d Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Mon, 9 Sep 2024 07:48:28 +0000 Subject: [PATCH 08/40] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index cfdf4da..10e03de 100644 --- a/README.md +++ b/README.md @@ -1538,7 +1538,7 @@ Currently, this action only updates the category and subject of an email. To set PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS --------- | -------- | ----------- | ---- | -------- **id** | required | Message ID to delete | string | `msgoffice365 message id` -**email_address** | optional | Email address of the mailbox owner | string | `email` +**email_address** | required | Email address of the mailbox owner | string | `email` **subject** | optional | Subject to set | string | **category** | optional | Categories to set | string | From c34a945bd167623dfb3f98421ed06cc05ed9c5c4 Mon Sep 17 00:00:00 2001 From: kzuchowska Date: Mon, 9 Sep 2024 15:11:48 +0200 Subject: [PATCH 09/40] data -> data_to_send --- office365_connector.py | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/office365_connector.py b/office365_connector.py index 0f7db53..f8d552d 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3264,14 +3264,13 @@ def _paginator(self, action_result, endpoint, limit=None, params=None, query=Non return phantom.APP_SUCCESS, list_items def _handle_update_email(self, param): - self.save_progress("In action handler for: {}".format(self.get_action_identifier())) + self.save_progress(f"In action handler for: {self.get_action_identifier()}") action_result = self.add_action_result(ActionResult(dict(param))) email_addr = param["email_address"] message_id = param["id"] - endpoint = "/users/{0}".format(email_addr) - endpoint += "/messages/{0}".format(message_id) + endpoint = f"/users/{email_addr}/messages/{message_id}" category = param.get('category') subject = param.get('subject') @@ -3279,17 +3278,17 @@ def _handle_update_email(self, param): if subject is None and category is None: return action_result.set_status(phantom.APP_ERROR, "Please specify one of the email properties to update") - data = {} + data_to_send = {} if category is not None: category = [x.strip() for x in category.split(',')] - data['categories'] = category + data_to_send['categories'] = category if subject is not None: - data['subject'] = subject + data_to_send['subject'] = subject self.save_progress("Updating email") ret_val, _ = self._make_rest_call_helper( - action_result, endpoint, method="patch", data=json.dumps(data) + action_result, endpoint, method="patch", data=json.dumps(data_to_send) ) if phantom.is_fail(ret_val): return action_result.get_status() From 5c6c68d9b2e91764f6ac4532d15d6ed2e5854d71 Mon Sep 17 00:00:00 2001 From: kzuchowska Date: Mon, 9 Sep 2024 15:13:57 +0200 Subject: [PATCH 10/40] category->categories --- office365.json | 4 ++-- office365_connector.py | 12 ++++++------ 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/office365.json b/office365.json index 9136e3a..e2a814f 100644 --- a/office365.json +++ b/office365.json @@ -7164,7 +7164,7 @@ "data_type": "string", "order": 2 }, - "category": { + "categories": { "description": "Categories to set", "data_type": "string", "order": 3, @@ -7184,7 +7184,7 @@ ] }, { - "data_path": "action_result.parameter.category", + "data_path": "action_result.parameter.categories", "data_type": "string", "example_values": [ "Yellow, Blue, Purple, red" diff --git a/office365_connector.py b/office365_connector.py index f8d552d..4628480 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3272,16 +3272,16 @@ def _handle_update_email(self, param): endpoint = f"/users/{email_addr}/messages/{message_id}" - category = param.get('category') + categories = param.get('categories') subject = param.get('subject') - if subject is None and category is None: + if subject is None and categories is None: return action_result.set_status(phantom.APP_ERROR, "Please specify one of the email properties to update") data_to_send = {} - if category is not None: - category = [x.strip() for x in category.split(',')] - data_to_send['categories'] = category + if categories is not None: + categories = [x.strip() for x in categories.split(',')] + data_to_send['categories'] = categories if subject is not None: data_to_send['subject'] = subject @@ -3293,7 +3293,7 @@ def _handle_update_email(self, param): if phantom.is_fail(ret_val): return action_result.get_status() - self.save_progress("Getting sent email details with id: {}".format(message_id)) + self.save_progress(f"Getting sent email details with id: {message_id}") ret_val, message_details = self._get_message(action_result, email_addr, message_id) if phantom.is_fail(ret_val): return action_result From eafcdb3de8a0c268e95c87459abe76bd92035ec8 Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Mon, 9 Sep 2024 13:16:57 +0000 Subject: [PATCH 11/40] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 10e03de..822e6e9 100644 --- a/README.md +++ b/README.md @@ -1540,13 +1540,13 @@ PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS **id** | required | Message ID to delete | string | `msgoffice365 message id` **email_address** | required | Email address of the mailbox owner | string | `email` **subject** | optional | Subject to set | string | -**category** | optional | Categories to set | string | +**categories** | optional | Categories to set | string | #### Action Output DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES --------- | ---- | -------- | -------------- action_result.status | string | | success failed -action_result.parameter.category | string | | Yellow, Blue, Purple, red +action_result.parameter.categories | string | | Yellow, Blue, Purple, red action_result.parameter.email_address | string | `email` | test@sample.com action_result.parameter.id | string | `msgoffice365 message id` | AAMkAGIyMTUxYTkzLWRjYjctNDFjMi04NTAxLTQzMDFkNDhlZmI5MQBGAAAAAACxQSnX8n2GS4cunBIQ2sV7BwCQhMsoV7EYSJF42ChR9SCxAAAAYCbsAACQhMsoV7EYSJF42ChR9SCxAAAAjh8bAAA= action_result.parameter.subject | string | | Both value are modified From 096b934353c92fef2aa6d06671b3b524ab3ce93d Mon Sep 17 00:00:00 2001 From: kzuchowska Date: Tue, 10 Sep 2024 11:42:01 +0200 Subject: [PATCH 12/40] category -> categories in verbose --- office365.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/office365.json b/office365.json index e2a814f..9bde070 100644 --- a/office365.json +++ b/office365.json @@ -7134,7 +7134,7 @@ { "action": "update email", "description": "Update an email on the server", - "verbose": "Currently, this action only updates the category and subject of an email. To set multiple categories, please pass a comma-separated list to the category parameter.
NOTE: If the user tries to update the categories, then the existing categories of the email will be replaced with the new categories provided as input.", + "verbose": "Currently, this action only updates the categories and subject of an email. To set multiple categories, please pass a comma-separated list to the category parameter.
NOTE: If the user tries to update the categories, then the existing categories of the email will be replaced with the new categories provided as input.", "type": "generic", "identifier": "update_email", "read_only": false, From fa23cb968f65b32c4dcc8e2f75af52be23f48382 Mon Sep 17 00:00:00 2001 From: kzuchowska Date: Tue, 10 Sep 2024 11:43:34 +0200 Subject: [PATCH 13/40] add release notes --- release_notes/unreleased.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/release_notes/unreleased.md b/release_notes/unreleased.md index fbcb2fd..d012b52 100644 --- a/release_notes/unreleased.md +++ b/release_notes/unreleased.md @@ -1 +1,3 @@ **Unreleased** + +* added the 'update email' action [PAPP-34617] \ No newline at end of file From 8fc68e28aed740dc581965926b933615389b6b27 Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Tue, 10 Sep 2024 09:44:36 +0000 Subject: [PATCH 14/40] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 822e6e9..5f938d3 100644 --- a/README.md +++ b/README.md @@ -1532,7 +1532,7 @@ Update an email on the server Type: **generic** Read only: **False** -Currently, this action only updates the category and subject of an email. To set multiple categories, please pass a comma-separated list to the category parameter.
NOTE: If the user tries to update the categories, then the existing categories of the email will be replaced with the new categories provided as input. +Currently, this action only updates the categories and subject of an email. To set multiple categories, please pass a comma-separated list to the category parameter.
NOTE: If the user tries to update the categories, then the existing categories of the email will be replaced with the new categories provided as input. #### Action Parameters PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS From 275aa18278565130dd39a0f69ff088c743529618 Mon Sep 17 00:00:00 2001 From: kzuchowska Date: Tue, 10 Sep 2024 12:46:29 +0200 Subject: [PATCH 15/40] delete casting param to dict --- office365_connector.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/office365_connector.py b/office365_connector.py index 4628480..e952216 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3265,7 +3265,7 @@ def _paginator(self, action_result, endpoint, limit=None, params=None, query=Non def _handle_update_email(self, param): self.save_progress(f"In action handler for: {self.get_action_identifier()}") - action_result = self.add_action_result(ActionResult(dict(param))) + action_result = self.add_action_result(ActionResult(param)) email_addr = param["email_address"] message_id = param["id"] From 6002d2feae769342f8c9c900f0ed07ade090a1fa Mon Sep 17 00:00:00 2001 From: root Date: Wed, 11 Sep 2024 01:34:20 -0700 Subject: [PATCH 16/40] Bumped up the version of msgraphforoffice365 from 3.0.0 to 3.0.1 --- office365.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/office365.json b/office365.json index 9bde070..bb6fa07 100644 --- a/office365.json +++ b/office365.json @@ -33,8 +33,8 @@ } ], "license": "Copyright (c) 2017-2024 Splunk Inc.", - "app_version": "3.0.0", - "utctime_updated": "2023-10-12T11:20:32.000000Z", + "app_version": "3.0.1", + "utctime_updated": "2024-09-11T08:34:15.000000Z", "package_name": "phantom_msgraphoffice365", "main_module": "office365_connector.py", "min_phantom_version": "6.2.1", @@ -7532,4 +7532,4 @@ } ] } -} +} \ No newline at end of file From 3e5bb058e9d908805825c64e1f4ede7390a4639c Mon Sep 17 00:00:00 2001 From: root Date: Wed, 11 Sep 2024 01:34:56 -0700 Subject: [PATCH 17/40] Release notes for version 3.0.1 --- README.md | 2 +- release_notes/3.0.1.md | 1 + release_notes/unreleased.md | 2 -- 3 files changed, 2 insertions(+), 3 deletions(-) create mode 100644 release_notes/3.0.1.md diff --git a/README.md b/README.md index 5f938d3..0a63690 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ # MS Graph for Office 365 Publisher: Splunk -Connector Version: 3.0.0 +Connector Version: 3.0.1 Product Vendor: Microsoft Product Name: Office 365 (MS Graph) Product Version Supported (regex): ".\*" diff --git a/release_notes/3.0.1.md b/release_notes/3.0.1.md new file mode 100644 index 0000000..2daaf65 --- /dev/null +++ b/release_notes/3.0.1.md @@ -0,0 +1 @@ +* added the 'update email' action [PAPP-34617] \ No newline at end of file diff --git a/release_notes/unreleased.md b/release_notes/unreleased.md index d012b52..fbcb2fd 100644 --- a/release_notes/unreleased.md +++ b/release_notes/unreleased.md @@ -1,3 +1 @@ **Unreleased** - -* added the 'update email' action [PAPP-34617] \ No newline at end of file From 89e0b567df667aca2c16885bebf624b39eeec13c Mon Sep 17 00:00:00 2001 From: root Date: Wed, 11 Sep 2024 01:35:45 -0700 Subject: [PATCH 18/40] Release notes for version 3.0.1 From 841e60a64656cc1ff698a87124e0f9f8d7bb2d2c Mon Sep 17 00:00:00 2001 From: kczernik Date: Thu, 26 Sep 2024 11:43:10 +0200 Subject: [PATCH 19/40] PAPP-34619 | added block and unblock sender actions --- office365.json | 162 ++++++++++++++++++++++++++++++++++++++++- office365_connector.py | 60 ++++++++++++++- 2 files changed, 219 insertions(+), 3 deletions(-) diff --git a/office365.json b/office365.json index bb6fa07..7a9f4ff 100644 --- a/office365.json +++ b/office365.json @@ -7498,6 +7498,166 @@ } ], "versions": "EQ(*)" + }, + { + "action": "block sender", + "identifier": "block_sender", + "description": "Add the sender email into the block list", + "verbose": "", + "type": "contain", + "read_only": false, + "parameters": { + "message_id": { + "description": "Message ID to pick the sender of", + "data_type": "string", + "required": true, + "primary": true, + "contains": [], + "value_list": [], + "default": "", + "order": 0, + "name": "message_id" + }, + "user_id": { + "description": "User ID to base the action of", + "data_type": "string", + "required": true, + "primary": true, + "contains": [], + "value_list": [], + "default": "", + "order": 1, + "name": "user_id" + }, + "move_to_junk_folder": { + "description": "Should the email be moved to the junk folder", + "data_type": "boolean", + "required": false, + "primary": false, + "contains": [], + "default": "", + "order": 2, + "name": "move_to_junk_folder" + } + }, + "output": [ + { + "data_path": "action_result.parameter.id", + "data_type": "string", + "contains": [], + "column_name": "id", + "column_order": 0 + }, + { + "data_path": "action_result.parameter.move_to_junk_folder", + "data_type": "boolean", + "contains": [], + "column_name": "move_to_junk_folder", + "column_order": 1 + }, + { + "data_path": "action_result.status", + "data_type": "string", + "column_name": "status", + "column_order": 2 + }, + { + "data_path": "action_result.message", + "data_type": "string" + }, + { + "data_path": "summary.total_objects", + "data_type": "numeric" + }, + { + "data_path": "summary.total_objects_successful", + "data_type": "numeric" + } + ], + "render": { + "type": "table" + }, + "versions": "EQ(*)" + }, + { + "action": "unblock sender", + "identifier": "unblock_sender", + "description": "Remove the sender email from the block list", + "verbose": "", + "type": "contain", + "read_only": false, + "parameters": { + "message_id": { + "description": "Message ID to pick the sender of", + "data_type": "string", + "required": true, + "primary": true, + "contains": [], + "value_list": [], + "default": "", + "order": 0, + "name": "message_id" + }, + "user_id": { + "description": "User ID to base the action of", + "data_type": "string", + "required": true, + "primary": true, + "contains": [], + "value_list": [], + "default": "", + "order": 1, + "name": "user_id" + }, + "move_to_inbox": { + "description": "Should the email be moved to the inbox folder", + "data_type": "boolean", + "required": false, + "primary": false, + "contains": [], + "default": "", + "order": 2, + "name": "move_to_inbox" + } + }, + "output": [ + { + "data_path": "action_result.parameter.id", + "data_type": "string", + "contains": [], + "column_name": "id", + "column_order": 0 + }, + { + "data_path": "action_result.parameter.move_to_junk_folder", + "data_type": "boolean", + "contains": [], + "column_name": "move_to_inbox", + "column_order": 1 + }, + { + "data_path": "action_result.status", + "data_type": "string", + "column_name": "status", + "column_order": 2 + }, + { + "data_path": "action_result.message", + "data_type": "string" + }, + { + "data_path": "summary.total_objects", + "data_type": "numeric" + }, + { + "data_path": "summary.total_objects_successful", + "data_type": "numeric" + } + ], + "render": { + "type": "table" + }, + "versions": "EQ(*)" } ], "pip_dependencies": { @@ -7532,4 +7692,4 @@ } ] } -} \ No newline at end of file +} diff --git a/office365_connector.py b/office365_connector.py index e952216..67d4597 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -43,7 +43,7 @@ TC_FILE = "oauth_task.out" SERVER_TOKEN_URL = "https://login.microsoftonline.com/{0}/oauth2/v2.0/token" -MSGRAPH_API_URL = "https://graph.microsoft.com/v1.0" +MSGRAPH_API_URL = "https://graph.microsoft.com" MAX_END_OFFSET_VAL = 2147483646 @@ -792,12 +792,16 @@ def _make_rest_call_helper( method="get", nextLink=None, download=False, + beta=False, ): if nextLink: url = nextLink else: - url = "{0}{1}".format(MSGRAPH_API_URL, endpoint) + if not beta: + url = f"{MSGRAPH_API_URL}/v1.0{endpoint}" + else: + url = f"{MSGRAPH_API_URL}/beta{endpoint}" if headers is None: headers = {} @@ -3303,6 +3307,52 @@ def _handle_update_email(self, param): return action_result.set_status(phantom.APP_SUCCESS, "Successfully updated email") + def _handle_block_sender(self, param): + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) + action_result = self.add_action_result(ActionResult(dict(param))) + + message = param['message_id'] + user = param['user_id'] + move_to_junk_folder = param.get('move_to_junk_folder', False) + + endpoint = f'/users/{user}/messages/{message}/markAsJunk' + self.save_progress(f"endpoint {endpoint}") + + ret_val, response = self._make_rest_call_helper( + action_result, endpoint, data=json.dumps({"moveToJunk": move_to_junk_folder}), method='post', beta=True + ) + + self.save_progress(f"Response gathered by query: {response}") + + if phantom.is_fail(ret_val): + return action_result.set_status(phantom.APP_ERROR, f"Moving email with id: {message} to junk folder failed") + + action_result.add_data(response) + return action_result.set_status(phantom.APP_SUCCESS) + + def _handle_unblock_sender(self, param): + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) + action_result = self.add_action_result(ActionResult(dict(param))) + + message = param['message_id'] + user = param['user_id'] + move_to_inbox = param.get('move_to_inbox', False) + + endpoint = f'/users/{user}/messages/{message}/markAsNotJunk' + self.save_progress(f"endpoint {endpoint}") + + ret_val, response = self._make_rest_call_helper( + action_result, endpoint, data=json.dumps({"moveToInbox": move_to_inbox}), method='post', beta=True + ) + + self.save_progress(f"Response gathered by query: {response}") + + if phantom.is_fail(ret_val): + return action_result.set_status(phantom.APP_ERROR, f"Moving email with id: {message} to inbox folder failed") + + action_result.add_data(response) + return action_result.set_status(phantom.APP_SUCCESS) + def handle_action(self, param): ret_val = phantom.APP_SUCCESS @@ -3312,6 +3362,12 @@ def handle_action(self, param): self.debug_print("action_id", self.get_action_identifier()) + if action_id == 'block_sender': + ret_val = self._handle_block_sender(param) + + if action_id == 'unblock_sender': + ret_val = self._handle_unblock_sender(param) + if action_id == "test_connectivity": ret_val = self._handle_test_connectivity(param) From dbfead2860a0034d1af5c2519b28bdd182522693 Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Thu, 26 Sep 2024 09:45:29 +0000 Subject: [PATCH 20/40] Update README.md --- README.md | 50 +++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 49 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0a63690..7438282 100644 --- a/README.md +++ b/README.md @@ -351,6 +351,8 @@ VARIABLE | REQUIRED | TYPE | DESCRIPTION [send email](#action-send-email) - Sends an email with optional text rendering. Attachments are allowed a Content-ID tag for reference within the html [on poll](#action-on-poll) - Ingest emails from Office 365 using Graph API [update email](#action-update-email) - Update an email on the server +[block sender](#action-block-sender) - Add the sender email into the block list +[unblock sender](#action-unblock-sender) - Remove the sender email from the block list ## action: 'test connectivity' Use supplied credentials to generate a token with MS Graph @@ -1586,4 +1588,50 @@ action_result.message | string | | Create time: 2017-10-05T20:19:58Z Subject: Both value are modified Sent time: 2017-10-03T21:31:20Z summary.total_objects | numeric | | 1 -summary.total_objects_successful | numeric | | 1 \ No newline at end of file +summary.total_objects_successful | numeric | | 1 + +## action: 'block sender' +Add the sender email into the block list + +Type: **contain** +Read only: **False** + +#### Action Parameters +PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS +--------- | -------- | ----------- | ---- | -------- +**message_id** | required | Message ID to pick the sender of | string | +**user_id** | required | User ID to base the action of | string | +**move_to_junk_folder** | optional | Should the email be moved to the junk folder | boolean | + +#### Action Output +DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES +--------- | ---- | -------- | -------------- +action_result.parameter.id | string | | +action_result.parameter.move_to_junk_folder | boolean | | +action_result.status | string | | +action_result.message | string | | +summary.total_objects | numeric | | +summary.total_objects_successful | numeric | | + +## action: 'unblock sender' +Remove the sender email from the block list + +Type: **contain** +Read only: **False** + +#### Action Parameters +PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS +--------- | -------- | ----------- | ---- | -------- +**message_id** | required | Message ID to pick the sender of | string | +**user_id** | required | User ID to base the action of | string | +**move_to_inbox** | optional | Should the email be moved to the inbox folder | boolean | + +#### Action Output +DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES +--------- | ---- | -------- | -------------- +action_result.parameter.id | string | | +action_result.parameter.move_to_junk_folder | boolean | | +action_result.status | string | | +action_result.message | string | | +summary.total_objects | numeric | | +summary.total_objects_successful | numeric | | \ No newline at end of file From 7e12ff266cf9519e612c9bddff850a08e0f04fd1 Mon Sep 17 00:00:00 2001 From: kczernik Date: Thu, 26 Sep 2024 15:12:38 +0200 Subject: [PATCH 21/40] PAPP-34619 | blocking and unblocking in now prettier --- LICENSE | 2 +- office365.json | 34 ++++++++++++++++++++++++---------- office365_connector.py | 4 ---- 3 files changed, 25 insertions(+), 15 deletions(-) diff --git a/LICENSE b/LICENSE index d0f6848..a7dfdbd 100644 --- a/LICENSE +++ b/LICENSE @@ -198,4 +198,4 @@ distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and - limitations under the License. \ No newline at end of file + limitations under the License. diff --git a/office365.json b/office365.json index 7a9f4ff..463b10c 100644 --- a/office365.json +++ b/office365.json @@ -7542,24 +7542,31 @@ }, "output": [ { - "data_path": "action_result.parameter.id", + "data_path": "action_result.parameter.message_id", "data_type": "string", "contains": [], - "column_name": "id", + "column_name": "message id", "column_order": 0 }, { "data_path": "action_result.parameter.move_to_junk_folder", "data_type": "boolean", "contains": [], - "column_name": "move_to_junk_folder", + "column_name": "move to junk folder", "column_order": 1 }, + { + "data_path": "action_result.parameter.user_id", + "data_type": "boolean", + "contains": [], + "column_name": "user id", + "column_order": 2 + }, { "data_path": "action_result.status", "data_type": "string", "column_name": "status", - "column_order": 2 + "column_order": 5 }, { "data_path": "action_result.message", @@ -7622,24 +7629,31 @@ }, "output": [ { - "data_path": "action_result.parameter.id", + "data_path": "action_result.parameter.message_id", "data_type": "string", "contains": [], - "column_name": "id", + "column_name": "message id", "column_order": 0 }, { - "data_path": "action_result.parameter.move_to_junk_folder", + "data_path": "action_result.parameter.move_to_inbox", "data_type": "boolean", "contains": [], - "column_name": "move_to_inbox", + "column_name": "move to inbox folder", "column_order": 1 }, + { + "data_path": "action_result.parameter.user_id", + "data_type": "boolean", + "contains": [], + "column_name": "user id", + "column_order": 2 + }, { "data_path": "action_result.status", "data_type": "string", "column_name": "status", - "column_order": 2 + "column_order": 5 }, { "data_path": "action_result.message", @@ -7688,7 +7702,7 @@ }, { "module": "soupsieve", - "input_file": "wheels/py3/soupsieve-2.5-py3-none-any.whl" + "input_file": "wheels/py3/soupsieve-2.6-py3-none-any.whl" } ] } diff --git a/office365_connector.py b/office365_connector.py index 67d4597..48bb9e1 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3322,8 +3322,6 @@ def _handle_block_sender(self, param): action_result, endpoint, data=json.dumps({"moveToJunk": move_to_junk_folder}), method='post', beta=True ) - self.save_progress(f"Response gathered by query: {response}") - if phantom.is_fail(ret_val): return action_result.set_status(phantom.APP_ERROR, f"Moving email with id: {message} to junk folder failed") @@ -3345,8 +3343,6 @@ def _handle_unblock_sender(self, param): action_result, endpoint, data=json.dumps({"moveToInbox": move_to_inbox}), method='post', beta=True ) - self.save_progress(f"Response gathered by query: {response}") - if phantom.is_fail(ret_val): return action_result.set_status(phantom.APP_ERROR, f"Moving email with id: {message} to inbox folder failed") From a9405fe63c650ed129c34c829c3c16be497c36a6 Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Thu, 26 Sep 2024 13:15:25 +0000 Subject: [PATCH 22/40] Update README.md --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 7438282..b2b7f49 100644 --- a/README.md +++ b/README.md @@ -1606,8 +1606,9 @@ PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS #### Action Output DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES --------- | ---- | -------- | -------------- -action_result.parameter.id | string | | +action_result.parameter.message_id | string | | action_result.parameter.move_to_junk_folder | boolean | | +action_result.parameter.user_id | boolean | | action_result.status | string | | action_result.message | string | | summary.total_objects | numeric | | @@ -1629,8 +1630,9 @@ PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS #### Action Output DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES --------- | ---- | -------- | -------------- -action_result.parameter.id | string | | -action_result.parameter.move_to_junk_folder | boolean | | +action_result.parameter.message_id | string | | +action_result.parameter.move_to_inbox | boolean | | +action_result.parameter.user_id | boolean | | action_result.status | string | | action_result.message | string | | summary.total_objects | numeric | | From 0606187737f28c508e82cd9b7cfd9b638f05faca Mon Sep 17 00:00:00 2001 From: kczernik Date: Mon, 30 Sep 2024 11:23:19 +0200 Subject: [PATCH 23/40] PAPP-34619 | introduced ci cd tools in version 1.22 --- .pre-commit-config.yaml | 2 +- office365.json | 24 - office365_connector.py | 985 ++++++------------ office365_consts.py | 68 +- process_email.py | 467 ++++----- pyproject.toml | 7 + requirements.txt | 1 - tox.ini | 2 +- .../py3/beautifulsoup4-4.9.1-py3-none-any.whl | Bin 115057 -> 0 bytes .../soupsieve-2.3.2.post1-py3-none-any.whl | Bin 37377 -> 0 bytes wheels/py3/soupsieve-2.5-py3-none-any.whl | Bin 36131 -> 0 bytes 11 files changed, 599 insertions(+), 957 deletions(-) create mode 100644 pyproject.toml delete mode 100644 wheels/py3/beautifulsoup4-4.9.1-py3-none-any.whl delete mode 100644 wheels/py3/soupsieve-2.3.2.post1-py3-none-any.whl delete mode 100644 wheels/py3/soupsieve-2.5-py3-none-any.whl diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index e210658..d85e1dd 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -1,6 +1,6 @@ repos: - repo: https://github.com/phantomcyber/dev-cicd-tools - rev: v1.17 + rev: v1.22 hooks: - id: org-hook - id: package-app-dependencies diff --git a/office365.json b/office365.json index 463b10c..db3a7d0 100644 --- a/office365.json +++ b/office365.json @@ -7676,33 +7676,9 @@ ], "pip_dependencies": { "wheel": [ - { - "module": "beautifulsoup4", - "input_file": "wheels/py3/beautifulsoup4-4.9.1-py3-none-any.whl" - }, { "module": "python_magic", "input_file": "wheels/shared/python_magic-0.4.18-py2.py3-none-any.whl" - }, - { - "module": "soupsieve", - "input_file": "wheels/py3/soupsieve-2.3.2.post1-py3-none-any.whl" - } - ] - }, - "pip39_dependencies": { - "wheel": [ - { - "module": "beautifulsoup4", - "input_file": "wheels/py3/beautifulsoup4-4.9.1-py3-none-any.whl" - }, - { - "module": "python_magic", - "input_file": "wheels/shared/python_magic-0.4.18-py2.py3-none-any.whl" - }, - { - "module": "soupsieve", - "input_file": "wheels/py3/soupsieve-2.6-py3-none-any.whl" } ] } diff --git a/office365_connector.py b/office365_connector.py index 48bb9e1..fae6b0b 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -86,7 +86,7 @@ def _load_app_state(asset_id, app_connector=None): except Exception as e: if app_connector: error_msg = _get_error_msg_from_exception(e, app_connector) - app_connector.debug_print('In _load_app_state: {0}'.format(error_msg)) + app_connector.debug_print("In _load_app_state: {0}".format(error_msg)) if app_connector: app_connector.debug_print("Loaded state: ", state) @@ -144,9 +144,7 @@ def _save_app_state(state, asset_id, app_connector=None): except Exception as e: error_msg = _get_error_msg_from_exception(e, app_connector) if app_connector: - app_connector.debug_print( - "Unable to save state file: {0}".format(error_msg) - ) + app_connector.debug_print("Unable to save state file: {0}".format(error_msg)) print("Unable to save state file: {0}".format(error_msg)) return phantom.APP_ERROR @@ -197,18 +195,14 @@ def _validate_integer(action_result, parameter, key, allow_zero=False): try: if not float(parameter).is_integer(): return ( - action_result.set_status( - phantom.APP_ERROR, MSGOFFICE365_VALID_INT_MSG.format(param=key) - ), + action_result.set_status(phantom.APP_ERROR, MSGOFFICE365_VALID_INT_MSG.format(param=key)), None, ) parameter = int(parameter) except Exception: return ( - action_result.set_status( - phantom.APP_ERROR, MSGOFFICE365_VALID_INT_MSG.format(param=key) - ), + action_result.set_status(phantom.APP_ERROR, MSGOFFICE365_VALID_INT_MSG.format(param=key)), None, ) @@ -254,9 +248,7 @@ def _handle_oauth_result(request, path_parts): if not admin_consent and not code: return HttpResponse( - "ERROR: admin_consent or authorization code not found in URL\n{0}".format( - json.dumps(request.GET) - ), + "ERROR: admin_consent or authorization code not found in URL\n{0}".format(json.dumps(request.GET)), content_type="text/plain", status=400, ) @@ -300,9 +292,7 @@ def _handle_oauth_start(request, path_parts): # get the asset id, the state file is created for each asset asset_id = request.GET.get("asset_id") if not asset_id: - return HttpResponse( - "ERROR: Asset ID not found in URL", content_type="text/plain", status=404 - ) + return HttpResponse("ERROR: Asset ID not found in URL", content_type="text/plain", status=404) # Load the state that was created for the asset state = _load_app_state(asset_id) @@ -360,9 +350,7 @@ def handle_request(request, path_parts): auth_status_file_path = "{0}/{1}_{2}".format(app_dir, asset_id, TC_FILE) real_auth_status_file_path = os.path.abspath(auth_status_file_path) if not os.path.dirname(real_auth_status_file_path) == app_dir: - return HttpResponse( - "Error: Invalid asset_id", content_type="text/plain", status=400 - ) + return HttpResponse("Error: Invalid asset_id", content_type="text/plain", status=400) open(auth_status_file_path, "w").close() try: uid = pwd.getpwnam("apache").pw_uid @@ -374,9 +362,7 @@ def handle_request(request, path_parts): return ret_val - return HttpResponse( - "error: Invalid endpoint", content_type="text/plain", status=404 - ) + return HttpResponse("error: Invalid endpoint", content_type="text/plain", status=404) def _get_dir_name_from_app_name(app_name): @@ -410,9 +396,7 @@ def __init__(self): self._scope = None self._access_token = None self._refresh_token = None - self._REPLACE_CONST = ( - "C53CEA8298BD401BA695F247633D0542" # pragma: allowlist secret - ) + self._REPLACE_CONST = "C53CEA8298BD401BA695F247633D0542" # pragma: allowlist secret self._duplicate_count = 0 self._asset_id = None @@ -425,9 +409,7 @@ def load_state(self): state = super().load_state() if not isinstance(state, dict): self.debug_print("Resetting the state file with the default format") - state = { - "app_version": self.get_app_json().get('app_version') - } + state = {"app_version": self.get_app_json().get("app_version")} return state return self._decrypt_state(state) @@ -444,19 +426,16 @@ def update_state_fields(self, value, helper_function, error_message): try: return helper_function(value, self._asset_id) except Exception as ex: - self.debug_print("{}: {}".format(error_message, - _get_error_msg_from_exception(ex, self))) + self.debug_print("{}: {}".format(error_message, _get_error_msg_from_exception(ex, self))) return None def check_state_fields(self, state, helper_function, error_message): access_token = state.get("non_admin_auth", {}).get("access_token") if access_token: - state["non_admin_auth"]["access_token"] = self.update_state_fields(access_token, - helper_function, error_message) + state["non_admin_auth"]["access_token"] = self.update_state_fields(access_token, helper_function, error_message) refresh_token = state.get("non_admin_auth", {}).get("refresh_token") if refresh_token: - state["non_admin_auth"]["refresh_token"] = self.update_state_fields(refresh_token, - helper_function, error_message) + state["non_admin_auth"]["refresh_token"] = self.update_state_fields(refresh_token, helper_function, error_message) access_token = state.get("admin_auth", {}).get("access_token") if access_token: state["admin_auth"]["access_token"] = self.update_state_fields(access_token, helper_function, error_message) @@ -514,7 +493,7 @@ def _process_html_response(self, response, action_result): msg = "Status Code: {0}. Data from server:\n{1}\n".format(status_code, error_text) - msg = msg.replace('{', '{{').replace('}', '}}') + msg = msg.replace("{", "{{").replace("}", "}}") return RetVal(action_result.set_status(phantom.APP_ERROR, msg), None) @@ -536,17 +515,15 @@ def _process_json_response(self, r, action_result): error_text = "" error_msg = "" - error = resp_json.get('error', '') - error_desc = resp_json.get('error_description', '') + error = resp_json.get("error", "") + error_desc = resp_json.get("error_description", "") if isinstance(error, dict): - error_code = error.get('code') - error_msg = error.get('message') + error_code = error.get("code") + error_msg = error.get("message") if error_msg: try: - soup = BeautifulSoup( - resp_json.get("error", {}).get("message"), "html.parser" - ) + soup = BeautifulSoup(resp_json.get("error", {}).get("message"), "html.parser") # Remove the script, style, footer and navigation part from the HTML message for element in soup(["script", "style", "footer", "nav"]): element.extract() @@ -572,8 +549,7 @@ def _process_json_response(self, r, action_result): # You should process the error returned in the json - msg = "Error: Status Code: {0} Data from server: {1}".format( - r.status_code, error_text) + msg = "Error: Status Code: {0} Data from server: {1}".format(r.status_code, error_text) return RetVal(action_result.set_status(phantom.APP_ERROR, msg), None) @@ -600,9 +576,7 @@ def _process_response(self, r, action_result): return self._process_html_response(r, action_result) if r.status_code == 404: - return RetVal( - action_result.set_status(phantom.APP_ERROR, "Email not found"), None - ) + return RetVal(action_result.set_status(phantom.APP_ERROR, "Email not found"), None) if 200 <= r.status_code <= 204: return RetVal(phantom.APP_SUCCESS, None) @@ -614,7 +588,8 @@ def _process_response(self, r, action_result): # everything else is actually an error at this point msg = "Can't process response from server. Status Code: {0} Data from server: {1}".format( - r.status_code, r.text.replace('{', '{{').replace('}', '}}')) + r.status_code, r.text.replace("{", "{{").replace("}", "}}") + ) return RetVal(action_result.set_status(phantom.APP_ERROR, msg), None) @@ -636,9 +611,7 @@ def _make_rest_call( request_func = getattr(requests, method) except AttributeError: return RetVal( - action_result.set_status( - phantom.APP_ERROR, "Invalid method: {0}".format(method) - ), + action_result.set_status(phantom.APP_ERROR, "Invalid method: {0}".format(method)), resp_json, ) @@ -672,9 +645,7 @@ def _make_rest_call( def _get_asset_name(self, action_result): - rest_endpoint = SPLUNK_SOAR_ASSET_INFO_URL.format( - url=self.get_phantom_base_url(), asset_id=self._asset_id - ) + rest_endpoint = SPLUNK_SOAR_ASSET_INFO_URL.format(url=self.get_phantom_base_url(), asset_id=self._asset_id) ret_val, resp_json = self._make_rest_call(action_result, rest_endpoint, False) @@ -701,9 +672,7 @@ def _update_container(self, action_result, container_id, container): :param container: container's payload to update :return: status phantom.APP_ERROR/phantom.APP_SUCCESS with status message """ - rest_endpoint = SPLUNK_SOAR_CONTAINER_INFO_URL.format( - url=self.get_phantom_base_url(), container_id=container_id - ) + rest_endpoint = SPLUNK_SOAR_CONTAINER_INFO_URL.format(url=self.get_phantom_base_url(), container_id=container_id) try: data = json.dumps(container) @@ -716,9 +685,7 @@ def _update_container(self, action_result, container_id, container): ).format(container_id, error_msg) return action_result.set_status(phantom.APP_ERROR, msg) - ret_val, _ = self._make_rest_call( - action_result, rest_endpoint, False, data=data, method="post" - ) + ret_val, _ = self._make_rest_call(action_result, rest_endpoint, False, data=data, method="post") if phantom.is_fail(ret_val): return action_result.get_status() @@ -765,9 +732,7 @@ def _get_url_to_app_rest(self, action_result=None): if phantom.is_fail(ret_val): return (action_result.get_status(), None) - self.save_progress( - "Using Splunk SOAR base URL as: {0}".format(phantom_base_url) - ) + self.save_progress("Using Splunk SOAR base URL as: {0}".format(phantom_base_url)) app_json = self.get_app_json() @@ -775,9 +740,7 @@ def _get_url_to_app_rest(self, action_result=None): app_dir_name = _get_dir_name_from_app_name(app_name) - url_to_app_rest = "{0}/rest/handler/{1}_{2}/{3}".format( - phantom_base_url, app_dir_name, app_json["appid"], asset_name - ) + url_to_app_rest = "{0}/rest/handler/{1}_{2}/{3}".format(phantom_base_url, app_dir_name, app_json["appid"], asset_name) return (phantom.APP_SUCCESS, url_to_app_rest) @@ -806,19 +769,16 @@ def _make_rest_call_helper( if headers is None: headers = {} - headers.update({ - 'Authorization': 'Bearer {0}'.format(self._access_token), - 'Accept': 'application/json', - 'Content-Type': 'application/json' - }) + headers.update( + {"Authorization": "Bearer {0}".format(self._access_token), "Accept": "application/json", "Content-Type": "application/json"} + ) ret_val, resp_json = self._make_rest_call(action_result, url, verify, headers, params, data, method, download=download) # If token is expired, generate a new token msg = action_result.get_message() - if msg and (('token' in msg and 'expired' in msg) or any(failure_msg in msg for failure_msg in AUTH_FAILURE_MSG)): - self.debug_print("MSGRAPH", - f"Error '{msg}' found in API response. Requesting new access token using refresh token") + if msg and (("token" in msg and "expired" in msg) or any(failure_msg in msg for failure_msg in AUTH_FAILURE_MSG)): + self.debug_print("MSGRAPH", f"Error '{msg}' found in API response. Requesting new access token using refresh token") ret_val = self._get_token(action_result) if phantom.is_fail(ret_val): return action_result.get_status(), None @@ -842,7 +802,7 @@ def _make_rest_call_helper( return phantom.APP_SUCCESS, resp_json def _sanitize_file_name(self, file_name): - return re.sub('[,"\']', '', file_name) + return re.sub("[,\"']", "", file_name) def _add_attachment_to_vault(self, attachment, container_id, file_data): fd, tmp_file_path = tempfile.mkstemp(dir=Vault.get_vault_tmp_dir()) @@ -869,19 +829,13 @@ def _handle_attachment(self, attachment, container_id, artifact_json=None): vault_id = None try: - if ( - "contentBytes" in attachment - ): # Check whether the attachment contains the data + if "contentBytes" in attachment: # Check whether the attachment contains the data file_data = base64.b64decode(attachment.pop("contentBytes")) - ret_val, vault_id = self._add_attachment_to_vault( - attachment, container_id, file_data - ) + ret_val, vault_id = self._add_attachment_to_vault(attachment, container_id, file_data) if phantom.is_fail(ret_val): return phantom.APP_ERROR else: - self.debug_print( - "No content found in the attachment. Hence, skipping the vault file creation." - ) + self.debug_print("No content found in the attachment. Hence, skipping the vault file creation.") except Exception as e: error_msg = _get_error_msg_from_exception(e, self) @@ -910,37 +864,25 @@ def _handle_attachment(self, attachment, container_id, artifact_json=None): return phantom.APP_SUCCESS - def _handle_item_attachment( - self, attachment, container_id, endpoint, action_result - ): + def _handle_item_attachment(self, attachment, container_id, endpoint, action_result): vault_id = None try: attach_endpoint = "{}/{}/$value".format(endpoint, attachment["id"]) - ret_val, rfc822_email = self._make_rest_call_helper( - action_result, attach_endpoint, download=True - ) + ret_val, rfc822_email = self._make_rest_call_helper(action_result, attach_endpoint, download=True) if phantom.is_fail(ret_val): - self.debug_print( - "Error while downloading the file content, for attachment id: {}".format( - attachment["id"] - ) - ) + self.debug_print("Error while downloading the file content, for attachment id: {}".format(attachment["id"])) return phantom.APP_ERROR attachment["name"] = "{}.eml".format(attachment["name"]) if rfc822_email: # Check whether the API returned any data - ret_val, vault_id = self._add_attachment_to_vault( - attachment, container_id, rfc822_email - ) + ret_val, vault_id = self._add_attachment_to_vault(attachment, container_id, rfc822_email) if phantom.is_fail(ret_val): return phantom.APP_ERROR else: - self.debug_print( - "No content found for the item attachment. Hence, skipping the vault file creation." - ) + self.debug_print("No content found for the item attachment. Hence, skipping the vault file creation.") except Exception as e: error_msg = _get_error_msg_from_exception(e, self) @@ -950,9 +892,7 @@ def _handle_item_attachment( attachment["vaultId"] = vault_id return phantom.APP_SUCCESS - def _create_reference_attachment_artifact( - self, container_id, attachment, artifact_json - ): + def _create_reference_attachment_artifact(self, container_id, attachment, artifact_json): """ Create reference attachment artifact. @@ -997,9 +937,7 @@ def _create_email_artifacts(self, container_id, email, artifact_id=None, create_ # Set email ID contains self._process_email._set_email_id_contains(email["id"]) - email_artifact["cef_types"] = { - "messageId": self._process_email._email_id_contains - } + email_artifact["cef_types"] = {"messageId": self._process_email._email_id_contains} email_artifact["source_data_identifier"] = artifact_id @@ -1017,9 +955,7 @@ def _create_email_artifacts(self, container_id, email, artifact_id=None, create_ # add first email to To recipients = v if len(recipients): - cef["toEmail"] = ( - recipients[0].get("emailAddress", {}).get("address", "") - ) + cef["toEmail"] = recipients[0].get("emailAddress", {}).get("address", "") elif k == "id": cef["messageId"] = v elif k == "internetMessageHeaders": @@ -1035,9 +971,7 @@ def _create_email_artifacts(self, container_id, email, artifact_id=None, create_ else: cef[k] = v - if cef.get("body", {}).get("content") and ( - cef.get("body", {}).get("contentType") == "html" - ): + if cef.get("body", {}).get("content") and (cef.get("body", {}).get("contentType") == "html"): html_body = cef["body"]["content"] try: @@ -1057,7 +991,7 @@ def _create_email_artifacts(self, container_id, email, artifact_id=None, create_ if not create_iocs: return [email_artifact] - body = email['body']['content'] + body = email["body"]["content"] ips = [] self._process_email._get_ips(body, ips) @@ -1137,12 +1071,8 @@ def _extract_attachments( # We need to expand the item attachment only once if first_time: - sub_email_endpoint = ( - attach_endpoint + "/{0}?$expand=microsoft.graph.itemattachment/item".format(attachment["id"]) - ) - ret_val, sub_email_resp = self._make_rest_call_helper( - action_result, sub_email_endpoint - ) + sub_email_endpoint = attach_endpoint + "/{0}?$expand=microsoft.graph.itemattachment/item".format(attachment["id"]) + ret_val, sub_email_resp = self._make_rest_call_helper(action_result, sub_email_endpoint) if phantom.is_fail(ret_val): return action_result.get_status() sub_email = sub_email_resp.get("item", {}) @@ -1151,7 +1081,7 @@ def _extract_attachments( sub_email = attachment.get("item", {}) if sub_email: - sub_artifacts = self._create_email_artifacts(container_id, sub_email, attachment['id'], create_iocs=False) + sub_artifacts = self._create_email_artifacts(container_id, sub_email, attachment["id"], create_iocs=False) artifacts += sub_artifacts # Use recursive approach to extract the reference attachment @@ -1166,27 +1096,15 @@ def _extract_attachments( container_id, ) if phantom.is_fail(ret_val): - self.debug_print( - "Error while processing nested attachments, for attachment id: {}".format( - attachment["id"] - ) - ) + self.debug_print("Error while processing nested attachments, for attachment id: {}".format(attachment["id"])) if first_time: # Fetch the rfc822 content for the item attachment - sub_email_endpoint = "{0}/{1}/$value".format( - attach_endpoint, attachment["id"] - ) + sub_email_endpoint = "{0}/{1}/$value".format(attach_endpoint, attachment["id"]) attachment["name"] = "{}.eml".format(attachment["name"]) - ret_val, rfc822_email = self._make_rest_call_helper( - action_result, sub_email_endpoint, download=True - ) + ret_val, rfc822_email = self._make_rest_call_helper(action_result, sub_email_endpoint, download=True) if phantom.is_fail(ret_val): - self.debug_print( - "Error while downloading the email content, for attachment id: {}".format( - attachment["id"] - ) - ) + self.debug_print("Error while downloading the email content, for attachment id: {}".format(attachment["id"])) if rfc822_email: # Create ProcessEmail Object for email item attachment @@ -1194,25 +1112,17 @@ def _extract_attachments( process_email_obj._trigger_automation = False ret_val, msg = process_email_obj.process_email( - rfc822_email, attachment['id'], epoch=None, - container_id=container_id, ingest_email=False) + rfc822_email, attachment["id"], epoch=None, container_id=container_id, ingest_email=False + ) if phantom.is_fail(ret_val): - self.debug_print( - "Error while processing the email content, for attachment id: {}".format( - attachment["id"] - ) - ) + self.debug_print("Error while processing the email content, for attachment id: {}".format(attachment["id"])) if config.get("ingest_eml", False): # Add eml file into the vault if ingest_email is checked - ret_val, vault_id = self._add_attachment_to_vault( - attachment, container_id, rfc822_email - ) + ret_val, vault_id = self._add_attachment_to_vault(attachment, container_id, rfc822_email) if phantom.is_fail(ret_val): - self.debug_print( - "Could not process item attachment. See logs for details" - ) + self.debug_print("Could not process item attachment. See logs for details") else: # If success, create vault artifact artifact_json = { @@ -1234,19 +1144,13 @@ def _extract_attachments( artifacts.append(artifact_json) else: - self.debug_print( - "No content found for the item attachment. Hence, skipping the email file processing." - ) + self.debug_print("No content found for the item attachment. Hence, skipping the email file processing.") - elif ( - attachment.get("@odata.type") == "#microsoft.graph.referenceAttachment" - ): + elif attachment.get("@odata.type") == "#microsoft.graph.referenceAttachment": attach_artifact = {} artifacts.append(attach_artifact) - self._create_reference_attachment_artifact( - container_id, attachment, attach_artifact - ) + self._create_reference_attachment_artifact(container_id, attachment, attach_artifact) elif attachment.get("name", "").endswith(".eml"): if "contentBytes" in attachment: @@ -1262,21 +1166,17 @@ def _extract_attachments( process_email_obj = ProcessEmail(self, config) process_email_obj._trigger_automation = False - ret_val, msg = process_email_obj.process_email(rfc822_email, attachment['id'], epoch=None, container_id=container_id) + ret_val, msg = process_email_obj.process_email(rfc822_email, attachment["id"], epoch=None, container_id=container_id) if phantom.is_fail(ret_val): return action_result.set_status(phantom.APP_ERROR, msg) else: - self.debug_print( - "No content found in the .eml file attachment. Hence, skipping the email file processing." - ) + self.debug_print("No content found in the .eml file attachment. Hence, skipping the email file processing.") elif first_time: attach_artifact = {} artifacts.append(attach_artifact) - if not self._handle_attachment( - attachment, container_id, artifact_json=attach_artifact - ): + if not self._handle_attachment(attachment, container_id, artifact_json=attach_artifact): return action_result.set_status( phantom.APP_ERROR, "Could not process attachment. See logs for details.", @@ -1296,11 +1196,11 @@ def _process_email_data(self, config, action_result, endpoint, email): """ container = {} - container['name'] = email['subject'] if email['subject'] else email['id'] - container_description = MSGOFFICE365_CONTAINER_DESCRIPTION.format(last_modified_time=email['lastModifiedDateTime']) - container['description'] = container_description - container['source_data_identifier'] = email['id'] - container['data'] = {'raw_email': email} + container["name"] = email["subject"] if email["subject"] else email["id"] + container_description = MSGOFFICE365_CONTAINER_DESCRIPTION.format(last_modified_time=email["lastModifiedDateTime"]) + container["description"] = container_description + container["source_data_identifier"] = email["id"] + container["data"] = {"raw_email": email} ret_val, msg, container_id = self.save_container(container) @@ -1312,21 +1212,15 @@ def _process_email_data(self, config, action_result, endpoint, email): self._duplicate_count += 1 # Prevent further processing if the email is not modified - ret_val, container_info, status_code = self.get_container_info( - container_id=container_id - ) + ret_val, container_info, status_code = self.get_container_info(container_id=container_id) if phantom.is_fail(ret_val): return action_result.set_status( phantom.APP_ERROR, - "Status Code: {}. Error occurred while fetching the container info for container ID: {}".format( - status_code, container_id - ), + "Status Code: {}. Error occurred while fetching the container info for container ID: {}".format(status_code, container_id), ) if container_info.get("description", "") == container_description: - msg = "Email ID: {} has not been modified. Hence, skipping the artifact ingestion.".format( - email["id"] - ) + msg = "Email ID: {} has not been modified. Hence, skipping the artifact ingestion.".format(email["id"]) self.debug_print(msg) return action_result.set_status(phantom.APP_SUCCESS, msg) else: @@ -1343,8 +1237,8 @@ def _process_email_data(self, config, action_result, endpoint, email): if config.get("extract_eml", True): subject = email.get("subject") email_message = { - "id": email['id'], - "name": subject if subject else "email_message_{}".format(email['id']), + "id": email["id"], + "name": subject if subject else "email_message_{}".format(email["id"]), } if not self._handle_item_attachment( email_message, @@ -1370,18 +1264,14 @@ def _process_email_data(self, config, action_result, endpoint, email): } if email_message["vaultId"]: - artifact_cef.update({ - "vaultId": email_message["vaultId"] - }) + artifact_cef.update({"vaultId": email_message["vaultId"]}) artifact_json["cef"] = artifact_cef attachment_artifacts.append(artifact_json) if email["hasAttachments"] and config.get("extract_attachments", False): attach_endpoint = endpoint + "/{0}/attachments".format(email["id"]) - ret_val, attach_resp = self._make_rest_call_helper( - action_result, attach_endpoint - ) + ret_val, attach_resp = self._make_rest_call_helper(action_result, attach_endpoint) if phantom.is_fail(ret_val): return action_result.get_status() @@ -1432,11 +1322,7 @@ def _handle_test_connectivity(self, param): ret_val, app_rest_url = self._get_url_to_app_rest(action_result) app_state = {} if phantom.is_fail(ret_val): - self.save_progress( - "Unable to get the URL to the app's REST Endpoint. Error: {0}".format( - action_result.get_message() - ) - ) + self.save_progress("Unable to get the URL to the app's REST Endpoint. Error: {0}".format(action_result.get_message())) return action_result.set_status(phantom.APP_ERROR) # create the url that the oauth server should re-direct to after the auth is completed @@ -1450,11 +1336,7 @@ def _handle_test_connectivity(self, param): if self._admin_access: # Create the url for fetching administrator consent - admin_consent_url = ( - "https://login.microsoftonline.com/{0}/adminconsent".format( - self._tenant - ) - ) + admin_consent_url = "https://login.microsoftonline.com/{0}/adminconsent".format(self._tenant) admin_consent_url += "?client_id={0}".format(self._client_id) admin_consent_url += "&redirect_uri={0}".format(redirect_uri) admin_consent_url += "&state={0}".format(self._asset_id) @@ -1466,9 +1348,7 @@ def _handle_test_connectivity(self, param): "Please provide scope for non-admin access in the asset configuration", ) # Create the url authorization, this is the one pointing to the oauth server side - admin_consent_url = "https://login.microsoftonline.com/{0}/oauth2/v2.0/authorize".format( - self._tenant - ) + admin_consent_url = "https://login.microsoftonline.com/{0}/oauth2/v2.0/authorize".format(self._tenant) admin_consent_url += "?client_id={0}".format(self._client_id) admin_consent_url += "&redirect_uri={0}".format(redirect_uri) admin_consent_url += "&state={0}".format(self._asset_id) @@ -1479,16 +1359,12 @@ def _handle_test_connectivity(self, param): # The URL that the user should open in a different tab. # This is pointing to a REST endpoint that points to the app - url_to_show = "{0}/start_oauth?asset_id={1}&".format( - app_rest_url, self._asset_id - ) + url_to_show = "{0}/start_oauth?asset_id={1}&".format(app_rest_url, self._asset_id) # Save the state, will be used by the request handler _save_app_state(app_state, self._asset_id, self) - self.save_progress( - "Please connect to the following URL from a different tab to continue the connectivity process" - ) + self.save_progress("Please connect to the following URL from a different tab to continue the connectivity process") self.save_progress(url_to_show) self.save_progress(MSGOFFICE365_AUTHORIZE_TROUBLESHOOT_MSG) @@ -1497,9 +1373,7 @@ def _handle_test_connectivity(self, param): completed = False app_dir = os.path.dirname(os.path.abspath(__file__)) - auth_status_file_path = "{0}/{1}_{2}".format( - app_dir, self._asset_id, TC_FILE - ) + auth_status_file_path = "{0}/{1}_{2}".format(app_dir, self._asset_id, TC_FILE) if self._admin_access: self.save_progress("Waiting for Admin Consent to complete") @@ -1518,9 +1392,7 @@ def _handle_test_connectivity(self, param): time.sleep(TC_STATUS_SLEEP) if not completed: - self.save_progress( - "Authentication process does not seem to be completed. Timing out" - ) + self.save_progress("Authentication process does not seem to be completed. Timing out") return action_result.set_status(phantom.APP_ERROR) self.send_progress("") @@ -1540,15 +1412,13 @@ def _handle_test_connectivity(self, param): return action_result.set_status(phantom.APP_ERROR) else: if not self._state.get("code"): - self.save_progress( - "Authorization code not received or not given" - ) + self.save_progress("Authorization code not received or not given") self.save_progress("Test Connectivity Failed") return action_result.set_status(phantom.APP_ERROR) # Deleting the local state file because of it replicates with actual state file while installing the app current_file_path = pathlib.Path(__file__).resolve() - input_file = f'{self._asset_id}_state.json' + input_file = f"{self._asset_id}_state.json" state_file_path = current_file_path.with_name(input_file) state_file_path.unlink() @@ -1559,21 +1429,17 @@ def _handle_test_connectivity(self, param): self._remove_tokens(action_result) return action_result.get_status() - params = {'$top': '1'} + params = {"$top": "1"} message_failed = "" if self._admin_access: message_failed = "API to fetch details of all the users failed" self.save_progress("Getting info about all users to verify token") - ret_val, response = self._make_rest_call_helper( - action_result, "/users", params=params - ) + ret_val, response = self._make_rest_call_helper(action_result, "/users", params=params) else: message_failed = "API to get user details failed" self.save_progress("Getting info about a single user to verify token") - ret_val, response = self._make_rest_call_helper( - action_result, "/me", params=params - ) + ret_val, response = self._make_rest_call_helper(action_result, "/me", params=params) if phantom.is_fail(ret_val): self.save_progress(message_failed) @@ -1591,9 +1457,7 @@ def _handle_test_connectivity(self, param): def _handle_copy_email(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) email_addr = param["email_address"] @@ -1619,23 +1483,17 @@ def _handle_copy_email(self, param): self.save_progress(error) return action_result.set_status(phantom.APP_ERROR, error) - ret_val, response = self._make_rest_call_helper( - action_result, endpoint, data=json.dumps(body), method="post" - ) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, data=json.dumps(body), method="post") if phantom.is_fail(ret_val): return action_result.get_status() action_result.add_data(response) - return action_result.set_status( - phantom.APP_SUCCESS, "Successfully copied email" - ) + return action_result.set_status(phantom.APP_SUCCESS, "Successfully copied email") def _handle_move_email(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) email_addr = param["email_address"] @@ -1648,9 +1506,7 @@ def _handle_move_email(self, param): body = {"DestinationId": folder} if param.get("get_folder_id", True): try: - dir_id, error, _ = self._get_folder_id( - action_result, folder, email_addr - ) + dir_id, error, _ = self._get_folder_id(action_result, folder, email_addr) except ReturnException as e: self._dump_error_log(e) @@ -1663,9 +1519,7 @@ def _handle_move_email(self, param): self.save_progress(error) return action_result.set_status(phantom.APP_ERROR, error) - ret_val, response = self._make_rest_call_helper( - action_result, endpoint, data=json.dumps(body), method="post" - ) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, data=json.dumps(body), method="post") if phantom.is_fail(ret_val): return action_result.get_status() @@ -1675,9 +1529,7 @@ def _handle_move_email(self, param): def _handle_delete_email(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) email_addr = param["email_address"] @@ -1686,21 +1538,15 @@ def _handle_delete_email(self, param): endpoint += "/messages/{0}".format(message_id) - ret_val, _ = self._make_rest_call_helper( - action_result, endpoint, method="delete" - ) + ret_val, _ = self._make_rest_call_helper(action_result, endpoint, method="delete") if phantom.is_fail(ret_val): return action_result.get_status() - return action_result.set_status( - phantom.APP_SUCCESS, "Successfully deleted email" - ) + return action_result.set_status(phantom.APP_SUCCESS, "Successfully deleted email") def _handle_delete_event(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) email_addr = param["email_address"] @@ -1714,29 +1560,21 @@ def _handle_delete_event(self, param): endpoint += "/decline" data = json.dumps({"sendResponse": True}) - ret_val, _ = self._make_rest_call_helper( - action_result, endpoint, method=method, data=data - ) + ret_val, _ = self._make_rest_call_helper(action_result, endpoint, method=method, data=data) if phantom.is_fail(ret_val): return action_result.get_status() - return action_result.set_status( - phantom.APP_SUCCESS, "Successfully deleted event" - ) + return action_result.set_status(phantom.APP_SUCCESS, "Successfully deleted event") def _handle_oof_check(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) user_id = param["user_id"] endpoint = "/users/{0}/mailboxSettings/automaticRepliesSetting".format(user_id) - ret_val, response = self._make_rest_call_helper( - action_result, endpoint, method="get" - ) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, method="get") if phantom.is_fail(ret_val): return action_result.get_status() @@ -1744,14 +1582,10 @@ def _handle_oof_check(self, param): action_result.update_summary({"events_matched": action_result.get_data_size()}) - return action_result.set_status( - phantom.APP_SUCCESS, "Successfully retrieved out of office status" - ) + return action_result.set_status(phantom.APP_SUCCESS, "Successfully retrieved out of office status") def _handle_list_events(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) user_id = param.get("user_id") if param.get("user_id") else None @@ -1799,15 +1633,10 @@ def _handle_list_events(self, param): if not events: # No events found is a valid scenario that there can be 0 events returned # even if the API call is a success for the correct given inputs and hence, returning APP_SUCCESS. - return action_result.set_status( - phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND - ) + return action_result.set_status(phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND) for event in events: - attendees = [ - attendee.get("emailAddress", {}).get("name") - for attendee in event.get("attendees", []) - ] + attendees = [attendee.get("emailAddress", {}).get("name") for attendee in event.get("attendees", [])] event["attendee_list"] = ", ".join(attendees) action_result.add_data(event) @@ -1816,16 +1645,12 @@ def _handle_list_events(self, param): return action_result.set_status( phantom.APP_SUCCESS, - "Successfully retrieved {} event{}".format( - num_events, "" if num_events == 1 else "s" - ), + "Successfully retrieved {} event{}".format(num_events, "" if num_events == 1 else "s"), ) def _handle_list_groups(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) limit = param.get("limit") @@ -1845,9 +1670,7 @@ def _handle_list_groups(self, param): return action_result.get_status() if not groups: - return action_result.set_status( - phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND - ) + return action_result.set_status(phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND) for group in groups: action_result.add_data(group) @@ -1857,16 +1680,12 @@ def _handle_list_groups(self, param): return action_result.set_status( phantom.APP_SUCCESS, - "Successfully retrieved {} group{}".format( - num_groups, "" if num_groups == 1 else "s" - ), + "Successfully retrieved {} group{}".format(num_groups, "" if num_groups == 1 else "s"), ) def _handle_list_group_members(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) limit = param.get("limit") @@ -1878,16 +1697,16 @@ def _handle_list_group_members(self, param): if phantom.is_fail(ret_val): return action_result.get_status() - method = param.get('method', 'Group ID') - group_id = identificator = param['identificator'] - if param.get('filter'): - query = param.get('filter') + method = param.get("method", "Group ID") + group_id = identificator = param["identificator"] + if param.get("filter"): + query = param.get("filter") is_advance_query = True - if method.lower() not in ('group id', 'group e-mail'): + if method.lower() not in ("group id", "group e-mail"): return action_result.set_status(phantom.APP_ERROR, MSGOFFICE365_INVALID_METHOD) - if method.lower() == 'group e-mail': + if method.lower() == "group e-mail": if not util.is_email(identificator): return action_result.set_status(phantom.APP_ERROR, MSGOFFICE365_INVALID_EMAIL) @@ -1899,14 +1718,14 @@ def _handle_list_group_members(self, param): if not group: return action_result.set_status( - phantom.APP_ERROR, "There is no such {} group name, Please check the correct " - "spelling or existence".format(identificator)) - group_id = group[0]['id'] + phantom.APP_ERROR, "There is no such {} group name, Please check the correct " "spelling or existence".format(identificator) + ) + group_id = group[0]["id"] - transitive_members = param.get('get_transitive_members', True) - endpoint = '/groups/{0}/members'.format(group_id) + transitive_members = param.get("get_transitive_members", True) + endpoint = "/groups/{0}/members".format(group_id) if transitive_members: - endpoint = '/groups/{0}/transitiveMembers'.format(group_id) + endpoint = "/groups/{0}/transitiveMembers".format(group_id) ret_val, members = self._paginator(action_result, endpoint, limit, query=query, is_advance_query=is_advance_query) @@ -1914,9 +1733,7 @@ def _handle_list_group_members(self, param): return action_result.get_status() if not members: - return action_result.set_status( - phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND - ) + return action_result.set_status(phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND) for member in members: action_result.add_data(member) @@ -1926,16 +1743,12 @@ def _handle_list_group_members(self, param): return action_result.set_status( phantom.APP_SUCCESS, - "Successfully retrieved {} group member{}".format( - num_members, "" if num_members == 1 else "s" - ), + "Successfully retrieved {} group member{}".format(num_members, "" if num_members == 1 else "s"), ) def _handle_list_users(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) limit = param.get("limit") @@ -1955,9 +1768,7 @@ def _handle_list_users(self, param): return action_result.get_status() if not users: - return action_result.set_status( - phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND - ) + return action_result.set_status(phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND) for user in users: action_result.add_data(user) @@ -1967,23 +1778,17 @@ def _handle_list_users(self, param): return action_result.set_status( phantom.APP_SUCCESS, - "Successfully retrieved {} user{}".format( - num_users, "" if num_users == 1 else "s" - ), + "Successfully retrieved {} user{}".format(num_users, "" if num_users == 1 else "s"), ) def _handle_list_rules(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) user_id = param["user_id"] - endpoint = "/users/{user_id}/mailFolders/inbox/messageRules".format( - user_id=user_id - ) + endpoint = "/users/{user_id}/mailFolders/inbox/messageRules".format(user_id=user_id) ret_val, rules = self._paginator(action_result, endpoint) @@ -1991,9 +1796,7 @@ def _handle_list_rules(self, param): return action_result.get_status() if not rules: - return action_result.set_status( - phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND - ) + return action_result.set_status(phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND) for rule in rules: action_result.add_data(rule) @@ -2003,9 +1806,7 @@ def _handle_list_rules(self, param): return action_result.set_status( phantom.APP_SUCCESS, - "Successfully retrieved {} rule{}".format( - num_rules, "" if num_rules == 1 else "s" - ), + "Successfully retrieved {} rule{}".format(num_rules, "" if num_rules == 1 else "s"), ) def flatten_json(self, y): @@ -2028,17 +1829,13 @@ def flatten(x, name=""): def _handle_get_rule(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) user_id = param["user_id"] rule_id = param["rule_id"] - endpoint = "/users/{user_id}/mailFolders/inbox/messageRules/{rule_id}".format( - user_id=user_id, rule_id=rule_id - ) + endpoint = "/users/{user_id}/mailFolders/inbox/messageRules/{rule_id}".format(user_id=user_id, rule_id=rule_id) ret_val, rule = self._make_rest_call_helper(action_result, endpoint) @@ -2046,23 +1843,17 @@ def _handle_get_rule(self, param): return action_result.get_status() if not rule: - return action_result.set_status( - phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND - ) + return action_result.set_status(phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND) rule = self.flatten_json(rule) self.debug_print(rule) action_result.add_data(rule) - return action_result.set_status( - phantom.APP_SUCCESS, "Successfully retrieved specified inbox rule" - ) + return action_result.set_status(phantom.APP_SUCCESS, "Successfully retrieved specified inbox rule") def _handle_list_folders(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) list_folder = list() @@ -2095,9 +1886,7 @@ def _handle_list_folders(self, param): if phantom.is_fail(ret_val): return action_result.get_status() else: - ret_val = self._list_child_folders( - action_result, list_folder, user_id=user_id, folder_id=folder_id - ) + ret_val = self._list_child_folders(action_result, list_folder, user_id=user_id, folder_id=folder_id) if phantom.is_fail(ret_val): return action_result.get_status() @@ -2110,9 +1899,7 @@ def _handle_list_folders(self, param): return action_result.set_status( phantom.APP_SUCCESS, - "Successfully retrieved {} mail folder{}".format( - num_folders, "" if num_folders == 1 else "s" - ), + "Successfully retrieved {} mail folder{}".format(num_folders, "" if num_folders == 1 else "s"), ) def _fetch_root_folders(self, action_result, user_id): @@ -2126,27 +1913,19 @@ def _fetch_root_folders(self, action_result, user_id): if not folders: return ( - action_result.set_status( - phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND - ), + action_result.set_status(phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND), None, ) return phantom.APP_SUCCESS, folders - def _list_child_folders( - self, action_result, list_folder, user_id, parent_folder=None, folder_id=None - ): + def _list_child_folders(self, action_result, list_folder, user_id, parent_folder=None, folder_id=None): # fetching root level folders if not folder_id: - ret_val, child_folders = self._fetch_child_folders( - action_result, user_id, parent_folder["id"] - ) + ret_val, child_folders = self._fetch_child_folders(action_result, user_id, parent_folder["id"]) else: - ret_val, child_folders = self._fetch_child_folders( - action_result, user_id, folder_id - ) + ret_val, child_folders = self._fetch_child_folders(action_result, user_id, folder_id) if phantom.is_fail(ret_val): return action_result.get_status() @@ -2173,9 +1952,7 @@ def _list_child_folders( def _fetch_child_folders(self, action_result, user_id, folder_id): - endpoint = "/users/{user_id}/mailFolders/{folder_id}/childFolders".format( - user_id=user_id, folder_id=folder_id - ) + endpoint = "/users/{user_id}/mailFolders/{folder_id}/childFolders".format(user_id=user_id, folder_id=folder_id) ret_val, folders = self._paginator(action_result, endpoint) @@ -2204,9 +1981,7 @@ def _flatten_headers(self, headers): def _handle_get_email(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) email_addr = param["email_address"] @@ -2221,26 +1996,18 @@ def _handle_get_email(self, param): if param.get("extract_headers"): header_endpoint = endpoint + "?$select=internetMessageHeaders" - ret_val, header_response = self._make_rest_call_helper( - action_result, header_endpoint - ) + ret_val, header_response = self._make_rest_call_helper(action_result, header_endpoint) if phantom.is_fail(ret_val): return action_result.get_status() # For Drafts there might not be any internetMessageHeaders, # so we have to use get() fetching instead of directly fetching from dictionary - response["internetMessageHeaders"] = header_response.get( - "internetMessageHeaders" - ) + response["internetMessageHeaders"] = header_response.get("internetMessageHeaders") if param.get("download_attachments", False) and response.get("hasAttachments"): endpoint += "/attachments" - attachment_endpoint = ( - "{}?$expand=microsoft.graph.itemattachment/item".format(endpoint) - ) - ret_val, attach_resp = self._make_rest_call_helper( - action_result, attachment_endpoint - ) + attachment_endpoint = "{}?$expand=microsoft.graph.itemattachment/item".format(endpoint) + ret_val, attach_resp = self._make_rest_call_helper(action_result, attachment_endpoint) if phantom.is_fail(ret_val): return action_result.get_status() @@ -2254,9 +2021,7 @@ def _handle_get_email(self, param): "Could not process attachment. See logs for details", ) elif attachment.get("@odata.type") == "#microsoft.graph.itemAttachment": - if not self._handle_item_attachment( - attachment, self.get_container_id(), endpoint, action_result - ): + if not self._handle_item_attachment(attachment, self.get_container_id(), endpoint, action_result): return action_result.set_status( phantom.APP_ERROR, "Could not process item attachment. See logs for details", @@ -2270,21 +2035,15 @@ def _handle_get_email(self, param): "#microsoft.graph.eventMessageResponse", ]: - event_endpoint = "{}/?$expand=Microsoft.Graph.EventMessage/Event".format( - endpoint - ) - ret_val, event_resp = self._make_rest_call_helper( - action_result, event_endpoint - ) + event_endpoint = "{}/?$expand=Microsoft.Graph.EventMessage/Event".format(endpoint) + ret_val, event_resp = self._make_rest_call_helper(action_result, event_endpoint) if phantom.is_fail(ret_val): return action_result.get_status() response["event"] = event_resp["event"] if "internetMessageHeaders" in response: - response["internetMessageHeaders"] = self._flatten_headers( - response["internetMessageHeaders"] - ) + response["internetMessageHeaders"] = self._flatten_headers(response["internetMessageHeaders"]) # If the response has attachments, update every attachment data with its type # 'attachmentType' key - indicates type of attachment @@ -2295,9 +2054,7 @@ def _handle_get_email(self, param): attachment_type = attachment.get("@odata.type", "") attachment["attachmentType"] = attachment_type if attachment_type == "#microsoft.graph.itemAttachment": - attachment["itemType"] = attachment.get("item", {}).get( - "@odata.type", "" - ) + attachment["itemType"] = attachment.get("item", {}).get("@odata.type", "") if param.get("download_email"): subject = response.get("subject") @@ -2319,15 +2076,11 @@ def _handle_get_email(self, param): action_result.add_data(response) - return action_result.set_status( - phantom.APP_SUCCESS, "Successfully fetched email" - ) + return action_result.set_status(phantom.APP_SUCCESS, "Successfully fetched email") def _handle_get_email_properties(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) email_addr = param["email_address"] @@ -2347,11 +2100,7 @@ def _handle_get_email_properties(self, param): select_list.append("sender") if "properties_list" in param: properties_list = param["properties_list"] - properties_list = [ - property.strip() - for property in properties_list.strip().split(",") - if property.strip() - ] + properties_list = [property.strip() for property in properties_list.strip().split(",") if property.strip()] select_list += properties_list if select_list: @@ -2362,15 +2111,11 @@ def _handle_get_email_properties(self, param): return action_result.get_status() if "internetMessageHeaders" in response: - response["internetMessageHeaders"] = self._flatten_headers( - response["internetMessageHeaders"] - ) + response["internetMessageHeaders"] = self._flatten_headers(response["internetMessageHeaders"]) action_result.add_data(response) - return action_result.set_status( - phantom.APP_SUCCESS, "Successfully fetched email" - ) + return action_result.set_status(phantom.APP_SUCCESS, "Successfully fetched email") def _manage_data_duplication(self, emails, total_ingested, limit, max_emails): """ @@ -2403,9 +2148,7 @@ def _manage_data_duplication(self, emails, total_ingested, limit, max_emails): def _handle_on_poll(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) config = self.get_config() @@ -2436,13 +2179,9 @@ def _handle_on_poll(self, param): start_time = self._state["last_time"] if not config.get("email_address"): - return action_result.set_status( - phantom.APP_ERROR, "Email Address to ingest must be supplied in asset!" - ) + return action_result.set_status(phantom.APP_ERROR, "Email Address to ingest must be supplied in asset!") elif not config.get("folder"): - return action_result.set_status( - phantom.APP_ERROR, "Folder to ingest from must be supplied in asset!" - ) + return action_result.set_status(phantom.APP_ERROR, "Folder to ingest from must be supplied in asset!") endpoint = "/users/{0}".format(config.get("email_address")) @@ -2450,7 +2189,7 @@ def _handle_on_poll(self, param): folder = config.get("folder", "") if config.get("get_folder_id", True): try: - dir_id, error, _ = self._get_folder_id(action_result, folder, config.get('email_address')) + dir_id, error, _ = self._get_folder_id(action_result, folder, config.get("email_address")) except ReturnException as e: self._dump_error_log(e) @@ -2467,7 +2206,7 @@ def _handle_on_poll(self, param): params = {"$orderBy": "lastModifiedDateTime {}".format(order)} - params['$select'] = ','.join(MSGOFFICE365_SELECT_PARAMETER_LIST) + params["$select"] = ",".join(MSGOFFICE365_SELECT_PARAMETER_LIST) if start_time: params["$filter"] = "lastModifiedDateTime ge {0}".format(start_time) @@ -2482,40 +2221,28 @@ def _handle_on_poll(self, param): while True: self._duplicate_count = 0 - ret_val, emails = self._paginator( - action_result, endpoint, limit=cur_limit, params=params - ) + ret_val, emails = self._paginator(action_result, endpoint, limit=cur_limit, params=params) if phantom.is_fail(ret_val): return action_result.get_status() if not emails: - return action_result.set_status( - phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND - ) + return action_result.set_status(phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND) failed_email_ids = 0 total_emails = len(emails) self.save_progress("Total emails fetched: {}".format(total_emails)) if self.is_poll_now(): - self.save_progress( - "Ingesting all possible artifacts (ignoring maximum artifacts value) for POLL NOW" - ) + self.save_progress("Ingesting all possible artifacts (ignoring maximum artifacts value) for POLL NOW") for index, email in enumerate(emails): try: - self.send_progress( - "Processing email # {} with ID ending in: {}".format( - index + 1, email["id"][-10:] - ) - ) - ret_val = self._process_email_data( - config, action_result, endpoint, email - ) + self.send_progress("Processing email # {} with ID ending in: {}".format(index + 1, email["id"][-10:])) + ret_val = self._process_email_data(config, action_result, endpoint, email) if phantom.is_fail(ret_val): failed_email_ids += 1 - self.debug_print("Error occurred while processing email ID: {}. {}".format(email.get('id'), action_result.get_message())) + self.debug_print("Error occurred while processing email ID: {}. {}".format(email.get("id"), action_result.get_message())) except Exception as e: failed_email_ids += 1 error_msg = _get_error_msg_from_exception(e, self) @@ -2528,9 +2255,7 @@ def _handle_on_poll(self, param): ) if not self.is_poll_now(): - last_time = datetime.strptime( - emails[email_index]["lastModifiedDateTime"], O365_TIME_FORMAT - ).strftime(O365_TIME_FORMAT) + last_time = datetime.strptime(emails[email_index]["lastModifiedDateTime"], O365_TIME_FORMAT).strftime(O365_TIME_FORMAT) self._state["last_time"] = last_time self.save_state(deepcopy(self._state)) @@ -2539,9 +2264,7 @@ def _handle_on_poll(self, param): # Duplication logic should only work for the oldest first order and if we have more data on the server. if total_emails >= cur_limit and email_index == -1: - cur_limit, total_ingested = self._manage_data_duplication( - emails, total_ingested, cur_limit, max_emails - ) + cur_limit, total_ingested = self._manage_data_duplication(emails, total_ingested, cur_limit, max_emails) if not cur_limit: break else: @@ -2580,18 +2303,14 @@ def _validate_range(self, email_range, action_result): if maxi > MAX_END_OFFSET_VAL: return action_result.set_status( phantom.APP_ERROR, - "Invalid range value. The max_offset value cannot be greater than {0}".format( - MAX_END_OFFSET_VAL - ), + "Invalid range value. The max_offset value cannot be greater than {0}".format(MAX_END_OFFSET_VAL), ) return phantom.APP_SUCCESS def _handle_generate_token(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) ret_val = self._get_token(action_result) if phantom.is_fail(ret_val): @@ -2603,9 +2322,7 @@ def _handle_generate_token(self, param): def _handle_run_query(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) limit = param.get("limit") @@ -2621,11 +2338,7 @@ def _handle_run_query(self, param): params = dict() if "internet_message_id" in param: - params = { - "$filter": "internetMessageId eq '{0}'".format( - param["internet_message_id"] - ) - } + params = {"$filter": "internetMessageId eq '{0}'".format(param["internet_message_id"])} elif "query" in param: query = "?{0}".format(param["query"]) @@ -2650,20 +2363,14 @@ def _handle_run_query(self, param): if param.get("search_well_known_folders", False): endpoint += "/mailFolders" - folder_params = { - "$filter": "{}".format(MSGOFFICE365_WELL_KNOWN_FOLDERS_FILTER) - } - ret_val, response = self._paginator( - action_result, endpoint, params=folder_params - ) + folder_params = {"$filter": "{}".format(MSGOFFICE365_WELL_KNOWN_FOLDERS_FILTER)} + ret_val, response = self._paginator(action_result, endpoint, params=folder_params) if phantom.is_fail(ret_val): return action_result.set_status(phantom.APP_ERROR) if not response: - return action_result.set_status( - phantom.APP_SUCCESS, "No well known folders found" - ) + return action_result.set_status(phantom.APP_SUCCESS, "No well known folders found") folders = response @@ -2713,9 +2420,7 @@ def _handle_run_query(self, param): messages.extend(folder_messages) else: - ret_val, messages = self._paginator( - action_result, endpoint, limit, params=params - ) + ret_val, messages = self._paginator(action_result, endpoint, limit, params=params) if phantom.is_fail(ret_val): msg = action_result.get_message() @@ -2726,9 +2431,7 @@ def _handle_run_query(self, param): return action_result.get_status() if not messages: - return action_result.set_status( - phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND - ) + return action_result.set_status(phantom.APP_SUCCESS, MSGOFFICE365_NO_DATA_FOUND) action_result.update_data(messages) action_result.update_summary({"emails_matched": action_result.get_data_size()}) @@ -2760,7 +2463,7 @@ def _get_folder_id(self, action_result, folder, email): try: for i, subf in enumerate(path[1:]): - subpath = "/".join(path[0: i + 2]) + subpath = "/".join(path[0 : i + 2]) parent_id = dir_id dir_id = self._get_child_folder(action_result, subf, parent_id, email) @@ -2784,9 +2487,7 @@ def _get_folder(self, action_result, folder, email): params["$filter"] = "displayName eq '{}'".format(folder) endpoint = "/users/{}/mailFolders".format(email) - ret_val, response = self._make_rest_call_helper( - action_result, endpoint, params=params - ) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, params=params) if phantom.is_fail(ret_val): raise ReturnException(action_result.get_message()) @@ -2804,9 +2505,7 @@ def _get_child_folder(self, action_result, folder, parent_id, email): params["$filter"] = "displayName eq '{}'".format(folder) endpoint = "/users/{}/mailFolders/{}/childFolders".format(email, parent_id) - ret_val, response = self._make_rest_call_helper( - action_result, endpoint, params=params - ) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, params=params) if phantom.is_fail(ret_val): raise ReturnException() @@ -2823,9 +2522,7 @@ def _new_folder(self, action_result, folder, email): data = json.dumps({"displayName": folder}) endpoint = "/users/{}/mailFolders".format(email) - ret_val, response = self._make_rest_call_helper( - action_result, endpoint, data=data, method="post" - ) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, data=data, method="post") if phantom.is_fail(ret_val): raise ReturnException() @@ -2844,33 +2541,23 @@ def _new_child_folder(self, action_result, folder, parent_id, email, pathsofar): data = json.dumps({"displayName": folder}) endpoint = "/users/{}/mailFolders/{}/childFolders".format(email, parent_id) - ret_val, response = self._make_rest_call_helper( - action_result, endpoint, data=data, method="post" - ) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, data=data, method="post") if phantom.is_fail(ret_val): raise ReturnException() if response.get("id", False): self._currentdir = response - self.save_progress( - "Success({}): created child folder in folder {}".format( - folder, pathsofar - ) - ) + self.save_progress("Success({}): created child folder in folder {}".format(folder, pathsofar)) return response["id"] - msg = "Error({}): unable to create child folder in folder {}".format( - folder, pathsofar - ) + msg = "Error({}): unable to create child folder in folder {}".format(folder, pathsofar) self.save_progress(msg) action_result.set_status(phantom.APP_ERROR, msg) raise ReturnException() def _handle_create_folder(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) email = param["email_address"] @@ -2920,9 +2607,7 @@ def _handle_create_folder(self, param): action_result.add_data(self._currentdir) else: - msg = "Error({}): folder doesn't exists in mailbox".format( - path[0] - ) + msg = "Error({}): folder doesn't exists in mailbox".format(path[0]) self.save_progress(msg) return action_result.set_status(phantom.APP_ERROR, msg) @@ -2936,21 +2621,15 @@ def _handle_create_folder(self, param): # next all the childFolders in between for subf in path: - dir_id = self._get_child_folder( - action_result, subf, parent_id, email - ) + dir_id = self._get_child_folder(action_result, subf, parent_id, email) if not dir_id: if minusp: - dir_id = self._new_child_folder( - action_result, subf, parent_id, email, pathsofar - ) + dir_id = self._new_child_folder(action_result, subf, parent_id, email, pathsofar) action_result.add_data(self._currentdir) else: - msg = "Error({}): child folder doesn't exists in folder {}".format( - subf, pathsofar - ) + msg = "Error({}): child folder doesn't exists in folder {}".format(subf, pathsofar) self.save_progress(msg) return action_result.set_status(phantom.APP_ERROR, msg) @@ -2960,15 +2639,11 @@ def _handle_create_folder(self, param): # finally, the actual folder dir_id = self._get_child_folder(action_result, final, parent_id, email) if dir_id: - msg = "Error: child folder {0} already exists in the folder {1}".format( - final, pathsofar - ) + msg = "Error: child folder {0} already exists in the folder {1}".format(final, pathsofar) self.save_progress(msg) return action_result.set_status(phantom.APP_ERROR, msg) - dir_id = self._new_child_folder( - action_result, final, parent_id, email, pathsofar - ) + dir_id = self._new_child_folder(action_result, final, parent_id, email, pathsofar) action_result.add_data(self._currentdir) except ReturnException as e: @@ -2985,9 +2660,7 @@ def _handle_create_folder(self, param): def _handle_get_folder_id(self, param): - self.save_progress( - "In action handler for: {0}".format(self.get_action_identifier()) - ) + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) email = param["email_address"] @@ -3013,48 +2686,45 @@ def _handle_get_folder_id(self, param): return action_result.set_status(phantom.APP_ERROR, error) def _email_to_recipient(self, email: str): - recipient = { - "emailAddress": { - "address": email - } - } + recipient = {"emailAddress": {"address": email}} return recipient - def _create_draft_message(self, action_result, subject: str, body: str, from_email: str, - *, to_emails: list[str], cc_emails: list[str], bcc_emails: list[str], headers: dict[str, str]): - endpoint = '/users/{}/messages'.format(from_email) - req_headers = { - 'Prefer': 'IdType="ImmutableId"' - } - msg = { - "subject": subject, - "body": { - "contentType": "HTML", - "content": body - } - } + def _create_draft_message( + self, + action_result, + subject: str, + body: str, + from_email: str, + *, + to_emails: list[str], + cc_emails: list[str], + bcc_emails: list[str], + headers: dict[str, str], + ): + endpoint = "/users/{}/messages".format(from_email) + req_headers = {"Prefer": 'IdType="ImmutableId"'} + msg = {"subject": subject, "body": {"contentType": "HTML", "content": body}} if to_emails: - msg['toRecipients'] = [self._email_to_recipient(email) for email in to_emails] + msg["toRecipients"] = [self._email_to_recipient(email) for email in to_emails] if cc_emails: - msg['ccRecipients'] = [self._email_to_recipient(email) for email in cc_emails] + msg["ccRecipients"] = [self._email_to_recipient(email) for email in cc_emails] if bcc_emails: - msg['bccRecipients'] = [self._email_to_recipient(email) for email in bcc_emails] + msg["bccRecipients"] = [self._email_to_recipient(email) for email in bcc_emails] if headers: - msg['internetMessageHeaders'] = [ - {'name': key, 'value': value} for key, value in headers.items()] + msg["internetMessageHeaders"] = [{"name": key, "value": value} for key, value in headers.items()] - ret_val, response = self._make_rest_call_helper(action_result, endpoint, method='post', headers=req_headers, data=json.dumps(msg)) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, method="post", headers=req_headers, data=json.dumps(msg)) if phantom.is_fail(ret_val): return action_result.get_status(), None - message_id = response['id'] + message_id = response["id"] return action_result, message_id def _send_draft_message(self, action_result, user_id, message_id): endpoint = "/users/{}/messages/{}/send".format(user_id, message_id) - ret_val, _ = self._make_rest_call_helper(action_result, endpoint, method='post') + ret_val, _ = self._make_rest_call_helper(action_result, endpoint, method="post") if phantom.is_fail(ret_val): return action_result.set_status(phantom.APP_ERROR, "Failed to send draft email with id: {}".format(message_id)), None @@ -3071,7 +2741,7 @@ def _add_attachment_to_message(self, action_result, vault_id, user_id, message_i if not vault_info: return action_result.set_status(phantom.APP_ERROR, "Failed to find vault entry {}".format(vault_id)), None - if vault_info['size'] > MSGOFFICE365_UPLOAD_SESSION_CUTOFF: + if vault_info["size"] > MSGOFFICE365_UPLOAD_SESSION_CUTOFF: ret_val, attachment_id = self._upload_large_attachment(action_result, vault_info, user_id, message_id) else: ret_val, attachment_id = self._upload_small_attachment(action_result, vault_info, user_id, message_id) @@ -3080,80 +2750,90 @@ def _add_attachment_to_message(self, action_result, vault_id, user_id, message_i def _upload_small_attachment(self, action_result, vault_info, user_id, message_id): endpoint = "/users/{}/messages/{}/attachments".format(user_id, message_id) - with open(vault_info['path'], mode='rb') as file: + with open(vault_info["path"], mode="rb") as file: file_content = file.read() data = { - '@odata.type': '#microsoft.graph.fileAttachment', - 'name': vault_info['name'], - 'contentType': vault_info['mime_type'], - 'contentBytes': base64.b64encode(file_content).decode('ascii'), - 'contentId': vault_info['vault_id'] + "@odata.type": "#microsoft.graph.fileAttachment", + "name": vault_info["name"], + "contentType": vault_info["mime_type"], + "contentBytes": base64.b64encode(file_content).decode("ascii"), + "contentId": vault_info["vault_id"], } - ret_val, response = self._make_rest_call_helper(action_result, endpoint, method='post', data=json.dumps(data)) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, method="post", data=json.dumps(data)) if phantom.is_fail(ret_val): return action_result.set_status(phantom.APP_ERROR, "Failed to upload vault entry {}".format(vault_info["vault_id"])), None - attachment_id = response['id'] + attachment_id = response["id"] return phantom.APP_SUCCESS, attachment_id def _upload_large_attachment(self, action_result, vault_info, user_id, message_id): endpoint = "/users/{}/messages/{}/attachments/createUploadSession".format(user_id, message_id) - file_size = vault_info['size'] + file_size = vault_info["size"] data = { - 'AttachmentItem': { - 'attachmentType': 'file', - 'name': vault_info['name'], - 'contentType': vault_info['mime_type'], - 'contentId': vault_info['vault_id'], - 'size': file_size + "AttachmentItem": { + "attachmentType": "file", + "name": vault_info["name"], + "contentType": vault_info["mime_type"], + "contentId": vault_info["vault_id"], + "size": file_size, } } - ret_val, response = self._make_rest_call_helper(action_result, endpoint, method='post', data=json.dumps(data)) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, method="post", data=json.dumps(data)) if phantom.is_fail(ret_val): return action_result.set_status(phantom.APP_ERROR, "Failed to upload vault entry {}".format(vault_info["vault_id"])), None - upload_url = response['uploadUrl'] + upload_url = response["uploadUrl"] - with open(vault_info['path'], mode='rb') as file: + with open(vault_info["path"], mode="rb") as file: for start_position in range(0, file_size, MSGOFFICE365_UPLOAD_LARGE_FILE_CUTOFF): file_content = file.read(MSGOFFICE365_UPLOAD_LARGE_FILE_CUTOFF) end_position = start_position + len(file_content) - 1 headers = { - 'Content-Type': 'application/octet-stream', - 'Content-Range': "bytes {}-{}/{}".format(start_position, end_position, file_size) + "Content-Type": "application/octet-stream", + "Content-Range": "bytes {}-{}/{}".format(start_position, end_position, file_size), } flag = True while flag: response = requests.put(upload_url, headers=headers, data=file_content) - if response.status_code == 429 and response.headers['Retry-After']: - retry_time = int(response.headers['Retry-After']) + if response.status_code == 429 and response.headers["Retry-After"]: + retry_time = int(response.headers["Retry-After"]) if retry_time > 300: # throw error if wait time greater than 300 seconds self.debug_print("Retry is canceled as retry time is greater than 300 seconds") self._process_response(response, action_result) - return action_result.set_status( - phantom.APP_ERROR, "Failed to upload file, {} Please retry after \ - {} seconds".format(action_result.get_message(), retry_time ) - ), None + return ( + action_result.set_status( + phantom.APP_ERROR, + "Failed to upload file, {} Please retry after \ + {} seconds".format( + action_result.get_message(), retry_time + ), + ), + None, + ) self.debug_print("Retrying after {} seconds".format(retry_time)) time.sleep(retry_time + 1) elif not response.ok: - return action_result.set_status( - phantom.APP_ERROR, "Failed to upload file, Error occurred : {}, {}".format(response.status_code, str(response.text)) - ), None + return ( + action_result.set_status( + phantom.APP_ERROR, + "Failed to upload file, Error occurred : {}, {}".format(response.status_code, str(response.text)), + ), + None, + ) else: flag = False - result_location = response.headers.get('Location', 'no_location_found') + result_location = response.headers.get("Location", "no_location_found") match = re.search(r"Attachments\('(?P[^']+)'\)", result_location) if not match: return action_result.set_status(phantom.APP_ERROR, "Unable to extract attachment id from url {}".format(result_location)), None - attachment_id = match.group('attachment_id') + attachment_id = match.group("attachment_id") return phantom.APP_SUCCESS, attachment_id def _get_message(self, action_result, user_id, message_id): endpoint = "/users/{}/messages/{}".format(user_id, message_id) - ret_val, response = self._make_rest_call_helper(action_result, endpoint, method='get') + ret_val, response = self._make_rest_call_helper(action_result, endpoint, method="get") if phantom.is_fail(ret_val): return action_result.set_status(phantom.APP_ERROR, "Failed to get email with id: {}".format(message_id)), None @@ -3164,24 +2844,25 @@ def _handle_send_email(self, param): action_result = self.add_action_result(ActionResult(dict(param))) config = self.get_config() - from_email = param.get('from') or config.get('email_address') - to_emails = [email for x in param.get('to', '').split(',') if (email := x.strip())] - cc_emails = [email for x in param.get('cc', '').split(',') if (email := x.strip())] - bcc_emails = [email for x in param.get('bcc', '').split(',') if (email := x.strip())] + from_email = param.get("from") or config.get("email_address") + to_emails = [email for x in param.get("to", "").split(",") if (email := x.strip())] + cc_emails = [email for x in param.get("cc", "").split(",") if (email := x.strip())] + bcc_emails = [email for x in param.get("bcc", "").split(",") if (email := x.strip())] - subject = param['subject'] + subject = param["subject"] try: - headers = json.loads(param.get('headers', '{}')) + headers = json.loads(param.get("headers", "{}")) except Exception: return action_result.set_status(phantom.APP_ERROR, "Please enter headers in a valid JSON format") - body = param['body'] - vault_ids = [vault_id for x in param.get('attachments', '').split(',') if (vault_id := x.strip())] + body = param["body"] + vault_ids = [vault_id for x in param.get("attachments", "").split(",") if (vault_id := x.strip())] self.save_progress("Creating draft message") - ret_val, message_id = self._create_draft_message(action_result, subject, body, from_email, headers=headers, - to_emails=to_emails, cc_emails=cc_emails, bcc_emails=bcc_emails) + ret_val, message_id = self._create_draft_message( + action_result, subject, body, from_email, headers=headers, to_emails=to_emails, cc_emails=cc_emails, bcc_emails=bcc_emails + ) if phantom.is_fail(ret_val): return action_result self.save_progress("Created draft message with id: {}".format(message_id)) @@ -3193,10 +2874,7 @@ def _handle_send_email(self, param): if phantom.is_fail(ret_val): return action_result self.save_progress("Created attachment with id: {}".format(attachment_id)) - attachment = { - 'vault_id': vault_id, - 'attachment_id': attachment_id - } + attachment = {"vault_id": vault_id, "attachment_id": attachment_id} attachments.append(attachment) self.save_progress("Sending draft email with id: {}".format(message_id)) @@ -3239,16 +2917,14 @@ def _paginator(self, action_result, endpoint, limit=None, params=None, query=Non params = {"$top": page_size} if query: - params.update({'$filter': query}) + params.update({"$filter": query}) if is_advance_query: - params['$count'] = 'true' - headers['ConsistencyLevel'] = 'eventual' + params["$count"] = "true" + headers["ConsistencyLevel"] = "eventual" while True: - ret_val, response = self._make_rest_call_helper( - action_result, endpoint, nextLink=next_link, params=params, headers=headers - ) + ret_val, response = self._make_rest_call_helper(action_result, endpoint, nextLink=next_link, params=params, headers=headers) if phantom.is_fail(ret_val): return action_result.get_status(), None @@ -3276,24 +2952,22 @@ def _handle_update_email(self, param): endpoint = f"/users/{email_addr}/messages/{message_id}" - categories = param.get('categories') - subject = param.get('subject') + categories = param.get("categories") + subject = param.get("subject") if subject is None and categories is None: return action_result.set_status(phantom.APP_ERROR, "Please specify one of the email properties to update") data_to_send = {} if categories is not None: - categories = [x.strip() for x in categories.split(',')] - data_to_send['categories'] = categories + categories = [x.strip() for x in categories.split(",")] + data_to_send["categories"] = categories if subject is not None: - data_to_send['subject'] = subject + data_to_send["subject"] = subject self.save_progress("Updating email") - ret_val, _ = self._make_rest_call_helper( - action_result, endpoint, method="patch", data=json.dumps(data_to_send) - ) + ret_val, _ = self._make_rest_call_helper(action_result, endpoint, method="patch", data=json.dumps(data_to_send)) if phantom.is_fail(ret_val): return action_result.get_status() @@ -3311,15 +2985,15 @@ def _handle_block_sender(self, param): self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) - message = param['message_id'] - user = param['user_id'] - move_to_junk_folder = param.get('move_to_junk_folder', False) + message = param["message_id"] + user = param["user_id"] + move_to_junk_folder = param.get("move_to_junk_folder", False) - endpoint = f'/users/{user}/messages/{message}/markAsJunk' + endpoint = f"/users/{user}/messages/{message}/markAsJunk" self.save_progress(f"endpoint {endpoint}") ret_val, response = self._make_rest_call_helper( - action_result, endpoint, data=json.dumps({"moveToJunk": move_to_junk_folder}), method='post', beta=True + action_result, endpoint, data=json.dumps({"moveToJunk": move_to_junk_folder}), method="post", beta=True ) if phantom.is_fail(ret_val): @@ -3332,15 +3006,15 @@ def _handle_unblock_sender(self, param): self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) - message = param['message_id'] - user = param['user_id'] - move_to_inbox = param.get('move_to_inbox', False) + message = param["message_id"] + user = param["user_id"] + move_to_inbox = param.get("move_to_inbox", False) - endpoint = f'/users/{user}/messages/{message}/markAsNotJunk' + endpoint = f"/users/{user}/messages/{message}/markAsNotJunk" self.save_progress(f"endpoint {endpoint}") ret_val, response = self._make_rest_call_helper( - action_result, endpoint, data=json.dumps({"moveToInbox": move_to_inbox}), method='post', beta=True + action_result, endpoint, data=json.dumps({"moveToInbox": move_to_inbox}), method="post", beta=True ) if phantom.is_fail(ret_val): @@ -3358,10 +3032,10 @@ def handle_action(self, param): self.debug_print("action_id", self.get_action_identifier()) - if action_id == 'block_sender': + if action_id == "block_sender": ret_val = self._handle_block_sender(param) - if action_id == 'unblock_sender': + if action_id == "unblock_sender": ret_val = self._handle_unblock_sender(param) if action_id == "test_connectivity": @@ -3397,7 +3071,7 @@ def handle_action(self, param): elif action_id == "list_groups": ret_val = self._handle_list_groups(param) - elif action_id == 'list_group_members': + elif action_id == "list_group_members": ret_val = self._handle_list_group_members(param) elif action_id == "list_users": @@ -3424,10 +3098,10 @@ def handle_action(self, param): elif action_id == "get_rule": ret_val = self._handle_get_rule(param) - elif action_id == 'send_email': + elif action_id == "send_email": ret_val = self._handle_send_email(param) - elif action_id == 'update_email': + elif action_id == "update_email": ret_val = self._handle_update_email(param) return ret_val @@ -3466,9 +3140,7 @@ def _get_token(self, action_result): ) self.debug_print("Generating token...") - ret_val, resp_json = self._make_rest_call( - action_result, req_url, headers=headers, data=data, method="post" - ) + ret_val, resp_json = self._make_rest_call(action_result, req_url, headers=headers, data=data, method="post") if phantom.is_fail(ret_val): return action_result.get_status() # Save the response on the basis of admin_access @@ -3502,10 +3174,10 @@ def _get_token(self, action_result): if self._admin_access: - if self._access_token != self._state.get('admin_auth', {}).get('access_token'): + if self._access_token != self._state.get("admin_auth", {}).get("access_token"): return action_result.set_status(phantom.APP_ERROR, MSGOFFICE365_INVALID_PERMISSION_ERROR) else: - if self._access_token != self._state.get('non_admin_auth', {}).get('access_token'): + if self._access_token != self._state.get("non_admin_auth", {}).get("access_token"): return action_result.set_status(phantom.APP_ERROR, MSGOFFICE365_INVALID_PERMISSION_ERROR) self.debug_print("Token generated successfully") @@ -3532,23 +3204,22 @@ def initialize(self): # Load all the asset configuration in global variables self._state = self.load_state() - self._tenant = config['tenant'] - self._client_id = config['client_id'] - self._client_secret = config['client_secret'] - self._admin_access = config.get('admin_access') - self._admin_consent = config.get('admin_consent') - self._scope = config.get('scope') if config.get('scope') else None + self._tenant = config["tenant"] + self._client_id = config["client_id"] + self._client_secret = config["client_secret"] + self._admin_access = config.get("admin_access") + self._admin_consent = config.get("admin_consent") + self._scope = config.get("scope") if config.get("scope") else None self._number_of_retries = config.get("retry_count", MSGOFFICE365_DEFAULT_NUMBER_OF_RETRIES) - ret_val, self._number_of_retries = _validate_integer(self, self._number_of_retries, - "'Maximum attempts to retry the API call' asset configuration") + ret_val, self._number_of_retries = _validate_integer( + self, self._number_of_retries, "'Maximum attempts to retry the API call' asset configuration" + ) if phantom.is_fail(ret_val): return self.get_status() - self._retry_wait_time = config.get( - "retry_wait_time", MSGOFFICE365_DEFAULT_RETRY_WAIT_TIME - ) + self._retry_wait_time = config.get("retry_wait_time", MSGOFFICE365_DEFAULT_RETRY_WAIT_TIME) ret_val, self._retry_wait_time = _validate_integer( self, self._retry_wait_time, @@ -3564,17 +3235,11 @@ def initialize(self): "Please provide scope for non-admin access in the asset configuration", ) - self._access_token = self._state.get("non_admin_auth", {}).get( - "access_token", None - ) - self._refresh_token = self._state.get("non_admin_auth", {}).get( - "refresh_token", None - ) + self._access_token = self._state.get("non_admin_auth", {}).get("access_token", None) + self._refresh_token = self._state.get("non_admin_auth", {}).get("refresh_token", None) else: - self._access_token = self._state.get("admin_auth", {}).get( - "access_token", None - ) + self._access_token = self._state.get("admin_auth", {}).get("access_token", None) if action_id == "test_connectivity": # User is trying to complete the authentication flow, so just return True from here so that test connectivity continues @@ -3584,9 +3249,7 @@ def initialize(self): # if it was not and the current action is not test connectivity then it's an error if self._admin_access and not admin_consent: - return self.set_status( - phantom.APP_ERROR, MSGOFFICE365_RUN_CONNECTIVITY_MSG - ) + return self.set_status(phantom.APP_ERROR, MSGOFFICE365_RUN_CONNECTIVITY_MSG) if not self._admin_access and (not self._access_token or not self._refresh_token): ret_val = self._get_token(action_result) @@ -3594,9 +3257,7 @@ def initialize(self): if phantom.is_fail(ret_val): return self.set_status( phantom.APP_ERROR, - "{0}. {1}".format( - MSGOFFICE365_RUN_CONNECTIVITY_MSG, action_result.get_message() - ), + "{0}. {1}".format(MSGOFFICE365_RUN_CONNECTIVITY_MSG, action_result.get_message()), ) # Create ProcessEmail Object for on_poll @@ -3654,9 +3315,7 @@ def finalize(self): login_url = "{}login".format(BaseConnector._get_phantom_base_url()) try: print("Accessing the Login page") - r = requests.get( - login_url, verify=verify, timeout=MSGOFFICE365_DEFAULT_REQUEST_TIMEOUT - ) + r = requests.get(login_url, verify=verify, timeout=MSGOFFICE365_DEFAULT_REQUEST_TIMEOUT) csrftoken = r.cookies["csrftoken"] data = { "username": args.username, @@ -3679,9 +3338,7 @@ def finalize(self): session_id = r2.cookies["sessionid"] except Exception as e: - print( - "Unable to get session id from the platform. Error: {0}".format(str(e)) - ) + print("Unable to get session id from the platform. Error: {0}".format(str(e))) sys.exit(1) if len(sys.argv) < 2: diff --git a/office365_consts.py b/office365_consts.py index 4e72ea9..8a699bf 100644 --- a/office365_consts.py +++ b/office365_consts.py @@ -20,26 +20,34 @@ SPLUNK_SOAR_ASSET_INFO_URL = "{url}rest/asset/{asset_id}" SPLUNK_SOAR_CONTAINER_INFO_URL = "{url}rest/container/{container_id}" O365_TIME_FORMAT = "%Y-%m-%dT%H:%M:%SZ" -MSGOFFICE365_RUN_CONNECTIVITY_MSG = "Please run test connectivity first to complete authorization flow and "\ - "generate a token that the app can use to make calls to the server " -MSGOFFICE365_WELL_KNOWN_FOLDERS_FILTER = "displayName eq 'archive' or displayName eq 'clutter' or "\ - "displayName eq 'conflicts' or displayName eq 'conversation history' or displayName eq 'deleted items' or "\ - "displayName eq 'drafts' or displayName eq 'inbox' or displayName eq 'junk email' or displayName eq 'local failures' or"\ - " displayName eq 'msg folder root' or displayName eq 'outbox' or displayName eq 'recoverable items deletions' or "\ - "displayName eq 'scheduled' or displayName eq 'search folders' or displayName eq 'sent items' or displayName eq 'server failures' or "\ +MSGOFFICE365_RUN_CONNECTIVITY_MSG = ( + "Please run test connectivity first to complete authorization flow and " "generate a token that the app can use to make calls to the server " +) +MSGOFFICE365_WELL_KNOWN_FOLDERS_FILTER = ( + "displayName eq 'archive' or displayName eq 'clutter' or " + "displayName eq 'conflicts' or displayName eq 'conversation history' or displayName eq 'deleted items' or " + "displayName eq 'drafts' or displayName eq 'inbox' or displayName eq 'junk email' or displayName eq 'local failures' or" + " displayName eq 'msg folder root' or displayName eq 'outbox' or displayName eq 'recoverable items deletions' or " + "displayName eq 'scheduled' or displayName eq 'search folders' or displayName eq 'sent items' or displayName eq 'server failures' or " "displayName eq 'sync issues'" -MSGOFFICE365_STATE_FILE_CORRUPT_ERROR = "Error occurred while loading the state file. " \ - "Resetting the state file with the default format. Please test the connectivity." +) +MSGOFFICE365_STATE_FILE_CORRUPT_ERROR = ( + "Error occurred while loading the state file. " "Resetting the state file with the default format. Please test the connectivity." +) -MSGOFFICE365_AUTHORIZE_TROUBLESHOOT_MSG = 'If authorization URL fails to communicate with your '\ - 'Splunk SOAR instance, check whether you have: '\ - ' 1. Specified the Web Redirect URL of your App -- The Redirect URL should be /result . '\ - ' 2. Configured the base URL of your Splunk SOAR Instance at Administration -> Company Settings -> Info' -MSGOFFICE365_INVALID_PERMISSION_ERROR = "Error occurred while saving the newly generated access token "\ - "(in place of the expired token) in the state file." +MSGOFFICE365_AUTHORIZE_TROUBLESHOOT_MSG = ( + "If authorization URL fails to communicate with your " + "Splunk SOAR instance, check whether you have: " + " 1. Specified the Web Redirect URL of your App -- The Redirect URL should be /result . " + " 2. Configured the base URL of your Splunk SOAR Instance at Administration -> Company Settings -> Info" +) +MSGOFFICE365_INVALID_PERMISSION_ERROR = ( + "Error occurred while saving the newly generated access token " "(in place of the expired token) in the state file." +) MSGOFFICE365_INVALID_PERMISSION_ERROR += " Please check the owner, owner group, and the permissions of the state file. The Splunk SOAR " -MSGOFFICE365_INVALID_PERMISSION_ERROR += "user should have the correct access rights and ownership for the corresponding state file "\ - "(refer to readme file for more information)." +MSGOFFICE365_INVALID_PERMISSION_ERROR += ( + "user should have the correct access rights and ownership for the corresponding state file " "(refer to readme file for more information)." +) MSGOFFICE365_NO_DATA_FOUND = "No data found" MSGOFFICE365_DUPLICATE_CONTAINER_FOUND_MSG = "duplicate container found" MSGOFFICE365_ERROR_EMPTY_RESPONSE = "Status Code {code}. Empty response and no information in the header." @@ -47,13 +55,17 @@ MSGOFFICE365_DEFAULT_REQUEST_TIMEOUT = 30 # in seconds MSGOFFICE365_DEFAULT_NUMBER_OF_RETRIES = 3 MSGOFFICE365_DEFAULT_RETRY_WAIT_TIME = 60 # in seconds -MSGOFFICE365_CONTAINER_DESCRIPTION = 'Email ingested using MS Graph API - {last_modified_time}' -MSGOFFICE365_HTTP_401_STATUS_CODE = '401' -MSGOFFICE365_INVALID_CLIENT_ID_ERROR_CODE = 'AADSTS700016' -MSGOFFICE365_INVALID_TENANT_ID_FORMAT_ERROR_CODE = 'AADSTS900023' -MSGOFFICE365_INVALID_TENANT_ID_NOT_FOUND_ERROR_CODE = 'AADSTS90002' -MSGOFFICE365_ASSET_PARAM_CHECK_LIST_ERROR = [MSGOFFICE365_HTTP_401_STATUS_CODE, MSGOFFICE365_INVALID_CLIENT_ID_ERROR_CODE, - MSGOFFICE365_INVALID_TENANT_ID_FORMAT_ERROR_CODE, MSGOFFICE365_INVALID_TENANT_ID_NOT_FOUND_ERROR_CODE] +MSGOFFICE365_CONTAINER_DESCRIPTION = "Email ingested using MS Graph API - {last_modified_time}" +MSGOFFICE365_HTTP_401_STATUS_CODE = "401" +MSGOFFICE365_INVALID_CLIENT_ID_ERROR_CODE = "AADSTS700016" +MSGOFFICE365_INVALID_TENANT_ID_FORMAT_ERROR_CODE = "AADSTS900023" +MSGOFFICE365_INVALID_TENANT_ID_NOT_FOUND_ERROR_CODE = "AADSTS90002" +MSGOFFICE365_ASSET_PARAM_CHECK_LIST_ERROR = [ + MSGOFFICE365_HTTP_401_STATUS_CODE, + MSGOFFICE365_INVALID_CLIENT_ID_ERROR_CODE, + MSGOFFICE365_INVALID_TENANT_ID_FORMAT_ERROR_CODE, + MSGOFFICE365_INVALID_TENANT_ID_NOT_FOUND_ERROR_CODE, +] # Constants relating to '_get_error_message_from_exception' @@ -61,9 +73,7 @@ # Constants relating to 'validate_integer' MSGOFFICE365_VALID_INT_MSG = "Please provide a valid integer value in the {param} parameter" -MSGOFFICE365_NON_NEG_NON_ZERO_INT_MSG = ( - "Please provide a valid non-zero positive integer value in the {param} parameter" -) +MSGOFFICE365_NON_NEG_NON_ZERO_INT_MSG = "Please provide a valid non-zero positive integer value in the {param} parameter" AUTH_FAILURE_MSG = [ "token is invalid", "Access token has expired", @@ -71,7 +81,7 @@ "AuthenticationFailed", "TokenExpired", "InvalidAuthenticationToken", - "Lifetime validation failed, the token is expired." + "Lifetime validation failed, the token is expired.", ] MSGOFFICE365_NON_NEG_INT_MSG = "Please provide a valid non-negative integer value in the {param} parameter" MSGOFFICE365_ENCRYPTION_ERROR = "Error occurred while encrypting the state file" @@ -111,5 +121,5 @@ "toRecipients", "uniqueBody", "webLink", - "internetMessageId" + "internetMessageId", ] diff --git a/process_email.py b/process_email.py index 2de3122..616eefe 100644 --- a/process_email.py +++ b/process_email.py @@ -38,30 +38,26 @@ from office365_consts import ERROR_MSG_UNAVAILABLE -_container_common = { - "run_automation": False # Don't run any playbooks, when this artifact is added -} +_container_common = {"run_automation": False} # Don't run any playbooks, when this artifact is added -_artifact_common = { - "run_automation": False # Don't run any playbooks, when this artifact is added -} +_artifact_common = {"run_automation": False} # Don't run any playbooks, when this artifact is added FILE_EXTENSIONS = { - '.vmsn': ['os memory dump', 'vm snapshot file'], - '.vmss': ['os memory dump', 'vm suspend file'], - '.js': ['javascript'], - '.doc': ['doc'], - '.docx': ['doc'], - '.xls': ['xls'], - '.xlsx': ['xls'], + ".vmsn": ["os memory dump", "vm snapshot file"], + ".vmss": ["os memory dump", "vm suspend file"], + ".js": ["javascript"], + ".doc": ["doc"], + ".docx": ["doc"], + ".xls": ["xls"], + ".xlsx": ["xls"], } MAGIC_FORMATS = [ - (re.compile('^PE.* Windows'), ['pe file', 'hash']), - (re.compile('^MS-DOS executable'), ['pe file', 'hash']), - (re.compile('^PDF '), ['pdf']), - (re.compile('^MDMP crash'), ['process dump']), - (re.compile('^Macromedia Flash'), ['flash']), + (re.compile("^PE.* Windows"), ["pe file", "hash"]), + (re.compile("^MS-DOS executable"), ["pe file", "hash"]), + (re.compile("^PDF "), ["pdf"]), + (re.compile("^MDMP crash"), ["process dump"]), + (re.compile("^Macromedia Flash"), ["flash"]), ] MSG_DEFAULT_ARTIFACT_COUNT = 100 @@ -89,26 +85,39 @@ PROC_EMAIL_JSON_EMAIL_HEADERS = "email_headers" PROC_EMAIL_CONTENT_TYPE_MSG = "message/rfc822" -URI_REGEX = r'([Hh][Tt][Tt][Pp][Ss]?:\/\/)((?:[:@\.\-_0-9]|[^ -@\[-\`\{-\~\s]|' \ - r'[\[\(][^\s\[\]\(\)]*[\]\)])+)((?:[\/\?]+(?:[^\[\'\"\(\{\)\]\}\s]|[\[\(][^\[\]\(\)]*[\]\)])*)*)[\/]?' +URI_REGEX = ( + r"([Hh][Tt][Tt][Pp][Ss]?:\/\/)((?:[:@\.\-_0-9]|[^ -@\[-\`\{-\~\s]|" + r"[\[\(][^\s\[\]\(\)]*[\]\)])+)((?:[\/\?]+(?:[^\[\'\"\(\{\)\]\}\s]|[\[\(][^\[\]\(\)]*[\]\)])*)*)[\/]?" +) EMAIL_REGEX = r"\b[A-Z0-9._%+-]+@+[A-Z0-9.-]+\.[A-Z]{2,}\b" EMAIL_REGEX2 = r'".*"@[A-Z0-9.-]+\.[A-Z]{2,}\b' HASH_REGEX = r"\b[0-9a-fA-F]{32}\b|\b[0-9a-fA-F]{40}\b|\b[0-9a-fA-F]{64}\b" -IP_REGEX = r'\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}' -IPV6_REGEX = r'\s*((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|' -IPV6_REGEX += r'(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))' -IPV6_REGEX += (r'|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)' - r'(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|') -IPV6_REGEX += (r'(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)' - r'(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|') -IPV6_REGEX += (r'(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)' - r'(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|') -IPV6_REGEX += (r'(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)' - r'(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|') -IPV6_REGEX += (r'(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)' - r'(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|') -IPV6_REGEX += (r'(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)' - r'(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))(%.+)?\s*') +IP_REGEX = r"\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}" +IPV6_REGEX = r"\s*((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|" +IPV6_REGEX += r"(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))" +IPV6_REGEX += ( + r"|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)" r"(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|" +) +IPV6_REGEX += ( + r"(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)" + r"(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|" +) +IPV6_REGEX += ( + r"(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)" + r"(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|" +) +IPV6_REGEX += ( + r"(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)" + r"(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|" +) +IPV6_REGEX += ( + r"(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)" + r"(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|" +) +IPV6_REGEX += ( + r"(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)" + r"(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))(%.+)?\s*" +) uri_regexc = re.compile(URI_REGEX) @@ -197,7 +206,7 @@ def is_ipv6(self, input_ip): def _debug_print(self, *args): - if self._base_connector and hasattr(self._base_connector, 'debug_print'): + if self._base_connector and hasattr(self._base_connector, "debug_print"): self._base_connector.debug_print(*args) return @@ -211,22 +220,20 @@ def _get_string(self, input_str, charset): input_str = str(make_header(decode_header(input_str))) except Exception: input_str = self._decode_uni_string(input_str, input_str) - self._debug_print( - "Error occurred while converting to string with specific encoding {}".format(input_str) - ) + self._debug_print("Error occurred while converting to string with specific encoding {}".format(input_str)) return input_str def _clean_url(self, url): - url = url.strip('\r\n') + url = url.strip("\r\n") # Check before splicing, find returns -1 if not found # _and_ you will end up splicing on -1 (incorrectly) - if '<' in url: - url = url[:url.find('<')] + if "<" in url: + url = url[: url.find("<")] - if '>' in url: - url = url[:url.find('>')] + if ">" in url: + url = url[: url.find(">")] return url.strip() @@ -242,7 +249,7 @@ def _extract_urls_domains(self, file_data, urls, domains, parent_id=None): emails.extend(re.findall(email_regexc2, file_data)) for curr_email in emails: - domain = curr_email[curr_email.rfind('@') + 1:] + domain = curr_email[curr_email.rfind("@") + 1 :] if domain and (not ph_utils.is_ip(domain)): extracted_domains.add(domain) @@ -268,16 +275,16 @@ def _extract_urls_domains(self, file_data, urls, domains, parent_id=None): # in the email uri_text.append(self._clean_url(link.get_text())) # it's html, so get all the urls - if not link['href'].startswith('mailto:'): - uris.append(link['href']) + if not link["href"].startswith("mailto:"): + uris.append(link["href"]) for src in srcs: uri_text.append(self._clean_url(src.get_text())) # it's html, so get all the urls - uris.append(src['src']) + uris.append(src["src"]) if uri_text: - uri_text = [x for x in uri_text if x.startswith('http')] + uri_text = [x for x in uri_text if x.startswith("http")] if uri_text: uris.extend(uri_text) @@ -291,7 +298,7 @@ def _extract_urls_domains(self, file_data, urls, domains, parent_id=None): unique_uris = set(uris) # Validate the uris - validate_uri = URLValidator(schemes=['http', 'https']) + validate_uri = URLValidator(schemes=["http", "https"]) validated_uris = list() for uri in unique_uris: try: @@ -304,9 +311,9 @@ def _extract_urls_domains(self, file_data, urls, domains, parent_id=None): # add the uris to the urls for uri in validated_uris: if parent_id: - uri_dict = {'requestURL': uri, 'parentInternetMessageId': parent_id} + uri_dict = {"requestURL": uri, "parentInternetMessageId": parent_id} else: - uri_dict = {'requestURL': uri} + uri_dict = {"requestURL": uri} urls.append(uri_dict) if self._config[PROC_EMAIL_JSON_EXTRACT_DOMAINS]: @@ -316,24 +323,24 @@ def _extract_urls_domains(self, file_data, urls, domains, parent_id=None): extracted_domains.add(domain) # work on any mailto urls if present if links: - mailtos = [x['href'] for x in links if (x['href'].startswith('mailto:'))] + mailtos = [x["href"] for x in links if (x["href"].startswith("mailto:"))] for curr_email in mailtos: - domain = curr_email[curr_email.find('@') + 1:] + domain = curr_email[curr_email.find("@") + 1 :] if domain and (not self._is_ip(domain)): - if '?' in domain: - domain = domain[:domain.find('?')] + if "?" in domain: + domain = domain[: domain.find("?")] extracted_domains.add(domain) for domain in extracted_domains: if parent_id: - domains.append({'destinationDnsDomain': domain, 'parentInternetMessageId': parent_id}) + domains.append({"destinationDnsDomain": domain, "parentInternetMessageId": parent_id}) else: - domains.append({'destinationDnsDomain': domain}) + domains.append({"destinationDnsDomain": domain}) return def _sanitize_file_name(self, file_name): - return re.sub('[,"\']', '', file_name) + return re.sub("[,\"']", "", file_name) def _get_ips(self, file_data, ips, parent_id=None): @@ -359,14 +366,14 @@ def _get_ips(self, file_data, ips, parent_id=None): unique_ips = set(ips_in_mail) for ip in unique_ips: if parent_id: - ips.append({'sourceAddress': ip, 'parentInternetMessageId': parent_id}) + ips.append({"sourceAddress": ip, "parentInternetMessageId": parent_id}) else: - ips.append({'sourceAddress': ip}) + ips.append({"sourceAddress": ip}) def _sanitize_dict(self, obj): if isinstance(obj, str): - return obj.replace('\x00', '') + return obj.replace("\x00", "") if isinstance(obj, list): return [self._sanitize_dict(item) for item in obj] if isinstance(obj, set): @@ -386,19 +393,19 @@ def _extract_hashes(self, file_data, hashes, parent_id=None): unique_hashes = set(hashs_in_mail) for hash in unique_hashes: if parent_id: - hashes.append({'fileHash': hash, 'parentInternetMessageId': parent_id}) + hashes.append({"fileHash": hash, "parentInternetMessageId": parent_id}) else: - hashes.append({'fileHash': hash}) + hashes.append({"fileHash": hash}) def _handle_body(self, body, parsed_mail, body_index, email_id): - local_file_path = body['file_path'] - charset = body.get('charset') + local_file_path = body["file_path"] + charset = body.get("charset") parent_id = None - if 'True' in local_file_path: - for item in parsed_mail['email_headers']: - parent_id = item['cef'].get('parentInternetMessageId') + if "True" in local_file_path: + for item in parsed_mail["email_headers"]: + parent_id = item["cef"].get("parentInternetMessageId") if parent_id: break @@ -408,10 +415,10 @@ def _handle_body(self, body, parsed_mail, body_index, email_id): domains = parsed_mail[PROC_EMAIL_JSON_DOMAINS] file_data = None - with open(local_file_path, 'rb') as f: # noqa + with open(local_file_path, "rb") as f: # noqa file_data = f.read() self._base_connector.debug_print("Reading file data using binary mode") - file_data = self._get_string(file_data, 'utf-8') + file_data = self._get_string(file_data, "utf-8") if file_data is None or len(file_data) == 0: return phantom.APP_ERROR @@ -437,10 +444,10 @@ def _add_artifacts(self, input_set, artifact_name, start_index, artifacts): artifact = {} artifact.update(_artifact_common) - artifact['source_data_identifier'] = start_index + added_artifacts - artifact['cef'] = item - artifact['name'] = artifact_name - self._debug_print('Artifact:', artifact) + artifact["source_data_identifier"] = start_index + added_artifacts + artifact["cef"] = item + artifact["name"] = artifact_name + self._debug_print("Artifact:", artifact) artifacts.append(artifact) added_artifacts += 1 @@ -449,8 +456,8 @@ def _add_artifacts(self, input_set, artifact_name, start_index, artifacts): def _parse_email_headers_as_inline(self, file_data, parsed_mail, charset, email_id): # remove the 'Forwarded Message' from the email text and parse it - p = re.compile(r'.*Forwarded Message.*\r\n(.*)', re.IGNORECASE) - email_text = p.sub(r'\1', file_data.strip()[:500]) + p = re.compile(r".*Forwarded Message.*\r\n(.*)", re.IGNORECASE) + email_text = p.sub(r"\1", file_data.strip()[:500]) mail = email.message_from_string(email_text) self._parse_email_headers(parsed_mail, mail, charset, add_email_id=email_id) @@ -461,7 +468,7 @@ def _add_email_header_artifacts(self, email_header_artifacts, start_index, artif added_artifacts = 0 for artifact in email_header_artifacts: - artifact['source_data_identifier'] = start_index + added_artifacts + artifact["source_data_identifier"] = start_index + added_artifacts artifacts.append(artifact) added_artifacts += 1 @@ -481,16 +488,16 @@ def _create_artifacts(self, parsed_mail, ingest_email=True): artifact_id = 0 # add artifacts - added_artifacts = self._add_artifacts(ips, 'IP Artifact', artifact_id, self._artifacts) + added_artifacts = self._add_artifacts(ips, "IP Artifact", artifact_id, self._artifacts) artifact_id += added_artifacts - added_artifacts = self._add_artifacts(hashes, 'Hash Artifact', artifact_id, self._artifacts) + added_artifacts = self._add_artifacts(hashes, "Hash Artifact", artifact_id, self._artifacts) artifact_id += added_artifacts - added_artifacts = self._add_artifacts(urls, 'URL Artifact', artifact_id, self._artifacts) + added_artifacts = self._add_artifacts(urls, "URL Artifact", artifact_id, self._artifacts) artifact_id += added_artifacts - added_artifacts = self._add_artifacts(domains, 'Domain Artifact', artifact_id, self._artifacts) + added_artifacts = self._add_artifacts(domains, "Domain Artifact", artifact_id, self._artifacts) artifact_id += added_artifacts if ingest_email: @@ -504,7 +511,7 @@ def _decode_uni_string(self, input_str, def_name): # try to find all the decoded strings, we could have multiple decoded strings # or a single decoded string between two normal strings separated by \r\n # YEAH...it could get that messy - encoded_strings = re.findall(r'=\?.*\?=', input_str, re.I) + encoded_strings = re.findall(r"=\?.*\?=", input_str, re.I) # return input_str as is, no need to do any conversion if not encoded_strings: @@ -513,7 +520,7 @@ def _decode_uni_string(self, input_str, def_name): # get the decoded strings try: decoded_strings = [decode_header(x)[0] for x in encoded_strings] - decoded_strings = [{'value': x[0], 'encoding': x[1]} for x in decoded_strings] + decoded_strings = [{"value": x[0], "encoding": x[1]} for x in decoded_strings] except Exception as e: error_msg = _get_error_msg_from_exception(e) self._debug_print("Decoding: {0}. {1}".format(encoded_strings, error_msg)) @@ -522,7 +529,7 @@ def _decode_uni_string(self, input_str, def_name): # convert to dict for safe access, if it's an empty list, the dict will be empty decoded_strings = dict(enumerate(decoded_strings)) - new_str = '' + new_str = "" new_str_create_count = 0 for i, encoded_string in enumerate(encoded_strings): @@ -532,8 +539,8 @@ def _decode_uni_string(self, input_str, def_name): # nothing to replace with continue - value = decoded_string.get('value') - encoding = decoded_string.get('encoding') + value = decoded_string.get("value") + encoding = decoded_string.get("encoding") if not encoding or not value: # nothing to replace with @@ -549,7 +556,7 @@ def _decode_uni_string(self, input_str, def_name): new_str_create_count += 1 except Exception: try: - if encoding != 'utf-8': + if encoding != "utf-8": value = str(value, encoding) except Exception: pass @@ -595,8 +602,8 @@ def _handle_if_body(self, content_disp, content_id, content_type, part, bodies, if content_disp is None: process_as_body = True # if content disposition is inline - elif content_disp.lower().strip() == 'inline': - if 'text/html' in content_type or 'text/plain' in content_type: + elif content_disp.lower().strip() == "inline": + if "text/html" in content_type or "text/plain" in content_type: process_as_body = True if not process_as_body: @@ -607,31 +614,31 @@ def _handle_if_body(self, content_disp, content_id, content_type, part, bodies, if not part_payload: return (phantom.APP_SUCCESS, False) - if 'text/html' in content_type and self._parsed_mail[PROC_EMAIL_JSON_EMAIL_HEADERS]: + if "text/html" in content_type and self._parsed_mail[PROC_EMAIL_JSON_EMAIL_HEADERS]: # Get Email Header Artifact email_header_artifact = self._parsed_mail[PROC_EMAIL_JSON_EMAIL_HEADERS][0] - artifact_cef = email_header_artifact['cef'] + artifact_cef = email_header_artifact["cef"] html_body = self._get_string(part_payload, charset=content_charset) - artifact_cef['bodyHtml'] = html_body + artifact_cef["bodyHtml"] = html_body try: soup = BeautifulSoup(html_body, "html.parser") # Remove the script, style, footer, title and navigation part from the HTML message for element in soup(["script", "style", "footer", "title", "nav"]): element.extract() - body_text = soup.get_text(separator=' ') - split_lines = body_text.split('\n') + body_text = soup.get_text(separator=" ") + split_lines = body_text.split("\n") split_lines = [x.strip() for x in split_lines if x.strip()] - body_text = '\n'.join(split_lines) + body_text = "\n".join(split_lines) if body_text: artifact_cef["bodyText"] = body_text except Exception: self._debug_print("Cannot parse email body text details") - with open(file_path, 'wb') as f: # noqa + with open(file_path, "wb") as f: # noqa f.write(part_payload) - bodies.append({'file_path': file_path, 'charset': part.get_content_charset()}) + bodies.append({"file_path": file_path, "charset": part.get_content_charset()}) return (phantom.APP_SUCCESS, False) @@ -649,51 +656,51 @@ def _handle_attachment(self, part, tmp_dir, file_name, file_path): attach_meta_info = dict() if headers: - attach_meta_info = {'headers': dict(headers)} + attach_meta_info = {"headers": dict(headers)} for curr_attach in self._attachments_from_msgraph: - if curr_attach.get('should_ignore', False): + if curr_attach.get("should_ignore", False): continue try: - attach_content = curr_attach['content'] + attach_content = curr_attach["content"] except Exception: continue - if attach_content.strip().replace('\r\n', '') == part_base64_encoded.strip().replace('\r\n', ''): + if attach_content.strip().replace("\r\n", "") == part_base64_encoded.strip().replace("\r\n", ""): attach_meta_info.update(dict(curr_attach)) - del attach_meta_info['content'] - curr_attach['should_ignore'] = True + del attach_meta_info["content"] + curr_attach["should_ignore"] = True part_payload = part.get_payload(decode=True) if not part_payload: return phantom.APP_SUCCESS try: - with open(file_path, 'wb') as f: # noqa + with open(file_path, "wb") as f: # noqa f.write(part_payload) - files.append({'file_name': file_name, 'file_path': file_path, 'meta_info': attach_meta_info}) + files.append({"file_name": file_name, "file_path": file_path, "meta_info": attach_meta_info}) except IOError as ioerr: error_msg = _get_error_msg_from_exception(ioerr) if "File name too long" in error_msg: self.write_with_new_filename(part_payload, files, file_name, as_byte=False) else: - self._debug_print('Failed to write file: {}'.format(ioerr)) + self._debug_print("Failed to write file: {}".format(ioerr)) def write_with_new_filename(self, data, dict_to_fill, file_name, as_byte=False): try: fd, full_path = tempfile.mkstemp(dir=Vault.get_vault_tmp_dir()) os.close(fd) - with open(full_path, 'wb') as f: # noqa + with open(full_path, "wb") as f: # noqa if as_byte: f.write(data.as_bytes()) else: f.write(data) - dict_to_fill.append({'file_name': file_name, 'file_path': full_path}) + dict_to_fill.append({"file_name": file_name, "file_path": full_path}) except Exception as e: - self._base_connector.debug_print('Exception while writing file: {}'.format(e)) + self._base_connector.debug_print("Exception while writing file: {}".format(e)) def _handle_part(self, part, part_index, tmp_dir, extract_attach, parsed_mail, child=False): @@ -701,9 +708,9 @@ def _handle_part(self, part, part_index, tmp_dir, extract_attach, parsed_mail, c # get the file_name file_name = part.get_filename() - content_disp = part.get('Content-Disposition') - content_type = part.get('Content-Type') - content_id = part.get('Content-ID') + content_disp = part.get("Content-Disposition") + content_type = part.get("Content-Type") + content_id = part.get("Content-ID") if file_name is None: # init name and extension to default values @@ -712,7 +719,7 @@ def _handle_part(self, part, part_index, tmp_dir, extract_attach, parsed_mail, c # Try to create an extension from the content type if possible if content_type is not None: - extension = mimetypes.guess_extension(re.sub(';.*', '', content_type)) + extension = mimetypes.guess_extension(re.sub(";.*", "", content_type)) # Try to create a name from the content id if possible if content_id is not None: @@ -723,7 +730,7 @@ def _handle_part(self, part, part_index, tmp_dir, extract_attach, parsed_mail, c file_name = self._sanitize_file_name(self._decode_uni_string(file_name, file_name)) # Remove any chars that we don't want in the name - file_path = "{0}/{1}_{2}_{3}".format(tmp_dir, part_index, file_name.replace('<', '').replace('>', '').replace(' ', ''), child) + file_path = "{0}/{1}_{2}_{3}".format(tmp_dir, part_index, file_name.replace("<", "").replace(">", "").replace(" ", ""), child) self._debug_print("file_path: {0}".format(file_path)) @@ -755,7 +762,7 @@ def _update_headers(self, headers): headers_ci = CaseInsensitiveDict(headers) for curr_header_lower in self._headers_from_ews: - if headers_ci.get('message-id', 'default_value1').strip() == curr_header_lower.get('message-id', 'default_value2').strip(): + if headers_ci.get("message-id", "default_value1").strip() == curr_header_lower.get("message-id", "default_value2").strip(): # the headers match with the one that we got from the ews API, so update it headers.update(curr_header_lower) @@ -770,7 +777,7 @@ def _get_email_headers_from_part(self, part, charset=None): charset = part.get_content_charset() if charset is None: - charset = 'utf8' + charset = "utf8" if not email_headers: return {} @@ -787,20 +794,20 @@ def _get_email_headers_from_part(self, part, charset=None): # Handle received seperately received_headers = list() try: - received_headers = [self._get_string(x[1], charset) for x in email_headers if x[0].lower() == 'received'] + received_headers = [self._get_string(x[1], charset) for x in email_headers if x[0].lower() == "received"] except Exception as e: error_msg = _get_error_msg_from_exception(e) err = "Error occurred while handling the received header tuple separately" self._debug_print("{}. {}".format(err, error_msg)) if received_headers: - headers['Received'] = received_headers + headers["Received"] = received_headers # handle the subject string, if required add a new key - subject = headers.get('Subject') + subject = headers.get("Subject") if subject: - if type(subject) == str: - headers['decodedSubject'] = self._decode_uni_string(subject, subject) + if isinstance(subject, str): + headers["decodedSubject"] = self._decode_uni_string(subject, subject) return headers @@ -817,40 +824,40 @@ def _parse_email_headers(self, parsed_mail, part, charset=None, add_email_id=Non cef_artifact = {} cef_types = {} - if headers.get('From'): - emails = headers['From'] + if headers.get("From"): + emails = headers["From"] if emails: - cef_artifact.update({'fromEmail': emails}) + cef_artifact.update({"fromEmail": emails}) - if headers.get('To'): - emails = headers['To'] + if headers.get("To"): + emails = headers["To"] if emails: - cef_artifact.update({'toEmail': emails}) + cef_artifact.update({"toEmail": emails}) # if the header did not contain any email addresses then ignore this artifact - message_id = headers.get('message-id') + message_id = headers.get("message-id") if not cef_artifact and message_id is None: return 0 - cef_types.update({'fromEmail': ['email'], 'toEmail': ['email']}) + cef_types.update({"fromEmail": ["email"], "toEmail": ["email"]}) if headers: self._update_headers(headers) - cef_artifact['emailHeaders'] = dict(headers) + cef_artifact["emailHeaders"] = dict(headers) - for curr_key in list(cef_artifact['emailHeaders'].keys()): - if curr_key.lower().startswith('body'): - curr_value = cef_artifact['emailHeaders'].pop(curr_key) + for curr_key in list(cef_artifact["emailHeaders"].keys()): + if curr_key.lower().startswith("body"): + curr_value = cef_artifact["emailHeaders"].pop(curr_key) if self._config.get(PROC_EMAIL_JSON_EXTRACT_BODY, False): cef_artifact.update({curr_key: curr_value}) - elif curr_key == 'parentInternetMessageId': - curr_value = cef_artifact['emailHeaders'].pop(curr_key) + elif curr_key == "parentInternetMessageId": + curr_value = cef_artifact["emailHeaders"].pop(curr_key) cef_artifact.update({curr_key: curr_value}) - elif curr_key == 'parentGuid': - curr_value = cef_artifact['emailHeaders'].pop(curr_key) + elif curr_key == "parentGuid": + curr_value = cef_artifact["emailHeaders"].pop(curr_key) cef_artifact.update({curr_key: curr_value}) - elif curr_key == 'emailGuid': - curr_value = cef_artifact['emailHeaders'].pop(curr_key) + elif curr_key == "emailGuid": + curr_value = cef_artifact["emailHeaders"].pop(curr_key) cef_artifact.update({curr_key: curr_value}) # Adding the email id as a cef artifact crashes the UI when trying to show the action dialog box @@ -858,17 +865,17 @@ def _parse_email_headers(self, parsed_mail, part, charset=None, add_email_id=Non # from adding the emailId # add_email_id = False if add_email_id: - cef_artifact['emailId'] = add_email_id + cef_artifact["emailId"] = add_email_id if self._email_id_contains: - cef_types.update({'emailId': self._email_id_contains}) + cef_types.update({"emailId": self._email_id_contains}) artifact = {} artifact.update(_artifact_common) - artifact['name'] = 'Email Artifact' - artifact['label'] = 'email' - artifact['severity'] = self._base_connector.get_config().get('container_severity', 'medium') - artifact['cef'] = cef_artifact - artifact['cef_types'] = cef_types + artifact["name"] = "Email Artifact" + artifact["label"] = "email" + artifact["severity"] = self._base_connector.get_config().get("container_severity", "medium") + artifact["cef"] = cef_artifact + artifact["cef_types"] = cef_types email_header_artifacts.append(artifact) return len(email_header_artifacts) @@ -886,14 +893,14 @@ def _handle_mail_object(self, mail, email_id, rfc822_email, tmp_dir, start_time_ charset = mail.get_content_charset() if charset is None: - charset = 'utf-8' + charset = "utf-8" # Extract fields and place it in a dictionary - self._parsed_mail[PROC_EMAIL_JSON_SUBJECT] = mail.get('Subject', '') - self._parsed_mail[PROC_EMAIL_JSON_FROM] = mail.get('From', '') - self._parsed_mail[PROC_EMAIL_JSON_TO] = mail.get('To', '') - self._parsed_mail[PROC_EMAIL_JSON_DATE] = mail.get('Date', '') - self._parsed_mail[PROC_EMAIL_JSON_MSG_ID] = mail.get('Message-ID', '') + self._parsed_mail[PROC_EMAIL_JSON_SUBJECT] = mail.get("Subject", "") + self._parsed_mail[PROC_EMAIL_JSON_FROM] = mail.get("From", "") + self._parsed_mail[PROC_EMAIL_JSON_TO] = mail.get("To", "") + self._parsed_mail[PROC_EMAIL_JSON_DATE] = mail.get("Date", "") + self._parsed_mail[PROC_EMAIL_JSON_MSG_ID] = mail.get("Message-ID", "") self._parsed_mail[PROC_EMAIL_JSON_FILES] = files = [] self._parsed_mail[PROC_EMAIL_JSON_BODIES] = bodies = [] self._parsed_mail[PROC_EMAIL_JSON_START_TIME] = start_time_epoch @@ -909,10 +916,10 @@ def _handle_mail_object(self, mail, email_id, rfc822_email, tmp_dir, start_time_ add_email_id = email_id self._parse_email_headers(self._parsed_mail, part, add_email_id=add_email_id) - if message_id is None and part.get('Message-ID'): - message_id = part.get('Message-ID') + if message_id is None and part.get("Message-ID"): + message_id = part.get("Message-ID") child = False - elif message_id and part.get('Message-ID'): + elif message_id and part.get("Message-ID"): child = True self._debug_print("part: {0}".format(part.__dict__)) @@ -931,9 +938,9 @@ def _handle_mail_object(self, mail, email_id, rfc822_email, tmp_dir, start_time_ else: self._parse_email_headers(self._parsed_mail, mail, add_email_id=email_id) file_path = "{0}/part_1.text".format(tmp_dir) - with open(file_path, 'wb') as f: # noqa + with open(file_path, "wb") as f: # noqa f.write(mail.get_payload(decode=True)) - bodies.append({'file_path': file_path, 'charset': mail.get_content_charset()}) + bodies.append({"file_path": file_path, "charset": mail.get_content_charset()}) # get the container name container_name = self._get_container_name(self._parsed_mail, email_id) @@ -947,11 +954,11 @@ def _handle_mail_object(self, mail, email_id, rfc822_email, tmp_dir, start_time_ container_data = dict(self._parsed_mail) # delete the header info, we dont make it a part of the container json - del(container_data[PROC_EMAIL_JSON_EMAIL_HEADERS]) + del container_data[PROC_EMAIL_JSON_EMAIL_HEADERS] container.update(_container_common) - self._container['source_data_identifier'] = email_id - self._container['name'] = container_name - self._container['data'] = {'raw_email': rfc822_email} + self._container["source_data_identifier"] = email_id + self._container["name"] = container_name + self._container["data"] = {"raw_email": rfc822_email} # Create the sets before handling the bodies If both the bodies add the same ip # only one artifact should be created @@ -986,7 +993,7 @@ def _set_email_id_contains(self, email_id): return try: - email_id = self._get_string(email_id, 'utf-8') + email_id = self._get_string(email_id, "utf-8") except Exception: email_id = str(email_id) @@ -1002,7 +1009,7 @@ def _int_process_email(self, rfc822_email, email_id, start_time_epoch, ingest_em ret_val = phantom.APP_SUCCESS - tmp_dir = tempfile.mkdtemp(prefix='ph_email_phmsgo365') + tmp_dir = tempfile.mkdtemp(prefix="ph_email_phmsgo365") self._tmp_dirs.append(tmp_dir) try: @@ -1012,7 +1019,7 @@ def _int_process_email(self, rfc822_email, email_id, start_time_epoch, ingest_em self._debug_print(msg) return (phantom.APP_ERROR, msg, []) - results = [{'container': self._container, 'artifacts': self._artifacts, 'files': self._attachments, 'temp_directory': tmp_dir}] + results = [{"container": self._container, "artifacts": self._artifacts, "files": self._attachments, "temp_directory": tmp_dir}] return (ret_val, "Email Parsed", results) @@ -1048,26 +1055,17 @@ def process_email(self, rfc822_email, email_id, epoch, container_id=None, email_ def _save_ingested(self, container, using_dummy): if using_dummy: - cid = container['id'] - artifacts = container['artifacts'] + cid = container["id"] + artifacts = container["artifacts"] for artifact in artifacts: - artifact['container_id'] = cid + artifact["container_id"] = cid ret_val, msg, ids = self._base_connector.save_artifacts(artifacts) - self._base_connector.debug_print( - "save_artifacts returns, value: {0}, reason: {1}".format( - ret_val, - msg - ) - ) + self._base_connector.debug_print("save_artifacts returns, value: {0}, reason: {1}".format(ret_val, msg)) else: ret_val, msg, cid = self._base_connector.save_container(container) self._base_connector.debug_print( - "save_container (with artifacts) returns, value: {0}, reason: {1}, id: {2}".format( - ret_val, - msg, - cid - ) + "save_container (with artifacts) returns, value: {0}, reason: {1}, id: {2}".format(ret_val, msg, cid) ) return ret_val, msg, cid @@ -1080,25 +1078,25 @@ def _handle_save_ingested(self, artifacts, container, container_id, files): # We are adding artifacts to an existing container using_dummy = True container = { - 'name': 'Dummy Container', - 'dummy': True, - 'id': container_id, - 'artifacts': artifacts, + "name": "Dummy Container", + "dummy": True, + "id": container_id, + "artifacts": artifacts, } else: # Create a new container - container['artifacts'] = artifacts + container["artifacts"] = artifacts - if hasattr(self._base_connector, '_preprocess_container'): + if hasattr(self._base_connector, "_preprocess_container"): container = self._base_connector._preprocess_container(container) - for artifact in list([x for x in container.get('artifacts', []) if not x.get('source_data_identifier')]): + for artifact in list([x for x in container.get("artifacts", []) if not x.get("source_data_identifier")]): self._set_sdi(artifact) - if files and container.get('artifacts'): + if files and container.get("artifacts"): # Make sure the playbook only runs once # We will instead set run_automation on the last vault artifact which is added - container['artifacts'][-1]['run_automation'] = False + container["artifacts"][-1]["run_automation"] = False ret_val, msg, container_id = self._save_ingested(container, using_dummy) @@ -1117,9 +1115,7 @@ def _handle_save_ingested(self, artifacts, container, container_id, files): last_file = len(files) - 1 for i, curr_file in enumerate(files): run_automation = self._trigger_automation if i == last_file else False - ret_val, added_to_vault = self._handle_file( - curr_file, container_id, run_automation - ) + ret_val, added_to_vault = self._handle_file(curr_file, container_id, run_automation) if added_to_vault: vault_artifacts_added += 1 @@ -1141,7 +1137,7 @@ def _parse_results(self, results, container_id=None): if container_id is None: - container = result.get('container') + container = result.get("container") if not container: continue @@ -1152,7 +1148,7 @@ def _parse_results(self, results, container_id=None): container = None # run a loop to first set the sdi which will create the hash - artifacts = result.get('artifacts', []) + artifacts = result.get("artifacts", []) for j, artifact in enumerate(artifacts): if not artifact: @@ -1173,20 +1169,20 @@ def _parse_results(self, results, container_id=None): # if it is the last artifact of the last container if (j + 1) == len_artifacts: # mark it such that active playbooks get executed if trigger automation is set to True - artifact['run_automation'] = self._trigger_automation + artifact["run_automation"] = self._trigger_automation - cef_artifact = artifact.get('cef') - if 'parentGuid' in cef_artifact: - parent_guid = cef_artifact.pop('parentGuid') + cef_artifact = artifact.get("cef") + if "parentGuid" in cef_artifact: + parent_guid = cef_artifact.pop("parentGuid") if parent_guid in self._guid_to_hash: - cef_artifact['parentSourceDataIdentifier'] = self._guid_to_hash[parent_guid] - if 'emailGuid' in cef_artifact: - del cef_artifact['emailGuid'] + cef_artifact["parentSourceDataIdentifier"] = self._guid_to_hash[parent_guid] + if "emailGuid" in cef_artifact: + del cef_artifact["emailGuid"] - self._handle_save_ingested(artifacts, container, container_id, result.get('files')) + self._handle_save_ingested(artifacts, container, container_id, result.get("files")) # delete any temp directories that were created by the email parsing function - [shutil.rmtree(x['temp_directory'], ignore_errors=True) for x in results if x.get('temp_directory')] + [shutil.rmtree(x["temp_directory"], ignore_errors=True) for x in results if x.get("temp_directory")] return self._base_connector.set_status(phantom.APP_SUCCESS) @@ -1201,22 +1197,22 @@ def _add_vault_hashes_to_dictionary(self, cef_artifact, vault_id): # matching the vault id, the info that we are looking for (the hashes) # will be the same for every entry, so just access the first one try: - metadata = vault_info[0].get('metadata') + metadata = vault_info[0].get("metadata") except Exception: return (phantom.APP_ERROR, "Failed to get vault item metadata") try: - cef_artifact['fileHashSha256'] = metadata['sha256'] + cef_artifact["fileHashSha256"] = metadata["sha256"] except Exception: pass try: - cef_artifact['fileHashMd5'] = metadata['md5'] + cef_artifact["fileHashMd5"] = metadata["md5"] except Exception: pass try: - cef_artifact['fileHashSha1'] = metadata['sha1'] + cef_artifact["fileHashSha1"] = metadata["sha1"] except Exception: pass @@ -1224,9 +1220,9 @@ def _add_vault_hashes_to_dictionary(self, cef_artifact, vault_id): def _handle_file(self, curr_file, container_id, run_automation=False): - file_name = curr_file.get('file_name') + file_name = curr_file.get("file_name") - local_file_path = curr_file['file_path'] + local_file_path = curr_file["file_path"] contains = self._get_file_contains(local_file_path) @@ -1249,10 +1245,7 @@ def _handle_file(self, curr_file, container_id, run_automation=False): try: vault_add_success, vault_add_msg, vault_id = phantom_rules.vault_add( - file_location=local_file_path, - container=container_id, - file_name=file_name, - metadata=vault_attach_dict + file_location=local_file_path, container=container_id, file_name=file_name, metadata=vault_attach_dict ) except Exception as e: self._debug_print(phantom.APP_ERR_FILE_ADD_TO_VAULT.format(e)) @@ -1263,12 +1256,12 @@ def _handle_file(self, curr_file, container_id, run_automation=False): return (phantom.APP_ERROR, phantom.APP_ERROR) # add the vault id artifact to the container - cef_artifact = curr_file.get('meta_info', {}) + cef_artifact = curr_file.get("meta_info", {}) if file_name: - cef_artifact.update({'fileName': file_name}) + cef_artifact.update({"fileName": file_name}) if vault_id: - cef_artifact.update({'vaultId': vault_id}) + cef_artifact.update({"vaultId": vault_id}) # now get the rest of the hashes and add them to the cef artifact self._add_vault_hashes_to_dictionary(cef_artifact, vault_id) @@ -1278,17 +1271,17 @@ def _handle_file(self, curr_file, container_id, run_automation=False): artifact = {} artifact.update(_artifact_common) - artifact['container_id'] = container_id - artifact['name'] = 'Vault Artifact' - artifact['cef'] = cef_artifact - artifact['run_automation'] = run_automation + artifact["container_id"] = container_id + artifact["name"] = "Vault Artifact" + artifact["cef"] = cef_artifact + artifact["run_automation"] = run_automation if contains: - artifact['cef_types'] = {'vaultId': contains} + artifact["cef_types"] = {"vaultId": contains} self._set_sdi(artifact) - if 'parentGuid' in cef_artifact: - parent_guid = cef_artifact.pop('parentGuid') - cef_artifact['parentSourceDataIdentifier'] = self._guid_to_hash[parent_guid] + if "parentGuid" in cef_artifact: + parent_guid = cef_artifact.pop("parentGuid") + cef_artifact["parentSourceDataIdentifier"] = self._guid_to_hash[parent_guid] ret_val, status_string, artifact_id = self._base_connector.save_artifact(artifact) self._base_connector.debug_print("save_artifact returns, value: {0}, reason: {1}, id: {2}".format(ret_val, status_string, artifact_id)) @@ -1297,30 +1290,30 @@ def _handle_file(self, curr_file, container_id, run_automation=False): def _set_sdi(self, input_dict): - if 'source_data_identifier' in input_dict: - del input_dict['source_data_identifier'] + if "source_data_identifier" in input_dict: + del input_dict["source_data_identifier"] input_dict_hash = input_dict - cef = input_dict.get('cef') + cef = input_dict.get("cef") curr_email_guid = None if cef is not None: - if 'parentGuid' in cef or 'emailGuid' in cef: + if "parentGuid" in cef or "emailGuid" in cef: # make a copy since the dictionary will have to be different input_dict_hash = deepcopy(input_dict) - cef = input_dict_hash['cef'] - if 'parentGuid' in cef: - del cef['parentGuid'] - curr_email_guid = cef.get('emailGuid') + cef = input_dict_hash["cef"] + if "parentGuid" in cef: + del cef["parentGuid"] + curr_email_guid = cef.get("emailGuid") if curr_email_guid is not None: - del cef['emailGuid'] + del cef["emailGuid"] - input_dict['source_data_identifier'] = self._create_dict_hash(input_dict_hash) + input_dict["source_data_identifier"] = self._create_dict_hash(input_dict_hash) if curr_email_guid: - self._guid_to_hash[curr_email_guid] = input_dict['source_data_identifier'] + self._guid_to_hash[curr_email_guid] = input_dict["source_data_identifier"] return phantom.APP_SUCCESS @@ -1334,14 +1327,14 @@ def _create_dict_hash(self, input_dict): try: input_dict_str = json.dumps(input_dict, sort_keys=True) except Exception as e: - self._base_connector.debug_print('Handled exception in _create_dict_hash', e) + self._base_connector.debug_print("Handled exception in _create_dict_hash", e) return None fips_enabled = self._base_connector._get_fips_enabled() if not fips_enabled: - return hashlib.md5(UnicodeDammit(input_dict_str).unicode_markup.encode('utf-8')).hexdigest() # nosemgrep + return hashlib.md5(UnicodeDammit(input_dict_str).unicode_markup.encode("utf-8")).hexdigest() # nosemgrep - return hashlib.sha256(UnicodeDammit(input_dict_str).unicode_markup.encode('utf-8')).hexdigest() + return hashlib.sha256(UnicodeDammit(input_dict_str).unicode_markup.encode("utf-8")).hexdigest() def _del_tmp_dirs(self): """Remove any tmp_dirs that were created.""" diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..474efd9 --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,7 @@ +[tool.black] +line-length = 145 +target-version = ['py39'] +verbose = true + +[tool.isort] +line_length = 145 diff --git a/requirements.txt b/requirements.txt index d9e3a42..4266143 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,2 +1 @@ -beautifulsoup4==4.9.1 python-magic==0.4.18 diff --git a/tox.ini b/tox.ini index c4644ad..2b96e78 100644 --- a/tox.ini +++ b/tox.ini @@ -1,7 +1,7 @@ [flake8] max-line-length = 145 max-complexity = 28 -extend-ignore = F403,E128,E126,E111,E121,E127,E731,E201,E202,F405,E722,D,W292 +extend-ignore = F403,E128,E126,E121,E127,E731,E201,E202,E203,E701,F405,E722,D [isort] line_length = 145 diff --git a/wheels/py3/beautifulsoup4-4.9.1-py3-none-any.whl b/wheels/py3/beautifulsoup4-4.9.1-py3-none-any.whl deleted file mode 100644 index 080b2f8e9aa9d8260006d2d3af7032cb80b8fe55..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 115057 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�d8Z>VA$SSD`!IazspFSoo*7Y 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

&;-`LY;~ewDDVP@KoY2& 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≶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 xe@vCk(Ku)9~-IUbC^$OTQraK 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 diff --git a/wheels/py3/soupsieve-2.5-py3-none-any.whl b/wheels/py3/soupsieve-2.5-py3-none-any.whl deleted file mode 100644 index e1be1281914864efacd06642fbf27970213ee2b2..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 36131 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 Date: Tue, 1 Oct 2024 16:38:52 +0200 Subject: [PATCH 24/40] PAPP-34619 | resolve_name action first iteration --- office365.json | 52 ++++++++++++++++++++++++++++++++++++++++++ office365_connector.py | 37 ++++++++++++++++++++++++++++++ 2 files changed, 89 insertions(+) diff --git a/office365.json b/office365.json index db3a7d0..fcf0ee5 100644 --- a/office365.json +++ b/office365.json @@ -7672,6 +7672,58 @@ "type": "table" }, "versions": "EQ(*)" + }, + { + "action": "resolve name", + "identifier": "resolve_name", + "description": "Verify aliases and resolve display names to the appropriate mailbox user.", + "verbose": "Resolve an Alias name or email address, into mailboxes.", + "type": "investigate", + "read_only": true, + "parameters": { + "email": { + "description": "Name to resolve", + "data_type": "string", + "required": true, + "primary": true, + "contains": [], + "value_list": [], + "default": "", + "order": 0, + "name": "email" + } + }, + "output": [ + { + "data_path": "action_result.parameter.email", + "data_type": "string", + "contains": [], + "column_name": "email", + "column_order": 0 + }, + { + "data_path": "action_result.status", + "data_type": "string", + "column_name": "status", + "column_order": 1 + }, + { + "data_path": "action_result.message", + "data_type": "string" + }, + { + "data_path": "summary.total_objects", + "data_type": "numeric" + }, + { + "data_path": "summary.total_objects_successful", + "data_type": "numeric" + } + ], + "render": { + "type": "table" + }, + "versions": "EQ(*)" } ], "pip_dependencies": { diff --git a/office365_connector.py b/office365_connector.py index fae6b0b..041252e 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3023,6 +3023,40 @@ def _handle_unblock_sender(self, param): action_result.add_data(response) return action_result.set_status(phantom.APP_SUCCESS) + def _handle_resolve_name(self, param): + self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) + action_result = self.add_action_result(ActionResult(dict(param))) + + email = param["email"] + + endpoint = f"/users?$filter=startswith(displayName,'{email}') or startswith(mail,'{email}')" + endpoint_other_mails = f"{endpoint}&$select=mail,mailNickname,proxyAddresses,otherMails" + endpoint_other_address = f"{endpoint}&$select=city,state,street,postalCode" + + ret_val, response = self._make_rest_call_helper(action_result, endpoint) + ret_val_proxy, response_proxy = self._make_rest_call_helper(action_result, endpoint_other_mails) + ret_val_address, response_address = self._make_rest_call_helper(action_result, endpoint_other_address) + + endpoint_mailbox = f"/users/{response.get('value')[0].get('id')}/mailboxSettings" + ret_val_mailbox, response_mailbox = self._make_rest_call_helper(action_result, endpoint_mailbox) + + self.save_progress(f"{ret_val} Got response {response}") + self.save_progress(f"{ret_val_proxy} Got response other mails {response_proxy}") + self.save_progress(f"{ret_val_address} Got response address {response_address}") + self.save_progress(f"{ret_val_mailbox} Got response mailbox {response_mailbox}") + + if phantom.is_fail(ret_val): + return action_result.set_status(phantom.APP_ERROR, "Got invalid ret val") + + action_result.add_data(response) + action_result.add_data(response_proxy) + action_result.add_data(response_address) + action_result.add_data(response_mailbox) + + # summary = action_result.update_summary({}) + # summary['num_data'] = len(action_result['data']) + return action_result.set_status(phantom.APP_SUCCESS) + def handle_action(self, param): ret_val = phantom.APP_SUCCESS @@ -3032,6 +3066,9 @@ def handle_action(self, param): self.debug_print("action_id", self.get_action_identifier()) + if action_id == "resolve_name": + ret_val = self._handle_resolve_name(param) + if action_id == "block_sender": ret_val = self._handle_block_sender(param) From 1d3810cb7b768a206ae1918b20efc2a3a286be6d Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Tue, 1 Oct 2024 14:39:26 +0000 Subject: [PATCH 25/40] Update README.md --- README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/README.md b/README.md index b2b7f49..c86b751 100644 --- a/README.md +++ b/README.md @@ -353,6 +353,7 @@ VARIABLE | REQUIRED | TYPE | DESCRIPTION [update email](#action-update-email) - Update an email on the server [block sender](#action-block-sender) - Add the sender email into the block list [unblock sender](#action-unblock-sender) - Remove the sender email from the block list +[resolve name](#action-resolve-name) - Verify aliases and resolve display names to the appropriate mailbox user. ## action: 'test connectivity' Use supplied credentials to generate a token with MS Graph @@ -1636,4 +1637,26 @@ action_result.parameter.user_id | boolean | | action_result.status | string | | action_result.message | string | | summary.total_objects | numeric | | +summary.total_objects_successful | numeric | | + +## action: 'resolve name' +Verify aliases and resolve display names to the appropriate mailbox user. + +Type: **investigate** +Read only: **True** + +Resolve an Alias name or email address, into mailboxes. + +#### Action Parameters +PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS +--------- | -------- | ----------- | ---- | -------- +**email** | required | Name to resolve | string | + +#### Action Output +DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES +--------- | ---- | -------- | -------------- +action_result.parameter.email | string | | +action_result.status | string | | +action_result.message | string | | +summary.total_objects | numeric | | summary.total_objects_successful | numeric | | \ No newline at end of file From b9e538a38c5a9eb6b810747a7672d66c0cd7aa79 Mon Sep 17 00:00:00 2001 From: kczernik Date: Wed, 2 Oct 2024 17:36:11 +0200 Subject: [PATCH 26/40] PAPP-34619 | resolve_name | cleaned up | prepared for multiple responses --- office365_connector.py | 36 +++++++++++++++++++----------------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/office365_connector.py b/office365_connector.py index 041252e..359b015 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3027,31 +3027,33 @@ def _handle_resolve_name(self, param): self.save_progress("In action handler for: {0}".format(self.get_action_identifier())) action_result = self.add_action_result(ActionResult(dict(param))) + # id or userPrincipalName email = param["email"] endpoint = f"/users?$filter=startswith(displayName,'{email}') or startswith(mail,'{email}')" - endpoint_other_mails = f"{endpoint}&$select=mail,mailNickname,proxyAddresses,otherMails" - endpoint_other_address = f"{endpoint}&$select=city,state,street,postalCode" + ret_val, responses = self._make_rest_call_helper(action_result, endpoint) - ret_val, response = self._make_rest_call_helper(action_result, endpoint) - ret_val_proxy, response_proxy = self._make_rest_call_helper(action_result, endpoint_other_mails) - ret_val_address, response_address = self._make_rest_call_helper(action_result, endpoint_other_address) + if phantom.is_fail(ret_val): + return action_result.set_status(phantom.APP_ERROR, "Got invalid ret val") - endpoint_mailbox = f"/users/{response.get('value')[0].get('id')}/mailboxSettings" - ret_val_mailbox, response_mailbox = self._make_rest_call_helper(action_result, endpoint_mailbox) + for response in responses.get("value"): - self.save_progress(f"{ret_val} Got response {response}") - self.save_progress(f"{ret_val_proxy} Got response other mails {response_proxy}") - self.save_progress(f"{ret_val_address} Got response address {response_address}") - self.save_progress(f"{ret_val_mailbox} Got response mailbox {response_mailbox}") + user_id = response.get("id") - if phantom.is_fail(ret_val): - return action_result.set_status(phantom.APP_ERROR, "Got invalid ret val") + endpoint_other_mails = f"/users/{user_id}?$select=mailNickname,proxyAddresses,otherMails" + endpoint_other_address = f"/users/{user_id}?$select=city,state,street,postalCode" + endpoint_mailbox = f"/users/{user_id}/mailboxSettings" - action_result.add_data(response) - action_result.add_data(response_proxy) - action_result.add_data(response_address) - action_result.add_data(response_mailbox) + ret_val_proxy, response_proxy = self._make_rest_call_helper(action_result, endpoint_other_mails) + ret_val_address, response_address = self._make_rest_call_helper(action_result, endpoint_other_address) + ret_val_mailbox, response_mailbox = self._make_rest_call_helper(action_result, endpoint_mailbox) + + self.save_progress(f"{ret_val} Got response {response}") + self.save_progress(f"{ret_val_proxy} Got response other mails {response_proxy}") + self.save_progress(f"{ret_val_address} Got response address {response_address}") + self.save_progress(f"{ret_val_mailbox} Got response mailbox {response_mailbox}") + + action_result.add_data(response | response_proxy | response_address | (response_mailbox or {})) # summary = action_result.update_summary({}) # summary['num_data'] = len(action_result['data']) From 78ebd00e418df3d845acad8aa5dd1984e08b7d6b Mon Sep 17 00:00:00 2001 From: kczernik Date: Mon, 7 Oct 2024 08:34:47 +0200 Subject: [PATCH 27/40] PAPP-34619 | resolve name logic done --- office365.json | 6 +++--- office365_connector.py | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/office365.json b/office365.json index fcf0ee5..164610e 100644 --- a/office365.json +++ b/office365.json @@ -7566,7 +7566,7 @@ "data_path": "action_result.status", "data_type": "string", "column_name": "status", - "column_order": 5 + "column_order": 3 }, { "data_path": "action_result.message", @@ -7653,7 +7653,7 @@ "data_path": "action_result.status", "data_type": "string", "column_name": "status", - "column_order": 5 + "column_order": 3 }, { "data_path": "action_result.message", @@ -7676,7 +7676,7 @@ { "action": "resolve name", "identifier": "resolve_name", - "description": "Verify aliases and resolve display names to the appropriate mailbox user.", + "description": "Verify aliases and resolve display names to the appropriate user", "verbose": "Resolve an Alias name or email address, into mailboxes.", "type": "investigate", "read_only": true, diff --git a/office365_connector.py b/office365_connector.py index 359b015..ecd6fbf 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3042,7 +3042,7 @@ def _handle_resolve_name(self, param): endpoint_other_mails = f"/users/{user_id}?$select=mailNickname,proxyAddresses,otherMails" endpoint_other_address = f"/users/{user_id}?$select=city,state,street,postalCode" - endpoint_mailbox = f"/users/{user_id}/mailboxSettings" + endpoint_mailbox = f"/users/{user_id}/mailboxSettings/userPurpose" ret_val_proxy, response_proxy = self._make_rest_call_helper(action_result, endpoint_other_mails) ret_val_address, response_address = self._make_rest_call_helper(action_result, endpoint_other_address) @@ -3053,7 +3053,7 @@ def _handle_resolve_name(self, param): self.save_progress(f"{ret_val_address} Got response address {response_address}") self.save_progress(f"{ret_val_mailbox} Got response mailbox {response_mailbox}") - action_result.add_data(response | response_proxy | response_address | (response_mailbox or {})) + action_result.add_data(response | response_proxy | response_address | (response_mailbox or {"userPurpose": None})) # summary = action_result.update_summary({}) # summary['num_data'] = len(action_result['data']) From cc1859a94c3b6876b5bdc213685bfb86cd568c6d Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Mon, 7 Oct 2024 06:35:40 +0000 Subject: [PATCH 28/40] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index c86b751..0c809c2 100644 --- a/README.md +++ b/README.md @@ -353,7 +353,7 @@ VARIABLE | REQUIRED | TYPE | DESCRIPTION [update email](#action-update-email) - Update an email on the server [block sender](#action-block-sender) - Add the sender email into the block list [unblock sender](#action-unblock-sender) - Remove the sender email from the block list -[resolve name](#action-resolve-name) - Verify aliases and resolve display names to the appropriate mailbox user. +[resolve name](#action-resolve-name) - Verify aliases and resolve display names to the appropriate user ## action: 'test connectivity' Use supplied credentials to generate a token with MS Graph @@ -1640,7 +1640,7 @@ summary.total_objects | numeric | | summary.total_objects_successful | numeric | | ## action: 'resolve name' -Verify aliases and resolve display names to the appropriate mailbox user. +Verify aliases and resolve display names to the appropriate user Type: **investigate** Read only: **True** From d053ac494c27c1966a19fe2c1a00bb5b3bcc52dd Mon Sep 17 00:00:00 2001 From: kczernik Date: Mon, 7 Oct 2024 12:02:41 +0200 Subject: [PATCH 29/40] PAPP-34619 | gui results are now properly formated --- office365.json | 203 ++++++++++++++++++- office365_resolve_name.html | 379 ++++++++++++++++++++++++++++++++++++ office365_view.py | 3 + 3 files changed, 580 insertions(+), 5 deletions(-) create mode 100644 office365_resolve_name.html diff --git a/office365.json b/office365.json index 164610e..5a09c33 100644 --- a/office365.json +++ b/office365.json @@ -7568,6 +7568,18 @@ "column_name": "status", "column_order": 3 }, + { + "data_path": "action_result.summary", + "data_type": "string" + }, + { + "data_path": "action_result.status", + "data_type": "string", + "example_values": [ + "success", + "failed" + ] + }, { "data_path": "action_result.message", "data_type": "string" @@ -7655,6 +7667,18 @@ "column_name": "status", "column_order": 3 }, + { + "data_path": "action_result.summary", + "data_type": "string" + }, + { + "data_path": "action_result.status", + "data_type": "string", + "example_values": [ + "success", + "failed" + ] + }, { "data_path": "action_result.message", "data_type": "string" @@ -7686,7 +7710,10 @@ "data_type": "string", "required": true, "primary": true, - "contains": [], + "contains": [ + "email", + "string" + ], "value_list": [], "default": "", "order": 0, @@ -7697,16 +7724,178 @@ { "data_path": "action_result.parameter.email", "data_type": "string", - "contains": [], + "contains": [ + "email", + "string" + ], "column_name": "email", "column_order": 0 }, { - "data_path": "action_result.status", + "data_path": "action_result.data.*.id", "data_type": "string", - "column_name": "status", + "contains": [ + "msgoffice365 id" + ], + "column_name": "id", "column_order": 1 }, + { + "data_path": "action_result.data.*.userPrincipalName", + "data_type": "string", + "contains": [ + "msgoffice365 user principal name" + ], + "column_name": "principal name", + "column_order": 2 + }, + { + "data_path": "action_result.data.*.givenName", + "data_type": "string", + "contains": [ + "msgoffice365 given name" + ], + "column_name": "given name", + "column_order": 3 + }, + { + "data_path": "action_result.data.*.surname", + "data_type": "string", + "contains": [ + "msgoffice365 surname" + ], + "column_name": "surname", + "column_order": 4 + }, + { + "data_path": "action_result.data.*.displayName", + "data_type": "string", + "contains": [ + "msgoffice365 display name" + ], + "column_name": "display name", + "column_order": 5 + }, + { + "data_path": "action_result.data.*.mailNickname", + "data_type": "string", + "contains": [ + "msgoffice365 mail nickname" + ], + "column_name": "mail nickname", + "column_order": 6 + }, + { + "data_path": "action_result.data.*.mail", + "data_type": "string", + "contains": [ + "email" + ], + "column_name": "mail", + "column_order": 7 + }, + { + "data_path": "action_result.data.*.otherMails", + "data_type": "string", + "contains": [ + "email list" + ], + "column_name": "other mails", + "column_order": 8 + }, + { + "data_path": "action_result.data.*.proxyAddresses", + "data_type": "string", + "contains": [ + "email list" + ], + "column_name": "proxy email addresses", + "column_order": 9 + }, + { + "data_path": "action_result.data.*.jobTitle", + "data_type": "string", + "contains": [ + "msgoffice365 job title" + ], + "column_name": "job title", + "column_order": 10 + }, + { + "data_path": "action_result.data.*.officeLocation", + "data_type": "string", + "contains": [ + "msgoffice365 office location" + ], + "column_name": "office location", + "column_order": 11 + }, + { + "data_path": "action_result.data.*.value", + "data_type": "string", + "contains": [ + "msgoffice365 user purpose" + ], + "column_name": "user purpose", + "column_order": 12 + }, + { + "data_path": "action_result.data.*.mobilePhone", + "data_type": "string", + "contains": [ + "msgoffice365 mobile phone" + ], + "column_name": "mobile phone", + "column_order": 13 + }, + { + "data_path": "action_result.data.*.businessPhones", + "data_type": "string", + "contains": [ + "msgoffice365 buisness phones" + ], + "column_name": "business phones", + "column_order": 14 + }, + { + "data_path": "action_result.data.*.preferredLanguage", + "data_type": "string", + "contains": [ + "msgoffice365 preferred language" + ], + "column_name": "preferred language", + "column_order": 15 + }, + { + "data_path": "action_result.data.*.state", + "data_type": "string", + "contains": [ + "msgoffice365 state" + ], + "column_name": "state", + "column_order": 16 + }, + { + "data_path": "action_result.data.*.postalCode", + "data_type": "string", + "contains": [ + "msgoffice365 postal code" + ], + "column_name": "postal code", + "column_order": 17 + }, + { + "data_path": "action_result.summary", + "data_type": "string" + }, + { + "data_path": "action_result.status", + "data_type": "string", + "example_values": [ + "success", + "failed" + ] + }, { "data_path": "action_result.message", "data_type": "string" @@ -7721,7 +7910,11 @@ } ], "render": { - "type": "table" + "width": 12, + "title": "resolve name", + "type": "custom", + "height": 5, + "view": "office365_view.display_view" }, "versions": "EQ(*)" } diff --git a/office365_resolve_name.html b/office365_resolve_name.html new file mode 100644 index 0000000..03b3a3f --- /dev/null +++ b/office365_resolve_name.html @@ -0,0 +1,379 @@ +{% extends 'widgets/widget_template.html' %} +{% load custom_template %} + +{% block custom_title_prop %}{% if title_logo %}style="background-size: auto 60%; background-position: 50%; background-repeat: no-repeat; background-image: url('/app_resource/{{ title_logo }}');"{% endif %}{% endblock %} +{% block title1 %}{{ title1 }}{% endblock %} +{% block title2 %}{{ title2 }}{% endblock %} +{% block custom_tools %} +{% endblock %} + +{% block widget_content %} + + + + +

+ + + {% for result in results %} + {% if not result.data %} +

No data found

+ {% else %} +
+

Action Parameters

+ + + + + +
Email Address + {{ result.param.email }} +   + +
+
+ +
+

Data

+ + + + + + + + + + + + + + + + + + + + + {% for data in result.data %} + + + {% if data.id is not None %} + + {% else %} + + {% endif %} + + {% if data.userPrincipalName is not None %} + + {% else %} + + {% endif %} + + {% if data.givenName is not None %} + + {% else %} + + {% endif %} + + {% if data.surname is not None %} + + {% else %} + + {% endif %} + + {% if data.displayName is not None %} + + {% else %} + + {% endif %} + + {% if data.mailNickname is not None %} + + {% else %} + + {% endif %} + + {% if data.mail is not None %} + + {% else %} + + {% endif %} + + {% if data.otherMails is not None %} + + {% else %} + + {% endif %} + + {% if data.proxyAddresses is not None %} + + {% else %} + + {% endif %} + + {% if data.jobTitle is not None %} + + {% else %} + + {% endif %} + + {% if data.officeLocation is not None %} + + {% else %} + + {% endif %} + + {% if data.value is not None %} + + {% else %} + + {% endif %} + + {% if data.mobilePhone is not None %} + + {% else %} + + {% endif %} + + {% if data.businessPhones is not None %} + + {% else %} + + {% endif %} + + {% if data.preferredLanguage is not None %} + + {% else %} + + {% endif %} + + {% if data.state is not None %} + + {% else %} + + {% endif %} + + {% if data.postalCode is not None %} + + {% else %} + + {% endif %} + + + {% endfor %} +
idPrincipal namegiven namesurnamedisplay namemail nicknamemailother mailsproxy email addressesjob titleoffice locationvaluemobile phonebusiness phonespreferred languagestatepostal code
+ + {{ data.id }} +   + + + None + + {{ data.userPrincipalName }} +   + + + None + + {{ data.givenName }} +   + + + None + + {{ data.surname }} +   + + + None + + {{ data.displayName }} +   + + + None + + {{ data.mailNickname }} +   + + + None + + {{ data.mail }} +   + + + None + + {{ data.otherMails }} +   + + + None + + {{ data.proxyAddresses }} +   + + + None + + {{ data.jobTitle }} +   + + + None + + {{ data.officeLocation }} +   + + + None + + {{ data.value }} +   + + + None + + {{ data.mobilePhone }} +   + + + None + + {{ data.businessPhones }} +   + + + None + + {{ data.preferredLanguage }} +   + + + None + + {{ data.state }} +   + + + None + + {{ data.postalCode }} +   + + + None
+
+ {% endif %} + {% endfor %} +
+ + +{% endblock %} diff --git a/office365_view.py b/office365_view.py index 538f096..2008a9a 100644 --- a/office365_view.py +++ b/office365_view.py @@ -105,4 +105,7 @@ def display_view(provides, all_app_runs, context): if provides == "list rules": return_page = "office365_list_rules.html" + if provides == "resolve name": + return_page = "office365_resolve_name.html" + return return_page From 4faf68aef9b2bc07f11aa3ae5eb4ebea809c7e06 Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Mon, 7 Oct 2024 10:03:45 +0000 Subject: [PATCH 30/40] Update README.md --- README.md | 28 +++++++++++++++++++++++++--- 1 file changed, 25 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 0c809c2..e885f13 100644 --- a/README.md +++ b/README.md @@ -1611,6 +1611,8 @@ action_result.parameter.message_id | string | | action_result.parameter.move_to_junk_folder | boolean | | action_result.parameter.user_id | boolean | | action_result.status | string | | +action_result.summary | string | | +action_result.status | string | | success failed action_result.message | string | | summary.total_objects | numeric | | summary.total_objects_successful | numeric | | @@ -1635,6 +1637,8 @@ action_result.parameter.message_id | string | | action_result.parameter.move_to_inbox | boolean | | action_result.parameter.user_id | boolean | | action_result.status | string | | +action_result.summary | string | | +action_result.status | string | | success failed action_result.message | string | | summary.total_objects | numeric | | summary.total_objects_successful | numeric | | @@ -1650,13 +1654,31 @@ Resolve an Alias name or email address, into mailboxes. #### Action Parameters PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS --------- | -------- | ----------- | ---- | -------- -**email** | required | Name to resolve | string | +**email** | required | Name to resolve | string | `email` `string` #### Action Output DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES --------- | ---- | -------- | -------------- -action_result.parameter.email | string | | -action_result.status | string | | +action_result.parameter.email | string | `email` `string` | +action_result.data.\*.id | string | `msgoffice365 id` | +action_result.data.\*.userPrincipalName | string | `msgoffice365 user principal name` | +action_result.data.\*.givenName | string | `msgoffice365 given name` | +action_result.data.\*.surname | string | `msgoffice365 surname` | +action_result.data.\*.displayName | string | `msgoffice365 display name` | +action_result.data.\*.mailNickname | string | `msgoffice365 mail nickname` | +action_result.data.\*.mail | string | `email` | +action_result.data.\*.otherMails | string | `email list` | +action_result.data.\*.proxyAddresses | string | `email list` | +action_result.data.\*.jobTitle | string | `msgoffice365 job title` | +action_result.data.\*.officeLocation | string | `msgoffice365 office location` | +action_result.data.\*.value | string | `msgoffice365 user purpose` | +action_result.data.\*.mobilePhone | string | `msgoffice365 mobile phone` | +action_result.data.\*.businessPhones | string | `msgoffice365 buisness phones` | +action_result.data.\*.preferredLanguage | string | `msgoffice365 preferred language` | +action_result.data.\*.state | string | `msgoffice365 state` | +action_result.data.\*.postalCode | string | `msgoffice365 postal code` | +action_result.summary | string | | +action_result.status | string | | success failed action_result.message | string | | summary.total_objects | numeric | | summary.total_objects_successful | numeric | | \ No newline at end of file From bc9cc8ad27b80df2bdc76a43a11d69f240b1863a Mon Sep 17 00:00:00 2001 From: kczernik Date: Tue, 15 Oct 2024 10:26:53 +0200 Subject: [PATCH 31/40] PAPP-34619 | polishing implemented methods --- office365_connector.py | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/office365_connector.py b/office365_connector.py index ecd6fbf..a15200e 100644 --- a/office365_connector.py +++ b/office365_connector.py @@ -3032,6 +3032,7 @@ def _handle_resolve_name(self, param): endpoint = f"/users?$filter=startswith(displayName,'{email}') or startswith(mail,'{email}')" ret_val, responses = self._make_rest_call_helper(action_result, endpoint) + self.save_progress(f"Fetching user ended witch {ret_val}") if phantom.is_fail(ret_val): return action_result.set_status(phantom.APP_ERROR, "Got invalid ret val") @@ -3048,15 +3049,10 @@ def _handle_resolve_name(self, param): ret_val_address, response_address = self._make_rest_call_helper(action_result, endpoint_other_address) ret_val_mailbox, response_mailbox = self._make_rest_call_helper(action_result, endpoint_mailbox) - self.save_progress(f"{ret_val} Got response {response}") - self.save_progress(f"{ret_val_proxy} Got response other mails {response_proxy}") - self.save_progress(f"{ret_val_address} Got response address {response_address}") - self.save_progress(f"{ret_val_mailbox} Got response mailbox {response_mailbox}") + self.save_progress(f"Got statuses: mails: {ret_val_proxy}, address: {ret_val_address}, mailbox: {ret_val_mailbox}") action_result.add_data(response | response_proxy | response_address | (response_mailbox or {"userPurpose": None})) - # summary = action_result.update_summary({}) - # summary['num_data'] = len(action_result['data']) return action_result.set_status(phantom.APP_SUCCESS) def handle_action(self, param): From 41a562f375864abcbd4037bf0fbf3e7ba31c3f8e Mon Sep 17 00:00:00 2001 From: kczernik Date: Mon, 21 Oct 2024 14:29:05 +0200 Subject: [PATCH 32/40] PAPP-34619 | empty test commit From 8b5ade2d638cb60e11e69cbf3f9460069152b63c Mon Sep 17 00:00:00 2001 From: kczernik Date: Mon, 21 Oct 2024 15:39:13 +0200 Subject: [PATCH 33/40] PAPP-34619 | working on static tests --- office365.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/office365.json b/office365.json index 5a09c33..79bdbfb 100644 --- a/office365.json +++ b/office365.json @@ -37,7 +37,7 @@ "utctime_updated": "2024-09-11T08:34:15.000000Z", "package_name": "phantom_msgraphoffice365", "main_module": "office365_connector.py", - "min_phantom_version": "6.2.1", + "min_phantom_version": "6.2.2", "latest_tested_versions": [ "Cloud 9 January, 2024" ], @@ -7503,7 +7503,7 @@ "action": "block sender", "identifier": "block_sender", "description": "Add the sender email into the block list", - "verbose": "", + "verbose": "This action takes as input an email whose sender will be added to the Block Senders List. The message ID changes after the execution and is a required parameter for request hence undo action would require unique ID. Note that a message from the email address must exist in the user's mailbox before you can add the email address to or remove it from the Blocked Senders List.
  • If the move_to_junk_folder parameter is set to True, the sender of the target email message is added to the blocked sender list and the email message is moved to the Junk Email folder.
  • If the move_to_junk_folder attribute is set to False, the sender of the target email message is added to the blocked sender list and the email message is not moved from the folder.
To view the current Block Senders list, please read the following Powershell articles:
  • https://docs.microsoft.com/en-us/powershell/exchange/exchange-online/connect-to-exchange-online-powershell/connect-to-exchange-online-powershell?view=exchange-ps
  • https://docs.microsoft.com/en-us/powershell/module/exchange/antispam-antimalware/Get-MailboxJunkEmailConfiguration?view=exchange-ps
\",", "type": "contain", "read_only": false, "parameters": { @@ -7602,7 +7602,7 @@ "action": "unblock sender", "identifier": "unblock_sender", "description": "Remove the sender email from the block list", - "verbose": "", + "verbose": "This action takes as input an email whose sender will be removed from the Block Senders List. The message ID changes after the execution and is a required parameter for request hence undo action would require unique ID. Note that a message from the email address must exist in the user's mailbox before you can add the email address to or remove it from the Blocked Senders List.
  • If the move_to_inbox parameter is set to True, the sender of the target email message is removed from the blocked sender list and the email message is moved from the Junk Email folder.
  • If the move_to_inbox attribute is set to False, the sender of the target email message is removed from the blocked sender list and the email message is not moved from the folder.
To view the current Block Senders list, please read the following Powershell articles:
  • https://docs.microsoft.com/en-us/powershell/exchange/exchange-online/connect-to-exchange-online-powershell/connect-to-exchange-online-powershell?view=exchange-ps
  • https://docs.microsoft.com/en-us/powershell/module/exchange/antispam-antimalware/Get-MailboxJunkEmailConfiguration?view=exchange-ps
", "type": "contain", "read_only": false, "parameters": { @@ -7701,7 +7701,7 @@ "action": "resolve name", "identifier": "resolve_name", "description": "Verify aliases and resolve display names to the appropriate user", - "verbose": "Resolve an Alias name or email address, into mailboxes.", + "verbose": "Resolve an Alias name or email address, gathering complex data about the user.", "type": "investigate", "read_only": true, "parameters": { From 1b446503dec78c22502f7be2fb8fd8afb2f34675 Mon Sep 17 00:00:00 2001 From: splunk-soar-connectors-admin Date: Mon, 21 Oct 2024 13:40:01 +0000 Subject: [PATCH 34/40] Update README.md --- README.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e885f13..b6f62bb 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Connector Version: 3.0.1 Product Vendor: Microsoft Product Name: Office 365 (MS Graph) Product Version Supported (regex): ".\*" -Minimum Product Version: 6.2.1 +Minimum Product Version: 6.2.2 This app connects to Office 365 using the MS Graph API to support investigate and generic actions related to the email messages and calendar events @@ -1597,6 +1597,8 @@ Add the sender email into the block list Type: **contain** Read only: **False** +This action takes as input an email whose sender will be added to the Block Senders List. The message ID changes after the execution and is a required parameter for request hence undo action would require unique ID. Note that a message from the email address must exist in the user's mailbox before you can add the email address to or remove it from the Blocked Senders List.
  • If the move_to_junk_folder parameter is set to True, the sender of the target email message is added to the blocked sender list and the email message is moved to the Junk Email folder.
  • If the move_to_junk_folder attribute is set to False, the sender of the target email message is added to the blocked sender list and the email message is not moved from the folder.
To view the current Block Senders list, please read the following Powershell articles:
  • https://docs.microsoft.com/en-us/powershell/exchange/exchange-online/connect-to-exchange-online-powershell/connect-to-exchange-online-powershell?view=exchange-ps
  • https://docs.microsoft.com/en-us/powershell/module/exchange/antispam-antimalware/Get-MailboxJunkEmailConfiguration?view=exchange-ps
", + #### Action Parameters PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS --------- | -------- | ----------- | ---- | -------- @@ -1623,6 +1625,8 @@ Remove the sender email from the block list Type: **contain** Read only: **False** +This action takes as input an email whose sender will be removed from the Block Senders List. The message ID changes after the execution and is a required parameter for request hence undo action would require unique ID. Note that a message from the email address must exist in the user's mailbox before you can add the email address to or remove it from the Blocked Senders List.
  • If the move_to_inbox parameter is set to True, the sender of the target email message is removed from the blocked sender list and the email message is moved from the Junk Email folder.
  • If the move_to_inbox attribute is set to False, the sender of the target email message is removed from the blocked sender list and the email message is not moved from the folder.
To view the current Block Senders list, please read the following Powershell articles:
  • https://docs.microsoft.com/en-us/powershell/exchange/exchange-online/connect-to-exchange-online-powershell/connect-to-exchange-online-powershell?view=exchange-ps
  • https://docs.microsoft.com/en-us/powershell/module/exchange/antispam-antimalware/Get-MailboxJunkEmailConfiguration?view=exchange-ps
+ #### Action Parameters PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS --------- | -------- | ----------- | ---- | -------- @@ -1649,7 +1653,7 @@ Verify aliases and resolve display names to the appropriate user Type: **investigate** Read only: **True** -Resolve an Alias name or email address, into mailboxes. +Resolve an Alias name or email address, gathering complex data about the user. #### Action Parameters PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS From 486164e70ea07bc6b4bcee673b0486816d491f37 Mon Sep 17 00:00:00 2001 From: kczernik Date: Mon, 21 Oct 2024 16:32:46 +0200 Subject: [PATCH 35/40] PAPP-34619 | working on static tests take 2 --- office365.json | 4 ++-- office365_resolve_name.html | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/office365.json b/office365.json index 79bdbfb..78ea226 100644 --- a/office365.json +++ b/office365.json @@ -7503,7 +7503,7 @@ "action": "block sender", "identifier": "block_sender", "description": "Add the sender email into the block list", - "verbose": "This action takes as input an email whose sender will be added to the Block Senders List. The message ID changes after the execution and is a required parameter for request hence undo action would require unique ID. Note that a message from the email address must exist in the user's mailbox before you can add the email address to or remove it from the Blocked Senders List.
  • If the move_to_junk_folder parameter is set to True, the sender of the target email message is added to the blocked sender list and the email message is moved to the Junk Email folder.
  • If the move_to_junk_folder attribute is set to False, the sender of the target email message is added to the blocked sender list and the email message is not moved from the folder.
To view the current Block Senders list, please read the following Powershell articles:
  • https://docs.microsoft.com/en-us/powershell/exchange/exchange-online/connect-to-exchange-online-powershell/connect-to-exchange-online-powershell?view=exchange-ps
  • https://docs.microsoft.com/en-us/powershell/module/exchange/antispam-antimalware/Get-MailboxJunkEmailConfiguration?view=exchange-ps
\",", + "verbose": "This action takes as input an email whose sender will be added to the Block Senders List. The message ID changes after the execution and is a required parameter for request hence undo action would require unique ID. Note that a message from the email address must exist in the user's mailbox before you can add the email address to or remove it from the Blocked Senders List.
  • If the move_to_junk_folder parameter is set to True, the sender of the target email message is added to the blocked sender list and the email message is moved to the Junk Email folder.
  • If the move_to_junk_folder attribute is set to False, the sender of the target email message is added to the blocked sender list and the email message is not moved from the folder.
To view the current Block Senders list, please read the following Powershell articles:
  • https://docs.microsoft.com/en-us/powershell/exchange/exchange-online/connect-to-exchange-online-powershell/connect-to-exchange-online-powershell?view=exchange-ps
  • https://docs.microsoft.com/en-us/powershell/module/exchange/antispam-antimalware/Get-MailboxJunkEmailConfiguration?view=exchange-ps.
", "type": "contain", "read_only": false, "parameters": { @@ -7602,7 +7602,7 @@ "action": "unblock sender", "identifier": "unblock_sender", "description": "Remove the sender email from the block list", - "verbose": "This action takes as input an email whose sender will be removed from the Block Senders List. The message ID changes after the execution and is a required parameter for request hence undo action would require unique ID. Note that a message from the email address must exist in the user's mailbox before you can add the email address to or remove it from the Blocked Senders List.
  • If the move_to_inbox parameter is set to True, the sender of the target email message is removed from the blocked sender list and the email message is moved from the Junk Email folder.
  • If the move_to_inbox attribute is set to False, the sender of the target email message is removed from the blocked sender list and the email message is not moved from the folder.
To view the current Block Senders list, please read the following Powershell articles:
  • https://docs.microsoft.com/en-us/powershell/exchange/exchange-online/connect-to-exchange-online-powershell/connect-to-exchange-online-powershell?view=exchange-ps
  • https://docs.microsoft.com/en-us/powershell/module/exchange/antispam-antimalware/Get-MailboxJunkEmailConfiguration?view=exchange-ps
", + "verbose": "This action takes as input an email whose sender will be removed from the Block Senders List. The message ID changes after the execution and is a required parameter for request hence undo action would require unique ID. Note that a message from the email address must exist in the user's mailbox before you can add the email address to or remove it from the Blocked Senders List.
  • If the move_to_inbox parameter is set to True, the sender of the target email message is removed from the blocked sender list and the email message is moved from the Junk Email folder.
  • If the move_to_inbox attribute is set to False, the sender of the target email message is removed from the blocked sender list and the email message is not moved from the folder.
To view the current Block Senders list, please read the following Powershell articles:
  • https://docs.microsoft.com/en-us/powershell/exchange/exchange-online/connect-to-exchange-online-powershell/connect-to-exchange-online-powershell?view=exchange-ps
  • https://docs.microsoft.com/en-us/powershell/module/exchange/antispam-antimalware/Get-MailboxJunkEmailConfiguration?view=exchange-ps.
", "type": "contain", "read_only": false, "parameters": { diff --git a/office365_resolve_name.html b/office365_resolve_name.html index 03b3a3f..0c4c166 100644 --- a/office365_resolve_name.html +++ b/office365_resolve_name.html @@ -9,7 +9,7 @@ {% block widget_content %} -