Displays detailed information about all the policy settings about email malware analysis.
Note
Use the
show email-analysis policycommand 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 " |
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-trackingparameter was added in Release 7.6. Command output was enhanced to include theTyposquattingsetting in Release 7.8.0. Command output was enhanced to include theEnable Notice (tap mode)setting in Release 7.9.0. Use theshow analysis url-policycommand to verify the status for Advanced URL Defense, typosuatting detection, and URL phishing in Release 8.0. Command output was enhanced to include theText Attachment Analysissetting in Release 8.0. Command output was enhanced to include whether the advanced X-Header is enabled in Release 8.0.2.