Skip to main content

EWS Mail Sender

This Integration is part of the EWS Mail Sender Pack.#

Exchange Web Services and Office 365 Email sender.

Configure EWS Mail Sender on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for EWS Mail Sender.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    ewsServerExchange URL or Server IP addressTrue
    credentialsAuthentication: Email address (for Office 365) or DOMAIN\USERNAME (e.g. XSOAR.INT\admin)True
    defaultServerVersionServer Version (2007, 2010, 2010_SP2, 2013, or 2016)True
    authTypeAuthentication Type (NTLM, Basic, or Digest). For Office 365 use Basic.True
    insecureTrust any certificate (not secure)False
    proxyUse system proxy settingsFalse
    impersonationHas impersonation rightsFalse
    mailboxSender MailboxFalse
    Single engineIf relevant, select the engine that acts as a proxy to the server. Engines are used when you need to access a remote network segments and there are network devices such as proxies, firewalls, etc. that prevent the Cortex XSOAR server from accessing the remote networks. For more information on Cortex XSOAR engines see: https://docs.paloaltonetworks.com/cortex/cortex-xsoar/6-2/cortex-xsoar-admin/enginesFalse
  4. Click Test to validate the URLs, token, and connection.

Top Use-cases:#

  • Send notifications to external users.
  • Send an email asking for a response to be returned as part of a playbook. See Receiving an email reply

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

send-mail#


Sends an email using EWS.

Base Command#

send-mail

Input#

Argument NameDescriptionRequired
toA CSV list of email addresses for the 'to' field.Required
ccA CSV list of email addresses for the 'cc' field.Optional
bccA CSV list of email addresses for the 'bcc' field.Optional
subjectSubject for the email to be sent.Required
replyToThe email address specified in the 'reply to' field.Optional
bodyThe contents (body) of the email to send.Optional
htmlBodyHTML formatted content (body) of the email to be sent. This argument overrides the "body" argument.Optional
attachIDsA CSV list of War Room entry IDs that contain files, and are used to attach files to the outgoing email. For example: attachIDs=15@8,19@8.Optional
attachNamesA CSV list of names of attachments to send. Should be the same number of elements as attachIDs.Optional
attachCIDsA CSV list of CIDs to embed attachments within the email itself.Optional

Context Output#

There is no context output for this command.

Command Example#

!send-mail body="hello this is a test" subject=Hi to=avishai@demistodev.onmicrosoft.com

Human Readable Output#

Sent email#

attachmentsfromsubjectto
avishai@demistodev.onmicrosoft.comHiavishai@demistodev.onmicrosoft.com

reply-mail#


Replies to an email using EWS.

Base Command#

reply-mail

Input#

Argument NameDescriptionRequired
inReplyToID of the item to reply to.Required
toA CSV list of email addresses for the 'to' field.Required
ccA CSV list of email addresses for the 'cc' field.Optional
bccA CSV list of email addresses for the 'bcc' field.Optional
subjectSubject for the email to be sent.Optional
bodyThe contents (body) of the email to send.Optional
htmlBodyHTML formatted content (body) of the email to be sent. This argument overrides the "body" argument.Optional
attachIDsA CSV list of War Room entry IDs that contain files, and are used to attach files to the outgoing email. For example: attachIDs=15@8,19@8.Optional
attachNamesA CSV list of names of attachments to send. Should be the same number of elements as attachIDs.Optional
attachCIDsA CSV list of CIDs to embed attachments within the email itself.Optional

Context Output#

There is no context output for this command.

Command Example#

!reply-mail item_id=AAMkAGY3OTQyMzMzLWYxNjktNDE0My05NmZhLWQ5MGY1YjIyNzBkNABGAAAAAACYCKjWAnXBTrnhgWJCcLX7BwDrxRwRjq/zTrN6vWSzK4OWAAAAAAEMAADrxRwRjq/zTrN6vWSzK4OWAAPYQGFeAAA= body=hello subject=hi to="avishai@demistodev.onmicrosoft.com"

Human Readable Output#

Sent email#

attachmentsfromsubjectto
avishai@demistodev.onmicrosoft.comhiavishai@demistodev.onmicrosoft.com