Document toolboxDocument toolbox

Configuration

The settings are categorised into the following tabs:


File Type Blocking

Refer to Restrict attachments by file type for more info on the filtering.

Settings

Description

Settings

Description

Filter Mode

Filter mode for uploaded attachments:

  • Allowlist - Only configured file extensions are allowed default

  • Denylist - Only configured file extensions are blocked

Extensions

List of comma delimited file extensions to be filtered.

MIME Type Check

Checks the MIME type of the uploaded attachment:

  • Enabled default

  • Disabled

MIME Type checking provides additional protection because it is not possible to bypass file type checks by renaming the file extension.

Exceptions

Always allow files without extension

  • Checked (Allow)

  • Unchecked (Block) default

Always allow password protected Microsoft Office files

  • Checked (Allow)

  • Unchecked (Block) default

Always allow Microsoft Office files encrypted with sensitivity labels

  • Checked (Allow)

  • Unchecked (Block) default

Error Message

The error message to display when invalid files are being attached to the issue.

For example:

This file type is not allowed.

Actor

The user to add comment when attachments have been deleted due to invalid extension/mime type.

Leave blank to set as Anonymous.

Comment Visibility Service Desk

The security level of the comment added:

  • Public (Comments will be Public unless triggered by Service Desk Team)

  • Internal (All comments will be internal) default

 

File Size Checking

Settings

Description

Settings

Description

File Size Check

To check file size of uploaded attachment:

  • Enabled

  • Disabled default

Error Message

The error message to display when file size exceeds the limit.

For example:

Total Size Limit

The total attachment size limit per issue.

Enter '0' for no limit.

Total Size Limit Error Message

The error message to display when total attachment size in issue exceeds the limit.

For example:

 

Count Limit

Settings

Description

Settings

Description

Max Attachment Limit

The maximum number of attachments allowed per issue.

Enter '0' for no limit.

Error Message

The error message to display when number of attachments in the issue has reached the limit.

For example:

 

Duplicate Blocking

Settings

Description

Settings

Description

Block Same Filename

Prevent users from uploading when there is an existing attachment with the same filename:

  • Yes

  • No default

Error Message

The error message to display when there is an existing attachment with the same filename.

For example:

Delete Duplicates

To delete all duplicates except the oldest version:

  • Yes

  • No default

Actor

The user to delete duplicates and add comment.

Leave blank to set as Anonymous.

Comment Visibility Service Desk

The security level of the comment added:

  • Public (Comments will be Public unless triggered by Service Desk Team)

  • Internal (All comments will be internal) default

Disable Comment

Disable issue commenting when duplicates are deleted:

  • Yes

  • No default

Disable Update Notification

Disable issue updated notification when duplicates are deleted:

  • Yes

  • No default

 

Virus Scanning

Settings

Description

Settings

Description

Missing File Check

Add comment to alert user if the file is missing after they are uploaded:

  • Enabled

  • Disabled default

Virus Scanning

Scan attachments for virus after they are uploaded:

  • Enabled

  • Disabled default

Scanner Path

The full path to the command line scanner.

For example:

/usr/bin/clamscan

Additional Options

The additional options for the command line scanner. Leave empty if not required.

Exception Handling

If file is infected

Check the checkbox to:

  • Delete file

  • Email Jira Sysadmin Group

Any other errors

Check the checkbox to:

  • Delete file

  • Email Jira Sysadmin Group

Jira Sysadmin Group

The group to send an email on the details of the occurrence.

Alert Message

The error message to be added as comment when an infected file is detected.

Filename of the infected file will be included in the comment.

Actor

The user to add the virus alert comment.

Leave blank to set as Anonymous.

Comment Visibility Service Desk

The security level of the comment added:

  • Public (Comments will be Public unless triggered by Service Desk Team)

  • Internal (All comments will be internal) default

 

Notifications

Settings

Description

Settings

Description

Event to Fire

The event to fire when attachments are added/removed. This event can be used in the notification scheme.

 

Attachment Download Log

Settings

Description

Settings

Description

Logging Mode

Keep track of the user and date time of attachment downloads:

  • Enabled

  • Disabled default

 

Look and Feel

Settings

Description

Settings

Description

Attachment Field Text

The text to display in the Attachment field in issue view screen.

Supported variables:

  • ${totalSizeLimit}

  • ${maxAttachmentLimit}

Show Attachment Limits

Show attachment limits used and available in the Attachment field:

  • Enabled

  • Disabled default