# SSRF

## Qué es

SSRF, abreviatura de server-side request forgery, es el ataque en el que alguien entrega una URL a un servidor y este la descarga en su nombre, desde el lugar de la red donde se encuentre. El catálogo Common Weakness Enumeration lo registra como CWE-918 y describe el fallo por lo que el código no hace: recibe una URL de un componente anterior, obtiene aquello a lo que apunta y nunca comprueba que la petición vaya al destino previsto. El atacante no cambia nada del código del servidor. Proporciona una dirección y la posición del servidor en la red hace el resto.

Esa posición es precisamente lo importante. Un servidor en un centro de datos o en una cuenta en la nube suele poder acceder a cosas que un visitante de internet no alcanza: un panel de administración vinculado a una dirección interna, un puerto de base de datos, un panel de supervisión o un servicio de metadatos. La entrada de CWE detalla las consecuencias. El servidor se convierte en un proxy para el atacante, se le puede hacer explorar puertos de equipos de la red interna, y esquemas de URL como `file://`, `gopher://` y `tftp://` pueden leer documentos de la propia máquina o dar al atacante más control sobre el contenido de la petición. CWE sitúa SSRF bajo una debilidad más amplia, CWE-441, el proxy involuntario o «delegado confundido»: un componente con privilegios que trabaja para alguien que no los tiene.

La función que abre la puerta suele ser corriente. La guía de prevención de OWASP menciona dos casos habituales: una imagen de avatar que la aplicación descarga desde una URL escrita por el usuario, y URL de webhooks o de retorno de llamada que los usuarios registran para que la aplicación las invoque después. Las vistas previas de enlaces y los botones para importar desde una URL pertenecen a la misma familia, al igual que cualquier función en la que el servidor siga una dirección escrita por otra persona. El título de la propia entrada de CWE escribe el término como Server-Side Request Forgery, con mayúsculas, y recoge un nombre anterior para lo mismo: XSPA, abreviatura de Cross Site Port Attack.

## Por qué importa

OWASP incorporó SSRF a su Top 10 de 2021 como A10, y no por su volumen. Sus datos mostraban una incidencia relativamente baja, pero la categoría fue la más elegida en la encuesta de la comunidad, y sus valoraciones de explotación e impacto superaban la media. OWASP lo explica por la normalización de la descarga de URL como función de las aplicaciones web y porque los servicios en la nube y las arquitecturas más complejas agravan las consecuencias. En la edición de 2025, SSRF ya no tiene una categoría propia: CWE-918 aparece entre las debilidades destacadas de A01:2025, Broken Access Control, la categoría que encabeza la lista. La clasificación de MITRE apunta en la misma dirección: CWE-918 figura en el CWE Top 25 Most Dangerous Software Weaknesses todos los años de 2021 a 2025.

El motivo es que SSRF atraviesa directamente las defensas en las que más se apoyan los equipos. La descripción de OWASP destaca que el ataque funciona incluso cuando la aplicación está detrás de un cortafuegos, una VPN o una lista de control de acceso de red, porque la petición sale desde dentro. Sus ejemplos recorren lo que hay tras ese perímetro: localizar hosts internos y puertos abiertos a partir del resultado o del tiempo de las conexiones, leer archivos locales como `file:///etc/passwd`, comunicarse con servicios internos como `http://localhost:28017/` y aprovecharlos para ir más lejos, hasta ejecutar código remoto o provocar una denegación de servicio.

Los metadatos de la nube son el caso que convierte una molestia en una intrusión. OWASP señala que la mayoría de los proveedores mantienen los metadatos de las instancias en `http://169.254.169.254/`, una dirección del bloque 169.254.0.0/16 que el registro de usos especiales de IANA clasifica como de enlace local. En Amazon EC2, el servicio de metadatos de esa dirección también proporciona al software de la instancia las credenciales de seguridad de AWS correspondientes al rol que tiene asociado. Si un servidor descarga cualquier URL para cualquiera, se le puede pedir que descargue esas credenciales.

El patrón sigue apareciendo en lugares nuevos. Entre los ejemplos recientes de CWE hay un conjunto de herramientas para LLM que descargaba URL de imágenes arbitrarias, un fallo que ya se utilizaba para explorar puertos en abril de 2026 (CVE-2026-33626) y un entorno de aplicaciones LLM cuyo recuperador de URL podía dirigirse a direcciones locales mediante una cabecera `Location` preparada para ello (CVE-2024-3095). Desde el punto de vista de la red, un agente que navega por la web para un usuario es un servidor que descarga URL elegidas por otra persona.

## Cómo se aplica en la práctica

Considere una aplicación de chat en `app.example.com` que muestra una tarjeta de vista previa cuando alguien pega un enlace. El navegador envía la URL al servidor y este descarga la página para leer su título y su imagen:

```http
POST /api/link-preview HTTP/1.1
Host: app.example.com
Content-Type: application/json

{"url": "https://news.example.org/2026/10/harbour-reopens"}
```

Ese es el funcionamiento previsto. Ahora se envía la misma petición con otra URL, la que utiliza la documentación de AWS para enumerar los metadatos de la instancia:

```http
POST /api/link-preview HTTP/1.1
Host: app.example.com
Content-Type: application/json

{"url": "http://169.254.169.254/latest/meta-data/"}
```

Si el servidor se ejecuta en EC2 y todavía permite la versión antigua IMDSv1, envía la petición desde dentro de la instancia, el servicio de metadatos responde y todo lo que devuelva el código de vista previa acaba en manos del atacante. No se ha inyectado nada ni se ha producido una caída. El servidor ha hecho exactamente aquello para lo que se construyó, pero con la dirección equivocada.

La comprobación del destino parte de adónde iría realmente la petición una vez resuelto el nombre, en lugar de fijarse en el texto de la URL. En Python, el módulo `ipaddress` de la biblioteca estándar utiliza los registros de usos especiales de IANA para clasificar si una dirección es global, excluyendo las direcciones directas de bucle local, privadas, de enlace local, compartidas y de documentación. La siguiente función auxiliar ilustra esa clasificación; no constituye una defensa completa contra SSRF. Un despliegue también debe limitar las peticiones a destinos unicast admisibles y tener en cuenta la traducción de direcciones, como NAT64: en una red con una pasarela de traducción, una dirección clasificada como global todavía puede alcanzar un destino IPv4 incrustado que esté bloqueado. La prueba de clasificación de la función auxiliar es esta:

```python
import ipaddress
import socket
from urllib.parse import urlsplit

ALLOWED_SCHEMES = {"http", "https"}


def resolve_public(url: str) -> tuple[str, int, list[str]]:
    parts = urlsplit(url)
    if parts.scheme not in ALLOWED_SCHEMES or not parts.hostname:
        raise ValueError("scheme or host not allowed")
    port = parts.port or (443 if parts.scheme == "https" else 80)
    infos = socket.getaddrinfo(parts.hostname, port, type=socket.SOCK_STREAM)
    addresses = sorted({info[4][0] for info in infos})
    for address in addresses:
        if not ipaddress.ip_address(address).is_global:
            raise ValueError(f"{address} is not a public address")
    return parts.hostname, port, addresses
```

Todas las direcciones a las que resuelva el nombre deben superar la prueba, no solo la primera. Después, el cliente se conecta a una de esas direcciones validadas y sigue enviando el nombre de host original en la cabecera `Host` y utilizándolo para comprobar el certificado TLS, con las redirecciones desactivadas. Permitir que el cliente HTTP resuelva el nombre una segunda vez anularía la comprobación. Ese es el enfoque que describe la guía de OWASP para el caso difícil, los webhooks, donde los usuarios eligen los destinos y ninguna lista de permitidos puede enumerarlos de antemano. Cuando los destinos se conocen, una lista de nombres de host exactos reduce aún más el alcance, aunque la guía deja claro que las direcciones resueltas siguen necesitando la misma prueba.

Las comprobaciones de aplicación son una capa. La descripción de [la implementación de correo con conmutación ante fallos y registro de entregas](/es/portfolio/built-email-with-failover-and-delivery-logging/) señala que la ruta de envío pasa por un cliente protegido contra SSRF con un tiempo de espera de 30 segundos. Detrás de la aplicación sigue siendo pertinente el consejo de OWASP para la red: sitúe el código que obtiene recursos remotos en su propio segmento de red y aplique reglas de cortafuegos que denieguen por defecto, para que una comprobación omitida se encuentre con una puerta cerrada.

## Dónde surgen los problemas

**Listas de denegación y coincidencias de patrones.** Un filtro que rechaza URL que contengan `127.0.0.1`, `localhost` o `169.254.169.254` ya ha perdido. La función POSIX `inet_addr()` acepta una dirección IPv4 con entre una y cuatro partes, cada una en decimal, octal o hexadecimal, por lo que, para cualquier analizador que siga esas reglas, tanto `2852039166` como `0xa9.0xfe.0xa9.0xfe` representan la dirección de metadatos. La entrada de CWE recoge una CVE en la que las formas octales y hexadecimales eludían una comprobación escrita para decimal y anulaban una protección contra SSRF (CVE-2016-4029). La entrada del Top 10 de OWASP lo dice sin rodeos: «No mitigue SSRF mediante una lista de denegación ni una expresión regular». Decida según la dirección resuelta, como antes, y permita de forma explícita en lugar de denegar casos concretos.

**Comprobar una vez y conectar después.** Validar el nombre de host y dejar después que el cliente HTTP vuelva a resolverlo abre una brecha. Con DNS rebinding, el nombre del atacante responde con una dirección pública durante la comprobación y con una interna para la conexión. Conéctese a la dirección exacta que haya validado y aplique la misma política a los reintentos y a las conexiones alternativas, que la guía de OWASP menciona expresamente.

**Seguir redirecciones.** La URL validada responde con una redirección a `http://169.254.169.254/` o a una URL `file://`, y el cliente la sigue sin preguntar. Los ejemplos de CWE incluyen una biblioteca de descarga de URL que seguía redirecciones a URL `file://` y `scp://` (CVE-2009-0037). Desactive las redirecciones o trate cada salto como una URL nueva que debe volver a superar toda la comprobación.

**Permitir todos los esquemas.** Un cliente que también admita `file`, `gopher` o `dict` entrega al atacante archivos locales o mucho más control sobre lo que llega a un servicio interno del que permite una petición HTTP. La guía de OWASP incluye esos esquemas entre los que puede utilizar una segunda petición. Permita únicamente `http` y `https`, en los puertos que necesite la función.

**Dos analizadores, dos hosts.** La guía de OWASP muestra cómo una cadena puede identificar dos hosts distintos. En `http://good.example\@bad.example`, un analizador que siga WHATWG URL Standard trata la barra inversa como una barra normal, por lo que la ruta empieza ahí y el host es `good.example`, mientras que `urlsplit` de Python interpreta todo lo anterior al último `@` como información del usuario y devuelve `bad.example`. Cuando un componente valida y otro descarga, pueden discrepar sobre adónde va la petición. Analice una sola vez y rechace cualquier URL cuyo host no sea interpretado de la misma forma por todos los analizadores por los que pase.

**Devolver la respuesta sin filtrar.** Un endpoint de vista previa que devuelve al solicitante el cuerpo descargado transforma un ataque que solo podía deducir qué había dentro a partir de errores y tiempos en uno que puede leerlo. Devuelva únicamente lo que necesite la función, como un título y una referencia a una imagen, nunca la respuesta sin filtrar, tal como aconseja la lista de OWASP.

**Dejar IMDSv1 activado.** La documentación de AWS indica que, por defecto, se pueden utilizar ambas versiones del servicio de metadatos de instancias. IMDSv2 exige primero un token de sesión, solicitado con un `PUT` a `/latest/api/token` y enviado después en la cabecera `X-aws-ec2-metadata-token`; cuando se exige IMDSv2 (`httpTokens=required`), IMDSv1 deja de funcionar. La guía de OWASP describe IMDSv2 como un mecanismo de defensa en profundidad que mitiga algunos casos de SSRF, no todos. Exija IMDSv2 en cada instancia y corrija también la aplicación.

**Una red plana.** Si el servicio que descarga puede alcanzar la base de datos, el panel de administración y el servicio de metadatos, cada comprobación omitida deja todo al alcance. Aplique los controles de red de OWASP: segmentación, reglas de cortafuegos que denieguen por defecto el tráfico interno y registros de flujos aceptados y bloqueados para que una exploración deje rastro.

## Lecturas adicionales

- [CWE-918: Server-Side Request Forgery (SSRF)](https://cwe.mitre.org/data/definitions/918.html) — la entrada de la debilidad: consecuencias, categoría superior del delegado confundido y CVE observadas.
- [OWASP Top 10:2021: A10 Server Side Request Forgery (SSRF)](https://owasp.org/Top10/2021/A10_2021-Server-Side_Request_Forgery_%28SSRF%29/) — por qué se añadió la categoría, controles de red y aplicación y cuatro escenarios de ataque.
- [OWASP Cheat Sheet Series: Server Side Request Forgery Prevention](https://cheatsheetseries.owasp.org/cheatsheets/Server_Side_Request_Forgery_Prevention_Cheat_Sheet.html) — listas de permitidos, conexión solo a direcciones validadas, discrepancias entre analizadores y el caso de los webhooks.
- [OWASP Top 10:2025: A01 Broken Access Control](https://owasp.org/Top10/2025/A01_2025-Broken_Access_Control/) — dónde se sitúa CWE-918 en la edición de 2025.
- [Amazon EC2: Access instance metadata for an EC2 instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html) — IMDSv1 e IMDSv2, la petición del token y cómo saber si se exige IMDSv2.
- [Python documentation: ipaddress](https://docs.python.org/3/library/ipaddress.html) — `is_global` y los registros de IANA que sigue.

<https://engineer.company/es/glossary/ssrf/>
