Las pruebas de seguridad de la API comienzan con una pregunta incómoda: ¿cuántos puntos finales expone su aplicación actualmente? No los que aparecen en la especificación OpenAPI, sino los que su código realmente utiliza.
Para la mayoría de los equipos, esas dos cifras no coinciden. La especificación se escribió hace meses, el código siguió evolucionando y, en el proceso, surgieron rutas internas, puntos finales de exportación y versiones antiguas que nadie documentó. Se trata de API ocultas, y no se puede probar algo cuya existencia se desconoce.
TL; DR
Pruebas de seguridad de API en dos niveles: inventario desde el código, prueba en tiempo de ejecución.
No se pueden proteger las API cuya existencia se desconoce. Las pruebas de seguridad de las API comienzan con un inventario fiable, y la fuente más fiable es el propio código, no la especificación.
- Desviación del inventario: La comparación del código y la especificación revela puntos finales que existen pero no están documentados (API en la sombra) y operaciones documentadas que ya no sirven (API huérfanas), ambas en OWASP API9:2023.
- Defectos en el controlador: Muchos fallos de la API no son errores de inyección. Se trata de una comprobación de propiedad faltante (BOLA), una ruta de administración sin comprobación de roles o una respuesta que devuelve más campos de los que debería. Se detectan mejor analizando el controlador.
- Prueba en tiempo de ejecución: Las pruebas en tiempo de ejecución confirman lo que sugiere el código: qué puntos finales responden sin autenticación, dónde su puerta de enlace ya realiza la compensación y qué es vulnerable en la aplicación implementada.
- Un hallazgo por problema: En conjunto, las dos capas ofrecen un único resultado por cada problema, clasificado según los datos que revela (personales, de pago, de salud, credenciales).
El primer paso: Crea tu inventario de API a partir del código, compáralo con tu especificación OpenAPI y, a continuación, dirige las pruebas en tiempo de ejecución al catálogo completo, no solo a la parte documentada.
Por qué las pruebas de seguridad de API típicas resultan insuficientes
La mayoría de los equipos protegen sus API con tres elementos: una puerta de enlace que aplica la autenticación en el perímetro, un escáner que verifica la especificación y una prueba de penetración manual una o dos veces al año. Los tres son útiles, pero comparten un punto ciego.
Todos dependen de que alguien sepa qué puntos finales existen. El escáner solo prueba lo que está especificado. La prueba de penetración cubre el alcance que se le asignó. Y la puerta de enlace aplica la autenticación en el borde, pero no puede ver que el controlador nunca verifica si el pedido 4512 pertenece al usuario que lo solicita.
Es por eso que la Top 10 de seguridad API de OWASP dedica una categoría completa a la gestión inadecuada del inventario (API9:2023), y por qué su principal riesgo es la autorización a nivel de objeto defectuosa (API1): un fallo lógico sin firma y sin patrón de inyección.
Capa 1: un inventario de API construido a partir de código
Las pruebas de seguridad de API fiables comienzan con un inventario elaborado a partir de la única fuente que no se desvía: el código. Seguridad de la API de Xygeni Inspecciona tus manifiestos de dependencias, detecta los frameworks web que utilizas y extrae todos los puntos finales, incluidas las rutas declaradas en varios archivos.
Lee marcos de trabajo web populares en los principales lenguajes del lado del servidor, como Spring Boot, ASP.NET Core, Django, FastAPI, Express y Laravel, además de OpenAPI 3.x y las especificaciones de Swagger 2.x. El resultado es un catálogo de servicios, módulos y puntos finales, con sus métodos, parámetros, cuerpos de solicitud y estructuras de respuesta.
Con el código y las especificaciones uno al lado del otro, la desviación se hace evidente:
- API de sombra: puntos finales que el código utiliza, pero que la especificación no documenta.
- API huérfanas: operaciones específicas que ningún controlador ya atiende.
Si aún no estás listo para activar la detección, el modo de descubrimiento crea el catálogo y detecta las lagunas automáticamente. Es una buena manera de iniciar la conversación con los equipos de desarrollo sin generar confusión desde el primer día.
¿Qué fallos detectas al leer el manual?
Muchas vulnerabilidades de las API no son errores de inyección, sino fallos de verificación. Dado que Xygeni analiza conjuntamente las rutas, los manejadores y las especificaciones, puede detectar vulnerabilidades que los escáneres basados en patrones no pueden. Cada hallazgo se asigna a su categoría en el OWASP API Security Top 10 (2023) y a CWE.
Fallos de API que se detectan leyendo el código.
Cada defecto se corresponde con su categoría en el Top 10 de seguridad API de OWASPDe esta forma, los resultados hablan el mismo idioma que sus auditores y pentesters.
| Falla | Qué busca en el código | Categoría OWASP |
|---|---|---|
| Autorización de nivel de objeto rotoBOLA / IDOR | Puntos finales que cargan un objeto mediante un ID de la solicitud sin comprobar si pertenece al usuario. | API1 |
| Exposición excesiva de datos | Respuestas que devuelven más campos de los necesarios | API3 |
| Autorización de nivel de función defectuosa | Rutas administrativas sin verificación de roles | API5 |
| Puntos finales no autenticados y asignación masiva | Abrir rutas y solicitar organismos que acepten campos que no deberían | API2 y API3 |
| API ocultas y huérfanas | Diferencias entre código y especificación | API9 |
Para BOLA, el análisis por lenguaje busca comprobaciones de propiedad, ámbito del repositorio y vinculación de identidad. También resuelve las reglas de autorización declaradas centralmente en la configuración de su framework, y puede agregar los nombres de sus propias funciones de comprobación de propiedad para reducir aún más el ruido. Las API de GraphQL tienen sus propias comprobaciones específicas.
El detalle que cambia la priorización: cada campo se etiqueta como datos personales, de pago, de salud, de credenciales o criptográficos. Un punto final no autenticado que devuelve datos personales se clasifica como crítico, en lugar de perderse en la cola detrás de un centenar de hallazgos menores.
Capa 2: pruebas en tiempo de ejecución
El código te dice lo que podría suceder. Las pruebas en tiempo de ejecución te dicen lo que realmente sucede. Las pruebas completas de seguridad de la API necesitan ambas perspectivas, y Xygeni las conecta a través del mismo inventario de puntos finales en tres niveles:
- Verificación en vivo de la seguridad de la API. Envía una solicitud no destructiva por cada punto final candidato para confirmar o refutar los resultados de la autenticación. Si el entorno responde con un código 401 o 403, el resultado se marca como refutado: prueba de que su puerta de enlace ya compensa esta situación.
- Xygeni DAST. Prueba aplicaciones web y API en ejecución desde una imagen Docker firmada que se ejecuta en tus propios servidores de integración continua o en tu red interna. Para pruebas en producción, utiliza una intensidad pasiva, que no envía cargas útiles de ataque. Para pruebas activas, se recomienda un entorno de preproducción con una cuenta de prueba.
- Pruebas de penetración con IA. Un agente de IA planifica y ejecuta ataques no dañinos contra objetivos autorizados para demostrar qué hallazgos son explotables, en relación con el Top 10 de seguridad de la API de OWASP.
Un problema, un hallazgo
La ventaja de combinar el inventario con las pruebas en tiempo de ejecución no reside en generar más alertas, sino en obtener menos alertas, pero de mejor calidad. AI SAST Los hallazgos en el controlador, los hallazgos de DAST en el punto final en ejecución y los fallos de la API están correlacionados en el ASPM Gráfico de riesgos, con etiquetas de sensibilidad adjuntas.
Inventario de API a partir de pruebas de código frente a pruebas en tiempo de ejecución
Ninguna capa reemplaza a la otra. Las pruebas completas de seguridad de la API utilizan ambas, conectadas a través del mismo inventario de puntos finales:
| Dimensión | Inventario de API desde el código | Pruebas en tiempo de ejecución |
|---|---|---|
| Cuando se ejecuta | Antes del despliegue, en cada pull request | En relación con la aplicación desplegada (en fase de pruebas o pasiva en producción) |
| Lo que mejor ve | API en la sombra, BOLA, comprobaciones de roles faltantes, exposición de datos | ¿Qué responde realmente? Configuración del entorno, capacidad de explotación. |
| Lo que le da a la otra capa | El catálogo completo de puntos finales para probar | Confirmación o refutación de lo que sugiere el código. |
Un fallo en el controlador y el punto final expuesto que lo alcanza constituyen un único problema, con un único responsable. Y si ya utiliza otra herramienta DAST, Xygeni importa sus resultados a la misma vista de riesgo, sin solicitarle que la reemplace.
¿Quieres ver ambas capas funcionando juntas? Mira nuestra sesión Del código al entorno de ejecución: ¿Por qué? SAST DAST y otros sistemas son esenciales para la seguridad de las aplicaciones modernas.donde explicamos cómo los hallazgos del código y las pruebas en tiempo de ejecución se confirman mutuamente.
Cómo integrar las pruebas de seguridad de API en el ciclo de vida de desarrollo.
El patrón que mejor funciona para equipos de tamaño mediano es simple:
- En cada pull request: Seguridad de la API en la integración continua sobre el código modificado, además de análisis DAST incrementales.
- Antes commit: como herramienta de edición del pre-commit Acceso a archivos en preparación.
- Diariamente o al fusionar: un escaneo DAST completo.
- Antes de cada lanzamiento importante: Pruebas de penetración con IA en el entorno de preproducción para validar el backlog y confirmar que cada corrección solucionó la vulnerabilidad.
El escáner de seguridad de API se ejecuta en cualquier lugar, incluidos entornos aislados de la red, e informa a Xygeni SaaS o a su on-premise plataforma. Los resultados se muestran en formato JSON, SARIF 2.1.0, CSV y Markdown para pull request comentarios.
Pruebas de seguridad de API y cumplimiento normativo
Para los equipos en banca, seguros o el sector público, las pruebas de seguridad de API también son evidencia. Cada hallazgo lleva etiquetas de cumplimiento para Artículo 32 del RGPD, PCI DSS 4.0 (requisitos 3.4, 6.4.3, 7.1, 7.2 y 8) y SP 800-53 del NIST (AC-3, AC-6, IA-2, IA-5), visibles en la plataforma y en la salida JSON y SARIF.
Si su organización se encuentra en DORA or NIS2Las pruebas en tiempo de ejecución le brindan evidencia continua entre las pruebas de penetración manuales que sus reguladores aún exigen.
Prueba la API que realmente utilizas, no la que documentaste.
Las pruebas de seguridad de API que solo leen la especificación prueban la API que crees tener, no la que realmente utilizas. Comienza con un inventario creado a partir del código, confírmalo con pruebas en tiempo de ejecución y clasifica cada vulnerabilidad según los datos que expone el punto final.
¿Quieres ver todos los puntos de acceso que expone tu código? Reserva una sesión con un ingeniero para crear el inventario de API de uno de tus repositorios y revisar los resultados. ¡O empieza hoy mismo con el análisis gratuito de código y dependencias!
Preguntas Frecuentes
¿Necesito realizar pruebas de seguridad de la API si ya tengo una puerta de enlace de API?
Sí. Una puerta de enlace aplica la autenticación en el borde, pero no puede detectar una comprobación de propiedad faltante dentro de un controlador ni una respuesta que devuelva demasiados campos. La comprobación en tiempo real de Xygeni incluso muestra dónde su puerta de enlace ya compensa, marcando esos hallazgos como refutados.
¿Cómo puedo encontrar API ocultas o no documentadas?
Compara lo que sirve tu código con lo que documenta tu especificación. Xygeni API Security lo hace automáticamente: descubre los puntos finales a partir del código fuente, marca como API ocultas aquellos que no aparecen en tu especificación OpenAPI o Swagger, y marca como huérfanas las operaciones de especificación que no tienen un controlador.
¿Es seguro ejecutar pruebas en tiempo de ejecución en un entorno de producción?
Con la intensidad pasiva de Xygeni DAST, sí: no envía cargas útiles de ataque, permite limitar la tasa de solicitudes e identifica su tráfico con el encabezado X-Xygeni-DAST. Para pruebas activas y pentesting con IA, se recomienda un entorno de prueba con una cuenta de prueba.







