# Mail

FSProtect mail integration enables users to receive email notifications as soon as a scan is completed. Users can include summary reports, full reports, and the results of customized queries as access links in the notification email, providing a quick overview of the scan results. In case a scan fails, an email is sent with the reason for the failure, keeping users informed.

## **Creating New Configuration**

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2FegSMYyIZg9FtizwWA7kn%2Fimage.png?alt=media&#x26;token=26550101-7952-4113-901a-c62c14e25d8b" alt=""><figcaption><p>Mail Integration</p></figcaption></figure>

Tooltip provider that is above and right side on the table allows us to;

* **Export**: Exports all mail configurations and respective information that is listed in this table as a CSV file.
* **New Configuration**: Create a new mail configuration from scratch.

Left-click on the `New Configuration` button redirects the users to the creation page.

### Mandatory Fields

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2FLy4nnlgM2kVGsMHLvFBs%2Fimage.png?alt=media&#x26;token=dea73e56-5328-4465-8cef-617528128481" alt=""><figcaption><p>Mandatory Values of Mail Configuration</p></figcaption></figure>

**Configuration Name**: Name of the mail configuration.

**Mail Server**: Fully Qualified Domain Name (FQDN) or IP address of the mail server.

**Mail Server Port**: Port number of the mail server.

**Connection Security**: Connection type used to connect to the mail server (e.g. TLS, SSL, None).

**Send Email To**: Receiver list of the notification email.

**Send Summary Report**: Determines whether the summary report access link is attached to the notification email.

**Send Full Report**: Determines whether the full report access link is attached to the notification email.

**Active**: Indicates whether the mail configuration is active.

### Optional Fields

**Email Address**: The sender mail address of the notification mail.

**Email Password**: The password of the sender mail address of the notification mail.

{% hint style="info" %}
When Email Address and Email Password is empty, client will try loging in anonymously to the mail server. For example SMTP Relay servers that authenticates by itself.
{% endhint %}

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2FiT2Nz7R0GZxJKBERAoWQ%2Fimage.png?alt=media&#x26;token=c7067a5d-d271-4fb8-999a-4e3e3a053cd9" alt=""><figcaption><p>Optional Parameters of Mail Configuration</p></figcaption></figure>

**Use Different Sender**\
Allows specifying a custom sender (“From”) email address.\
If not provided, the authenticated email address is used.

**Send Summary Report**\
Includes the summary report access link in the notification email.

**Send Full Report**\
Includes the full report access link in the notification email.

**New Vulnerabilities**\
Sends notification when new vulnerabilities are detected compared to the previous scheduled scan.

**Fixed Vulnerabilities**\
Sends notification when vulnerabilities are fixed compared to the previous scheduled scan.

**Scheduled Reports Difference**\
Sends notification when scheduled scan results differ from the previous execution.

**Send All Saved Queries**\
Includes results of all saved queries in the notification email.

**Saved Query IDs**\
Specifies which saved queries are included when **Send All Saved Queries** is disabled.

**Scheduled Reports**: Scheduled reports are the built-in or custom-created `Search&Reports` queries. The results of these queries can be added as attachments to allow users to get a quick overview and instant answers to the questions they are curious about.

**Save**: Saves the new configuration to the database.

**Save and Test** (Recommended): Saves the new configuration to the database and sends a confirmation e-mail to validate/verify the configuration.

After `Save`/`Save and Test`, users can see the saved mail configurations.

## Mail Configurations

The table contains the regarding information about the integrated mail servers and allows us to perform operations on these configurations with the help of a three-dot button.

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2FaqpxVqQhW4X2YxmlvYXD%2Fimage.png?alt=media&#x26;token=0aefe020-d4eb-445c-a71b-f9a9058c71d6" alt=""><figcaption><p>List of Mail Integrations</p></figcaption></figure>

### Column Info

**Name**: Name of the configuration.

**Mail Server**: Full Qualified Domain Name(FQDN) of the mail server.

**Full Report**: Whether the full report access link is attached to the notification mail.

**Active**: Whether the mail configuration is active.

**Mail To**: The receiver list of the notification mail.

**SMTP Relay** : If **Email Address** and **Email Password** are not provided, FSProtect sends emails using SMTP Relay or anonymous delivery without SMTP authentication.\
This behavior is commonly used with internal or IP-trusted mail servers.

### Operations

Three-dot button on the each row allows us to perform following operations on a mail integration configuration;

**Edit**: Edit the selected mail configuration.

**Delete**: Delete the selected mail configuration.

The following figure is an example of the notification e-mail that sent after the completion of the scan.

![Mail Notification](https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2Fgit-blob-fc8ba2d6f822be696a95d2a524b32500b830d961%2Fmail_notification_mail.PNG?alt=media)

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2FQPKkGuX2LhvSFpg3G1B7%2Fimage.png?alt=media&#x26;token=3a890a6b-02e7-45ad-8f10-219397b45b52" alt=""><figcaption><p>Mail Failed Notification</p></figcaption></figure>

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2Fw8TajpUs5XAx4KgXGQ1V%2Fimage.png?alt=media&#x26;token=2c31175c-5bfc-42f8-975c-4655021a3434" alt=""><figcaption><p>Example of Send All Saved Queries</p></figcaption></figure>
