Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

Microsoft Exchange Server is a mail server and calendaring server developed by Microsoft. This integration relies on EWS being enabled for the server.

Connect Exchange (Quarantine Messages) with Devo SOAR

  1. Navigate to Automations > Integrations.

  2. Search for Exchange (Quarantine Messages).

  3. Click Details, then the + icon. Enter the required information in the following fields.

  4. Label: Enter a connection name.

  5. Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.

  6. Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).

  7. Remote Agent: Run this integration using the Devo SOAR Remote Agent.

  8. Self-Signed Certificate: Upload a .pfx Self-Signed Certificate file. Can be override at action level.

  9. Timeout (Optional): Seconds to wait before stopping the authentication request (Default is 30 seconds).

  10. After you've entered all the details, click Connect.

Download Quarantine Message List

Download all the Quarantine Messages from the start date till the end date. It will take few minutes to run this action, so in case response gets delayed, then timeout limit has to be increased

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Enter Start Date

Jinja-templated text containing the start date after which the quarantine messages have to be downloaded. Date in Format MM/DD/YYYY. Example: {{date}}

Required

Enter End Date

Jinja-templated text containing the end date before which the quarantine messages have to be downloaded. Date in Format MM/DD/YYYY. Example: {{date}}

Required

Self-Signed Certificate

Upload a .pfx Self-Signed Certificate file.

Optional

Certificate password

Certificate Password.

Optional

Tenant ID

Jinja-templated text containing the value of the directory ID or verified domain of your Office 365 tenant. Example: {{tenantid}}

Required

App ID

Jinja-templated text containing the value of App ID. Example: {{appid}}

Required

Output

JSON containing the following items:

``` {json}"data":{ "has_error":false, "error":null, "File Id ":[ "49fd25d0e39a436dad0e2644913b73e7.eml", "7c78cf94f6294bdeb44ca7d4c7d9e7e9.eml", "9f8fe488c81e4d359d008d0709b3a1f0.eml", "6e7968c33ac9405ea6b47993d04b304f.eml", "13dfdf58e65c490d89d74529656c1e67.eml", "9b459430deec43418394842f33ab8a0b.eml" ] }

## Download Quarantine Message By Certificate

Download Quarantine Message with given message-id by certificate auth. It will take few minutes to run this action, so in case response gets delayed, then timeout limit has to be increased

### Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

| Input Name              | Description                                                                                                    | Required |
| :---------------------- | :------------------------------------------------------------------------------------------------------------- | :------- |
| Self-Signed Certificate | Upload a .pfx Self-Signed Certificate file.                                                                    | Optional |
| Certificate password    | Certificate Password.                                                                                          | Optional |
| Tenant ID               | Text containing the value of the directory ID or verified domain of your Office 365 tenant.                    | Required |
| App ID                  | Text containing the value of App ID.                                                                           | Required |
| Email Message ID        | [Jinja-templated](doc:jinja-template) text containing the value of message ID of the email. Example: {{msgid}} | Required |

### Output

JSON containing the following items:


``` {json}"data":{
    "has_error":false,
    "File-Id ":[
        "2ae60eb911a348bbb3bc5120f0976cef.eml"
    ],
    "error":null
}

Release Notes

  • v2.1.2 - Upgraded the ExchangeOnlineManagement library to 3.1.0

  • v2.0.4 - Proper error message when some error occurs in connecting the server or retrieving the message.

  • v2.0.0 - Updated architecture to support IO via filesystem

  • v1.0.3 - Added 2 actions: Download Quarantine Message By Certificate and Download Quarantine Message List.

  • No labels