Memcached Detection

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""Detect Memcached and unauthenticated stats access."""

from kittysploit import *
from lib.protocols.tcp.tcp_scanner_client import Tcp_scanner_client
from lib.scanner.memcached.detectors import probe_memcached


class Module(Scanner, Tcp_scanner_client):
    __info__ = {
        "name": "Memcached Detection",
        "description": "Detects Memcached and unauthenticated stats command access.",
        "author": ["KittySploit Team"],
        "severity": "high",
        "metadata": {"max-request": 1, "product": "memcached", "vendor": "memcached"},
        "tags": ["memcached", "database", "scanner", "misconfig", "unauth"],
    'agent': {
        'risk': 'active',
        'effects': ['network_probe'],
        'expected_requests': 1,
        'reversible': True,
        'approval_required': False,
        'produces': ['tech_hints', 'risk_signals'],
        'cost': 1.0,
        'noise': 0.5,
        'value': 1.0,
        'requires':         {'min_endpoints': 0,
         'min_params': 0,
         'tech_hints_any': [],
         'tech_hints_all': [],
         'specializations_any': [],
         'risk_signals_any': [],
         'auth_session': False,
         'capabilities_any': [],
         'capabilities_all': [],
         'confidence_min': {},
         'confidence_min_any': {},
         'endpoint_pattern_any': [],
         'param_any': [],
         'api_surface_ready': False},
        'chain':         {'produces_capabilities': [{'capability': 'admin_surface', 'from_detail': ''}],
         'consumes_capabilities': [],
         'option_bindings': {},
         'suggested_followups': []},
    },
    }

    port = OptPort(11211, "Target Memcached port", True)

    def run(self):
        host = self._host()
        port = self._port()
        if not host or not self.is_tcp_open(host=host, port=port):
            return False

        info = probe_memcached(host=host, port=port, timeout=self._timeout())
        if not info.get("detected"):
            return False

        stats = info.get("stats") or {}
        version = str(stats.get("version", ""))
        severity = "high" if info.get("unauthenticated") else "info"
        self.set_info(
            severity=severity,
            reason=f"Memcached detected (version={version or 'unknown'})",
            version=version,
            unauthenticated=bool(info.get("unauthenticated")),
        )
        return True