Cómo montar un proxy HTTPS con Squid y Docker para demostrar la inspección del tráfico web
1. Objetivo del laboratorio
En esta práctica vamos a montar un proxy web con Squid 6.14 y Docker que permita demostrar cómo una organización puede inspeccionar conexiones HTTPS cuando los dispositivos utilizan una autoridad certificadora (CA) de confianza instalada por el administrador.
El laboratorio permitirá:
- Configurar un proxy Squid en un equipo local.
- Crear una autoridad certificadora propia.
- Generar certificados para los dominios visitados.
- Interceptar conexiones HTTPS mediante SSL Bump.
- Registrar las URL solicitadas.
- Observar los términos de búsqueda enviados mediante peticiones GET.
- Comprender qué información puede conocer un administrador de red y cuáles son las limitaciones de la inspección TLS.
Entorno utilizado:
- MacBook Air con Apple Silicon M1.
- macOS.
- Docker Desktop.
- Ubuntu 24.04.
- Squid 6.14.
- OpenSSL.
- Python o curl para generar peticiones de prueba.
La práctica se realizará exclusivamente con tráfico de laboratorio y datos ficticios.
2. Preparar el entorno
Instalar Docker Desktop:
Una vez instalado, comprobar que Docker funciona:
docker --version
docker compose version
Crear el directorio del laboratorio:
mkdir -p ~/laboratorio-proxy
cd ~/laboratorio-proxy
mkdir -p squid/certs
mkdir -p squid/ssl_db
mkdir -p logs
La estructura será:
laboratorio-proxy/
│
├── Dockerfile
├── docker-compose.yml
├── entrypoint.sh
│
├── squid/
│ ├── squid.conf
│ ├── certs/
│ └── ssl_db/
│
└── logs/
3. Crear la autoridad certificadora del laboratorio
Squid necesita una autoridad certificadora para generar certificados de los dominios HTTPS que inspeccionará.
Desde el directorio ~/laboratorio-proxy, ejecutar:
openssl req -new -newkey rsa:4096 \
-sha256 -days 3650 -nodes -x509 \
-keyout squid/certs/lab-ca.key \
-out squid/certs/lab-ca.crt \
-subj "/C=ES/O=Laboratorio/OU=Formacion/CN=Laboratorio Squid CA"
Crear el archivo PEM que utilizará Squid:
cat squid/certs/lab-ca.crt squid/certs/lab-ca.key \
> squid/certs/lab-ca.pem
Proteger la clave privada:
chmod 600 squid/certs/lab-ca.key
chmod 600 squid/certs/lab-ca.pem
Comprobar los archivos:
ls -l squid/certs/
Deben aparecer:
lab-ca.crt
lab-ca.key
lab-ca.pem
Importante: la clave privada lab-ca.key y el archivo lab-ca.pem deben permanecer protegidos. Nunca deben compartirse con los alumnos ni utilizarse para inspeccionar dispositivos o cuentas ajenas al laboratorio.
4. Crear el Dockerfile
En el directorio principal, crear el archivo:
nano Dockerfile
Introducir:
FROM ubuntu:24.04
ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update && \
apt-get install -y squid-openssl openssl ca-certificates && \
rm -rf /var/lib/apt/lists/*
COPY squid/squid.conf /etc/squid/squid.conf
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh
EXPOSE 3128
ENTRYPOINT ["/entrypoint.sh"]
Guardar el archivo.
5. Crear el script de inicio de Squid
Crear:
nano entrypoint.sh
Introducir el siguiente contenido:
#!/bin/sh
set -e
echo "[+] Preparando Squid..."
mkdir -p /var/lib/ssl_db
mkdir -p /var/log/squid
chown -R proxy:proxy /var/lib/ssl_db
chown -R proxy:proxy /var/log/squid
if [ ! -d /var/lib/ssl_db/db ]; then
echo "[+] Inicializando base de datos SSL..."
/usr/lib/squid/security_file_certgen \
-c -s /var/lib/ssl_db/db -M 16MB
chown -R proxy:proxy /var/lib/ssl_db/db
fi
echo "[+] Comprobando configuracion..."
squid -k parse -f /etc/squid/squid.conf
echo "[+] Iniciando Squid..."
exec squid -N -f /etc/squid/squid.conf
Guardar y dar permisos:
chmod +x entrypoint.sh
Este script inicializa la base de datos de certificados que Squid necesita para generar certificados dinámicos.
6. Configurar Squid
Crear el archivo:
nano squid/squid.conf
Introducir esta configuración completa:
# Puerto del proxy e inspección TLS
http_port 3128 ssl-bump \
cert=/etc/squid/certs/lab-ca.pem \
generate-host-certificates=on \
dynamic_cert_mem_cache_size=16MB
# Generación de certificados dinámicos
sslcrtd_program /usr/lib/squid/security_file_certgen \
-s /var/lib/ssl_db/db -M 16MB
sslcrtd_children 5 startup=1 idle=1
# Inspección HTTPS
acl step1 at_step SslBump1
ssl_bump peek step1
ssl_bump bump all
# Acceso al proxy
http_access allow all
# Desactivar caché
cache deny all
# FORMATO PERSONALIZADO DE REGISTRO
# %>ru conserva la URL original recibida del cliente.
logformat laboratorio %ts.%03tu %6tr %>a %Ss/%03>Hs %<st %rm %>ru %Sh/%<a %mt
# Registro de accesos
access_log stdio:/var/log/squid/access.log laboratorio
# Registro de errores
cache_log /var/log/squid/cache.log
visible_hostname laboratorio-squid
La línea más importante de esta configuración es:
logformat laboratorio %ts.%03tu %6tr %>a %Ss/%03>Hs %<st %rm %>ru %Sh/%<a %mt
Squid dispone de diferentes códigos para registrar las URL:
%ru: registra la URL sanitizada y respetastrip_query_terms, que oculta los parámetros de búsqueda de forma predeterminada.%>ru: registra la URL recibida del cliente y no aplica esa eliminación de parámetros.
Por eso utilizamos %>ru.
Documentación oficial:
Guardar el archivo.
7. Crear Docker Compose
Crear:
nano docker-compose.yml
Introducir:
services:
squid:
build:
context: .
dockerfile: Dockerfile
container_name: squid-laboratorio
restart: unless-stopped
ports:
- "127.0.0.1:3128:3128"
dns:
- 1.1.1.1
- 8.8.8.8
volumes:
- ./squid/certs:/etc/squid/certs:ro
- ./squid/ssl_db:/var/lib/ssl_db
- ./logs:/var/log/squid
security_opt:
- no-new-privileges:true
La publicación del puerto está limitada a 127.0.0.1, por lo que el proxy solamente estará disponible desde el propio Mac a través de ese puerto.
8. Construir e iniciar el laboratorio
Desde el directorio principal:
cd ~/laboratorio-proxy
Detener posibles instancias anteriores:
docker compose down
Construir la imagen:
docker compose build --no-cache
Iniciar el contenedor:
docker compose up -d
Comprobar su estado:
docker compose ps
El resultado esperado será parecido a:
NAME STATUS
squid-laboratorio Up
Consultar los mensajes de inicio:
docker logs squid-laboratorio
Deberían aparecer mensajes similares a:
[+] Preparando Squid...
[+] Comprobando configuracion...
[+] Iniciando Squid...
Comprobar la configuración:
docker exec squid-laboratorio squid -k parse
9. Primera prueba: conexión HTTPS
Vamos a comprobar que Squid puede establecer una conexión HTTPS.
Ejecutar:
curl -4 -v \
--proxy http://127.0.0.1:3128 \
--cacert ~/laboratorio-proxy/squid/certs/lab-ca.crt \
https://www.cloudflare.com/
En la salida debemos localizar:
HTTP/1.1 200 Connection established
También debe aparecer un certificado cuyo emisor sea:
issuer: C=ES; O=Laboratorio; OU=Formacion; CN=Laboratorio Squid CA
Y:
SSL certificate verify ok.
Esto demuestra que Squid está generando un certificado para el dominio y que curl confía en la autoridad certificadora del laboratorio.
10. Observar las conexiones en tiempo real
Abrir una segunda ventana de Terminal y ejecutar:
docker exec -it squid-laboratorio \
tail -f /var/log/squid/access.log
En la primera terminal repetir la petición:
curl -4 \
--proxy http://127.0.0.1:3128 \
--cacert ~/laboratorio-proxy/squid/certs/lab-ca.crt \
https://www.cloudflare.com/
En la segunda terminal aparecerá una entrada parecida a:
TCP_MISS/200 1341770 GET https://www.cloudflare.com/
Esto demuestra que Squid está registrando las solicitudes HTTP que atraviesan el proxy después de la inspección TLS.
11. Demostración: registrar los términos de búsqueda de Google
Esta es una de las pruebas más interesantes para explicar la privacidad en las redes corporativas.
Abrir una terminal y ejecutar:
curl -4 -L \
--proxy http://127.0.0.1:3128 \
--cacert ~/laboratorio-proxy/squid/certs/lab-ca.crt \
"https://www.google.com/search?q=PRUEBA12345"
En otra terminal observar:
docker exec -it squid-laboratorio \
tail -f /var/log/squid/access.log
La entrada que buscamos tendrá una estructura similar a:
GET https://www.google.com/search?q=PRUEBA12345
El texto PRUEBA12345 es el término de búsqueda que hemos enviado en la petición GET.
Podemos realizar otra prueba:
curl -4 -L \
--proxy http://127.0.0.1:3128 \
--cacert ~/laboratorio-proxy/squid/certs/lab-ca.crt \
"https://www.google.com/search?q=proteccion+de+datos"
El registro permitirá observar la URL de búsqueda, siempre que Google acepte la petición y esta se envíe mediante GET.
12. Demostración: acceso a Outlook
También podemos observar el acceso a Outlook:
curl -4 -v \
--proxy http://127.0.0.1:3128 \
--cacert ~/laboratorio-proxy/squid/certs/lab-ca.crt \
https://outlook.live.com/
En el registro podremos encontrar entradas similares a:
CONNECT outlook.live.com:443
GET https://outlook.live.com/
Esto permite demostrar que el administrador puede conocer el dominio visitado y las solicitudes HTTP que atraviesan el proxy.
Importante: esta prueba no permite capturar las contraseñas de una cuenta Microsoft. El registro estándar de Squid no almacena automáticamente los cuerpos de las peticiones POST y los sistemas modernos de autenticación utilizan mecanismos adicionales.
13. Consultar los registros almacenados
Para consultar las últimas solicitudes:
docker exec squid-laboratorio \
tail -30 /var/log/squid/access.log
Para consultar los errores:
docker exec squid-laboratorio \
tail -30 /var/log/squid/cache.log
Para buscar un término concreto en los registros:
docker exec squid-laboratorio \
grep "PRUEBA12345" /var/log/squid/access.log
También podemos consultar directamente los registros desde el Mac:
cat logs/access.log
14. ¿Qué información puede observar un proxy corporativo?
| Información | ¿Se puede observar? |
|---|---|
| Dominio visitado | Sí |
| Dirección IP de destino | Sí |
| URL solicitada | Sí, mediante inspección TLS |
| Términos de búsqueda enviados por GET | Sí, si aparecen en la URL y se registran |
| Método HTTP (GET, POST, etc.) | Sí |
| Código de respuesta HTTP | Sí |
| Cuerpos de peticiones POST | No se guardan automáticamente en el registro estándar |
| Contraseñas de formularios | No se muestran automáticamente |
| Contenido de correos electrónicos | No se captura automáticamente |
La capacidad de inspección depende de que el cliente confíe en la CA, el tráfico atraviese el proxy y la aplicación permita la inspección TLS. Algunas aplicaciones utilizan mecanismos que pueden impedirla.
15. Detener el laboratorio
Cuando terminemos:
cd ~/laboratorio-proxy
docker compose down
La autoridad certificadora de laboratorio no debe permanecer instalada como autoridad de confianza cuando ya no se necesite.
Si se hubiera instalado en el llavero de macOS, se puede eliminar con:
security delete-certificate \
-c "Laboratorio Squid CA" \
~/Library/Keychains/login.keychain-db
Comprobar previamente que se está eliminando el certificado correcto.
Si se configuró el proxy del sistema en macOS, desactivarlo también:
networksetup -setwebproxystate Wi-Fi off
networksetup -setsecurewebproxystate Wi-Fi off