Postman Collection Exposure Detection

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""Detected exposed Postman collection JSON files that contained API endpoints and environment details."""

import re
from kittysploit import *
from lib.protocols.http.http_client import Http_client


class Module(Scanner, Http_client):
    __info__ = {
        'name': 'Postman Collection Exposure Detection',
        'description': 'Detected exposed Postman collection JSON files that contained API endpoints and environment details. These files were publicly accessible and disclosed authentication headers and other sensitive information.',
        'author': ['KittySploit Team'],
        'severity': 'low',
        'tags': ['web', 'scanner', 'exposure', 'api', 'postman'],
        'agent': {
            'risk': 'active',
            'effects': ['network_probe'],
            'expected_requests': 5,
            'reversible': True,
            'approval_required': False,
            'produces': ['tech_hints', 'risk_signals', 'endpoints'],
            'cost': 1.0,
            'noise': 0.3,
            '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': ['auxiliary/scanner/http/login_page_detector'],
            },
        },
        'references': ['https://medium.com/@utkarshporwal24/exposed-postman-collections-ed6086b96ba5'],
    }

    def run(self):
        for path in ('/postman.json', '/docs/postman.json', '/api/postman.json', '/postman_collection.json', '/collections/postman.json'):
            r = self.http_request(method="GET", path=path, allow_redirects=False)
            if not r or r.status_code != 200:
                continue
            body = r.text or ""
            headers = "\n".join(f"{k}: {v}" for k, v in r.headers.items())
            body_regexes = ('(?i)"info"\\s*:\\s*\\{\\s*"name"\\s*:\\s*".+?"', '(?i)"item"\\s*:\\s*\\[',)
            header_regexes = ('(?i)content-type:\\s*application/(json|vnd\\.postman\\.[^;\\s]+)',)
            if (any(re.search(rx, body, 0) for rx in body_regexes)) and (any(re.search(rx, headers, 0) for rx in header_regexes)):
                self.set_info(
                    severity='low',
                    reason="Postman Collection Exposure detected",
                    path=path,
                )
                return True
        return False