av-service/README.md
2025-05-05 12:17:45 +03:00

53 lines
No EOL
2.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# **av-service**
`av-service` — это сервис, взаимодействующий с Kaspersky Endpoint Security для Linux (KESL) на одной машине.
Основная задача сервиса — обеспечение защиты и анализа файлов с помощью интеграции с KESL.
Сервис использует консольные команды для выполнения операций и взаимодействия с KESL, таких как запуск задач проверки и получение результатов анализа.
---
## **Основные функции**
- Проверка файлов на наличие угроз с использованием KESL.
- Обработка файлов через POST-запросы.
- Логирование результатов проверки.
---
## **Требования**
- **Java 17**
- **KESL** (установлен и настроен на одной машине с сервисом)
---
## **Конфигурация и запуск**
### **1. Конфигурация параметров для сервиса**
Для корректного запуска сервиса добавьте следующие параметры в файл `application.yaml`:
```yaml
file:
upload:
directory: '/tmp/uploaded_files' # Путь для хранения временных файлов
spring:
servlet:
multipart:
max-file-size: 10MB # Максимальный размер загружаемого файла
max-request-size: 10MB # Максимальный размер запроса
server:
port: 8080 # Порт, на котором работает сервис
```
Для проверки ответов от KESL, при обнаружении архива с паролем, следует в файл `application.yaml` добавить следующий параметр:
```yaml
password:
protected:
result:
names: [
'Объекты, защищенные паролем',
'Password-protected objects'
]
```
### **2. Запуск JAR-файла с конфигурационным файлом**
```bash
java -jar app.jar --spring.config.location=file:/path/to/your/application.yaml -Dfile.encoding=UTF8
```
Ссылка на av-service задаётся в перекладчике (сервис ervu-lkrp-av) в параметре AV_REST_ADDRESS. Пример - AV_REST_ADDRESS=http://10.10.10.10:8080/av-wrapper/scan-file