HOME

Mini Shell 1.0
DIR:/opt/imunify360/venv/lib/python3.11/site-packages/imav/malwarelib/utils/
Current File : //opt/imunify360/venv/lib/python3.11/site-packages/imav/malwarelib/utils/revisium.py
"""
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License,
or (at your option) any later version.


This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
See the GNU General Public License for more details.


You should have received a copy of the GNU General Public License
 along with this program.  If not, see <https://www.gnu.org/licenses/>.

Copyright © 2019 Cloud Linux Software Inc.

This software is also available under ImunifyAV commercial license,
see <https://www.imunify360.com/legal/eula>
"""
import csv
import json
import os
import sys
import time
from contextlib import suppress
from enum import IntEnum
from pathlib import Path
from typing import Optional

from defence360agent.contracts.config import Core
from defence360agent.utils import snake_case


class DeletionType(IntEnum):
    INJECTION_REMOVED = 0
    REMOVED_BY_INJECTION_SIGNATURE = 1
    REMOVED_BY_SA_DELF_SIGNATURE = 2
    REMOVED_BY_SA_ODFL_SIGNATURE = 3
    REMOVED_BY_CAS_SIGNATURE = 6
    REMOVED_ELF = 7
    PATCH_APPLIED = 10


class ErrorType(IntEnum):
    NO_ERROR = 0
    FILE_TOO_BIG = 1
    FILE_READING_ERROR = 2
    FILE_NONE_WRITE = 3
    NOT_CLEANEDUP = 4
    FILE_NOT_EXISTS = 5
    FILE_MATCHED_NOT_CLEANED = 6


class RescanResultType(IntEnum):
    CLEAN = 0
    DETECTED = 1
    REQUIRED_ADVANCED_SIGNATURES = 2


class RevisiumTempFile:
    ext = "txt"

    def __init__(self, tempdir=None, mode=None):
        self.tempdir = Path(Core.TMPDIR) if tempdir is None else Path(tempdir)
        self.mode = mode

    def __enter__(self):
        filename = "%s_%d.%s" % (self.name, int(time.time() * 10e6), self.ext)
        self._path = self.tempdir / filename
        if self.mode:
            self._path.touch()
            os.chmod(str(self._path), mode=self.mode)
        return self

    def __exit__(self, *_):
        with suppress(FileNotFoundError):
            self._path.unlink()

    @property
    def filename(self):
        return str(self._path)

    @property
    def name(self):
        return snake_case(self.__class__.__name__)


class RevisiumJsonFile(RevisiumTempFile):
    ext = "json"

    def read(self):
        with self._path.open() as f:
            return json.load(f)


class RevisiumCSVFile(RevisiumTempFile):
    ext = "csv"

    @staticmethod
    def _convert_boolean(value: Optional[str]):
        if value:
            low_value = value.lower()
            if low_value in ["true", "false"]:
                return low_value == "true"
        elif value is None:
            return ""
        return value

    def read(self):
        """
        Reads a CSV file and returns its contents as a list of dictionaries.

        The file must be read in binary mode and decoded manually to preserve the original line ending and carriage
        return characters.
        """
        with self._path.open("rb") as f:
            contents = [
                line.decode(
                    sys.getfilesystemencoding(),
                    errors=sys.getfilesystemencodeerrors(),
                )
                for line in f
            ]
            reader = csv.DictReader(
                contents,
                fieldnames=[
                    "f",  # file path
                    "e",  # error
                    "d",  # type of deletion
                    "s",  # signature name (or other verdict string)
                    "t",  # signature type (unused?)
                    "r",  # rescan result after cleanup: 1 - infected, 0 - clean
                    "mb",  # mtime before cleanup
                    "ma",  # mtime after cleanup
                    "hb",  # hash before cleanup
                    "ha",  # hash after cleanup
                ],
            )
            return [
                {
                    field: self._convert_boolean(value)
                    for field, value in row.items()
                    if field is not None  # ignore unknown fields
                }
                for row in reader
            ]