Skip to main content
The QR Code URL Extraction feature is executed on MTAs and it not only scans raster images for QR codes and extracts URLs from them, but also includes the ability to extract QR code URLs from PDF attachments, ensuring a broader and more effective security measure. By default, this feature is enabled and renders a limited number of pages of every PDF attachment. If the default settings meet your needs, no further action is required. However, if you wish to customize these settings, please follow the instructions in the next sections. As an on-prem user, you can also decide what type of email traffic the rendering process is applied to in order to save some computing power. Since the rendering of mail body preview is quite demanding, it is disabled for most messages with the EXECUTE_MAIL_RENDER_PREVIEW_INSTRUCTION_* rule. File preview rendering, controlled by the EXECUTE_FILE_RENDER_PREVIEW_INSTRUCTION_ rule, is applied more broadly.
Which traffic is rendered by default, and the delivered values of the parameters below, are documented in Detection Defaults → QR code analysis. Password required.
You can change this behavior in Expert Editor in the local.properties file located at activeguard/core/rule_sets/90_local/params/ by setting the following parameters to ACTIVE or DISABLED:
Enabling FILE or MAIL rendering can significantly increase the resource usage on the MTA.
When enabling one of these FILE_RENDER rules:
you must also enable the two FILE_QR_EXTRACTION rules, otherwise they have no impact:

Enabling/disabling QR code URL extraction

  1. Open Expert Editor and go to the file located at activeguard/core/active_guard.yml.
  2. The following configuration represents the default settings, which are automatically applied in the absence of explicit qrCodeService configurations in the active_guard.yml file.
To disable the QR Code URL Extraction feature, simply change enabled: true to enabled: false.

Customizing extraction from PDF attachments

For a more tailored approach to handling PDF attachments, you can adjust how the system renders PDF pages for QR code extraction:
  1. In Expert Editor, open the activeguard/core/active_guard.yml file.
  2. Locate or add the pdfFileRenderService section to adjust the rendering settings for PDF attachments as needed:
The delivered PDF rendering values are documented in Detection Defaults → QR code analysis. Password required.
By following these steps, you can activate and configure the QR Code URL Extraction feature according to your organization’s specific needs. Adjusting the PDF rendering settings allows for flexibility in balancing performance with the thoroughness of QR code scanning within your documents.