Skip to main content

mail-reporting

The mail-reporting tool facilitates the automated sending of emails, complete with attachments, within Canva workflows. It is specifically designed for reporting purposes in cybersecurity automation, providing timely notifications and insights to team members or stakeholders by leveraging email communication.

Ideal Use Cases & Fit​

This tool excels in scenarios such as sending security assessment reports, alerting team members of vulnerabilities discovered during scans, or delivering compliance documentation. It is best utilized when automated notifications are critical for operational efficiency. However, it may not be suitable for scenarios requiring high interactivity or real-time communication.

Value in Workflows​

Incorporating mail-reporting into security workflows enhances communication and documentation processes. Positioned at the post-processing stage of assessments, it ensures that critical findings are promptly shared with relevant parties while maintaining a record of the communication. This integration improves responsiveness and accountability within security teams.

Input Data​

The tool expects a JSON configuration file with email parameters, which dictates how the email is structured and sent. The required fields include:

  • recipients: Email addresses of the recipients.
  • subject: Subject line of the email.
  • body: Content of the email body, which can be formatted as text or HTML.
  • attachment: Base64-encoded string of the file to be attached.
  • attachment_filename: Name of the file to be displayed in the email.

Example of the input configuration:

{
  "recipients": "[email protected],[email protected]",
  "subject": "Automated Report",
  "body": "<h2>Report Summary</h2><p>Please find the report attached.</p>",
  "type": "html",
  "attachment": "SGVsbG8gV29ybGQ=",
  "attachment_filename": "report.txt"
}

Configuration​

  • recipients: Newline or comma-separated recipient email addresses.
  • subject: Email subject text.
  • body: The content of the email body.
  • type: Specifies the message type, can be 'text' or 'html' (default: text).
  • attachment: Base64 encoded data for the attachment.
  • attachment_filename: Filename for the attached document.

These parameters allow workflow builders to customize the email delivery as per their operational needs, ensuring clear and effective communication in automated processes.