Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The settings are categorised into the following tabs:

Table of Contents

...

File Type Blocking

Info

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

Settings

Description

Default

Filter Mode

The filter

Filter mode for uploaded attachments:

  • Allowlist - Only configured file extensions are allowed

    Status
    titledefault

  • Denylist - Only configured file extensions are blocked

Allowlist

Extensions

Enter list

List of comma delimited file extensions to be filtered

jpg

Exceptions

Check the checkbox to:

.

MIME Type Check

Checks the MIME type of the uploaded attachment:

  • Enabled

    Status
    titledefault

  • Disabled

Tip

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)

    Status
    titledefault

Always allow password protected Microsoft Office files

  • Checked (Allow)

  • Unchecked

Check the checkbox to:
  • (Block)

    Status
    titledefault

Always allow Microsoft Office files encrypted with sensitivity labels

  • Checked (Allow)

  • Unchecked (Block)

    Error message
    • Status
      titledefault

    Error Message

    The error message

    displayed

    to display when invalid files

    are attached

    are being attached to

    an

    the issue

    Please update the error message in the Attachment Checker configuration

    .

    For example:

    Warning

    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

    Comments
    (For

    .

    Comment Visibility

    Status
    colourBlue
    titleService 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)

      Status
      title

    Internal
    • default

    File Size Checking

    Info

    Refer to Limit the file size for different user groups for more info on setting the file size limits.

    Settings

    Description

Default

File Size Check

Check

To check file size

if

of uploaded attachment:

  • Enabled

  • Disabled

    Enable
    • Status

    Disable
    • title

    Disabled
    • default

    Error Message

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

    For example:

    Warning

    The file size has exceeded the maximum size limit.

    Total Size Limit

    The total attachment size limit per issue.

    Enter '0' for no limit.

No limit

Total Size Limit Error Message

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

For example:

Warning

The total attachment size in this issue has exceeded the limit.

Count Limit

Settings

Description

Default

Example

Max Attachment Limit

The maximum number of attachments allowed

for each

per issue.

 

Enter '0

if

' for no limit

is to be enforced

.

Tip

If no

attachment

attachments are allowed, admins can revoke

the 

the Create

Attachments 

Attachments permission in the permission schemes

0

0
5
100 

Max Attachment

.

Error Message

The error message to display

to the user

when

maximum 

number of attachments

has exceeded. 

in the issue has reached the limit.

For example:

Warning

The number of attachments

for

in this issue has

exceeded

...

reached the limit.

Duplicate Blocking

Settings

Description

Default

Example

Block Same Filename

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

.

:

  • Yes

  • No

    Status
    titledefault

Error Message

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

For example:

Warning

There is another file with the same name. Please check

and rename Delete all copies

and rename your file.

Delete Duplicates

Ensure only 1 unique copy of newly added attachments.

To delete all duplicates except the oldest version

.

Duplicate Blocking mode is disabled when user creates ticket from Jira Service Desk Customer Portal. Customer portal user can only upload attachment after a ticket is being created

Virus Scanning

Choose whether to enable the on access scanning of attachments

:

  • Yes

  • No

    Yes
    • Status
      title

    No
    • default

    Actor

    Specify the

    The user to delete duplicates and add comment.

    Leave blank to set as Anonymous.

Anonymous

Settings

Description

Default

Example

On Access Scanning

Comment Visibility

Status
colourBlue
titleService 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)

    Status
    titledefault

Disable Comment

Disable issue commenting when duplicates are deleted:

  • Yes

  • No

    Status
    titledefault

Disable Update Notification

Disable issue updated notification when duplicates are deleted:

  • Yes

  • No

    Status
    titledefault

Virus Scanning

Info

Refer to Additional steps for virus scanning set up for more detailed steps.

Attachment Download Log

...

Settings

...

Description

...

Default

...

Example

...

Logging Mode

...

Whether to enable the logging of attachments downloaded for each Jira issue.

...

Enable

...

Enable
Disable

Accessing Configuration Panel

To access the configuration panel:

...

Go to the Jira Administration -> Add-ons

...

Click on Manage add-ons

...

Click on the Attachment Checker for Jira to expand the panel 

...

The Attachment Checker Settings page will be loaded 

...

Settings

Description

Missing File Check

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

  • Enabled

  • Disabled

    Disabled
    • Status

    Enabled
    • title

    Disabled
    • default

    Virus Scanning

    Choose whether to enable the scanning of attachments

    Please refer to Additional steps for anti-virus scanning for instructions to set up the virus scanning.

    Event Notification

    ...

    Settings

    ...

    Description

    ...

    Default

    ...

    Example

    ...

    Event to fire

    ...

    The notification event to fired when there is any modification made to attachments

    ...

    None

    ...

    Issue Updated

    Scan attachments for virus after they are uploaded:

    • Enabled

    • Disabled

      Disabled
      • Status

      Enabled
      • title

      Disabled
      • default

      Scanner Path

      The full path to the command line scanner.

      For example:

      Code Block
      /usr/bin/
      sweep
      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.

       

      It

      Filename of the infected file will be

      appended after the filename of the infected file

      virusfile.exe - Please delete the file and upload the disinfected one

    Please delete the file and upload the disinfected one

    Delete Virus Files

    Whether to delete the infected attachment automatically 

    No

    Yes
    No 

    included in the comment.

    Actor

    The user to add the virus alert comment.

    Leave blank to set as Anonymous.

    Comment Visibility

    Status
    colourBlue
    titleService 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)

      Status
      titledefault

    Notifications

    Info

    Refer to Email notification for attachment updates for more info.

    Settings

    Description

    Event to Fire

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

    Tip

    It is recommended to create a separate Attachment Updated event.

    Attachment Download Log

    Info

    Refer to Restrict attachment downloads for more info on how to restrict groups and/or project roles from downloading attachments.

    Settings

    Description

    Logging Mode

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

    • Enabled

    • Disabled

      Status
      titledefault

    Look and Feel

    Info

    Refer to Display text for attachment upload for more info.

    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

      Status
      titledefault