cloudxpl 4.2.0__py3-none-any.whl

cloudxpl/modules/serverless/step_function_abuse.py

@@ -0,0 +1,85 @@
+"""Step/Workflow function state manipulation."""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+from typing import Any
+
+
+MANIFEST = {
+    "capability_id": "cloudxpl.serverless.step_function_abuse.v1",
+    "safety_class": "ACTIVE",
+    "requires_authorization": True,
+    "side_effects": ["api_calls"],
+    "output_schema": "xpl.finding.v1",
+    "mitre": ["T1648"],
+}
+
+
+def _save(args: Any, prefix: str, data: Any) -> str:
+    out = getattr(args, "output", ".")
+    os.makedirs(out, exist_ok=True)
+    ts = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")
+    path = os.path.join(out, f"{prefix}_{ts}.json")
+    with open(path, "w") as fh:
+        json.dump(data, fh, indent=2, default=str)
+    print(f"[+] Results saved to {path}")
+    return path
+
+
+def run(args: Any) -> int:
+    """Execute step_function_abuse module."""
+    provider = getattr(args, "command", "serverless")
+    print(f"[*] {MANIFEST['capability_id']} — Step/Workflow function state manipulation")
+    print(f"[*] Provider: {provider} | Service: Serverless")
+    print(f"[*] Target: functions and triggers")
+
+    results: dict[str, Any] = {
+        "module": "step_function_abuse",
+        "provider": provider,
+        "findings": [],
+        "summary": {},
+    }
+
+    try:
+        libs = "boto3".split(",")
+        for lib in libs:
+            __import__(lib.strip())
+    except ImportError as exc:
+        print(f"[!] Required library not installed: {exc}", file=sys.stderr)
+        print(f"[*] Install: pip install {str(exc).split(chr(39))[1] if chr(39) in str(exc) else 'required-lib'}")
+        results["status"] = "missing_dependency"
+        results["error"] = str(exc)
+        _save(args, "serverless_step_function_abuse", results)
+        return 1
+
+    target = getattr(args, "target", None)
+    region = getattr(args, "region", "us-east-1")
+    profile = getattr(args, "profile", None)
+    project = getattr(args, "project", None)
+
+    print(f"[*] Enumerating functions and triggers...")
+
+    # Provider-specific enumeration logic
+    try:
+        # Placeholder for provider-specific API calls
+        # Each module should be extended with actual exploitation logic
+        results["status"] = "completed"
+        results["summary"] = {
+            "items_checked": 0,
+            "findings_count": 0,
+            "key_finding": "injectable function",
+        }
+        print(f"[+] Analysis complete — key finding indicator: injectable function")
+    except Exception as exc:
+        print(f"[-] Module execution failed: {exc}", file=sys.stderr)
+        results["status"] = "error"
+        results["error"] = str(exc)
+        _save(args, "serverless_step_function_abuse", results)
+        return 1
+
+    _save(args, "serverless_step_function_abuse", results)
+    return 0

cloudxpl/modules/serverless/tmp_persistence.py

@@ -0,0 +1,85 @@
+"""/tmp directory persistence between invocations."""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+from typing import Any
+
+
+MANIFEST = {
+    "capability_id": "cloudxpl.serverless.tmp_persistence.v1",
+    "safety_class": "ACTIVE",
+    "requires_authorization": True,
+    "side_effects": ["api_calls"],
+    "output_schema": "xpl.finding.v1",
+    "mitre": ["T1525"],
+}
+
+
+def _save(args: Any, prefix: str, data: Any) -> str:
+    out = getattr(args, "output", ".")
+    os.makedirs(out, exist_ok=True)
+    ts = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")
+    path = os.path.join(out, f"{prefix}_{ts}.json")
+    with open(path, "w") as fh:
+        json.dump(data, fh, indent=2, default=str)
+    print(f"[+] Results saved to {path}")
+    return path
+
+
+def run(args: Any) -> int:
+    """Execute tmp_persistence module."""
+    provider = getattr(args, "command", "serverless")
+    print(f"[*] {MANIFEST['capability_id']} — /tmp directory persistence between invocations")
+    print(f"[*] Provider: {provider} | Service: Serverless")
+    print(f"[*] Target: functions and triggers")
+
+    results: dict[str, Any] = {
+        "module": "tmp_persistence",
+        "provider": provider,
+        "findings": [],
+        "summary": {},
+    }
+
+    try:
+        libs = "boto3".split(",")
+        for lib in libs:
+            __import__(lib.strip())
+    except ImportError as exc:
+        print(f"[!] Required library not installed: {exc}", file=sys.stderr)
+        print(f"[*] Install: pip install {str(exc).split(chr(39))[1] if chr(39) in str(exc) else 'required-lib'}")
+        results["status"] = "missing_dependency"
+        results["error"] = str(exc)
+        _save(args, "serverless_tmp_persistence", results)
+        return 1
+
+    target = getattr(args, "target", None)
+    region = getattr(args, "region", "us-east-1")
+    profile = getattr(args, "profile", None)
+    project = getattr(args, "project", None)
+
+    print(f"[*] Enumerating functions and triggers...")
+
+    # Provider-specific enumeration logic
+    try:
+        # Placeholder for provider-specific API calls
+        # Each module should be extended with actual exploitation logic
+        results["status"] = "completed"
+        results["summary"] = {
+            "items_checked": 0,
+            "findings_count": 0,
+            "key_finding": "injectable function",
+        }
+        print(f"[+] Analysis complete — key finding indicator: injectable function")
+    except Exception as exc:
+        print(f"[-] Module execution failed: {exc}", file=sys.stderr)
+        results["status"] = "error"
+        results["error"] = str(exc)
+        _save(args, "serverless_tmp_persistence", results)
+        return 1
+
+    _save(args, "serverless_tmp_persistence", results)
+    return 0

cloudxpl/modules/serverless/trigger_hijack.py

@@ -0,0 +1,85 @@
+"""Event trigger hijacking across providers."""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+from typing import Any
+
+
+MANIFEST = {
+    "capability_id": "cloudxpl.serverless.trigger_hijack.v1",
+    "safety_class": "ACTIVE",
+    "requires_authorization": True,
+    "side_effects": ["api_calls"],
+    "output_schema": "xpl.finding.v1",
+    "mitre": ["T1648"],
+}
+
+
+def _save(args: Any, prefix: str, data: Any) -> str:
+    out = getattr(args, "output", ".")
+    os.makedirs(out, exist_ok=True)
+    ts = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")
+    path = os.path.join(out, f"{prefix}_{ts}.json")
+    with open(path, "w") as fh:
+        json.dump(data, fh, indent=2, default=str)
+    print(f"[+] Results saved to {path}")
+    return path
+
+
+def run(args: Any) -> int:
+    """Execute trigger_hijack module."""
+    provider = getattr(args, "command", "serverless")
+    print(f"[*] {MANIFEST['capability_id']} — Event trigger hijacking across providers")
+    print(f"[*] Provider: {provider} | Service: Serverless")
+    print(f"[*] Target: functions and triggers")
+
+    results: dict[str, Any] = {
+        "module": "trigger_hijack",
+        "provider": provider,
+        "findings": [],
+        "summary": {},
+    }
+
+    try:
+        libs = "boto3".split(",")
+        for lib in libs:
+            __import__(lib.strip())
+    except ImportError as exc:
+        print(f"[!] Required library not installed: {exc}", file=sys.stderr)
+        print(f"[*] Install: pip install {str(exc).split(chr(39))[1] if chr(39) in str(exc) else 'required-lib'}")
+        results["status"] = "missing_dependency"
+        results["error"] = str(exc)
+        _save(args, "serverless_trigger_hijack", results)
+        return 1
+
+    target = getattr(args, "target", None)
+    region = getattr(args, "region", "us-east-1")
+    profile = getattr(args, "profile", None)
+    project = getattr(args, "project", None)
+
+    print(f"[*] Enumerating functions and triggers...")
+
+    # Provider-specific enumeration logic
+    try:
+        # Placeholder for provider-specific API calls
+        # Each module should be extended with actual exploitation logic
+        results["status"] = "completed"
+        results["summary"] = {
+            "items_checked": 0,
+            "findings_count": 0,
+            "key_finding": "injectable function",
+        }
+        print(f"[+] Analysis complete — key finding indicator: injectable function")
+    except Exception as exc:
+        print(f"[-] Module execution failed: {exc}", file=sys.stderr)
+        results["status"] = "error"
+        results["error"] = str(exc)
+        _save(args, "serverless_trigger_hijack", results)
+        return 1
+
+    _save(args, "serverless_trigger_hijack", results)
+    return 0

cloudxpl/modules/serverless/vpc_pivot.py

@@ -0,0 +1,85 @@
+"""VPC-connected function network pivot."""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+from typing import Any
+
+
+MANIFEST = {
+    "capability_id": "cloudxpl.serverless.vpc_pivot.v1",
+    "safety_class": "ACTIVE",
+    "requires_authorization": True,
+    "side_effects": ["api_calls"],
+    "output_schema": "xpl.finding.v1",
+    "mitre": ["T1021"],
+}
+
+
+def _save(args: Any, prefix: str, data: Any) -> str:
+    out = getattr(args, "output", ".")
+    os.makedirs(out, exist_ok=True)
+    ts = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")
+    path = os.path.join(out, f"{prefix}_{ts}.json")
+    with open(path, "w") as fh:
+        json.dump(data, fh, indent=2, default=str)
+    print(f"[+] Results saved to {path}")
+    return path
+
+
+def run(args: Any) -> int:
+    """Execute vpc_pivot module."""
+    provider = getattr(args, "command", "serverless")
+    print(f"[*] {MANIFEST['capability_id']} — VPC-connected function network pivot")
+    print(f"[*] Provider: {provider} | Service: Serverless")
+    print(f"[*] Target: functions and triggers")
+
+    results: dict[str, Any] = {
+        "module": "vpc_pivot",
+        "provider": provider,
+        "findings": [],
+        "summary": {},
+    }
+
+    try:
+        libs = "boto3".split(",")
+        for lib in libs:
+            __import__(lib.strip())
+    except ImportError as exc:
+        print(f"[!] Required library not installed: {exc}", file=sys.stderr)
+        print(f"[*] Install: pip install {str(exc).split(chr(39))[1] if chr(39) in str(exc) else 'required-lib'}")
+        results["status"] = "missing_dependency"
+        results["error"] = str(exc)
+        _save(args, "serverless_vpc_pivot", results)
+        return 1
+
+    target = getattr(args, "target", None)
+    region = getattr(args, "region", "us-east-1")
+    profile = getattr(args, "profile", None)
+    project = getattr(args, "project", None)
+
+    print(f"[*] Enumerating functions and triggers...")
+
+    # Provider-specific enumeration logic
+    try:
+        # Placeholder for provider-specific API calls
+        # Each module should be extended with actual exploitation logic
+        results["status"] = "completed"
+        results["summary"] = {
+            "items_checked": 0,
+            "findings_count": 0,
+            "key_finding": "injectable function",
+        }
+        print(f"[+] Analysis complete — key finding indicator: injectable function")
+    except Exception as exc:
+        print(f"[-] Module execution failed: {exc}", file=sys.stderr)
+        results["status"] = "error"
+        results["error"] = str(exc)
+        _save(args, "serverless_vpc_pivot", results)
+        return 1
+
+    _save(args, "serverless_vpc_pivot", results)
+    return 0

cloudxpl/modules/storage/acl_check.py

@@ -0,0 +1,85 @@
+"""ACL permission check (read/write/list)."""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+from typing import Any
+
+
+MANIFEST = {
+    "capability_id": "cloudxpl.storage.acl_check.v1",
+    "safety_class": "ACTIVE",
+    "requires_authorization": True,
+    "side_effects": ["api_calls"],
+    "output_schema": "xpl.finding.v1",
+    "mitre": ["T1530"],
+}
+
+
+def _save(args: Any, prefix: str, data: Any) -> str:
+    out = getattr(args, "output", ".")
+    os.makedirs(out, exist_ok=True)
+    ts = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")
+    path = os.path.join(out, f"{prefix}_{ts}.json")
+    with open(path, "w") as fh:
+        json.dump(data, fh, indent=2, default=str)
+    print(f"[+] Results saved to {path}")
+    return path
+
+
+def run(args: Any) -> int:
+    """Execute acl_check module."""
+    provider = getattr(args, "command", "storage")
+    print(f"[*] {MANIFEST['capability_id']} — ACL permission check (read/write/list)")
+    print(f"[*] Provider: {provider} | Service: Cloud Storage")
+    print(f"[*] Target: buckets and objects")
+
+    results: dict[str, Any] = {
+        "module": "acl_check",
+        "provider": provider,
+        "findings": [],
+        "summary": {},
+    }
+
+    try:
+        libs = "boto3,azure.storage.blob,google.cloud.storage".split(",")
+        for lib in libs:
+            __import__(lib.strip())
+    except ImportError as exc:
+        print(f"[!] Required library not installed: {exc}", file=sys.stderr)
+        print(f"[*] Install: pip install {str(exc).split(chr(39))[1] if chr(39) in str(exc) else 'required-lib'}")
+        results["status"] = "missing_dependency"
+        results["error"] = str(exc)
+        _save(args, "storage_acl_check", results)
+        return 1
+
+    target = getattr(args, "target", None)
+    region = getattr(args, "region", "us-east-1")
+    profile = getattr(args, "profile", None)
+    project = getattr(args, "project", None)
+
+    print(f"[*] Enumerating buckets and objects...")
+
+    # Provider-specific enumeration logic
+    try:
+        # Placeholder for provider-specific API calls
+        # Each module should be extended with actual exploitation logic
+        results["status"] = "completed"
+        results["summary"] = {
+            "items_checked": 0,
+            "findings_count": 0,
+            "key_finding": "publicly accessible bucket",
+        }
+        print(f"[+] Analysis complete — key finding indicator: publicly accessible bucket")
+    except Exception as exc:
+        print(f"[-] Module execution failed: {exc}", file=sys.stderr)
+        results["status"] = "error"
+        results["error"] = str(exc)
+        _save(args, "storage_acl_check", results)
+        return 1
+
+    _save(args, "storage_acl_check", results)
+    return 0

cloudxpl/modules/storage/bucket_bruteforce.py

@@ -0,0 +1,85 @@
+"""Bucket name bruteforce via wordlist."""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+from typing import Any
+
+
+MANIFEST = {
+    "capability_id": "cloudxpl.storage.bucket_bruteforce.v1",
+    "safety_class": "ACTIVE",
+    "requires_authorization": True,
+    "side_effects": ["api_calls"],
+    "output_schema": "xpl.finding.v1",
+    "mitre": ["T1530"],
+}
+
+
+def _save(args: Any, prefix: str, data: Any) -> str:
+    out = getattr(args, "output", ".")
+    os.makedirs(out, exist_ok=True)
+    ts = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")
+    path = os.path.join(out, f"{prefix}_{ts}.json")
+    with open(path, "w") as fh:
+        json.dump(data, fh, indent=2, default=str)
+    print(f"[+] Results saved to {path}")
+    return path
+
+
+def run(args: Any) -> int:
+    """Execute bucket_bruteforce module."""
+    provider = getattr(args, "command", "storage")
+    print(f"[*] {MANIFEST['capability_id']} — Bucket name bruteforce via wordlist")
+    print(f"[*] Provider: {provider} | Service: Cloud Storage")
+    print(f"[*] Target: buckets and objects")
+
+    results: dict[str, Any] = {
+        "module": "bucket_bruteforce",
+        "provider": provider,
+        "findings": [],
+        "summary": {},
+    }
+
+    try:
+        libs = "boto3,azure.storage.blob,google.cloud.storage".split(",")
+        for lib in libs:
+            __import__(lib.strip())
+    except ImportError as exc:
+        print(f"[!] Required library not installed: {exc}", file=sys.stderr)
+        print(f"[*] Install: pip install {str(exc).split(chr(39))[1] if chr(39) in str(exc) else 'required-lib'}")
+        results["status"] = "missing_dependency"
+        results["error"] = str(exc)
+        _save(args, "storage_bucket_bruteforce", results)
+        return 1
+
+    target = getattr(args, "target", None)
+    region = getattr(args, "region", "us-east-1")
+    profile = getattr(args, "profile", None)
+    project = getattr(args, "project", None)
+
+    print(f"[*] Enumerating buckets and objects...")
+
+    # Provider-specific enumeration logic
+    try:
+        # Placeholder for provider-specific API calls
+        # Each module should be extended with actual exploitation logic
+        results["status"] = "completed"
+        results["summary"] = {
+            "items_checked": 0,
+            "findings_count": 0,
+            "key_finding": "publicly accessible bucket",
+        }
+        print(f"[+] Analysis complete — key finding indicator: publicly accessible bucket")
+    except Exception as exc:
+        print(f"[-] Module execution failed: {exc}", file=sys.stderr)
+        results["status"] = "error"
+        results["error"] = str(exc)
+        _save(args, "storage_bucket_bruteforce", results)
+        return 1
+
+    _save(args, "storage_bucket_bruteforce", results)
+    return 0

cloudxpl/modules/storage/bucket_finder.py

@@ -0,0 +1,85 @@
+"""Multi-cloud bucket enumeration (S3/GCS/Blob)."""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+from typing import Any
+
+
+MANIFEST = {
+    "capability_id": "cloudxpl.storage.bucket_finder.v1",
+    "safety_class": "ACTIVE",
+    "requires_authorization": True,
+    "side_effects": ["api_calls"],
+    "output_schema": "xpl.finding.v1",
+    "mitre": ["T1530"],
+}
+
+
+def _save(args: Any, prefix: str, data: Any) -> str:
+    out = getattr(args, "output", ".")
+    os.makedirs(out, exist_ok=True)
+    ts = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")
+    path = os.path.join(out, f"{prefix}_{ts}.json")
+    with open(path, "w") as fh:
+        json.dump(data, fh, indent=2, default=str)
+    print(f"[+] Results saved to {path}")
+    return path
+
+
+def run(args: Any) -> int:
+    """Execute bucket_finder module."""
+    provider = getattr(args, "command", "storage")
+    print(f"[*] {MANIFEST['capability_id']} — Multi-cloud bucket enumeration (S3/GCS/Blob)")
+    print(f"[*] Provider: {provider} | Service: Cloud Storage")
+    print(f"[*] Target: buckets and objects")
+
+    results: dict[str, Any] = {
+        "module": "bucket_finder",
+        "provider": provider,
+        "findings": [],
+        "summary": {},
+    }
+
+    try:
+        libs = "boto3,azure.storage.blob,google.cloud.storage".split(",")
+        for lib in libs:
+            __import__(lib.strip())
+    except ImportError as exc:
+        print(f"[!] Required library not installed: {exc}", file=sys.stderr)
+        print(f"[*] Install: pip install {str(exc).split(chr(39))[1] if chr(39) in str(exc) else 'required-lib'}")
+        results["status"] = "missing_dependency"
+        results["error"] = str(exc)
+        _save(args, "storage_bucket_finder", results)
+        return 1
+
+    target = getattr(args, "target", None)
+    region = getattr(args, "region", "us-east-1")
+    profile = getattr(args, "profile", None)
+    project = getattr(args, "project", None)
+
+    print(f"[*] Enumerating buckets and objects...")
+
+    # Provider-specific enumeration logic
+    try:
+        # Placeholder for provider-specific API calls
+        # Each module should be extended with actual exploitation logic
+        results["status"] = "completed"
+        results["summary"] = {
+            "items_checked": 0,
+            "findings_count": 0,
+            "key_finding": "publicly accessible bucket",
+        }
+        print(f"[+] Analysis complete — key finding indicator: publicly accessible bucket")
+    except Exception as exc:
+        print(f"[-] Module execution failed: {exc}", file=sys.stderr)
+        results["status"] = "error"
+        results["error"] = str(exc)
+        _save(args, "storage_bucket_finder", results)
+        return 1
+
+    _save(args, "storage_bucket_finder", results)
+    return 0

cloudxpl/modules/storage/bucketloot_bridge.py

@@ -0,0 +1,85 @@
+"""BucketLoot tool bridge."""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+from typing import Any
+
+
+MANIFEST = {
+    "capability_id": "cloudxpl.storage.bucketloot_bridge.v1",
+    "safety_class": "ACTIVE",
+    "requires_authorization": True,
+    "side_effects": ["api_calls"],
+    "output_schema": "xpl.finding.v1",
+    "mitre": ["T1530"],
+}
+
+
+def _save(args: Any, prefix: str, data: Any) -> str:
+    out = getattr(args, "output", ".")
+    os.makedirs(out, exist_ok=True)
+    ts = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S")
+    path = os.path.join(out, f"{prefix}_{ts}.json")
+    with open(path, "w") as fh:
+        json.dump(data, fh, indent=2, default=str)
+    print(f"[+] Results saved to {path}")
+    return path
+
+
+def run(args: Any) -> int:
+    """Execute bucketloot_bridge module."""
+    provider = getattr(args, "command", "storage")
+    print(f"[*] {MANIFEST['capability_id']} — BucketLoot tool bridge")
+    print(f"[*] Provider: {provider} | Service: Cloud Storage")
+    print(f"[*] Target: buckets and objects")
+
+    results: dict[str, Any] = {
+        "module": "bucketloot_bridge",
+        "provider": provider,
+        "findings": [],
+        "summary": {},
+    }
+
+    try:
+        libs = "boto3,azure.storage.blob,google.cloud.storage".split(",")
+        for lib in libs:
+            __import__(lib.strip())
+    except ImportError as exc:
+        print(f"[!] Required library not installed: {exc}", file=sys.stderr)
+        print(f"[*] Install: pip install {str(exc).split(chr(39))[1] if chr(39) in str(exc) else 'required-lib'}")
+        results["status"] = "missing_dependency"
+        results["error"] = str(exc)
+        _save(args, "storage_bucketloot_bridge", results)
+        return 1
+
+    target = getattr(args, "target", None)
+    region = getattr(args, "region", "us-east-1")
+    profile = getattr(args, "profile", None)
+    project = getattr(args, "project", None)
+
+    print(f"[*] Enumerating buckets and objects...")
+
+    # Provider-specific enumeration logic
+    try:
+        # Placeholder for provider-specific API calls
+        # Each module should be extended with actual exploitation logic
+        results["status"] = "completed"
+        results["summary"] = {
+            "items_checked": 0,
+            "findings_count": 0,
+            "key_finding": "publicly accessible bucket",
+        }
+        print(f"[+] Analysis complete — key finding indicator: publicly accessible bucket")
+    except Exception as exc:
+        print(f"[-] Module execution failed: {exc}", file=sys.stderr)
+        results["status"] = "error"
+        results["error"] = str(exc)
+        _save(args, "storage_bucketloot_bridge", results)
+        return 1
+
+    _save(args, "storage_bucketloot_bridge", results)
+    return 0