Blocklisting

Owned by Ryan Clifton
Last updated: Apr 01, 2024 by Andy Brook [Plugin People]
6 min read

Summary

Blocklisting is a set of rules that is used to stop unwanted content from being processed by JEMH. Emails can be blocklisted to stop them from being processed, and attachments can be blocklisted to prevent addition to issues. Rules set here apply to all profiles.

Project View

JEMH Admin view

Project View

JEMH Admin view

 

 

Blocklist by Email Subject

These are Regular Expressions (Regex) that are used to match a target email subject. Matching emails will be dropped silently and recorded within Auditing if enabled.

Creating new Subject Blocklist

  1. Press the Create a Blocklisted Subject button.

  2. This will then show a text-box where you enter the Regex that will match on the subject of the email. Once completed, press Submit.

  3. Once submitted, you will then see the new Blocklist Subject within the list.

Configuration Options

Once you have created a Subject Blocklist there will be some options that will allow you to modify and delete that Subject Blocklist.

Edit (Pen Icon)

This will open the edit box which allows you to modify the Regex.

Delete (Bin Icon)

This will remove that Subject Blocklist and will then allow emails with that subject to be processed further.

Import Section

This allows you to import previously made Subject Blocklists into this Jira instance. This requires a ZIP file to be uploaded that has a XML inside that includes the Subject Blocklists.

Export Section

This allows you to export all of your Subject Blocklists so that they can be backed up or so they can be imported into a different Jira instance. When used it will create a ZIP that contains the Subject Blocklists.

Blocklist by URL

HTML emails can refer content by absolute URL, which JEMH can inline through wiki markup. This section allows specific image URLs or regular expression wildcards to be removed from all descriptions and comments.

Creating new Image URL Blocklist

  1. Press the Create a Blocklisted Image URL button.

  2. This will then show a text-box where you enter either the Image URL or the Regex that will match a specific Image URL. Once completed, press Submit.

  3. Once submitted, you will then see the new Blocklisted Image URL within the list.

Configuration Options

Once you have created a Subject Blocklist there will be some options that will allow you to modify and delete that Subject Blocklist.

Edit (Pen Icon)

This will open the edit box which allows you to modify the Regex.

Delete (Bin Icon)

This will remove that Subject Blocklist and will then allow emails with that subject to create issues.

Blocklist Attachment by Size and Mime Type

This allows you to blocklist attachments by their size and/or Mime Type.

Creating a new Size and Mime Type blocklist

  1. Press the Create a Blocklist by size button

  2. Enter the file size (in bytes) and optionally a valid MIME media type. Once complete press the Submit button.

  3. Once submitted, you will then see the new Blocklisted within the list.

Configuration options

Attachment Minimum Size (bytes)

This defines the minimum size of the attachments that can be added to issues.

Mime Type

This defines the Mime Type that the Blocklist should be applied to. If left blank then this Blocklist will apply to all Mime Types.

Edit (Pen Icon)

This will open the edit box which allows you to modify the size and the Mime Type for the Blocklist.

Delete (Bin Icon)

This will remove that Blocklist and will then allow attachments that is smaller than the Attachment Minimum Size (bytes) to be added to issues.

Blocklist Attachment by Fingerprint

In this section, targeted attachment blocking will be used. This keeps a record of the MD5 hash of a file and compares it against incoming attachments.  If a match is found, the attachment will not be added.  

Note: This blocklisting feature only works if the exact same attachment is found in an incoming email.  For example, two image files can look exactly the same but if one of them has had some meta-data added to it (comments, camera information etc.) then they are considered different files.

Creating a Blocklist for a single file

  1. Press the Create a Blocklisted Attachment button

  2. This will show the configuration options for selecting the attachment to block. Here you press Choose file and select the relevant File.

  3. Once configured you will see the attachment within the Blocklist

Creating multiple Blocklist’s for a zip file

If you want to block a set of images from an issue, just download them from the issue in a zip (download all) then upload that zip here:

 

  1. Press the Choose File button next to Upload ZIP

  2. Select the relevant ZIP folder that has the attachments and then press Upload.

  3. Once uploaded you then see the attachments that were contained within the ZIP file.

 

Configuration options

Delete (Bin Icon)

This will remove that attachment Blocklist and will that attachment to be added to issues.

Find and remove exact matches in a given project

Searches all attachments within a specific project and will remove any attachments that are exact matches.

Find and remove exact matches in ALL projects

Searches all issues in Jira for attachments that are exact matches to this attachment blacklist.