Table of Contents |
---|
...
Introduction
The Attachment Checker allows all uploaded attachments to be checked scanned with an external anti-virus scanner when they are uploaded.
This addresses the feature request raised in https://jira.atlassian.com/browse/JRA-8626 (Virus Scan Attachment)
...
...
Only the Confluence administrator can access this page
When an attachment is addeduploaded, a request is sent to scan the uploaded file. The request is handled asynchronously so that users need do not have to wait for the scanning to be completed especially if the file is large.
This addresses the feature request raised in JRA-8626
When a file is suspected to be infected, depending on your configurations, as of v.1.4.0 the following follow-ups could happen when the Delete Virus File option is enabled or disabled
...
(Virus scan attachments).
Info |
---|
Only Confluence administrators can access the configuration page. |
...
All non-zero codes are treated as infected if the virus scanner is unknown. Refer to list of compatible scanners for more info.
When an infection is detected or error occurs during scanning, a comment will be added and the following actions may be taken:
Actions | Description |
---|---|
Delete file |
|
|
|
|
|
|
The infected file would not be removed automatically.
by
Comment
Info |
---|
By default, Anonymous user would create a comment. Thus you would not need to create an account for the comment to be create. |
A comment to inform user that an infected file has been detected and replaced with a placeholder
A comment to inform the user to delete the infected file
When the user tries to open the infected file, it would be replaced with placeholder looking like this,
Email Confluence Sysadmin Group |
|
Comments
Delete file enabled | Delete file disabled | |
---|---|---|
If file is infected | ||
Any other errors |
Emails
Delete file enabled | Delete file disabled | |
---|---|---|
If file is infected | ||
Any other errors |
Placeholder
This is how the placeholder looks like when user preview the infected file:
...
How to set up the virus scanner
Install a 3rd-party virus scanner. Please refer to the list of
...
The paths would call a script, which calls the scanner's exe file.
...
Go to Attachment Checker Configuration → Virus Scanning tab.
Enable the Virus Scanning toggle button.
In Scanner Path field, enter the full path to the command line scanner or a script which calls the command line scanner.
In Additional Options field, enter the options if required.
Using command line scanner
Enter the full path to the command line scanner, for example:
Scanner Path | Additional Options |
---|---|
| |
|
|
Using script
You can also create a script (e.g. scanner.cmd) containing this script with options e.g.which calls the command line scanner in the script, for example:
Code Block |
---|
@echo off echo executing scan for %1 c:\progra~1\window~1\MpCmdRun.exe -Scan -ScanType -File "%1" echo "returning errorLevel = " %ERRORLEVEL% EXIT /B %ERRORLEVEL% |
As the script above contains some shorthand directory, you can retrieve shorthand commands through: dir /x
Related Information
...
Variables
The following variables can be used in the Additional Options:
Variable | Description |
---|---|
| The attachment id |
| The attachment creator’s username |