<!-- review: finished -->

<a id="http-auth-request"></a>

# Auth Request

Implementa la autorización de clientes basada en el resultado de una subpetición. Si la subpetición 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 subpetición se considera un error.

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

Cuando se [compila desde el código fuente](https://es.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild),
este módulo no se construye por defecto;
debe habilitarse con la
opción de compilación `‑‑with‑http_auth_request_module`
[build option](https://es.angie.software//angie/docs/installation/sourcebuild.md#configure).

En los paquetes e imágenes de [nuestros repositorios](https://es.angie.software//angie/docs/installation/index.md#install-packages),
el módulo está incluido en la compilación.

El módulo puede combinarse con otros módulos de acceso, como
[Access](https://es.angie.software//angie/docs/configuration/modules/http/http_access.md#http-access) y [Auth Basic](https://es.angie.software//angie/docs/configuration/modules/http/http_auth_basic.md#http-auth-basic), mediante la directiva [satisfy](https://es.angie.software//angie/docs/configuration/modules/http/index.md#satisfy).

<a id="configuration-example-7"></a>

## Ejemplo de configuración

```nginx
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;
}
```

<a id="directives-8"></a>

## Directivas

<a id="index-0"></a>

<a id="id1"></a>

### auth_request

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `auth_request` `uri` | `off`;   |
|--------------------------------------------------------------------------------------------|---------------------------------|
| Predeterminado                                                                             | `auth_request off;`             |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | http, server, location          |

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

<a id="index-1"></a>

<a id="auth-request-set"></a>

### auth_request_set

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `auth_request_set` $variable value;   |
|--------------------------------------------------------------------------------------------|---------------------------------------|
| Predeterminado                                                                             | —                                     |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | http, server, location                |

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