NGINX Allow Deny: Guía completa de listas blancas y negras de IP
Este artículo es una traducción del original en inglés.
Las directivas allow y deny de NGINX son herramientas esenciales para controlar el acceso a su servidor web por dirección IP. Ya sea que necesite crear una lista blanca de IP para áreas de administración o incluir en una lista negra a actores maliciosos, comprender cómo funcionan las reglas allow y deny de NGINX es fundamental para la seguridad del servidor.
Esta guía completa abarca todo lo que necesita saber sobre la configuración de allow y deny en NGINX, incluida la notación CIDR para rangos de red, el potente módulo geo para listas grandes de IP y ejemplos del mundo real con configuraciones probadas y verificadas mediante Gixy, el analizador de seguridad de configuraciones de NGINX.
Comprender las directivas allow y deny de NGINX
Las directivas allow y deny forman parte del ngx_http_access_module de NGINX, que se compila en NGINX de forma predeterminada. Estas directivas allow y deny de NGINX controlan si una dirección IP de cliente puede acceder a una ubicación determinada.
Sintaxis básica
allow address | CIDR | unix: | all;
deny address | CIDR | unix: | all;
Las directivas aceptan:
- Dirección IP única:
192.168.1.100 - Notación CIDR:
192.168.1.0/24(abarca de 192.168.1.0 a 192.168.1.255) unix:: Coincide con conexiones de socket de dominio UNIXall: Coincide con cualquier dirección IP
Contexto
Estas directivas se pueden usar en:
httpbloque (se aplica globalmente)serverbloque (se aplica al host virtual)locationbloque (se aplica a URL específicas)limit_exceptbloque (se aplica a métodos HTTP específicos)
Cómo evalúa NGINX las reglas allow y deny
Comprender el orden de evaluación de las reglas es esencial para una configuración correcta de allow y deny en NGINX. NGINX procesa las reglas allow y deny en el orden en que aparecen, y gana la primera regla que coincida.
location /admin {
allow 192.168.1.0/24; # Rule 1: Allow office network
allow 10.8.0.0/24; # Rule 2: Allow VPN range
deny all; # Rule 3: Deny everyone else
}
Para una solicitud desde 192.168.1.50:
- Comprobar la regla 1: ¿
192.168.1.50coincide con192.168.1.0/24? Sí → Permitir acceso - Las reglas 2 y 3 nunca se evalúan
Para una solicitud desde 203.0.113.10:
- Comprobar la regla 1: ¿
203.0.113.10coincide con192.168.1.0/24? No - Comprobar la regla 2: ¿
203.0.113.10coincide con10.8.0.0/24? No - Comprobar la regla 3: ¿
203.0.113.10coincide conall? Sí → Denegar acceso (HTTP 403)
Comportamiento predeterminado sin deny all
Un error común al configurar las reglas allow y deny de NGINX es olvidar la directiva deny all al final de una lista blanca:
# WRONG - Missing deny all!
location /admin {
allow 192.168.1.0/24;
allow 10.8.0.0/24;
# No deny all - non-matching IPs are ALLOWED!
}
Cuando ninguna regla coincide, NGINX devuelve NGX_DECLINED internamente, lo que significa que la solicitud continúa con normalidad. Siempre agregue deny all; al final de una configuración de lista blanca.
El analizador de seguridad Gixy marca esto como un problema de SEVERIDAD ALTA:
Problem: [allow_without_deny] Found allow directive(s) without deny in the same context.
Severity: HIGH
Reason: You probably want "deny all;" after all the "allow" directives
Puede verificar sus configuraciones con Gixy (disponible en el repositorio de GetPageSpeed):
sudo dnf install https://extras.getpagespeed.com/release-latest.rpm
sudo dnf install gixy
gixy /etc/nginx/nginx.conf
Notación CIDR explicada
La notación CIDR (Classless Inter-Domain Routing) especifica rangos de IP de forma eficiente. El formato es IP/prefix_length, donde la longitud del prefijo indica cuántos bits definen la porción de red.
Longitudes de prefijo CIDR comunes
| CIDR | Máscara de subred | Cantidad de IP | Rango de ejemplo |
|---|---|---|---|
| /32 | 255.255.255.255 | 1 | Solo una IP |
| /24 | 255.255.255.0 | 256 | 192.168.1.0 – 192.168.1.255 |
| /16 | 255.255.0.0 | 65,536 | 192.168.0.0 – 192.168.255.255 |
| /8 | 255.0.0.0 | 16,777,216 | 10.0.0.0 – 10.255.255.255 |
Rangos de red privada
Estos bloques CIDR se usan comúnmente en redes internas:
# RFC 1918 private address ranges
allow 10.0.0.0/8; # 10.0.0.0 - 10.255.255.255
allow 172.16.0.0/12; # 172.16.0.0 - 172.31.255.255
allow 192.168.0.0/16; # 192.168.0.0 - 192.168.255.255
# Localhost
allow 127.0.0.0/8; # 127.0.0.0 - 127.255.255.255
CIDR Validation Warning
NGINX valida que su notación CIDR tenga sentido. Si especifica bits de host que serían enmascarados, NGINX emite una advertencia:
nginx: [warn] low address bits of 192.168.1.50/24 are meaningless
Esta advertencia significa que usted escribió 192.168.1.50/24 cuando probablemente quería decir 192.168.1.0/24. La máscara /24 pone a cero el último octeto, por lo que el .50 se ignora. Aunque NGINX acepta la configuración, la advertencia ayuda a detectar errores.
Creating an NGINX IP Whitelist
Una lista blanca de IP de NGINX permite solo las direcciones especificadas y bloquea a todos los demás. Este es el enfoque más seguro para proteger interfaces de administración.
Basic Whitelist for Admin Areas
server {
listen 80;
server_name example.com;
root /var/www/html;
server_tokens off; # Hide NGINX version
# Protect admin area - whitelist only
location /admin {
# Office network
allow 192.168.1.0/24;
# VPN range
allow 10.8.0.0/24;
# Specific remote worker IP
allow 203.0.113.50;
# Block everyone else
deny all;
try_files $uri $uri/ /admin/index.php?$args;
}
location / {
try_files $uri $uri/ /index.php?$args;
}
}
NGINX Whitelist IP Using External File
Para facilitar el mantenimiento, almacene sus IP permitidas en un archivo separado:
# /etc/nginx/conf.d/site.conf
location /admin {
include /etc/nginx/allowlist.conf;
deny all;
try_files $uri $uri/ /admin/index.php?$args;
}
# /etc/nginx/allowlist.conf
# Office network
allow 192.168.1.0/24;
# VPN range
allow 10.8.0.0/24;
# Remote workers
allow 203.0.113.50; # Alice
allow 198.51.100.75; # Bob
# Localhost for CLI access
allow 127.0.0.1;
allow ::1;
Después de modificar el archivo de lista blanca, recargue NGINX:
nginx -t && systemctl reload nginx
Creating an IP Blacklist
Una lista negra de NGINX bloquea direcciones específicas mientras permite a todos los demás. Esto es útil para bloquear actores maliciosos conocidos.
Basic Blacklist
location / {
# Block known bad IPs
deny 192.168.100.1;
deny 192.168.100.2;
# Block entire problematic subnet
deny 10.99.0.0/24;
# Allow everyone else
allow all;
try_files $uri $uri/ /index.php?$args;
}
Order Matters for Exceptions
Puede crear excepciones dentro de una lista negra colocando permisos específicos antes de las denegaciones más amplias:
location / {
# Allow this specific IP even though its subnet is blocked
allow 192.168.100.10;
# Block the rest of the subnet
deny 192.168.100.0/24;
# Allow everyone else
allow all;
}
IPv6 Support
NGINX admite completamente direcciones IPv6 en las directivas allow y deny:
location /admin {
# IPv4
allow 192.168.1.0/24;
# IPv6 localhost
allow ::1;
# IPv6 private range (Unique Local Address)
allow fd00::/8;
# IPv6 link-local
allow fe80::/10;
# Specific IPv6 address
allow 2001:db8::1;
# IPv6 subnet
allow 2001:db8::/32;
deny all;
}
Cuando los clientes se conectan mediante IPv6 pero su servidor también tiene una dirección IPv4, asegúrese de incluir tanto las versiones IPv4 como IPv6 de las direcciones permitidas.
The Geo Module for Large IP Lists
Para gestionar miles de direcciones IP, el enfoque de allow deny de NGINX se vuelve ineficiente. NGINX evalúa las reglas de forma secuencial, por lo que una lista de 10.000 IP implica hasta 10.000 comparaciones por solicitud.
El módulo geo resuelve esto con estructuras de datos optimizadas. Asigna direcciones IP a variables utilizando ya sea un radix tree (para notación CIDR) o una two-level lookup table (para rangos de IP), ambos proporcionando búsquedas en tiempo casi constante.
Basic Geo Block
geo $is_blocked {
default 0; # Not blocked by default
192.168.100.1 1; # Block this IP
192.168.100.2 1; # Block this IP
10.99.0.0/24 1; # Block entire subnet
}
server {
listen 80;
server_tokens off;
location / {
if ($is_blocked) {
return 403;
}
# Normal request handling
try_files $uri $uri/ /index.php?$args;
}
}
Geo Block with Access Levels
geo $access_level {
default external;
127.0.0.1 localhost;
::1 localhost;
10.0.0.0/8 internal;
172.16.0.0/12 internal;
192.168.0.0/16 internal;
}
server {
listen 80;
server_tokens off;
# Only allow internal users to access admin
location /admin {
if ($access_level = external) {
return 403;
}
try_files $uri $uri/ /admin/index.php?$args;
}
}
Loading Geo Data from External File
geo $blocked_ip {
default 0;
include /etc/nginx/geo-blocklist.conf;
}
# /etc/nginx/geo-blocklist.conf
# Formato: valor IP/CIDR;
192.168.100.0/24 1;
10.99.0.0/16 1;
203.0.113.0/24 1;
Rangos geográficos para grandes conjuntos de datos
Para listas de IP muy grandes (como datos GeoIP), utilice la directiva ranges para un almacenamiento más eficiente:
geo $country {
ranges;
default ZZ;
1.0.0.0-1.0.0.255 AU;
1.0.1.0-1.0.3.255 CN;
8.8.8.0-8.8.8.255 US;
}
El modo de rangos utiliza una tabla de búsqueda de dos niveles con 65.536 buckets indexados por los 16 bits superiores de la dirección IPv4, y luego realiza una búsqueda binaria dentro de cada bucket. Esto proporciona búsquedas rápidas incluso con millones de entradas.
Protección de las áreas de administración de WordPress
A continuación se muestra un ejemplo completo para proteger la administración de WordPress utilizando las reglas allow deny de NGINX:
# Define allowed admin IPs
geo $allow_wp_admin {
default 0;
# Office network
192.168.1.0/24 1;
# VPN range
10.8.0.0/24 1;
# Localhost for WP-CLI
127.0.0.1 1;
::1 1;
}
server {
listen 80;
server_name example.com;
root /var/www/wordpress;
index index.php;
server_tokens off;
# Protect wp-admin directory
location /wp-admin {
if ($allow_wp_admin = 0) {
return 403;
}
location ~ [.]php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php-fpm/www.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
# Protect wp-login.php
location = /wp-login.php {
allow 192.168.1.0/24;
allow 10.8.0.0/24;
allow 127.0.0.1;
allow ::1;
deny all;
include fastcgi_params;
fastcgi_pass unix:/run/php-fpm/www.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
# Block xmlrpc.php entirely
location = /xmlrpc.php {
deny all;
}
# Standard WordPress handling
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ [.]php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php-fpm/www.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
Advertencia crítica: la directiva return omite el control de acceso
La directiva return se ejecuta en la fase de reescritura, que ocurre antes de la fase de acceso donde se evalúan las reglas allow deny de NGINX. Esto significa que:
location /admin {
allow 10.0.0.1;
deny all;
return 200 "Admin panel"; # Bypasses access control!
}
Esta configuración no protege /admin porque return se ejecuta antes de la comprobación de acceso.
Gixy detecta esta vulnerabilidad automáticamente:
Problem: [return_bypasses_allow_deny] Return directive bypasses allow/deny restrictions
Severity: MEDIUM
Reason: allow/deny do not restrict access to responses produced by return in the same scope
Utilice try_files o controladores de contenido (como fastcgi_pass, proxy_pass) en su lugar:
location /admin {
allow 10.0.0.1;
deny all;
try_files $uri $uri/ /admin/index.php?$args; # Access check runs first
}
Buenas prácticas de seguridad
Basándose en el análisis con Gixy, siga estas buenas prácticas de seguridad:
Ocultar la versión de NGINX
Deshabilite siempre la divulgación de la versión para evitar que los atacantes se dirijan a vulnerabilidades conocidas:
http {
server_tokens off;
server {
# ...
}
}
Gixy marca la ausencia de server_tokens off como de severidad ALTA:
Problem: [version_disclosure] Do not enable server_tokens on
Severity: HIGH
Reason: Missing server_tokens directive - defaults to 'on' which promotes information disclosure
Validar configuraciones con Gixy
Antes de desplegar, ejecute Gixy para detectar configuraciones de seguridad incorrectas. Gixy está disponible en el repositorio de GetPageSpeed:
# Install the GetPageSpeed repository
sudo dnf install https://extras.getpagespeed.com/release-latest.rpm
# Install Gixy
sudo dnf install gixy
# Analyze your configuration
gixy /etc/nginx/nginx.conf
# Check specific file
gixy /etc/nginx/conf.d/site.conf
Probar su configuración allow deny de NGINX
Pruebe siempre su configuración antes de aplicarla en producción:
# Check syntax
nginx -t
# Reload configuration
systemctl reload nginx
# Prueba desde diferentes IP con curl
curl -I http://example.com/admin
SIMULACIÓN DE SOLICITUDES DESDE DIFERENTES IP
Para las pruebas, puede usar el ngx_http_realip_module con un encabezado personalizado:
# Solo configuración de prueba: ¡eliminar en producción!
set_real_ip_from 127.0.0.1;
real_ip_header X-Test-IP;
Luego pruebe con:
curl -H "X-Test-IP: 192.168.1.50" http://localhost/admin
curl -H "X-Test-IP: 203.0.113.10" http://localhost/admin
HERENCIA DE CONFIGURACIÓN
Las reglas allow deny de NGINX siguen el modelo de herencia estándar:
- Los bloques secundarios heredan las reglas de los bloques principales si no se definen reglas en el bloque secundario
- Sí un bloque secundario tiene alguna regla de acceso, no hereda del bloque principal
server {
allow 10.0.0.0/8;
deny all;
location /public {
# Sin reglas de acceso: hereda las reglas del bloque server
}
location /api {
allow all; # Tiene reglas propias: NO hereda
}
}
CONSIDERACIONES DE RENDIMIENTO
Rendimiento de allow/deny
El módulo de acceso evalúa las reglas de forma secuencial con complejidad O(n). Para listas pequeñas (menos de 100 entradas), esto es insignificante. Para listas más grandes, use el módulo geo.
Rendimiento del módulo geo
El módulo geo utiliza estructuras de datos optimizadas:
- Modo CIDR: árbol radix con búsquedas O(32) para IPv4, O(128) para IPv6
- Modo rango: tabla de dos niveles con búsqueda en bucket O(1) más búsqueda binaria O(log n)
Para listas con miles de IP, el módulo geo es significativamente más rápido.
ERRORES COMUNES CON NGINX ALLOW DENY QUE DEBE EVITAR
- Olvidar
deny allal final de una lista blanca (Gixy: severidad ALTA) - Usar
returncon reglas de acceso: el return omite las comprobaciones de acceso (Gixy: severidad MEDIA) - Degar
server_tokens on: expone la versión de NGINX (Gixy: severidad ALTA) - Orden incorrecto de las reglas: recuerde que gana la primera coincidencia
- Bits CIDR sin sentido:
192.168.1.100/24debería ser192.168.1.0/24 - Falta de IPv6: si su servidor admite IPv6, incluya reglas de IPv6
- Probar solo desde localhost: pruebe siempre desde IP externas antes de desplegar
TEMAS RELACIONADOS DE SEGURIDAD EN NGINX
- Autenticación básica de NGINX con htpasswd: combine las restricciones por IP con la autenticación por contraseña
- Prioridad de location en NGINX: comprenda qué bloque location gestiona su solicitud
- Proxy inverso de NGINX: configure el proxy preservando las IP de los clientes
- Módulo de DNS inverso de NGINX: control de acceso basado en nombre de host en lugar de basado en IP
- Módulo de control de acceso de NGINX: reglas de acceso basadas en variables para escenarios complejos
RESUMEN
Las directivas allow deny de NGINX proporcionan un control de acceso basado en IP sencillo. Para configuraciones simples con un puñado de IP, funcionan bien. Para listas de IP más grandes o lógica más compleja, el módulo geo ofrece mejor rendimiento y flexibilidad.
Puntos clave a recordar:
- Las reglas allow deny de NGINX se evalúan en orden; gana la primera coincidencia
- Siempre termine las listas blancas con
deny all - Use la notación CIDR para rangos de red
- La directiva
returnomite las comprobaciones de acceso - Siempre establezca
server_tokens offpara ocultar la información de versión - Use el módulo geo para listas de IP grandes
- Valide las configuraciones con Gixy antes de desplegar
- Pruebe desde IP externas reales antes de desplegar
Con una lista blanca de IP adecuada mediante las reglas allow deny de NGINX y la validación con herramientas como Gixy, puede reducir significativamente su superficie de ataque asegurando que solo las redes de confianza puedan acceder a las áreas sensibles de su aplicación.
Reglas allow/deny más monitoreo de configuración. Las listas de IP son fáciles de escribir y fáciles de olvidar incluir en un nuevo bloque server. GetPageSpeed Amplify ejecuta escaneos gixy programados en cada host y vincula los hallazgos con métricas de tiempo de ejecución de NGINX en vivo. Compatible de forma directa con el obsoleto nginx-amplify-agent (fin de vida en enero de 2026).