nextcloud
/
files_antivirus
зеркало из https://github.com/nextcloud/files_antivirus.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность
👾 Antivirus app for Nextcloud Files
1 042 коммитов 19 Ветки 51 Тег 5,4 MiB
JavaScript 61.1%
PHP 38.6%
CSS 0.3%
Перейти к файлу
Nextcloud bot 2649698acd
[tx-robot] updated from transifex 
Signed-off-by: Nextcloud bot <bot@nextcloud.com>
 		2022-07-08 02:40:34 +00:00
.github Create fixup.yml 2022-06-24 11:33:44 +02:00
.tx Add transifex config 2018-02-27 14:08:40 +01:00
appinfo 3.3.0 changelog 2022-05-25 14:47:40 +02:00
css test the connection to the av when saving settings 2020-08-31 15:00:46 +02:00
img Add dark shield as activity fitler icon 2018-03-06 21:34:35 +01:00
js stricter types 2022-04-13 14:21:12 +02:00
l10n [tx-robot] updated from transifex 2022-07-08 02:40:34 +00:00
lib Merge pull request #236 from nextcloud/fix/handle-encryption-errors 2022-06-24 11:33:18 +02:00
screenshots Update README.md 2018-07-05 10:31:08 +02:00
templates add icap preset selector 2022-04-13 14:21:12 +02:00
tests Handle encryption error 2022-06-23 17:47:05 +02:00
.gitignore github ci 2021-06-02 16:42:24 +02:00
.nextcloudignore Version 3.2.2 2021-09-14 22:47:49 +02:00
.php_cs.dist github ci 2021-06-02 16:42:24 +02:00
.scrutinizer.yml Adding proper travis integration 2014-11-14 13:21:39 +01:00
CHANGELOG.md 3.3.0 changelog 2022-05-25 14:47:40 +02:00
LICENSE Add licence file to repo 2018-03-02 15:45:29 +01:00
README.md note about icap version 2022-05-25 14:31:57 +02:00
composer.json psalm analysis and fixes 2022-04-19 10:20:38 +02:00
composer.lock psalm analysis and fixes 2022-04-19 10:20:38 +02:00
krankerl.toml fix krankerl config 2020-08-31 15:00:46 +02:00
psalm.xml psalm analysis and fixes 2022-04-19 10:20:38 +02:00

README.md

Nextcloud Antivirus for Files

Build Status Scrutinizer Code Quality Code Coverage

files_antivirus is an antivirus app for Nextcloud using ClamAV, Kaspersky or an ICAP compatible scanner.

Features

  • 🐿️ When the user uploads a file, it's checked
  • ☣️ Infected files will be deleted and a notification will be shown and/or sent via email
  • 🔎 It runs a background job to scan all files

Requirements

One of

  • ClamAV as binaries on the Nextcloud server
  • ClamAV running in daemon mode
  • Kaspersky Scan Engine running in HTTP mode
  • Any virus scanner supporting ICAP (ClamAV and Kaspersky are tested, others should work)

Install

Documentation about installing ClamAV and this app can be found in our documentation.

ClamAV Details

This app can be configured to work with the executable or the daemon mode (recommended ❤️) of ClamAV. If this is used in daemon mode, it can connect through network or local file-socket. In daemon mode, it sends files to a remote/local server using the INSTREAM command.

Kaspersky HTTP Details

When running Kaspersky in HTTP mode the SessionTimeout will need to be set to a value higher than default, a value of 10 minutes (600000 millisecond) or higher is recommended to properly deal with larger uploads

ICAP (version 4.0 and later)

The app support the ICAP protocol which is a standard supported by various antivirus software products.

Some additional configuration is required depending on the antivirus software used:

  • ICAP service: The name of the service the antivirus software expects
  • ICAP virus response header: The name of the header the antivirus software send the details of the detected virus in

ClamAV ICAP

  • ICAP service: avscan
  • ICAP virus response header: X-Infection-Found

Kaspersky ICAP

  • ICAP service: req
  • ICAP virus response header: X-Virus-ID

Additionally, the Kaspersky scan engine needs some additional configuration: