<!-- review: finished -->

<a id="external-auth-totp"></a>

# Auth TOTP

Модуль реализует алгоритм одноразового пароля, основанный на времени действия (TOTP),
и обеспечивает механизм для одноразовых паролей с коротким сроком действия.

Особенности:

- Аутентификация по протоколу HTTP с использованием TOTP.
- Отслеживание аутентифицированных клиентов на основе файлов cookie после истечения срока действия TOTP.
- Настраиваемый секрет, временная привязка, временной шаг и длина усечения для генерации TOTP.
- Настраиваемый временной интервал для проверки TOTP.

<a id="installation-106"></a>

## Установка

Для [установки](https://angie.software//angie/docs/installation/index.md#install-packages) модуля используйте один из следующих пакетов:

- Angie: `angie-module-auth-totp`;
- Angie PRO: `angie-pro-module-auth-totp`.

<a id="loading-the-module-106"></a>

## Загрузка модуля

Для работы с модулем необходимо загрузить его в контексте `main{}`:

```nginx
load_module modules/ngx_http_auth_totp_module.so;
```

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

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

```nginx
server {
    listen 80;

    location /protected {
        auth_totp_realm "Protected";
        auth_totp_file /etc/angie/totp.conf;
        auth_totp_length 8;
        auth_totp_reuse off;
        auth_totp_skew 1;
        auth_totp_step 1m;
        auth_totp_cookie "totp-session";
        auth_totp_expiry 1d;
    }
}
```

<a id="additional-information-106"></a>

## Дополнительная информация

Подробная документация и исходный код доступны по ссылке:
[https://github.com/61131/nginx-http-auth-totp](https://github.com/61131/nginx-http-auth-totp)