Axonius - Send Email to Assets
  • 07 Nov 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Axonius - Send Email to Assets

  • Dark
    Light
  • PDF

Axonius - Send Email to Assets sends an email with a predefined subject and body to all assets which have an email address, based on the following logic:

  • Users query - Email will be sent to each User asset which has an email address.
  • Devices query - Email will be sent to each User asset which has an email address that is determined as the Latest Used User Email for each device.
Note:

The count returned from this action tells you the number of users emails were sent to for each device.

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

To configure Axonius - Send Email to Assets, from the Action Library, click Notify, and then click Axonius - Send Email to Assets or search for the action in the Action Library Search pane.

Action Settings

Click to view Action Settings
  1. Email subject (optional, default: empty) - Specify the email subject.
    • If supplied, the generated email subject will be the specified subject.
    • If not supplied, the email subject will be [Enforcement Set Name] + 'for Query:' + [query name]
  2. Custom message (optional, default: empty) - 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.
  3. Send to device owner (required, default: False) - Select whether to send an email to the device owner.
    • If enabled, an email will be sent to the email address of the device owner, if it exists.
    • If disabled, an email will be sent to each User asset which has an email address that is determined as the Latest Used User Email for each device.
  4. Limit recipients to first X, not counting CC - limit the number of recipients to only send to the first X recipients, based on the default order of recipients. The default value is 2. For a Devices query, the default order of email recipients is:
  • Device Owner (if Add device owner to recipients is selected)
  • Latest Used User Email (if Add latest used user email to recipients is selected)
  • device.mail
  • device.custom_email
  • device.email
  • all of device.last_used_users_mail_association (that one is a list)
  1. Confirm only send to device owner (and cc list) - send the email only to the owner of the device and not to the Latest Used User Email. When Send to Owner Only is selected as well as Confirm only send to device owner (and CC list), then the recipients list will ONLY include the device.owner (and any CC emails confgured in the enforcement set).
  2. Email CC list (optional, default: empty) - Specify a comma-separated list of email addresses.
    • If supplied, each email will also be sent to the supplied email addresses in that list.
    • If not supplied, each email will only be sent to each User asset which has an email address that is determined as the Latest Used User Email for each device.
NOTE
  • The following parameters can be used in the email message/custom body and work only when the triggering query is a user-based query:
    • {{USERNAME}} - The username of the user.
    • {{FIRST_NAME}} - The user's first name.
  • This field allows unsanitized HTML code.

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



What's Next
Changing your password will log you out immediately. Use the new password to log back in.
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.