<!-- review: finished -->

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

# Auth Request

Предоставляет возможность авторизации клиента, основанной на результате подзапроса. Если подзапрос возвращает код ответа 2xx, доступ разрешается. Если 401 или 403 — доступ запрещается с соответствующим кодом ошибки. Любой другой код ответа, возвращаемый подзапросом, считается ошибкой.

При ошибке 401 клиенту также передается заголовок `WWW-Authenticate` из ответа подзапроса.

При [сборке из исходного кода](https://angie.software//angie/docs/installation/sourcebuild.md#sourcebuild) модуль не собирается по умолчанию; его необходимо
включить с помощью [параметра сборки](https://angie.software//angie/docs/installation/sourcebuild.md#configure)
`‑‑with‑http_auth_request_module`.
В пакетах и образах из
[наших репозиториев](https://angie.software//angie/docs/installation/index.md#install-packages)
модуль включен в сборку.

Модуль может быть скомбинирован с другими модулями доступа, такими как [Access](https://angie.software//angie/docs/configuration/modules/http/http_access.md#http-access) и [Auth Basic](https://angie.software//angie/docs/configuration/modules/http/http_auth_basic.md#http-auth-basic) с помощью директивы [satisfy](https://angie.software//angie/docs/configuration/modules/http/index.md#satisfy).

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

## Пример конфигурации

```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="adc-directives-8"></a>

## Директивы

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

### auth_request

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `auth_request` `uri` | `off`;   |
|------------------------------------------------------------------------------------------|---------------------------------|
| По умолчанию                                                                             | `auth_request off;`             |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location          |

Включает авторизацию, основанную на результате выполнения подзапроса, и задает URI, на который будет отправлен подзапрос.

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

### auth_request_set

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `auth_request_set` $переменная значение;   |
|------------------------------------------------------------------------------------------|--------------------------------------------|
| По умолчанию                                                                             | —                                          |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | http, server, location                     |

Устанавливает переменную в запросе в заданное значение после завершения запроса авторизации. Значение может содержать переменные из запроса авторизации, например, $upstream_http_\*.