E-mail integration¶

Versio.io can send emails to one or more email recipients in response to a Versio.io event.

Configuration¶

You can add and configure an action for GitLab for each 'Alerting & action' entry in the 'Actions' section. The following configuration options are required:

Field	Description	Example
Server URL	The base URL of your GitLab instance.	`https://my-domain.com`
Project name or ID	The name or identifier (ID) of the GitLab project. The ID you found under `Settings` -> `General`.	`162`
Credential	An GitLab API token with write access. Create the token under `Settings` -> `Access tokens` and create a credential in Versio.io under `Environment settings` -> `Access management` -> `Credential vault`.

Table: GitLab integration configuration parameter

Click Save to apply the modifications.

The following image is an example of a GitLab configuration:

Versio.io e-mail integration configuration

Figure: Example of a Versio.io GitLab integration configuration

Alerting e-mail templates¶

Violation¶

# Custom email header
<!DOCTYPE html>
<html lang="de">
  <head>
    <meta charset="utf-8" />
    <title>New violation</title>
  </head>

  <body style="font-family:Arial, Helvetica, sans-serif; font-size:14px; color:#111111;">

    <p>
        <strong>{{eventCount}}</strong> new violations were found:
    </p>

    <table width="100%" cellpadding="6" cellspacing="0" border="1" style="border-collapse:collapse; border-color:#cccccc;">
      <tr style="background-color:#003964; color:#ffffff;">
        <th align="left">Product</th>
        <th align="left">Vendor</th>
        <th align="left">Version</th>
        <th align="left">Recommended version</th>
        <th align="left">Severity/CVSS (max)</th>
        <th align="left">Vulnerabilities</th>
        <th align="left">Instance</th>
        <th align="left">Link</th>
      </tr>

# Custom email body
        <tr>
            <td>{{eventRelatedViolationProductName}}</td>
            <td>{{eventRelatedViolationProductVendor}}</td>
            <td>{{eventRelatedViolationProductVersion}}</td>
            <td>{{eventRelatedViolationProductRecommendationVersion}}</td>
            <td>{{eventRelatedViolationProductCvssMax}}</td>
            <td>{{eventRelatedViolationProductCvesExplicit}}</td>
            <td>{{eventRelatedInstanceDisplayName}}</td>
            <td>
                <a href="{{eventRelatedViolationUrl}}" style="color:#003964;">Violation</a>
            </td>
        </tr>

# Custom email footer
    </table>

    <p>
      Enter general information here (e.g. contact details). 
    </p>
    <p>
      Send by Versio.io platform
    </p>
  </body>
</html>

Assessment change¶

# Custom email header
<!DOCTYPE html>
<html lang="de">
  <head>
    <meta charset="utf-8" />
    <title>Assessment change</title>
  </head>
  <body style="font-family:Arial, Helvetica, sans-serif; font-size:14px; color:#111111;">
    <p>There were <strong>{{eventCount}}</strong> new assessment changes:</p>
    <table width="100%" cellpadding="6" cellspacing="0" border="1" style="border-collapse:collapse; border-color:#cccccc;">
        <tr style="background-color:#003964; color:#ffffff;">
            <th align="left">Product</th>
            <th align="left">Vendor</th>
            <th align="left">Version</th>
            <th align="left">Recommended version</th>
            <th align="left">Severity/CVSS (max)</th>
            <th align="left">Vulnerabilities</th>
            <th align="left">Instances</th>
            <th align="left">Link</th>
        </tr>

# Custom email body
        <tr>
            <td>{{productName}}</td>
            <td>{{productVendor}}</td>
            <td>{{productVersion}}</td>
            <td>{{productRecommendationVersion}}</td>
            <td>{{cvssMaxExplicit}}</td>
            <td>{{cvesExplicit}}</td>
            <td>{{eventRelatedInstances}}</td>
        <td>
            <a href="{{eventUrl}}" style="color:#003964;">Event</a>
        </td>
        </tr>

# Custom email footer
    </table>

    <p>
      Enter general information here (e.g. contact details). 
    </p>
    <p>
      Send by Versio.io platform
    </p>
  </body>
</html>