v6.7.0

.github/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 [**Upgrade Guide**](https://intelowlproject.github.io/docs/IntelOwl/installation/#update-to-the-most-recent-version)
 
+## [v6.7.0](https://github.com/intelowlproject/IntelOwl/releases/tag/v6.7.0)
+We welcome the first working AI-based integration in IntelOwl! :tada:
+
+We invite all the users to test our new awesome Chatbot! :sunglasses: Check the [official doc](https://intelowlproject.github.io/docs/IntelOwl/chatbot/) for more info.
+
+Mainly this release merges all the developments performed by our Google Summer of Code contributors during the last month:
+* [Francesco Berardi](https://github.com/berardifra): "Integrating a Self-Deployed LLM Chatbot for Threat Intelligence"
+* [Sanjib Behera](https://github.com/sanjib2006): "Integration Ecosystem & Connector Optimization"
+
 ## [v6.6.1](https://github.com/intelowlproject/IntelOwl/releases/tag/v6.6.1)
 A lot of minor contributions to fix bugs and improve maintenance.
 

.github/workflows/codeql-analysis.yml

@@ -44,7 +44,7 @@ jobs:
         fetch-depth: 2
 
     - name: Set up Python
-      uses: actions/setup-python@v6.2.0
+      uses: actions/setup-python@v6.3.0
       with:
         python-version: '3.11'
 

.github/workflows/dependency_review.yml

@@ -13,4 +13,11 @@ jobs:
       - name: 'Checkout Repository'
         uses: actions/checkout@v6.0.2
       - name: 'Dependency Review'
-        uses: actions/dependency-review-action@v4
+        uses: actions/dependency-review-action@v4
+        with:
+          # GHSA-gr75-jv2w-4656: LangChain path traversal in file-search middleware/loaders.
+          # Patched only in langchain 1.3.9 (breaking major upgrade). The chatbot uses no
+          # document loaders, file-search middleware, or hub prompt pulls (only langchain.agents,
+          # langchain_core.*, langchain_ollama), so the vulnerable code paths are unreachable.
+          # Accepted until the planned langchain 1.x migration. Approved by @mlodic.
+          allow-ghsas: GHSA-gr75-jv2w-4656

.github/workflows/pull_request_automation.yml

@@ -37,7 +37,7 @@ jobs:
         uses: actions/checkout@v6.0.2
 
       - name: Set up Python
-        uses: actions/setup-python@v6.2.0
+        uses: actions/setup-python@v6.3.0
         with:
           python-version: 3.11
 
@@ -87,18 +87,23 @@ jobs:
           password: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Startup script launch (Slow)
-        if: contains(github.base_ref, 'master')
+        # Only the develop -> master release PR runs the full build: extra analyzers plus the
+        # chatbot stack (--ollama), which smoke-tests the ollama + celery_worker_chatbot topology
+        # on the :ci image. Kept off every other PR because the model pull is heavy.
+        if: github.base_ref == 'master' && github.head_ref == 'develop'
         run: |
           cp docker/env_file_integrations_template docker/env_file_integrations
-          ./start ci up --malware_tools_analyzers --phishing_analyzers -- --build -d
+          ./start ci up --malware_tools_analyzers --phishing_analyzers --ollama -- --build -d
         env:
           DOCKER_BUILDKIT: 1
           BUILDKIT_PROGRESS: "plain"
           STAGE: "ci"
           REPO_DOWNLOADER_ENABLED: false
 
       - name: Startup script launch (Fast)
-        if: "!contains(github.base_ref, 'master')"
+        # Exact complement of the Slow step so every other PR (incl. a non-develop head into
+        # master) still gets a container up for the test steps below.
+        if: ${{ !(github.base_ref == 'master' && github.head_ref == 'develop') }}
         run: |
           ./start ci up -- --build -d
         env:
@@ -137,7 +142,7 @@ jobs:
         with:
           node-version: 18
       - name: Cache node modules
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         with:
           path: ~/.npm
           key: npm-build-${{ hashFiles('frontend/package-lock.json') }}

api_app/analyzers_manager/file_analyzers/ipqsfile.py

@@ -0,0 +1,54 @@
+# This file is a part of IntelOwl https://github.com/intelowlproject/IntelOwl
+# See the file 'LICENSE' for copying permission.
+
+"""IPQualityScore file analyzer.
+
+Provides `IPQSFileScan`, a file-scanning analyzer that uploads files to
+IPQualityScore for malware detection and polls for results.
+"""
+
+import logging
+
+from api_app.analyzers_manager.classes import FileAnalyzer
+from api_app.mixins import IPQualityScoreMixin
+
+logger = logging.getLogger(__name__)
+
+
+class IPQSFileScan(FileAnalyzer, IPQualityScoreMixin):
+    """
+    Scan a binary file using IPQualityScore malware detection service.
+    """
+
+    @classmethod
+    def update(cls):
+        pass
+
+    def run(self):
+        binary = self.read_file_bytes()
+        files = {"files": (self.filename, binary)}
+        # lookup endpoint check for cached result
+        lookup_result = self._make_request(
+            self.lookup_endpoint,
+            method="POST",
+            _api_key=self._ipqs_api_key,
+            files=files,
+        )
+        if lookup_result.get("status", False) == "cached":
+            lookup_result.pop("update_url", None)
+            return lookup_result
+        # sending file to ipqs for scan
+        scan_result = self._make_request(
+            self.scan_endpoint,
+            method="POST",
+            _api_key=self._ipqs_api_key,
+            files=files,
+        )
+        # waiting for scan result with help of request id
+        result = self._poll_for_report(
+            endpoint=self.postback_endpoint,
+            _api_key=self._ipqs_api_key,
+            request_id=scan_result.get("request_id"),
+        )
+        result.pop("update_url", None)
+        return result

api_app/analyzers_manager/migrations/0191_analyzer_config_ipqs_malware_file_scanner.py

@@ -0,0 +1,218 @@
+from django.db import migrations
+from django.db.models.fields.related_descriptors import (
+    ForwardManyToOneDescriptor,
+    ForwardOneToOneDescriptor,
+    ManyToManyDescriptor,
+    ReverseManyToOneDescriptor,
+    ReverseOneToOneDescriptor,
+)
+
+plugin = {
+    "python_module": {
+        "health_check_schedule": None,
+        "update_schedule": None,
+        "module": "ipqsfile.IPQSFileScan",
+        "base_path": "api_app.analyzers_manager.file_analyzers",
+    },
+    "name": "IPQS_Malware_File_Scanner",
+    "description": "Scan files for malware, viruses, and malicious payloads in real-time using [IPQualityScore](https://www.ipqualityscore.com/)'s advanced  file scanning engine.",
+    "disabled": False,
+    "soft_time_limit": 140,
+    "routing_key": "default",
+    "health_check_status": True,
+    "type": "file",
+    "docker_based": False,
+    "maximum_tlp": "AMBER",
+    "observable_supported": [],
+    "supported_filetypes": [
+        "application/w-script-file",
+        "application/javascript",
+        "application/x-javascript",
+        "text/javascript",
+        "application/x-vbscript",
+        "text/x-ms-iqy",
+        "application/vnd.android.package-archive",
+        "application/x-dex",
+        "application/onenote",
+        "application/zip",
+        "multipart/x-zip",
+        "application/java-archive",
+        "text/rtf",
+        "application/rtf",
+        "application/x-sharedlib",
+        "application/vnd.microsoft.portable-executable",
+        "application/x-elf",
+        "application/octet-stream",
+        "application/vnd.tcpdump.pcap",
+        "application/pdf",
+        "text/html",
+        "application/x-mspublisher",
+        "application/vnd.ms-excel.addin.macroEnabled",
+        "application/vnd.ms-excel.sheet.macroEnabled.12",
+        "application/vnd.ms-excel",
+        "application/excel",
+        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        "application/xml",
+        "text/xml",
+        "application/encrypted",
+        "text/plain",
+        "text/csv",
+        "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        "application/msword",
+        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        "application/vnd.ms-powerpoint",
+        "application/vnd.ms-office",
+        "application/x-binary",
+        "application/x-macbinary",
+        "application/mac-binary",
+        "application/x-mach-binary",
+        "application/x-zip-compressed",
+        "application/x-compressed",
+        "application/vnd.ms-outlook",
+        "message/rfc822",
+        "application/pkcs7-signature",
+        "application/x-pkcs7-signature",
+        "multipart/mixed",
+        "text/x-shellscript",
+        "application/x-chrome-extension",
+        "application/json",
+        "application/x-executable",
+        "text/x-java",
+        "text/x-kotlin",
+        "text/x-swift",
+        "text/x-objective-c",
+        "application/x-ms-shortcut",
+        "application/gzip",
+    ],
+    "run_hash": False,
+    "run_hash_type": "",
+    "not_supported_filetypes": [],
+    "mapping_data_model": {},
+    "model": "analyzers_manager.AnalyzerConfig",
+}
+
+params = [
+    {
+        "python_module": {
+            "module": "ipqsfile.IPQSFileScan",
+            "base_path": "api_app.analyzers_manager.file_analyzers",
+        },
+        "name": "ipqs_api_key",
+        "type": "str",
+        "description": "Please provide the IPQS API key.",
+        "is_secret": True,
+        "required": True,
+    },
+    {
+        "python_module": {
+            "module": "ipqsfile.IPQSFileScan",
+            "base_path": "api_app.analyzers_manager.file_analyzers",
+        },
+        "name": "polling_interval",
+        "type": "int",
+        "description": "Recommended polling interval: 10 seconds.",
+        "is_secret": False,
+        "required": True,
+    },
+    {
+        "python_module": {
+            "module": "ipqsfile.IPQSFileScan",
+            "base_path": "api_app.analyzers_manager.file_analyzers",
+        },
+        "name": "max_retries",
+        "type": "int",
+        "description": "Recommended max retries: 8.",
+        "is_secret": False,
+        "required": True,
+    },
+]
+
+values = []
+
+
+def _get_real_obj(Model, field, value):
+    def _get_obj(Model, other_model, value):
+        if isinstance(value, dict):
+            real_vals = {}
+            for key, real_val in value.items():
+                real_vals[key] = _get_real_obj(other_model, key, real_val)
+            value = other_model.objects.get_or_create(**real_vals)[0]
+        # it is just the primary key serialized
+        else:
+            if isinstance(value, int):
+                if Model.__name__ == "PluginConfig":
+                    value = other_model.objects.get(name=plugin["name"])
+                else:
+                    value = other_model.objects.get(pk=value)
+            else:
+                value = other_model.objects.get(name=value)
+        return value
+
+    if (
+        type(getattr(Model, field))
+        in [
+            ForwardManyToOneDescriptor,
+            ReverseManyToOneDescriptor,
+            ReverseOneToOneDescriptor,
+            ForwardOneToOneDescriptor,
+        ]
+        and value
+    ):
+        other_model = getattr(Model, field).get_queryset().model
+        value = _get_obj(Model, other_model, value)
+    elif type(getattr(Model, field)) in [ManyToManyDescriptor] and value:
+        other_model = getattr(Model, field).rel.model
+        value = [_get_obj(Model, other_model, val) for val in value]
+    return value
+
+
+def _create_object(Model, data):
+    mtm, no_mtm = {}, {}
+    for field, value in data.items():
+        value = _get_real_obj(Model, field, value)
+        if type(getattr(Model, field)) is ManyToManyDescriptor:
+            mtm[field] = value
+        else:
+            no_mtm[field] = value
+    try:
+        o = Model.objects.get(**no_mtm)
+    except Model.DoesNotExist:
+        o = Model(**no_mtm)
+        o.full_clean()
+        o.save()
+        for field, value in mtm.items():
+            attribute = getattr(o, field)
+            if value is not None:
+                attribute.set(value)
+        return False
+    return True
+
+
+def migrate(apps, schema_editor):
+    Parameter = apps.get_model("api_app", "Parameter")
+    PluginConfig = apps.get_model("api_app", "PluginConfig")
+    python_path = plugin.pop("model")
+    Model = apps.get_model(*python_path.split("."))
+    if not Model.objects.filter(name=plugin["name"]).exists():
+        exists = _create_object(Model, plugin)
+        if not exists:
+            for param in params:
+                _create_object(Parameter, param)
+            for value in values:
+                _create_object(PluginConfig, value)
+
+
+def reverse_migrate(apps, schema_editor):
+    python_path = plugin.pop("model")
+    Model = apps.get_model(*python_path.split("."))
+    Model.objects.get(name=plugin["name"]).delete()
+
+
+class Migration(migrations.Migration):
+    atomic = False
+    dependencies = [
+        ("api_app", "0073_alter_updatecheckstatus_last_checked_at_and_more"),
+        ("analyzers_manager", "0190_remove_greynoise_labs_analyzer"),
+    ]
+
+    operations = [migrations.RunPython(migrate, reverse_migrate)]