Scanning Files Attached to Issues
By default, Security for Jira scans files attached to issues.
Most common document types are supported.
Any files which are 200MB or larger are skipped.
Archives (e.g.
.zip
,.rar
, and.gz
) are not supported yet.
Supported File Types
File Type | File Extensions |
---|---|
PDFs |
|
Microsoft Word Documents |
|
Microsoft Excel Spreadsheets |
|
Microsoft Powerpoint Presentations |
|
Microsoft OneNote Pages |
|
Email Messages |
|
XPS Documents |
|
Rich Text Documents |
|
Ebooks |
|
OpenOffice / LibreOffice Documents |
|
OpenOffice / LibreOffice Spreadsheets |
|
OpenOffice / LibreOffice Presentations |
|
WordPerfect Documents |
|
Plain text formats | Any extension not listed above is scanned as plain text. For example, |
Enabling and Disabling Attachment Scanning
We recommend leaving attachment scanning enabled, for the best security coverage. Nevertheless, you can turn attachment scanning on or off by navigating to the settings page, and toggling the “Scan attachments” setting.
![](../../__attachments/14956068932/Screenshot%202023-12-22%20at%208.47.44%E2%80%AFAM-20231222-144805.png?inst-v=dd2e15ff-a066-4891-84cc-df8425dc8a25)
Exporting Information About Scanned Attachments
To get information about which attachments Security for Jira scanned, skipped, or failed to scan, you can export information about scanned attachments. These exports are CSV formatted with the following columns:
Issue key
Issue summary
File name
Attachment ID
File size
Scan status - will be one of the following:
UNSCANNED
SCANNED
FAILED
Reason for not scanning - If the file is not scanned, then this will have a reason code:
UNSUPPORTED_FORMAT
ENCRYPTED
TOO_BIG
PARSE_ERROR
Error message - an optional error message which may indicate why scanning the attachment failed.
From the Soteri Dashboard, you can export attachment scan information for all attachments in all projects you can view reports for:
![](../../__attachments/14956068932/Screenshot%202023-12-22%20at%2012.30.36%E2%80%AFPM-20231222-183054.png?inst-v=dd2e15ff-a066-4891-84cc-df8425dc8a25)
From the Security Analysis page, you can export attachment scan information for a specific project:
![](../../__attachments/14956068932/Screenshot%202023-12-22%20at%209.00.24%E2%80%AFAM-20231222-150043.png?inst-v=dd2e15ff-a066-4891-84cc-df8425dc8a25)
You can also export this information using our REST API.