show email-analysis policy

Prev Next

Displays detailed information about all the policy settings about email malware analysis.

Note

Use the show email-analysis policy command to verify the status for Advanced URL Defense, typosquatting detection, and URL phishing in Release 8.0.

Syntax

show email-analysis policy [message-tracking]

Parameters

message-tracking

(Optional) Displays the maximum number of days to retain email records for message tracking.

Output fields

The following table describes the output fields for the show email-analysis policy command. Fields are listed in the approximate order in which they appear in the output.

Field

Description

Analyze URLs in body

Whether URL scanning is enabled so that the Email Security — Server appliance can scan URLs within an email message body and either allow or block access to URLs.

Analyze attachments

Whether the EMPS_ATTACHMENT_SCAN license is enabled so that the Email Security — Server appliance can submit email attachments for analysis.

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 (mins)

Number of minutes 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 number of objects in the attachments queue exceeds this threshold, new incoming emails are accepted but are delivered without being analyzed.

Congestion Refuse-connnection Mode

Whether refuse-congestion mode is enabled.

Congestion High Threshold

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

Congestion Low Threshold

When the number of emails in the email queue falls below this threshold, the SMTP interface is re-enabled and all new incoming SMTP connections are accepted.

Enable X Header

Whether the X-Header option is enabled. If the advanced X-Header option is enabled, the "Adv. X-header" setting is displayed. When deployed in block mode or monitor mode, the appliance adds the X-Headers to describe the analysis and detection results by the Multivector 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 email feature extraction is enabled. When you enable email feature extraction, the Email Security — Server appliance can scan the header and parts of the message body and extract the email features.

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.

Monitoring Enabled

Whether the monitor policy is enabled.

Monitoring Interval (min)

Monitor alert interval period in minutes.

Monitoring Bypass Threshold

Monitor alert bypass threshold limit.

Monitoring Deferred Threshold

Monitor alert threshold limit in the deferred queue.

Monitoring Backoff (sec)

Monitor alert backoff period in seconds.

Text Attachment Analysis

Whether the option to submit an ASCII text attachment for analysis is enabled.

Image Analysis

Whether the option to submit an image attachment for analysis is enabled.

Examples

The following example displays all the policy settings about email malware analysis.

hostname # show email-analysis policy
  
  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 (mins):      10
    Analyze image URLs:           yes
    Advanced URL Defense:         yes
    Extract/Rewrite HTML URL as Text:    no
    Max URLs Analyzed/email:      100
    Max Att. Analyzed/email:      20
    Congestion Bypass Mode:   yes
    Congestion Bypass Threshold:   3000
    Congestion Refuse-connnection Mode:   yes
    Congestion High Threshold:    10000
    Congestion Low Threshold:     9000
    Enable X Header:              no
    Use Header for To/From:       no
    Parse HTTPS URLs:             yes
    Invoke Email Feature Extractor:    yes
    Enable Notice (tap mode):     yes
    Enable Notice (block mode):   no
    Block notice from:            admin@do-not-reply.com
    Block notice subject:         Malicious email detected
    Block Admin Recipient(s):
      admin_haiti@haiti.com
    Block BCC Recipient(s):
      bcc_haiti@haiti.com
    TypoSquatting:                yes
    Monitoring Enabled  :      no
    Monitoring Interval (min): 15
    Monitoring Bypass Threshold:   1
    Monitoring Deferred Threshold: 100
    Monitoring Backoff (sec):      3600
    Text Attachment Analysis:      no
    Image Analysis:                no

The following example shows the maximum number of days to retain email records.

hostname # show email-analysis policy message-tracking
Numbers of days of messages-tracking data retained:   18

User role

Admin, Analyst, Operator, or Monitor

Command mode

Enable

Supported appliances

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

  • Email Security — Server: Before Release 7.5. The message-tracking parameter was added in Release 7.6. Command output was enhanced to include the Typosquatting setting in Release 7.8.0. Command output was enhanced to include the Enable Notice (tap mode) setting in Release 7.9.0. Use the show analysis url-policy command to verify the status for Advanced URL Defense, typosuatting detection, and URL phishing in Release 8.0. Command output was enhanced to include the Text Attachment Analysis setting in Release 8.0. Command output was enhanced to include whether the advanced X-Header is enabled in Release 8.0.2.