vamp-cloud-enum 1.1__tar.gz → 1.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: vamp-cloud-enum
3
- Version: 1.1
3
+ Version: 1.2
4
4
  Summary: Cloud asset enumeration and exposure analysis for authorized audits
5
5
  Author-email: VampSecure Studios <contact@vampsecurestudios.com>
6
6
  License: MIT
@@ -21,8 +21,9 @@ Requires-Dist: aiohttp>=3.9.0
21
21
  Requires-Dist: rich>=13.7.0
22
22
  Dynamic: license-file
23
23
 
24
+ <!-- © VampSecure Studios — VampSecure Labs Security Research Division -->
24
25
  <p align="center">
25
- <img src="https://img.shields.io/badge/version-1.0-crimson?style=flat-square" />
26
+ <img src="https://img.shields.io/badge/version-1.1-crimson?style=flat-square" />
26
27
  <img src="https://img.shields.io/badge/python-3.11+-blue?style=flat-square&logo=python&logoColor=white" />
27
28
  <img src="https://img.shields.io/badge/providers-AWS%20%7C%20Azure%20%7C%20GCP-teal?style=flat-square" />
28
29
  <img src="https://img.shields.io/badge/VampSecure_Labs-Security_Research-8b0000?style=flat-square" />
@@ -71,6 +72,13 @@ pip install -r requirements.txt
71
72
 
72
73
  ## Installation
73
74
 
75
+
76
+ ```bash
77
+ pip install vamp-cloud-enum
78
+ # o con Homebrew:
79
+ brew install vampsecure-labs/labs/vamp-cloud-enum
80
+ ```
81
+
74
82
  ```bash
75
83
  git clone https://github.com/belky-me/vamp-cloud-enum.git
76
84
  cd vamp-cloud-enum
@@ -188,3 +196,8 @@ python vamp_cloud_enum.py -d example.com -d example-cdn.com \
188
196
  © VampSecure Studios — VampSecure Labs Security Research Division<br/>
189
197
  For authorized security assessments only. Unauthorized use is prohibited.
190
198
  </p>
199
+
200
+ ---
201
+
202
+ ## Versión
203
+ v1.1 — VampSecure Labs Security Research Division
@@ -1,5 +1,6 @@
1
+ <!-- © VampSecure Studios — VampSecure Labs Security Research Division -->
1
2
  <p align="center">
2
- <img src="https://img.shields.io/badge/version-1.0-crimson?style=flat-square" />
3
+ <img src="https://img.shields.io/badge/version-1.1-crimson?style=flat-square" />
3
4
  <img src="https://img.shields.io/badge/python-3.11+-blue?style=flat-square&logo=python&logoColor=white" />
4
5
  <img src="https://img.shields.io/badge/providers-AWS%20%7C%20Azure%20%7C%20GCP-teal?style=flat-square" />
5
6
  <img src="https://img.shields.io/badge/VampSecure_Labs-Security_Research-8b0000?style=flat-square" />
@@ -48,6 +49,13 @@ pip install -r requirements.txt
48
49
 
49
50
  ## Installation
50
51
 
52
+
53
+ ```bash
54
+ pip install vamp-cloud-enum
55
+ # o con Homebrew:
56
+ brew install vampsecure-labs/labs/vamp-cloud-enum
57
+ ```
58
+
51
59
  ```bash
52
60
  git clone https://github.com/belky-me/vamp-cloud-enum.git
53
61
  cd vamp-cloud-enum
@@ -165,3 +173,8 @@ python vamp_cloud_enum.py -d example.com -d example-cdn.com \
165
173
  © VampSecure Studios — VampSecure Labs Security Research Division<br/>
166
174
  For authorized security assessments only. Unauthorized use is prohibited.
167
175
  </p>
176
+
177
+ ---
178
+
179
+ ## Versión
180
+ v1.1 — VampSecure Labs Security Research Division
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "vamp-cloud-enum"
7
- version = "1.1"
7
+ version = "1.2"
8
8
  description = "Cloud asset enumeration and exposure analysis for authorized audits"
9
9
  readme = "README.md"
10
10
  license = { text = "MIT" }
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: vamp-cloud-enum
3
- Version: 1.1
3
+ Version: 1.2
4
4
  Summary: Cloud asset enumeration and exposure analysis for authorized audits
5
5
  Author-email: VampSecure Studios <contact@vampsecurestudios.com>
6
6
  License: MIT
@@ -21,8 +21,9 @@ Requires-Dist: aiohttp>=3.9.0
21
21
  Requires-Dist: rich>=13.7.0
22
22
  Dynamic: license-file
23
23
 
24
+ <!-- © VampSecure Studios — VampSecure Labs Security Research Division -->
24
25
  <p align="center">
25
- <img src="https://img.shields.io/badge/version-1.0-crimson?style=flat-square" />
26
+ <img src="https://img.shields.io/badge/version-1.1-crimson?style=flat-square" />
26
27
  <img src="https://img.shields.io/badge/python-3.11+-blue?style=flat-square&logo=python&logoColor=white" />
27
28
  <img src="https://img.shields.io/badge/providers-AWS%20%7C%20Azure%20%7C%20GCP-teal?style=flat-square" />
28
29
  <img src="https://img.shields.io/badge/VampSecure_Labs-Security_Research-8b0000?style=flat-square" />
@@ -71,6 +72,13 @@ pip install -r requirements.txt
71
72
 
72
73
  ## Installation
73
74
 
75
+
76
+ ```bash
77
+ pip install vamp-cloud-enum
78
+ # o con Homebrew:
79
+ brew install vampsecure-labs/labs/vamp-cloud-enum
80
+ ```
81
+
74
82
  ```bash
75
83
  git clone https://github.com/belky-me/vamp-cloud-enum.git
76
84
  cd vamp-cloud-enum
@@ -188,3 +196,8 @@ python vamp_cloud_enum.py -d example.com -d example-cdn.com \
188
196
  © VampSecure Studios — VampSecure Labs Security Research Division<br/>
189
197
  For authorized security assessments only. Unauthorized use is prohibited.
190
198
  </p>
199
+
200
+ ---
201
+
202
+ ## Versión
203
+ v1.1 — VampSecure Labs Security Research Division
@@ -99,19 +99,19 @@ from vampsec_report import (
99
99
  # CONSTANTES Y CONFIGURACIÓN
100
100
  # =============================================================================
101
101
 
102
- VERSION = "1.1"
102
+ VERSION = "1.2"
103
103
  TOOL_NAME = "vamp-cloud-enum"
104
104
  AUTHOR = "© VampSecure Studios — VampSecure Labs Security Research Division"
105
105
 
106
106
  console = Console()
107
107
 
108
108
  BANNER = r"""
109
- __ ___ __ __ ___ ___ ___ ___ _ _ ___ ___ _ _ ___ ___
109
+ __ ___ __ __ ___ ___ ___ ___ _ _ ___ ___ _ _ ___ ___
110
110
  \ \ / /_\ | \/ | _ \/ __| __/ __| | | | _ \ __| | /_\ | _ ) __|
111
111
  \ V / _ \| |\/| | _/\__ \ _| (__| |_| | / _|| |__ / _ \| _ \__ \
112
112
  \_/_/ \_\_| |_|_| |___/___\___|\___/|_|_\___|____/_/ \_\___/___/
113
113
  by Antonio Hernandez "Belky" — VampSecure Studios
114
- vamp-cloud-enum v1.1 · Cloud Bucket Enumerator
114
+ vamp-cloud-enum v1.2 · Cloud Bucket Enumerator
115
115
  ────────────────────────────────────────────────────────────────────────
116
116
  USO EXCLUSIVO EN AUDITORÍAS AUTORIZADAS · El uso no autorizado es ilegal
117
117
  """
@@ -1437,6 +1437,16 @@ def parse_args() -> argparse.Namespace:
1437
1437
  "(acceso público, listado de contenedores) — v1.1"
1438
1438
  ),
1439
1439
  )
1440
+ p.add_argument(
1441
+ "--check-functions",
1442
+ action="store_true",
1443
+ dest="check_functions",
1444
+ help=(
1445
+ "Comprobar exposición de funciones serverless: AWS Lambda function URLs "
1446
+ "y Azure Function Apps. Genera muchas peticiones (usa con precaución). "
1447
+ "Hallazgos: AWS_LAMBDA_URL_EXPOSED, AZURE_FUNCTION_EXPOSED — v1.2"
1448
+ ),
1449
+ )
1440
1450
 
1441
1451
  add_report_args(p)
1442
1452
  return p.parse_args()
@@ -1470,6 +1480,185 @@ def _load_wordlist(path: str) -> List[str]:
1470
1480
  return []
1471
1481
 
1472
1482
 
1483
+ # =============================================================================
1484
+ # COMPROBACIÓN DE EXPOSICIÓN DE FUNCIONES SERVERLESS (v1.2)
1485
+ # =============================================================================
1486
+
1487
+ # Regiones AWS más comunes para Lambda function URLs
1488
+ _AWS_LAMBDA_REGIONES: List[str] = [
1489
+ "us-east-1", "us-east-2", "us-west-1", "us-west-2",
1490
+ "eu-west-1", "eu-west-2", "eu-central-1",
1491
+ "ap-southeast-1", "ap-southeast-2", "ap-northeast-1",
1492
+ ]
1493
+
1494
+ # Funciones Azure habituales a probar (variantes del nombre del endpoint)
1495
+ _AZURE_FUNC_NOMBRES: List[str] = [
1496
+ "api", "function", "func", "http", "trigger", "webhook",
1497
+ "process", "handler", "main", "app",
1498
+ ]
1499
+
1500
+
1501
+ def _generar_candidatos_lambda(dominios: List[str]) -> List[str]:
1502
+ """
1503
+ Genera candidatos para el ID de Lambda function URL usando partes del dominio.
1504
+
1505
+ Los function URL IDs de AWS Lambda son cadenas de 26 caracteres aleatorias
1506
+ y no se pueden predecir. Esta función genera candidatos basados en las partes
1507
+ del dominio para detectar funciones con nombres personalizados o patrones
1508
+ predecibles que algunas organizaciones configuran.
1509
+
1510
+ Retorna lista de candidatos únicos (en minúsculas, solo alfanuméricos y guiones).
1511
+ """
1512
+ candidatos: set = set()
1513
+ for dominio in dominios:
1514
+ # Extraer parte principal del dominio (sin TLD)
1515
+ partes = dominio.rstrip(".").split(".")
1516
+ # Usar el nombre del dominio sin TLD y sin subdominios secundarios
1517
+ if len(partes) >= 2:
1518
+ nombre = partes[-2]
1519
+ else:
1520
+ nombre = partes[0]
1521
+ # Normalizar: solo alfanuméricos y guiones
1522
+ import re as _re
1523
+ nombre_norm = _re.sub(r"[^a-z0-9\-]", "-", nombre.lower())
1524
+ nombre_norm = _re.sub(r"-+", "-", nombre_norm).strip("-")
1525
+ if not nombre_norm:
1526
+ continue
1527
+
1528
+ candidatos.add(nombre_norm)
1529
+ # Variantes comunes
1530
+ for sfx in ("api", "func", "lambda", "fn", "app", "service", "svc", "handler"):
1531
+ candidatos.add(f"{nombre_norm}-{sfx}")
1532
+ candidatos.add(f"{sfx}-{nombre_norm}")
1533
+
1534
+ return list(candidatos)
1535
+
1536
+
1537
+ def _check_lambda_function_urls(
1538
+ dominios: List[str],
1539
+ findings: List[BucketResult],
1540
+ ) -> None:
1541
+ """
1542
+ Prueba URLs de funciones Lambda AWS en busca de endpoints públicamente accesibles.
1543
+
1544
+ Realiza peticiones HEAD a `https://<candidato>.lambda-url.<región>.on.aws/`
1545
+ para detectar funciones con URLs públicas habilitadas.
1546
+
1547
+ Severidad:
1548
+ HIGH — Respuesta 200 (función accesible sin autenticación)
1549
+ MEDIUM — Respuesta 403 (función existe pero requiere autenticación)
1550
+ """
1551
+ import urllib.request as _ureq
1552
+ import urllib.error as _uerr
1553
+
1554
+ candidatos = _generar_candidatos_lambda(dominios)
1555
+
1556
+ for candidato in candidatos:
1557
+ for region in _AWS_LAMBDA_REGIONES:
1558
+ url = f"https://{candidato}.lambda-url.{region}.on.aws/"
1559
+ try:
1560
+ req = _ureq.Request(
1561
+ url,
1562
+ method="HEAD",
1563
+ headers={"User-Agent": f"VampSecureLabs/{VERSION}"},
1564
+ )
1565
+ with _ureq.urlopen(req, timeout=8) as resp:
1566
+ codigo = resp.status
1567
+ if codigo == 200:
1568
+ findings.append(BucketResult(
1569
+ name=candidato, provider="aws-lambda", url=url,
1570
+ status="PUBLIC", http_code=codigo,
1571
+ headers=dict(resp.headers),
1572
+ body_snippet=f"Lambda URL pública (200 OK) — {region}",
1573
+ severity="HIGH",
1574
+ finding_id="AWS_LAMBDA_URL_EXPOSED",
1575
+ ))
1576
+ except _uerr.HTTPError as exc:
1577
+ if exc.code == 403:
1578
+ # 403 confirma que la función existe (pero requiere auth)
1579
+ findings.append(BucketResult(
1580
+ name=candidato, provider="aws-lambda", url=url,
1581
+ status="FORBIDDEN", http_code=403,
1582
+ headers={},
1583
+ body_snippet=f"Lambda URL existe pero requiere autenticación (403) — {region}",
1584
+ severity="MEDIUM",
1585
+ finding_id="AWS_LAMBDA_URL_EXPOSED",
1586
+ ))
1587
+ except _uerr.URLError:
1588
+ # DNS NXDOMAIN u otro error de red: la función no existe con ese nombre/región
1589
+ pass
1590
+ except Exception:
1591
+ pass
1592
+
1593
+
1594
+ def _check_azure_function_apps(
1595
+ dominios: List[str],
1596
+ findings: List[BucketResult],
1597
+ ) -> None:
1598
+ """
1599
+ Prueba endpoints de Azure Function Apps en busca de funciones accesibles sin auth.
1600
+
1601
+ Realiza peticiones GET a `https://<nombre>.azurewebsites.net/api/<func>?code=`
1602
+ donde <nombre> se genera a partir de los dominios objetivo y <func> es una
1603
+ lista de nombres habituales de funciones HTTP trigger.
1604
+
1605
+ Severidad:
1606
+ HIGH — Respuesta 200 (función accesible sin código de autorización)
1607
+ """
1608
+ import urllib.request as _ureq
1609
+ import urllib.error as _uerr
1610
+ import re as _re
1611
+
1612
+ # Generar nombres de Function App candidatos a partir de los dominios
1613
+ app_names: List[str] = []
1614
+ for dominio in dominios:
1615
+ partes = dominio.rstrip(".").split(".")
1616
+ if len(partes) >= 2:
1617
+ nombre = partes[-2]
1618
+ else:
1619
+ nombre = partes[0]
1620
+ nombre_norm = _re.sub(r"[^a-z0-9\-]", "-", nombre.lower())
1621
+ nombre_norm = _re.sub(r"-+", "-", nombre_norm).strip("-")
1622
+ if not nombre_norm:
1623
+ continue
1624
+ app_names.append(nombre_norm)
1625
+ # Variantes comunes de Function App
1626
+ for sfx in ("api", "functions", "func", "app", "service"):
1627
+ app_names.append(f"{nombre_norm}-{sfx}")
1628
+ app_names.append(f"{sfx}-{nombre_norm}")
1629
+
1630
+ for app_name in app_names:
1631
+ for func_nombre in _AZURE_FUNC_NOMBRES:
1632
+ # Probar sin código de autorización (debería devolver 401/403 si es seguro)
1633
+ url = f"https://{app_name}.azurewebsites.net/api/{func_nombre}?code="
1634
+ try:
1635
+ req = _ureq.Request(
1636
+ url,
1637
+ headers={"User-Agent": f"VampSecureLabs/{VERSION}"},
1638
+ )
1639
+ with _ureq.urlopen(req, timeout=8) as resp:
1640
+ codigo = resp.status
1641
+ if codigo == 200:
1642
+ cuerpo = resp.read(256).decode("utf-8", errors="ignore")
1643
+ findings.append(BucketResult(
1644
+ name=f"{app_name}/{func_nombre}", provider="azure-functions", url=url,
1645
+ status="PUBLIC", http_code=codigo,
1646
+ headers=dict(resp.headers),
1647
+ body_snippet=cuerpo[:200],
1648
+ severity="HIGH",
1649
+ finding_id="AZURE_FUNCTION_EXPOSED",
1650
+ ))
1651
+ except _uerr.HTTPError as exc:
1652
+ # 401/403 = función existe pero requiere auth → no es hallazgo
1653
+ # 404 = función no existe → silencioso
1654
+ pass
1655
+ except _uerr.URLError:
1656
+ # DNS NXDOMAIN: Function App no existe → silencioso
1657
+ break # Si el dominio no resuelve, saltar todas las funciones del mismo app_name
1658
+ except Exception:
1659
+ pass
1660
+
1661
+
1473
1662
  # =============================================================================
1474
1663
  # FUNCIÓN PRINCIPAL
1475
1664
  # =============================================================================
@@ -1702,6 +1891,31 @@ async def run(args: argparse.Namespace) -> int:
1702
1891
  else:
1703
1892
  console.print(" [green]Sin malas configuraciones detectadas.[/]")
1704
1893
 
1894
+ # ── Comprobaciones de exposición serverless (v1.2) ────────────────────────
1895
+ if getattr(args, "check_functions", False) and args.domains:
1896
+ console.print(
1897
+ "\n[bold cyan]Comprobando exposición de funciones serverless "
1898
+ "(Lambda URLs + Azure Functions)…[/]\n"
1899
+ )
1900
+ function_findings: List[BucketResult] = []
1901
+
1902
+ if "s3" in providers:
1903
+ # Lambda es parte del ecosistema AWS (misma opción de proveedor que S3)
1904
+ console.print(" [dim]→ AWS Lambda function URLs…[/]")
1905
+ _check_lambda_function_urls(args.domains, function_findings)
1906
+
1907
+ if "azure" in providers:
1908
+ console.print(" [dim]→ Azure Function Apps…[/]")
1909
+ _check_azure_function_apps(args.domains, function_findings)
1910
+
1911
+ if function_findings:
1912
+ console.print(
1913
+ f" [yellow]Funciones serverless expuestas:[/] {len(function_findings)}"
1914
+ )
1915
+ found_all.extend(function_findings)
1916
+ else:
1917
+ console.print(" [green]Sin funciones serverless expuestas detectadas.[/]")
1918
+
1705
1919
  # ── Salida en consola ─────────────────────────────────────────────────────
1706
1920
  print_summary_table(found_all)
1707
1921
  print_critical_panels(found_all)
File without changes
File without changes