<!-- review: finished -->

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

# Auth Request

Implementa autorização de cliente baseada no resultado de uma subrequisição. Se a subrequisição retornar um código de resposta 2xx, o acesso é permitido. Se retornar 401 ou 403, o acesso é negado com o código de erro correspondente. Qualquer outro código de resposta retornado pela subrequisição é considerado um erro.

Para o erro 401, o cliente também recebe o cabeçalho `WWW-Authenticate` da resposta da subrequisição.

Ao [compilar a partir do código-fonte](https://pt.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild),
este módulo não é compilado por padrão;
deve ser habilitado com a
`‑‑with‑http_auth_request_module`
[opção de compilação](https://pt.angie.software//angie/docs/installation/sourcebuild.md#configure).

Em pacotes e imagens dos [nossos repositórios](https://pt.angie.software//angie/docs/installation/index.md#install-packages),
o módulo está incluído na compilação.

O módulo pode ser combinado com outros módulos de acesso, como
[Access](https://pt.angie.software//angie/docs/configuration/modules/http/http_access.md#http-access) e [Auth Basic](https://pt.angie.software//angie/docs/configuration/modules/http/http_auth_basic.md#http-auth-basic), através da diretiva [satisfy](https://pt.angie.software//angie/docs/configuration/modules/http/index.md#satisfy).

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

## Exemplo de Configuração

```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>

## Diretivas

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

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

### auth_request

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `auth_request` `uri` | `off`;   |
|-------------------------------------------------------------------------------------------|---------------------------------|
| Padrão                                                                                    | `auth_request off;`             |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | http, server, location          |

Habilita autorização baseada no resultado de uma subrequisição e define o URI para o qual a subrequisição será enviada.

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

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

### auth_request_set

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `auth_request_set` $variable value;   |
|-------------------------------------------------------------------------------------------|---------------------------------------|
| Padrão                                                                                    | —                                     |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | http, server, location                |

Define a variável de requisição para o valor fornecido após a requisição de autorização ser concluída. O valor pode conter variáveis da requisição de autorização, como `$upstream_http_*`.