show email-analysis

Prev Next

Shows all the configuration information about email analysis.

Syntax

show email-analysis

Parameters

None

Output fields

The following table describes the output fields for the Email-Analysis section of the show email-analysis command. For detailed information, see the Email Security — Server User Guide.

Field

Description

enabled

Whether analysis mode is enabled or disabled.

mode

Type of analysis mode that is enabled on the Email Security — Server appliance:

  • block—Block analysis mode is enabled.

  • drop—Drop analysis mode is enabled.

  • monitor—Monitor analysis mode is enabled.

  • tap—Tap/Span analysis mode is enabled.

For details about how each mode operates, refer to the Email Security — Server User Guide.

interface

Name of the network interface that is used for email analysis. The default network interface is pether3.

TLS receive mode

Options that are configured for transport layer security (TLS) when receiving mode is enabled:

  • None—No configurations use TLS.

  • Opportunistic—The connection accepts emails that are either TLS-encrypted or not TLS-encrypted.

  • Mandatory—TLS encryption is required for all connections.

TLS default deliv. mode

Options that are configured for TLS when the default delivery mode is enabled:

  • None—No configurations are configured with TLS.

  • Opportunistic—Emails are delivered over connections that are either TLS-encrypted or not TLS-encrypted.

  • Mandatory—TLS configuration is required for all connections.

  • Verify—Validation of the next-hop MTA server certificate is required before the TLS connection is established.

MTA certificate name

Name of the message transfer agent (MTA) certificate that verifies the identity of the Email Security — Server appliance to the downstream MTA. You can specify the certificate to be either "mta-cert" or "system-self-signed".

Password-protected objs

Whether objects are password-protected.

cipher list

Type of cipher list that is configured for X.509 (TLS/SSL) certificates.

minimum protocol version

Minimum protocol version that is used to secure email. The default is TLSv1.

Controlled-live-mode enabled

Whether controlled live mode is enabled. When you enable controlled live mode, the Email Security — Server appliance can detect malware that requires remote objects.

For details about controlled live mode, refer to the "Email MTA Configuration" chapter of the Email Security — Server User Guide.

URL dynamic analysis enabled

Whether URL Dynamic Analysis is enabled. When you enable URL Dynamic Analysis (also called DUA), the Email Security — Server appliance can analyze both the URL and the objects the URL references.

For details about URL Dynamic Analysis, "Email MTA Configuration" chapter of the Email Security — Server User Guide.

URL overlay detection enabled

Whether URL overlay detection is enabled. When you enable URL overlay detection, the Email Security — Server appliance can identify suspicious mismatches between the URLs that are embedded in an email message.

For details about URL overlay detection, refer to the "Monitoring Alerts" chapter of the Email Security — Server User Guide.

SNMP statistics interval

Time period to retrieve the SNMP statistics from the Email Security — Server appliance.

The following table describes the output fields for the Email-Analysis Policy section of the show email-analysis command.

Field

Description

Analyze URLs in body

When this option is enabled, URLs that are embedded in an email message body are analyzed.

Analyze attachments

When this option enabled, all email attachments are analyzed.

Analyze email using YARA

Whether YARA analysis is enabled.

Email YARA Weight Cap

The weights of the matched rules are totaled to determine an overall score for the sample.

Max Email Size (MB)

Maximum size (MB) limit for email to be submitted for analysis.

Analysis Timeout (sec)

Number of seconds after which the malware analysis stops if the analysis is not complete.

Analyze image URLs

When this option is enabled, a URL image is submitted for analysis.

Advanced URL Defense

Whether Advanced URL Defense is enabled. The option to parse HTTP links is automatically enabled when Advanced URL Defense is enabled.

Extract/Rewrite HTML URL as Text

Whether rewriting HTML URLs in email as text is enabled.

Max URLs Analyzed/email

Maximum number of URLs that are analyzed per email.

Max Att. Analyzed/email

Maximum number of attachments that are analyzed per email.

Congestion Bypass Mode

Whether bypass congestion mode is enabled.

Congestion Bypass Threshold

When the maximum number of objects in the attachments queue is exceeded, new incoming emails are accepted but are delivered without being analyzed.

Congestion Refuse-connnection Mode

Whether refuse-connection mode is enabled.

Congestion High Threshold

Maximum number of emails in the email queue. When the threshold is exceeded, the SMTP interface is disabled and all new incoming SMTP connections are refused.

Congestion Low Threshold

When the maximum number of emails in the email queue is exceeded, the SMTP interface is re-enabled and all new incoming SMTP connections are accepted.

Enable X Header

Whether the X-Header option is enabled. When deployed in block mode or monitor mode, the appliance adds the X-Headers to describe the analysis and detection results by the Multi-Vector Virtual Execution (MVX) engine.

Use Header for To/From

Whether the Header Envelope feature is enabled. When you enable the Header Envelope feature, the original To: and From: email header information is displayed in the eAlerts page and eQuarantine page in the Email Security — Server Web UI.

Parse HTTPS URLs

Whether the option to parse HTTP links is enabled.

Invoke Email Feature Extractor

Whether the pre-processor for email feature extraction is enabled.

Enable Notice (tap mode)

A notification message is sent to the recipient if a malicious email was detected in Tap/Span mode.

Enable Notice (block mode)

A block notification message is sent to the list of recipients when the Email Security — Server appliance is deployed in block mode.

Block notice from

The From email address header of a block notification message.

Block notice subject

The Subject header of a block notification message.

Block Admin Recipient(s)

Administrators are added to the list of recipients to receive the block notification message.

Block BCC Recipient(s)

Bcc recipients are added to the list of recipients to receive the block notification message.

TypoSquatting

Whether the typosquatting detection feature is enabled. When you enable typosquatting detection, the appliance can analyze suspicious sender and URL domains used in URLs within an email message body.

The following table describes the output fields for the Email-Analysis Quarantine section of the show email-analysis command.

Field

Description

size

Maximum size of the quarantine in gigabytes. The maximum size is 50 GB. The default size is 20 GB.

cleanup enable

Whether the option to automatically remove emails from the quarantine is enabled.

cleanup keep

Number of days to keep the emails in the quarantine before they are automatically removed.

high-water threshold

Maximum amount of space that can be used in the quarantine. The default threshold is 90 percent.

low-water threshold

Minimum amount of space that can be used in the quarantine. The default threshold is 60 percent.

The following table describes the output fields for the Domain(s) section of the show email-analysis command.

Field

Description

domain

Name of the domain.

next hop mta

IP address of the next-hop appliance.

MX Enable

Whether the option to use DNS MX record translation on the next-hop IP address is enabled.

TLS mode

Type of TLS policy (opportunistic, mandatory, or verify) that is configured for the MTA to use DNS MX record translation on the next-hop IP address. If a TLS policy is not specified, the value none is used.

Block Notice Enable

Enables or disables sending blocked email notifications to the email recipients on all subdomains of the specified domain. Block notification for global domains must be enabled before individual domain notifications can function.

Subdomain Relay Enable

Enables or disables email on all subdomains for the specified domain.

weight

Weighting value that is specified for outbound connections that need to go to that MTA. The total of the weighting values assigned to the next-hop entries must equal 100.

Example

The following example shows the configuration for email analysis.

hostname # show email-analysis 
  Email-Analysis:
    enabled:                   yes
    mode:                      monitor  
    interface:                 pether3
    TLS receive mode:          none
    TLS default deliv. mode:   none
    MTA certificate name:      system-self-signed
    Password-protected objs:   yes
    cipher list:               compatible
    minimum protocol version:  tls1
    Controlled-live-mode enabled: no
    URL dynamic analysis enabled: no
    URL overlay detection enabled: yes
    SNMP statistics interval:  1 (days)  1 (hours) 5 (minutes)
 Email-Analysis Policy:
      Analyze URLs in body:      yes
      Analyze attachments:          yes
      Analyze email using YARA:     yes
      Email YARA Weight Cap:        30
      Max Email Size (MB):          35
      Analysis Timeout (sec):       240
      Analyze image URLs:           yes
      Advanced URL Defense:         no
      Extract/Rewrite HTML URL as Text:    no
      Max URLs Analyzed/email:      5
      Max Att. Analyzed/email:      20
      Congestion Bypass Mode:   yes
      Congestion Bypass Threshold:   2000
      Congestion Bypass Unprocessed Limit:  0
      Congestion Refuse-connnection Mode:   yes
      Congestion High Threshold:    10000
      Congestion Low Threshold:     9000
      Enable X Header:              no
      Use Header for To/From:       yes
      Parse HTTPS URLs:             no
      Invoke Email Feature Extractor:    yes
      Enable Notice (tap mode):     yes
      Enable Notice (block mode):   yes
      Block notice from:            admin@do-not-reply.com
      Block notice subject:         Malicious email detected
      Block Admin Recipient(s): 
      Block BCC Recipient(s): 
      TypoSquatting:                yes
    Email-Analysis Quarantine:
      size:                      80
      cleanup enable:            yes
      cleanup keep:              30
      high-water threshold:      90
      low-water threshold:       60
      Domain(s):
    domain: mydomain3.com
       next hop mta: 172.17.74.400
       MX Enable: false
       TLS mode: none
       Block Notice Enable:	true
       Subdomain Relay Enable:	false			
    domain: mydomain4.com
       next hop mta: 172.16.244.100
       weight: 40
       next hop mta: 172.16.244.200
       weight: 20
       next hop mta: 172.16.244.300
       weight: 20
       next hop mta: 172.16.244.400
       weight: 20
       TLS mode: none
       Block Notice Enable:	true
       Subdomain Relay Enable:	false

User role

Admin, Operator, Monitor, or Analyst

Command mode

Enable

Supported appliances

This command is supported on the following appliances running the specified releases or later:

  • Email Security — Server: Before Release 6.4. Command output was enhanced to include the URL overlay detection setting in Release 8.0. Command output was enhanced to include the SNMP statistics interval time period in Release 8.1. Command output was enhanced to include the number of minutes in the SNMP statistics interval field in Release 8.1.2.