Auth Request#

Implementa la autorización de clientes basada en el resultado de una subsolicitud. Si la subsolicitud devuelve un código de respuesta 2xx, se permite el acceso. Si devuelve 401 o 403, se deniega el acceso con el código de error correspondiente. Cualquier otro código de respuesta devuelto por la subsolicitud se considera un error.

Para el error 401, el cliente también recibe la cabecera WWW-Authenticate de la respuesta de la subsolicitud.

Cuando se compila desde el código fuente, este módulo no se compila por defecto; debe habilitarse con la opción de compilación --with-http_auth_request_module.

En paquetes e imágenes de nuestros repositorios, el módulo está incluido en la compilación.

El módulo puede combinarse con otros módulos de acceso, como Access y Auth Basic, mediante la directiva satisfy.

Ejemplo de configuración#

location /private/ {
    auth_request /auth;
#    ...
}

location = /auth {
    proxy_pass ...;
    proxy_pass_request_body off;
    proxy_set_header Content-Length "";
    proxy_set_header X-Original-URI $request_uri;
}

Directivas#

auth_request#

Sintaxis

auth_request uri | off;

Predeterminado

auth_request off;

Contexto

http, server, location

Habilita la autorización basada en el resultado de una subsolicitud y establece la URI a la que se enviará la subsolicitud.

auth_request_set#

Sintaxis

auth_request_set $variable value;

Predeterminado

—

Contexto

http, server, location

Establece la variable de solicitud al valor dado después de que se complete la solicitud de autorización. El valor puede contener variables de la solicitud de autorización, como $upstream_http_*.