Send Email
  • 20 Sep 2022
  • 4 Minutes to read
  • Dark
    Light
  • PDF

Send Email

  • Dark
    Light
  • PDF

Send Email sends an email with the query results to a predefined list of recipients.

To configure Send Email , from the Action Library, click Notify, and then click Send Email.

Click to view Description

Axonius email templates summarize a query's results:

  • The Enforcement Set that triggered the email, and whether the enforcement was executed automatically or by a user.
  • The triggered query name and the number of previous results found, added (since last execution), and subtracted (since last execution) results, all together sum up to the total number of current results.
  • Summary of the top 10 results and link to view the entire query results. When the query is created on Activity logs and Fetch History using filters the email does not include a summary of the top 10 results.
  • CSVs of the all results and/or of changes in the query results attached
    If you set Compress email attachments under Email Settings on the Global Settings page, you can send the CSV files as one compressed file. The system will warn you if the compressed file reaches 10 Megabytes.

image.png

Connection Settings

Click to view Connection Settings

To use this action, you must enable Send Emails setting and configure the email host and port. For more details, see Email Settings on the Global Settings page.

Action Settings

Click to view Action Settings
  1. Email subject (optional) - Specify the email subject.
    • If supplied, the generated email subject will be the specified subject.
    • If not supplied, the generated email subject will be [Enforcement Set Name] + 'for Query:' + [query name]
  2. Custom message (up to 10K characters) (optional) - Specify the body of the email message.
    • If supplied, the generated email body will be the specified custom message.
    • If not supplied, the email message will be generated with no body.
NOTE
  • The following parameters can be used in the email subject and the message/body:
    • {{USERNAME}} - The username of the user.
    • {{FIRST_NAME}} - The user's first name.
  • This field allows unsanitized HTML code.
  1. Email to include top results section (required, default: True) - Select whether to include the top results section in the sent email.
    • If enabled, the email being sent will include the top results section.
    • If disabled, the email being sent will not include the top results section. It will only include the results summary.
  2. Email to include custom message only (required, default: False) - Select whether to include the Axonius email template in the sent email.
    • If enabled, the email being sent will not include the Axonius email template. It will only include the specified custom message.
    • If disabled, the email being sent will include the Axonius email template.
  3. Recipients (required) - Add list of recipients.
  4. Recipients CC (optional) - Add list of recipients CC.
    • If supplied, the email will be sent as CC to the specified email list.
    • If not supplied, the email will be sent only to the defined Recipients specified email list.
  5. Attach CSV with query results (required, default: False)
    • If enabled, the email being sent will include an attached CSV file with the query results.
    • If disabled, the email being sent will not include an attached CSV file with the query results.
  6. Attach CSV with changes in query results (required, default: False)
    • If enabled, the email being sent will include an attached CSV file with the changes in the query results (compared to the last run of the Enforcement Set). If no changes were identified in the results, no CSV will be generated.
    • If disabled, the email being sent will not include an attached CSV file.
  7. Send email even if no data is returned in the query (required, default: False) - Select whether to send an email even if the query does not return any results.

Additional CSV Settings

  1. Split by asset entities (required, default: false) - Select to create a CSV file where each asset on a device is shown as a separate row. This separates each asset as the 'expand' option in the application. It separates each asset by its entity. For example, you will be able to know which values were fetched from each adapter connection.
    a. If supplied, each value on a device or user is shown as a separate row.
    b. If not supplied all values on a device are in the same cell on the CSV file.
  2. Split by field values (optional, default empty) - Choose field value - For complex fields and lists you can create a CSV file where the values of complex fields and lists are represented as separate rows in the file. From the drop-down box select the value that you want to display in the file, 'Tags' for instance. Only fields that have been discovered are available. For example, if you export by Installed Software, you will be able to see each installed Software name and its version.
  3. Don't split complex objects into columns (optional, default: false) - When selected, complex objects appear in a single column in JSON format. By default, each field in a complex object is split into a separate column in the CSV file.
  4. Export CSV delimiter to use for multi-value fields (optional, default: Export CSV delimiter to use for multi-value fields field under the System Settings section in the GUI Settings) - Specify a delimiter to separate between values within the same field of an exported CSV file, otherwise the delimiter defined in Export CSV delimiter to use for multi-value fields is used.
  5. Maximum rows (optional, default: 1048500) - Specify the maximum number of rows to be included in the CSV file. When you set a value here the generated CSV file will include the top x rows, based on the specified values. Otherwise, the generated CSV file will include the default maximum rows, set as 1048500.


To learn more about configuring Enforcement Sets, see Configuring Enforcement Sets.


First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.