readme.ru.md

## Документация для CIDRAM v4 (Русский)

### Содержание
- 1. [ПРЕДИСЛОВИЕ](#user-content-SECTION1)
- 2. [ИНСТАЛЛЯЦИЯ](#user-content-SECTION2)
- 3. [ИСПОЛЬЗОВАНИЕ](#user-content-SECTION3)
- 4. [УПРАВЛЕНИЕ ФРОНТЕНД](#user-content-SECTION4)
- 5. [НАСТРОЙКИ](#user-content-SECTION5)
- 6. [СИГНАТУР ФОРМАТ](#user-content-SECTION6)
- 7. [ИЗВЕСТНЫЕ ПРОБЛЕМЫ СОВМЕСТИМОСТИ](#user-content-SECTION7)
- 8. [ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ (FAQ)](#user-content-SECTION8)
- 9. [ЛЕГАЛЬНАЯ ИНФОРМАЦИЯ](#user-content-SECTION9)
- 10. [ОБНОВЛЕНИЕ С ПРЕДЫДУЩИХ ОСНОВНЫХ ВЕРСИЙ](#user-content-SECTION10)

*Regarding translations: My native language is English. Because this is a free and open-source hobby project which generates zero income, and translatable content is likely to change as the features and functionality supported by the project changes, it doesn't make sense for me to spend money for translations. Because I'm the sole author/developer/maintainer for the project and I'm not a ployglot, any translations I produce are very likely to contain errors. Sorry, but realistically, that won't ever change. If you find any such errors/typos/mistakes/etc, your assistance to correct them would be very much appreciated. Pull requests are invited and encouraged. Otherwise, if you find these errors too much to handle, just stick with the original English source. If a translation is irredeemably incomprehensible, let me know which, and I can delete it. If you're not sure how to perform pull requests, ask. I can help.*

---


### 1. <a name="SECTION1"></a>ПРЕДИСЛОВИЕ

CIDRAM/СИДРАМ (Бесклассовая Адресация Доступа Менеджер / Classless Inter-Domain Routing Access Manager) это скрипт предназначен для защиты веб-сайтов, путем блокирования запросов, исходящих из IP-адресов рассматривается как источников нежелательного трафика, в том числе (но не ограничивается) трафик с конечными точками доступа нечеловеческих, клоуд/облачные сервисы, спамботы, скребки, и т.д. Она делает это путем вычисления возможной CIDR из IP-адресов, поставляется из входящих запросов, а затем попытка сопоставить эти возможные CIDR с его сигнатур файлы (эти сигнатур файлы содержат списки CIDR из IP-адресов рассматривается как источников нежелательного трафика); Если совпадения найдены, запросы блокируются.

[CIDRAM](https://cidram.github.io/) авторское право 2016 года, а также GNU/GPLv2, созданный [Caleb M (Maikuolan)](https://github.com/Maikuolan).

Это руководство находится в свободном доступе. Вы можете его передавать и/или модифицировать на условиях GNU General Public License, как публикует Фонд свободного программного обеспечения (Free Software Foundation); либо под второй версией лицензии, либо любой другой более поздней версией (по вашему выбору). Пособие публикуется не в целях увеличения прибыли или создания себе рекламы, а лишь в надежде принести пользу, правда, без всякой гарантии. Подробности Вы можете узнать на странице GNU General Public License в разделе `LICENSE.txt`, а также на страницах:
- <https://www.gnu.org/licenses/>.
- <https://opensource.org/licenses/>.

CIDRAM можно бесплатно загрузить здесь:
- [GitHub](https://github.com/CIDRAM/CIDRAM).
- [Bitbucket](https://bitbucket.org/Maikuolan/cidram).
- [Codeberg](https://codeberg.org/Maikuolan/CIDRAM).

Этот документ и его различные переводы можно найти здесь:
- [GitHub](https://github.com/CIDRAM/Docs).
- [Bitbucket](https://bitbucket.org/Maikuolan/cidram-docs).
- [Codeberg](https://codeberg.org/Maikuolan/CIDRAM-Docs).

---


### 2. <a name="SECTION2"></a>ИНСТАЛЛЯЦИЯ

#### 2.0 ИНСТАЛЛЯЦИЯ ВРУЧНУЮ

Во-первых, вам понадобится свежая копия CIDRAM. Вы можете скачать архив последней версии CIDRAM из репозитория [CIDRAM/CIDRAM](https://github.com/CIDRAM/CIDRAM). Чтобы быть конкретным, вам понадобится свежая копия каталога «vault» (все из архива, кроме каталога «vault» и его содержимого, можно безопасно удалить или проигнорировать).

До v3 необходимо было установить CIDRAM где-нибудь в вашем общедоступном root-каталоге, чтобы иметь доступ к фронтенду интерфейсу CIDRAM. Однако, начиная с версии 3, в этом нет необходимости, а для обеспечения максимальной безопасности и предотвращения несанкционированного доступа к CIDRAM и ее файлам рекомендуется вместо этого устанавливать CIDRAM за *пределами* общедоступного root. Не имеет особого значения, где именно вы решите установить CIDRAM, главное чтобы она была доступна для PHP, где-то достаточно безопасно, и где-то чем вы довольны. Также больше нет необходимости поддерживать имя каталога «vault», поэтому вы можете переименовать «vault» в любое имя, которое вы предпочитаете (но для ради удобства в документации он будет по-прежнему называться каталогом «vault»).

Когда вы будете готовы, загрузите каталог «vault» в выбранное вами место и убедитесь что у него есть разрешения необходимые для того чтобы PHP мог писать в каталог (в зависимости от рассматриваемой системы иногда вам не нужно ничего делать, а иногда вам нужно установить CHMOD 755 в каталог, или если есть проблемы с 755, вы можете попробовать 777, но 777 не рекомендуется из-за меньшей безопасности).

Далее, чтобы CIDRAM могла защитить вашу кодовую базу или CMS, вам необходимо создать «точку входа». Такая точка входа состоит из трех вещей:

1. Включение файла «loader.php» в соответствующую точку вашей кодовой базы или CMS.
2. Инстанциация CIDRAM core.
3. Вызов метода «protect».

Простой пример:

```PHP
<?php
require_once '/path/to/the/vault/directory/loader.php';
(new \CIDRAM\CIDRAM\Core())->protect();
```

Если вы используете веб-сервер Apache и имеете доступ к `php.ini`, вы можете использовать директиву `auto_prepend_file` для запуска CIDRAM всякий раз, когда делается любой запрос PHP. В таком случае наиболее подходящим местом для создания вашей точки входа будет ее собственный файл, и вы должны указать этот файл в директиве `auto_prepend_file`.

Пример:

`auto_prepend_file = "/path/to/your/entrypoint.php"`

Или это в файле `.htaccess`:

`php_value auto_prepend_file "/path/to/your/entrypoint.php"`

В других случаях наиболее подходящим местом для создания вашей точки входа будет самая ранняя возможная точка в вашей кодовой базе или CMS, чтобы она всегда загружалась всякий раз, когда кто-то обращается к любой странице на всем вашем веб-сайте. Если в вашей кодовой базе используется «начальная загрузка», хорошим примером будет самое начало вашего «начальная загрузочного» файла. Если в вашей кодовой базе есть центральный файл, отвечающий за соединение с вашей базой данных, другим хорошим примером будет самое начало этого центрального файла.

#### 2.1 ИНСТАЛЛЯЦИЯ С ПОМОЩЬЮ COMPOSER

[CIDRAM зарегистрирован в Packagist](https://packagist.org/packages/cidram/cidram), и так, если Вы знакомы с Composer, Вы можете использовать Composer для инсталляция CIDRAM.

`composer require cidram/cidram`

#### 2.2 ИНСТАЛЛЯЦИЯ ДЛЯ WORDPRESS

[CIDRAM зарегистрирован как плагин с базой данных плагинов WordPress](https://wordpress.org/plugins/cidram/), и Вы можете установить CIDRAM непосредственно из панели плагинов. Вы можете установить его так же, как любой другой плагин, и никаких дополнительных шагов не требуется.

*Предупреждение: Обновление CIDRAM через панель инструментов плагинов приводит к чистой установке! Если Вы персонализированные свою инсталляция (изменили вашу конфигурацию, установленные модули и т.д.), эти персонализации будут потеряны при обновлении через панель инструментов плагинов! Лог-файлы также будут потеряны! Чтобы сохранить файлы журналов и настройки, обновите страницу с CIDRAM фронтенд.*

#### 2.3 КОНФИГУРАЦИЯ И ПЕРСОНАЛИЗАЦИЯ

Настоятельно рекомендуется просмотреть конфигурацию новой установки, чтобы иметь возможность настроить ее в соответствии со своими потребностями. Вы также можете установить дополнительные модули, файлы сигнатур, создать вспомогательные правила, или реализовать другие настройки, чтобы ваша установка наилучшим образом соответствовала вашим потребностям. Я рекомендую использовать фронтенд интерфейс, чтобы делать эти вещи.

---


### 3. <a name="SECTION3"></a>ИСПОЛЬЗОВАНИЕ

CIDRAM должен автоматически блокировать нежелательные запросы на свой веб-сайт, без необходимости ручного помощь, кроме его первоначальной инсталляция.

Вы можете настроить конфигурацию, и настроить какие CIDR-ы заблокированы, путем изменения файла конфигурации и/или ваши сигнатур файлы.

CIDRAM можно обновлять вручную или через фронтенд. CIDRAM также может быть обновлен через Composer или WordPress, если они первоначально установлены с помощью этих средств.

---


### 4. <a name="SECTION4"></a>УПРАВЛЕНИЕ ФРОНТЕНД

#### 4.0 ЧТО ЯВЛЯЕТСЯ ФРОНТЕНД.

Фронтенд обеспечивает удобный и простой способ для поддержания, управления и обновить инсталляция CIDRAM. Вы можете просматривать, обмениваться и скачать лог-файлы через страницу для лог-файлы, Вы можете изменить конфигурацию с помощью страницы конфигурации, Вы можете устанавливать и удалять компоненты через страницу обновления, и Вы можете загрузить, скачать, и изменять файлы в вашем vault с помощью файл менеджер.

#### 4.1 КАК ПОЛУЧИТЬ ДОСТУП К ФРОНТЕНДУ.

Подобно тому, как вам нужно было создать точку входа, чтобы CIDRAM защищал ваш веб-сайт, вам также потребуется создать точку входа для доступа к фронтенду. Такая точка входа состоит из трех вещей:

1. Включение файла «loader.php» в соответствующую точку вашей кодовой базы или CMS.
2. Инстанциация CIDRAM front-end/фронтенд.
3. Вызов метода «view».

Простой пример:

```PHP
<?php
require_once '/path/to/the/vault/directory/loader.php';
(new \CIDRAM\CIDRAM\FrontEnd())->view();
```

Класс «FrontEnd» расширяет класс «Core», а это означает, что при желании, вы можете вызвать метод «защиты» перед вызовом метода «просмотра», чтобы заблокировать потенциально нежелательный трафик от доступа к фронтенду. Делать это совершенно необязательно.

Простой пример:

```PHP
<?php
require_once '/path/to/the/vault/directory/loader.php';
$CIDRAM = new \CIDRAM\CIDRAM\FrontEnd();
$CIDRAM->protect();
$CIDRAM->view();
```

Наиболее подходящим местом для создания точки входа для фронтенда является отдельный выделенный файл. В отличие от вашей ранее созданной точки входа, вы хотите, чтобы ваша фронтенд точка входа была доступна только путем прямого запроса определенного файла, в котором существует точка входа, поэтому в этом случае вы не захотите использовать `auto_prepend_file` или `.htaccess`.

После создания фронтенд точки входа используйте браузер для доступа к ней. Вам должна быть представлена страница входа. На странице входа введите имя пользователя и пароль стандартную (admin/password) и нажмите кнопку входа.

Заметка: После того, как Вы вошли в первый раз, в целях предотвращения несанкционированного доступа к фронтенд, Вы должны немедленно изменить имя пользователя и пароль! Это очень важно, потому что это можно загрузить произвольный PHP код на свой веб-сайт через фронтенд.

Кроме того, для обеспечения оптимальной безопасности настоятельно рекомендуется включить «двухфакторную аутентификацию» для всех аккаунтов фронтенд (инструкции приведены ниже).

#### 4.2 КАК ИСПОЛЬЗОВАТЬ ФРОНТЕНД.

Инструкции предоставляются на каждой странице в фронтенд, чтобы объяснить правильный способ использовать его и его целевое назначение. Если Вам нужна дополнительная объяснение или любой специальный помощь, обратитесь в поддержки. Дополнительно, есть некоторые видео доступны на YouTube, которые могли бы помочь путем демонстрации.

#### 4.3 ДВУХФАКТОРНАЯ АУТЕНТИФИКАЦИЯ

Возможно сделать фронтенд более безопасным, включив двухфакторную аутентификацию («2FA»). При входе в аккаунт с поддержкой 2FA, электронное письмо отправляется на адрес электронной почты, связанный с этой аккаунтой. Это электронное письмо содержит «код 2FA», который затем должен ввести пользователь в дополнение к имени пользователя и паролю, чтобы иметь возможность войти в систему, используя эту аккаунт. Это означает, что получить пароль аккаунтой будет недостаточно для того, чтобы любой хакер или потенциальный злоумышленник могли войти в эту аккаунт, потому что им также необходимо будет иметь доступ к адресу электронной почты, связанному с этой аккаунтой, чтобы иметь возможность получать и использовать код 2FA, связанный с сеансом, что делает фронтенд более безопасным.

Во-первых, чтобы включить двухфакторную аутентификацию, используя страницу обновлений фронтенда, установите компонент PHPMailer. CIDRAM использует PHPMailer для отправки электронных писем.

После того, как Вы установили PHPMailer, вам нужно будет заполнить директивы конфигурации для PHPMailer через страницу конфигурации CIDRAM или файл конфигурации. Более подробная информация об этих директивах конфигурации содержится в разделе конфигурации этого документа. После того, как Вы заполнили директивы конфигурации PHPMailer, установите `enable_two_factor` в `true`. На этом этапе должна быть включена двухфакторная аутентификация.

Затем вам нужно связать адрес электронной почты с аккаунтой, чтобы CIDRAM знал, куда отправлять коды 2FA при входе в эту аккаунт. Для этого используйте адрес электронной почты в качестве имени пользователя для аккаунтой (например, `foo@bar.tld`), или указать адрес электронной почты как часть имени пользователя так же, как при отправке письма обычно (например, `Foo Bar <foo@bar.tld>`).

Заметка: Особенно важна защита вашего vault от несанкционированного доступа (например, посредством укрепления безопасности вашего сервера и ужесточение разрешений общего доступа), поскольку несанкционированный доступ к вашему конфигурационному файлу (который хранится в вашем vault), может подвергнуть риску выставлять исходящие настройки SMTP (это включает имя пользователя и пароль SMTP). Вы должны убедиться, что ваше vault правильно защищено, прежде чем включить двухфакторную аутентификацию. Если не можете этого сделать, то, по крайней мере, Вы должны создать новую аккаунт электронной почты, предназначенную для этой цели, чтобы уменьшить риски, связанные с открытыми параметрами SMTP.

---


### 5. <a name="SECTION5"></a>НАСТРОЙКИ

Ниже представлен список переменных данных в файле конфигурации `config.yml`, а также краткое описание их функций.

```
Конфигурация (v4)
│
├───general
│       stages [string]
│       fields [string]
│       timezone [string]
│       time_offset [int]
│       time_format [string]
│       ipaddr [string]
│       http_response_header_code [int]
│       silent_mode [string]
│       silent_mode_response_header_code [int]
│       lang [string]
│       lang_override [bool]
│       numbers [string]
│       emailaddr [string]
│       emailaddr_display_style [string]
│       default_dns [string]
│       default_algo [string]
│       statistics [string]
│       statistics_captchas [string]
│       force_hostname_lookup [bool]
│       allow_gethostbyaddr_lookup [bool]
│       disabled_channels [string]
│       request_proxy [string]
│       request_proxyauth [string]
│       default_timeout [int]
│       sensitive [string]
│       email_notification_address [string]
│       email_notification_name [string]
│       email_notification_when [string]
├───components
│       ipv4 [string]
│       ipv6 [string]
│       modules [string]
│       imports [string]
│       events [string]
├───logging
│       standard_log [string]
│       apache_style_log [string]
│       serialised_log [string]
│       error_log [string]
│       outbound_request_log [string]
│       report_log [string]
│       truncate [string]
│       log_rotation_limit [int]
│       log_rotation_action [string]
│       log_banned_ips [bool]
│       log_sanitisation [bool]
├───frontend
│       frontend_log [string]
│       signatures_update_event_log [string]
│       max_login_attempts [int]
│       theme [string]
│       theme_mode [string]
│       magnification [float]
│       custom_header [string]
│       custom_footer [string]
│       remotes [string]
│       enable_two_factor [bool]
├───signatures
│       shorthand [string]
│       default_tracktime [string]
│       infraction_limit [int]
│       tracking_override [bool]
│       conflict_response [int]
├───verification
│       search_engines [string]
│       social_media [string]
│       other [string]
│       adjust [string]
├───captcha
│       usemode [int]
│       nonblocked_status_code [int]
│       api [string]
│       messages [string]
│       lockto [string]
│       hcaptcha_sitekey [string]
│       hcaptcha_secret [string]
│       friendly_sitekey [string]
│       friendly_apikey [string]
│       turnstile_sitekey [string]
│       turnstile_secret [string]
│       expiry [float]
│       signature_limit [int]
│       log [string]
├───legal
│       pseudonymise_ip_addresses [bool]
│       privacy_policy [string]
├───template_data
│       theme [string]
│       theme_mode [string]
│       magnification [float]
│       css_url [string]
│       block_event_title [string]
│       captcha_title [string]
│       custom_header [string]
│       custom_footer [string]
├───rate_limiting
│       max_bandwidth [string]
│       max_requests [int]
│       precision_ipv4 [int]
│       precision_ipv6 [int]
│       allowance_period [string]
│       exceptions [string]
│       segregate [bool]
├───supplementary_cache_options
│       prefix [string]
│       enable_apcu [bool]
│       enable_memcached [bool]
│       enable_redis [bool]
│       enable_pdo [bool]
│       memcached_host [string]
│       memcached_port [int]
│       redis_host [string]
│       redis_port [int]
│       redis_timeout [float]
│       redis_database_number [int]
│       pdo_dsn [string]
│       pdo_username [string]
│       pdo_password [string]
└───bypasses
        used [string]
```

#### «general» (Категория)
Общая конфигурация (любая конфигурация ядра, не относящаяся к другим категориям).

##### «stages» `[string]`
- Элементы управления этапами цепочки выполнения (состояние, регистрация ошибок, и т.д.).

```
stages───[Включить этот этап?]─[Записывать какие-либо ошибки, возникшие на этом этапе?]─[Засчитывать нарушения, возникшие на этом этапе, в отслеживания IP?]
├─BanCheck ("Проверьте, запрещены ли")
├─Tests ("Выполнить тестов файлов сигнатур")
├─Modules ("Выполнить модули")
├─SearchEngineVerification ("Выполнить проверку поисковой системы")
├─SocialMediaVerification ("Выполнить проверку в социальных сетях")
├─OtherVerification ("Выполнить другую проверку")
├─Aux ("Выполнить вспомогательные правила")
├─Tracking ("Выполнить отслеживание IP")
├─RL ("Выполнить ограничения скорости")
├─CAPTCHA ("Развертывание CAPTCHA (заблокированные запросы)")
├─Reporting ("Выполнить отчетность")
├─Statistics ("Обновить статистику")
├─Webhooks ("Выполнить веб-крючков")
├─TriggerNotifications ("Обработать очередь уведомлений о триггерах по электронной почте")
├─PrepareFields ("Подготовить поля для вывода и журналов")
├─Output ("Генерация выводных (заблокированные запросы)")
├─WriteLogs ("Запись в журналы (заблокированные запросы)")
├─Terminate ("Прекращать запрос (заблокированные запросы)")
├─AuxRedirect ("Редирект по вспомогательным правилам")
└─NonBlockedCAPTCHA ("Развертывание CAPTCHA (незаблокированные запросы)")
```

##### «fields» `[string]`
- Элементы управления для полей во время событий блокировки (когда запрос заблокирован).

```
fields───[Должно ли это поле отображаться в записях журнала?]─[Должно ли это поле отображаться на странице «доступ запрещен»?]─[Пропустить это поле, если оно пустое?]
├─ID ("ИД")
├─ScriptIdent ("Скрипт версия")
├─DateTime ("Дата/Время")
├─IPAddr ("IP-адрес")
├─IPAddrResolved ("IP-адрес (постановили)")
├─Query ("Запрос")
├─Referrer ("Реферер")
├─UA ("Пользовательский агент")
├─UALC ("Пользовательский агент (в нижнем регистре)")
├─SignatureCount ("Количество сигнатурей")
├─Signatures ("Идентификаторы для сигнатурей")
├─WhyReason ("Почему заблокированные")
├─ReasonMessage ("Почему заблокированные (подробный)")
├─rURI ("Реконструированный URI")
├─Infractions ("Нарушений")
├─ASNLookup ("** Поиск ASN")
├─CCLookup ("** Поиск кода страны")
├─Verified ("Подтвержденная идентичность")
├─Expired ("Истекший")
├─Ignored ("Игнорируется")
├─Request_Method ("Метод запроса")
├─Protocol ("Протокол")
├─SEC_CH_UA_PLATFORM ("!! SEC_CH_UA_PLATFORM")
├─SEC_CH_UA_MOBILE ("!! SEC_CH_UA_MOBILE")
├─SEC_CH_UA ("!! SEC_CH_UA")
├─Hostname ("Имя хоста")
├─CAPTCHA ("Статус CAPTCHA")
├─Inspection ("* Проверка условий")
└─ClientL10NAccepted ("Языковое разрешение")
```

* Предназначен только для отладки вспомогательных правил. Не отображается для заблокированных пользователей.

** Требуется функциональность поиска ASN (например, через модуль IP-API или BGPView).

!! Это подсказка клиенту с низкой энтропией. Это новая экспериментальная веб-технология, которая еще не получила широкой поддержки во всех браузерах и основных клиентах. *Видеть: <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Sec-CH-UA#browser_compatibility" dir="ltr" hreflang="en-US" rel="noopener noreferrer external">Sec-CH-UA - HTTP | MDN</a>.* Хотя клиентские подсказки могут быть полезны для снятия отпечатков пальцев, поскольку они не получили широкой поддержки, их присутствие в запросах не следует предполагать и не полагаться на них (т.е., блокировать по причине их отсутствия – плохая идея).

##### «timezone» `[string]`
- Часовой пояс для использования (например, Africa/Cairo, America/New_York, Asia/Tokyo, Australia/Perth, Europe/Berlin, Pacific/Guam, и т.д.). Укажите «SYSTEM», чтобы позволить PHP обрабатывать это автоматически.

```
timezone
├─SYSTEM ("Использовать часовой пояс по умолчанию.")
├─UTC ("UTC")
└─…Другие
```

##### «time_offset» `[int]`
- Смещение часового пояса в минут.

##### «time_format» `[string]`
- Формат нотации даты, используемый CIDRAM. Дополнительные опции могут быть добавлены по запросу.

```
time_format
├─{Day}, {dd} {Mon} {yyyy} {hh}:{ii}:{ss} {tz} ("{Day}, {dd} {Mon} {yyyy} {hh}:{ii}:{ss} {tz}")
├─{Day}, {dd} {Mon} {yyyy} {hh}:{ii}:{ss} ("{Day}, {dd} {Mon} {yyyy} {hh}:{ii}:{ss}")
├─{Day}, {dd} {Mon} {yyyy} ("{Day}, {dd} {Mon} {yyyy}")
├─{yyyy}.{mm}.{dd} {hh}:{ii}:{ss} {tz} ("{yyyy}.{mm}.{dd} {hh}:{ii}:{ss} {tz}")
├─{yyyy}.{mm}.{dd} {hh}:{ii}:{ss} ("{yyyy}.{mm}.{dd} {hh}:{ii}:{ss}")
├─{yyyy}.{mm}.{dd} ("{yyyy}.{mm}.{dd}")
├─{yyyy}-{mm}-{dd} {hh}:{ii}:{ss} {tz} ("{yyyy}-{mm}-{dd} {hh}:{ii}:{ss} {tz}")
├─{yyyy}-{mm}-{dd} {hh}:{ii}:{ss} ("{yyyy}-{mm}-{dd} {hh}:{ii}:{ss}")
├─{yyyy}-{mm}-{dd} ("{yyyy}-{mm}-{dd}")
├─{yyyy}/{mm}/{dd} {hh}:{ii}:{ss} {tz} ("{yyyy}/{mm}/{dd} {hh}:{ii}:{ss} {tz}")
├─{yyyy}/{mm}/{dd} {hh}:{ii}:{ss} ("{yyyy}/{mm}/{dd} {hh}:{ii}:{ss}")
├─{yyyy}/{mm}/{dd} ("{yyyy}/{mm}/{dd}")
├─{dd}.{mm}.{yyyy} {hh}:{ii}:{ss} {tz} ("{dd}.{mm}.{yyyy} {hh}:{ii}:{ss} {tz}")
├─{dd}.{mm}.{yyyy} {hh}:{ii}:{ss} ("{dd}.{mm}.{yyyy} {hh}:{ii}:{ss}")
├─{dd}.{mm}.{yyyy} ("{dd}.{mm}.{yyyy}")
├─{dd}-{mm}-{yyyy} {hh}:{ii}:{ss} {tz} ("{dd}-{mm}-{yyyy} {hh}:{ii}:{ss} {tz}")
├─{dd}-{mm}-{yyyy} {hh}:{ii}:{ss} ("{dd}-{mm}-{yyyy} {hh}:{ii}:{ss}")
├─{dd}-{mm}-{yyyy} ("{dd}-{mm}-{yyyy}")
├─{dd}/{mm}/{yyyy} {hh}:{ii}:{ss} {tz} ("{dd}/{mm}/{yyyy} {hh}:{ii}:{ss} {tz}")
├─{dd}/{mm}/{yyyy} {hh}:{ii}:{ss} ("{dd}/{mm}/{yyyy} {hh}:{ii}:{ss}")
├─{dd}/{mm}/{yyyy} ("{dd}/{mm}/{yyyy}")
├─{mm}.{dd}.{yyyy} {hh}:{ii}:{ss} {tz} ("{mm}.{dd}.{yyyy} {hh}:{ii}:{ss} {tz}")
├─{mm}.{dd}.{yyyy} {hh}:{ii}:{ss} ("{mm}.{dd}.{yyyy} {hh}:{ii}:{ss}")
├─{mm}.{dd}.{yyyy} ("{mm}.{dd}.{yyyy}")
├─{mm}-{dd}-{yyyy} {hh}:{ii}:{ss} {tz} ("{mm}-{dd}-{yyyy} {hh}:{ii}:{ss} {tz}")
├─{mm}-{dd}-{yyyy} {hh}:{ii}:{ss} ("{mm}-{dd}-{yyyy} {hh}:{ii}:{ss}")
├─{mm}-{dd}-{yyyy} ("{mm}-{dd}-{yyyy}")
├─{mm}/{dd}/{yyyy} {hh}:{ii}:{ss} {tz} ("{mm}/{dd}/{yyyy} {hh}:{ii}:{ss} {tz}")
├─{mm}/{dd}/{yyyy} {hh}:{ii}:{ss} ("{mm}/{dd}/{yyyy} {hh}:{ii}:{ss}")
├─{mm}/{dd}/{yyyy} ("{mm}/{dd}/{yyyy}")
├─{yy}.{mm}.{dd} {hh}:{ii}:{ss} {tz} ("{yy}.{mm}.{dd} {hh}:{ii}:{ss} {tz}")
├─{yy}.{mm}.{dd} {hh}:{ii}:{ss} ("{yy}.{mm}.{dd} {hh}:{ii}:{ss}")
├─{yy}.{mm}.{dd} ("{yy}.{mm}.{dd}")
├─{yy}-{mm}-{dd} {hh}:{ii}:{ss} {tz} ("{yy}-{mm}-{dd} {hh}:{ii}:{ss} {tz}")
├─{yy}-{mm}-{dd} {hh}:{ii}:{ss} ("{yy}-{mm}-{dd} {hh}:{ii}:{ss}")
├─{yy}-{mm}-{dd} ("{yy}-{mm}-{dd}")
├─{yy}/{mm}/{dd} {hh}:{ii}:{ss} {tz} ("{yy}/{mm}/{dd} {hh}:{ii}:{ss} {tz}")
├─{yy}/{mm}/{dd} {hh}:{ii}:{ss} ("{yy}/{mm}/{dd} {hh}:{ii}:{ss}")
├─{yy}/{mm}/{dd} ("{yy}/{mm}/{dd}")
├─{dd}.{mm}.{yy} {hh}:{ii}:{ss} {tz} ("{dd}.{mm}.{yy} {hh}:{ii}:{ss} {tz}")
├─{dd}.{mm}.{yy} {hh}:{ii}:{ss} ("{dd}.{mm}.{yy} {hh}:{ii}:{ss}")
├─{dd}.{mm}.{yy} ("{dd}.{mm}.{yy}")
├─{dd}-{mm}-{yy} {hh}:{ii}:{ss} {tz} ("{dd}-{mm}-{yy} {hh}:{ii}:{ss} {tz}")
├─{dd}-{mm}-{yy} {hh}:{ii}:{ss} ("{dd}-{mm}-{yy} {hh}:{ii}:{ss}")
├─{dd}-{mm}-{yy} ("{dd}-{mm}-{yy}")
├─{dd}/{mm}/{yy} {hh}:{ii}:{ss} {tz} ("{dd}/{mm}/{yy} {hh}:{ii}:{ss} {tz}")
├─{dd}/{mm}/{yy} {hh}:{ii}:{ss} ("{dd}/{mm}/{yy} {hh}:{ii}:{ss}")
├─{dd}/{mm}/{yy} ("{dd}/{mm}/{yy}")
├─{mm}.{dd}.{yy} {hh}:{ii}:{ss} {tz} ("{mm}.{dd}.{yy} {hh}:{ii}:{ss} {tz}")
├─{mm}.{dd}.{yy} {hh}:{ii}:{ss} ("{mm}.{dd}.{yy} {hh}:{ii}:{ss}")
├─{mm}.{dd}.{yy} ("{mm}.{dd}.{yy}")
├─{mm}-{dd}-{yy} {hh}:{ii}:{ss} {tz} ("{mm}-{dd}-{yy} {hh}:{ii}:{ss} {tz}")
├─{mm}-{dd}-{yy} {hh}:{ii}:{ss} ("{mm}-{dd}-{yy} {hh}:{ii}:{ss}")
├─{mm}-{dd}-{yy} ("{mm}-{dd}-{yy}")
├─{mm}/{dd}/{yy} {hh}:{ii}:{ss} {tz} ("{mm}/{dd}/{yy} {hh}:{ii}:{ss} {tz}")
├─{mm}/{dd}/{yy} {hh}:{ii}:{ss} ("{mm}/{dd}/{yy} {hh}:{ii}:{ss}")
├─{mm}/{dd}/{yy} ("{mm}/{dd}/{yy}")
├─{yyyy}年{m}月{d}日 {hh}時{ii}分{ss}秒 ("{yyyy}年{m}月{d}日 {hh}時{ii}分{ss}秒")
├─{yyyy}年{m}月{d}日 {hh}:{ii}:{ss} {tz} ("{yyyy}年{m}月{d}日 {hh}:{ii}:{ss} {tz}")
├─{yyyy}年{m}月{d}日 ("{yyyy}年{m}月{d}日")
├─{yy}年{m}月{d}日 {hh}時{ii}分{ss}秒 ("{yy}年{m}月{d}日 {hh}時{ii}分{ss}秒")
├─{yy}年{m}月{d}日 {hh}:{ii}:{ss} {tz} ("{yy}年{m}月{d}日 {hh}:{ii}:{ss} {tz}")
├─{yy}年{m}月{d}日 ("{yy}年{m}月{d}日")
├─{yyyy}년 {m}월 {d}일 {hh}시 {ii}분 {ss}초 ("{yyyy}년 {m}월 {d}일 {hh}시 {ii}분 {ss}초")
├─{yyyy}년 {m}월 {d}일 {hh}:{ii}:{ss} {tz} ("{yyyy}년 {m}월 {d}일 {hh}:{ii}:{ss} {tz}")
├─{yyyy}년 {m}월 {d}일 ("{yyyy}년 {m}월 {d}일")
├─{yy}년 {m}월 {d}일 {hh}시 {ii}분 {ss}초 ("{yy}년 {m}월 {d}일 {hh}시 {ii}분 {ss}초")
├─{yy}년 {m}월 {d}일 {hh}:{ii}:{ss} {tz} ("{yy}년 {m}월 {d}일 {hh}:{ii}:{ss} {tz}")
├─{yy}년 {m}월 {d}일 ("{yy}년 {m}월 {d}일")
├─{yyyy}-{mm}-{dd}T{hh}:{ii}:{ss}{t:z} ("{yyyy}-{mm}-{dd}T{hh}:{ii}:{ss}{t:z}")
├─{d}. {m}. {yyyy} ("{d}. {m}. {yyyy}")
└─…Другие
```

__*Заполнитель – Объяснение – Пример на основе 2024-04-30T18:27:49+08:00.*__<br />
`{yyyy}` – Год – Например, 2024.<br />
`{yy}` – Сокращенный год – Например, 24.<br />
`{Mon}` – Сокращенное название месяца (на английском языке) – Например, Apr.<br />
`{mm}` – Месяц с ведущими нулями – Например, 04.<br />
`{m}` – Месяц – Например, 4.<br />
`{Day}` – Сокращенное название дня (на английском языке) – Например, Tue.<br />
`{dd}` – День с ведущими нулями – Например, 30.<br />
`{d}` – День – Например, 30.<br />
`{hh}` – Час с ведущими нулями (используется 24-часовой формат времени) – Например, 18.<br />
`{h}` – Час (используется 24-часовой формат времени) – Например, 18.<br />
`{ii}` – Минуты с ведущими нулями – Например, 27.<br />
`{i}` – Минута – Например, 27.<br />
`{ss}` – Секунды с ведущими нулями – Например, 49.<br />
`{s}` – Секунда – Например, 49.<br />
`{tz}` – Часовой пояс (без двоеточия) – Например, +0800.<br />
`{t:z}` – Часовой пояс (с двоеточием) – Например, +08:00.

##### «ipaddr» `[string]`
- Место IP-адреса актуального соединения в общем потоке данных (полезно для таких сервисов как Cloudflare). Стандарт = REMOTE_ADDR. ВНИМАНИЕ: Изменяйте это значение только в том случае, если вы уверены в своих действиях!

```
ipaddr
├─HTTP_INCAP_CLIENT_IP ("HTTP_INCAP_CLIENT_IP (Incapsula)")
├─HTTP_CF_CONNECTING_IP ("HTTP_CF_CONNECTING_IP (Cloudflare)")
├─CF-Connecting-IP ("CF-Connecting-IP (Cloudflare)")
├─HTTP_X_FORWARDED_FOR ("HTTP_X_FORWARDED_FOR (Cloudbric)")
├─X-Forwarded-For ("X-Forwarded-For (Squid)")
├─Forwarded ("Forwarded")
├─REMOTE_ADDR ("REMOTE_ADDR (Стандарт)")
└─…Другие
```

Смотрите также:
- [NGINX Reverse Proxy](https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/)
- [Squid configuration directive forwarded_for](http://www.squid-cache.org/Doc/config/forwarded_for/)
- [Forwarded - HTTP \| MDN](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Forwarded)

##### «http_response_header_code» `[int]`
- Какое сообщение статуса HTTP должно отправлять CIDRAM при блокировке запросов?

```
http_response_header_code───[Стандарт]─[Юридический]─[Запрещенный]
├─200 (200 OK (Хорошо)): Наименее надежный, но наиболее удобный
│ для пользователя. Автоматизированные
│ запросы, скорее всего, интерпретируют
│ этот ответ как указание на то, что запрос
│ был выполнен успешно. Рекомендуется для
│ не заблокированных запросов.
├─403 (403 Forbidden (Запрещено)): Более надежен, но менее удобен в
│ использовании. Рекомендуется для
│ большинства общих обстоятельств.
├─410 (410 Gone (Удалён)): Может вызвать проблемы при разрешении
│ ложноположительный, поскольку некоторые
│ браузеры кэшируют это сообщение о
│ состоянии и не отправляют последующие
│ запросы даже после разблокировки. Может
│ быть наиболее предпочтительным в
│ некоторых контекстах, для определенных
│ видов трафика.
├─418 (418 I'm a teapot (Я чайник)): Отсылает к первоапрельской шутке (<a
│ href="https://tools.ietf.org/html/rfc2324" dir="ltr" hreflang="en-US"
│ rel="noopener noreferrer external">RFC 2324</a>). Очень
│ маловероятно, что это будет понято
│ каким-либо клиентом, ботом, браузером, или
│ кем-либо еще. Предоставляется для
│ развлечения и удобства, но обычно не
│ рекомендуется.
├─451 (451 Unavailable For Legal Reasons (Недоступно По Юридическим Причинам)): Рекомендуется при блокировке
│ преимущественно по юридическим причинам.
│ Не рекомендуется в других контекстах.
└─503 (503 Service Unavailable (Сервис Недоступен)): Самый надежный, но наименее удобный для
  пользователя. Рекомендуется при атаке
  или при работе с чрезвычайно постоянным
  нежелательным трафиком.
```

__1.__ При включении «тихого режима» будет использоваться HTTP-сообщение о состоянии, определяемое `general➡silent_mode_response_header_code` (оно имеет наивысший приоритет).

__2.__ При запрашивающий объект был заблокирован из-за превышения лимита нарушений, будет использовано HTTP-сообщение о статусе «запрещенный».

__3.__ При блокировке из-за ограничения скорости будет использоваться код 429, а при блокировке из-за конфликтов ресурсов будет использоваться сообщение о состоянии HTTP, определенное `signatures➡conflict_response` (ограничение скорости и конфликты ресурсов имеют равный приоритет в этом контексте).

__4.__ При блокировке из-за вспомогательного правила, которое устанавливает «переопределение кода статуса HTTP», будет использоваться это переопределение кода статуса HTTP.

__5.__ При блокировке по юридическим причинам (т.е., при блокировке из-за пользовательской сигнатуры, в которой используется сокращенное слово «юридический») будет использоваться HTTP-сообщение о состоянии «юридический».

__6.__ Для всех остальных заблокированных запросов будет использоваться HTTP-сообщение о состоянии «стандарт» (оно имеет самый низкий приоритет).

##### «silent_mode» `[string]`
- Должен CIDRAM молча перенаправить заблокированные попытки доступа вместо отображения страницы «доступ запрещен»? Если да, указать местоположение для перенаправления блокировал попытки доступа. Если нет, оставить эту переменную пустым.

##### «silent_mode_response_header_code» `[int]`
- Какое сообщение статуса HTTP должно отправлять CIDRAM при тихом перенаправлении заблокированных попыток доступа?

```
silent_mode_response_header_code
├─301 (301 Moved Permanently (Перемещено навсегда)): Сообщает клиенту, что перенаправление
│ является ПОСТОЯННЫМ, и что метод запроса,
│ используемый для перенаправления, МОЖЕТ
│ отличаться от метода запроса,
│ используемого для первоначального
│ запроса.
├─302 (302 Found (Найдено)): Сообщает клиенту, что перенаправление
│ является ВРЕМЕННЫМ, и что метод запроса,
│ используемый для перенаправления, МОЖЕТ
│ отличаться от метода запроса,
│ используемого для первоначального
│ запроса.
├─307 (307 Temporary Redirect (Временное перенаправление)): Сообщает клиенту, что перенаправление
│ является ВРЕМЕННЫМ, и что метод запроса,
│ используемый для перенаправления, НЕ
│ может отличаться от метода запроса,
│ используемого для первоначального
│ запроса.
└─308 (308 Permanent Redirect (Постоянное перенаправление)): Сообщает клиенту, что перенаправление
  является ПОСТОЯННЫМ, и что метод запроса,
  используемый для перенаправления, НЕ
  может отличаться от метода запроса,
  используемого для первоначального
  запроса.
```

Независимо от того, как мы инструктируем клиента, важно помнить, что в конечном счете мы не имеем никакого контроля над тем, что клиент решит сделать, и нет никакой гарантии, что клиент выполнит наши инструкции.

##### «lang» `[string]`
- Задаёт CIDRAM стандарт языка.

```
lang
├─af ("Afrikaans")
├─ar ("العربية")
├─bg ("Български")
├─bn ("বাংলা")
├─bs ("Bosanski")
├─ca ("Català")
├─cs ("Čeština")
├─de ("Deutsch")
├─en ("English (AU/GB/NZ)")
├─en-CA ("English (CA)")
├─en-US ("English (US)")
├─es ("Español")
├─fa ("فارسی")
├─fr ("Français (FR)")
├─fr-CA ("Français (CA)")
├─gl ("Galego")
├─gu ("ગુજરાતી")
├─he ("עברית")
├─hi ("हिंदी")
├─hr ("Hrvatski")
├─id ("Bahasa Indonesia")
├─it ("Italiano")
├─ja ("日本語")
├─ko ("한국어")
├─lv ("Latviešu")
├─ml ("മലയാളം")
├─mr ("मराठी")
├─ms ("Bahasa Melayu")
├─nl ("Nederlandse")
├─no ("Norsk")
├─pa ("ਪੰਜਾਬੀ")
├─pl ("Polski")
├─pt-BR ("Português (Brasil)")
├─pt-PT ("Português (Europeu)")
├─ro ("Română")
├─ru ("Русский")
├─sv ("Svenska")
├─sr ("Српски")
├─ta ("தமிழ்")
├─th ("ภาษาไทย")
├─tr ("Türkçe")
├─uk ("Українська")
├─ur ("اردو")
├─vi ("Tiếng Việt")
├─zh-Hans ("中文（简体）")
└─zh-Hant ("中文（傳統）")
```

##### «lang_override» `[bool]`
- Локализовать в соответствии с HTTP_ACCEPT_LANGUAGE, когда это возможно? True = Да [Стандарт]; False = Нет.

##### «numbers» `[string]`
- Как Вы предпочитаете номера для отображения? Выберите пример, который выглядит наиболее правильным для вас.

```
numbers
├─Arabic-1 ("١٢٣٤٥٦٧٫٨٩")
├─Arabic-2 ("١٬٢٣٤٬٥٦٧٫٨٩")
├─Arabic-3 ("۱٬۲۳۴٬۵۶۷٫۸۹")
├─Arabic-4 ("۱۲٬۳۴٬۵۶۷٫۸۹")
├─Armenian ("Ճ̅Ի̅Գ̅ՏՇԿԷ")
├─Base-12 ("4b6547.a8")
├─Base-16 ("12d687.e3")
├─Bengali-1 ("১২,৩৪,৫৬৭.৮৯")
├─Burmese-1 ("၁၂၃၄၅၆၇.၈၉")
├─China-1 ("123,4567.89")
├─Chinese-Simplified ("一百二十三万四千五百六十七点八九")
├─Chinese-Simplified-Financial ("壹佰贰拾叁萬肆仟伍佰陆拾柒点捌玖")
├─Chinese-Traditional ("一百二十三萬四千五百六十七點八九")
├─Chinese-Traditional-Financial ("壹佰貳拾叄萬肆仟伍佰陸拾柒點捌玖")
├─Fullwidth ("１２３４５６７.８９")
├─Geez ("፻፳፫፼፵፭፻፷፯")
├─Hebrew ("א׳׳ב׳קג׳יד׳ךסז")
├─India-1 ("12,34,567.89")
├─India-2 ("१२,३४,५६७.८९")
├─India-3 ("૧૨,૩૪,૫૬૭.૮૯")
├─India-4 ("੧੨,੩੪,੫੬੭.੮੯")
├─India-5 ("೧೨,೩೪,೫೬೭.೮೯")
├─India-6 ("౧౨,౩౪,౫౬౭.౮౯")
├─Japanese ("百万二十万三万四千五百六十七・八九分")
├─Javanese ("꧑꧒꧓꧔꧕꧖꧗.꧘꧙")
├─Khmer-1 ("១.២៣៤.៥៦៧,៨៩")
├─Lao-1 ("໑໒໓໔໕໖໗.໘໙")
├─Latin-1 ("1,234,567.89")
├─Latin-2 ("1 234 567.89")
├─Latin-3 ("1.234.567,89")
├─Latin-4 ("1 234 567,89")
├─Latin-5 ("1,234,567·89")
├─Mayan ("𝋧𝋮𝋦𝋨𝋧.𝋱𝋰")
├─Mongolian ("᠑᠒᠓᠔᠕᠖᠗.᠘᠙")
├─NoSep-1 ("1234567.89")
├─NoSep-2 ("1234567,89")
├─Odia ("୧୨୩୪୫୬୭.୮୯")
├─Roman ("M̅C̅C̅X̅X̅X̅I̅V̅DLXVII")
├─SDN-Dwiggins ("4E6,547;X8")
├─SDN-Pitman ("4↋6,547;↊8")
├─Tamil ("௲௲௨௱௲௩௰௲௪௲௫௱௬௰௭")
├─Thai-1 ("๑,๒๓๔,๕๖๗.๘๙")
├─Thai-2 ("๑๒๓๔๕๖๗.๘๙")
└─Tibetan ("༡༢༣༤༥༦༧.༨༩")
```

##### «emailaddr» `[string]`
- Если хотите, можете предоставить адрес электронной почты здесь чтобы дать пользователям, когда они заблокированы, для их использования в качестве точки контакта за поддержку и/или помощь ибо в случае их блокирования по ошибке. ПРЕДУПРЕЖДЕНИЕ: Любой адрес электронной почты Вы предоставляете здесь наверняка будет найдены по спамботами и скребки во время используется здесь, и так, это настоятельно рекомендуется, если Вы решите добавить адрес электронной почты здесь, что Вы убедитесь что адрес электронной почты что Вы предоставляете здесь одноразовый адрес и/или адрес который Вы не против чтобы быть спамом (другими словами, Вы вероятно не хотите использовать ваши основные личные электронной почты или первичные бизнес электронной почты).

##### «emailaddr_display_style» `[string]`
- Как бы вы предпочли отображать адрес электронной почты пользователям?

```
emailaddr_display_style
├─default ("Ссылки кликабельны")
└─noclick ("Текст не кликабельны")
```

##### «default_dns» `[string]`
- Список DNS-серверов, чтобы использовать для имен хостов поиска. ВНИМАНИЕ: Изменяйте это значение только в том случае, если вы уверены в своих действиях!

__FAQ.__ *<a href="https://github.com/CIDRAM/Docs/blob/master/readme.ru.md#что-я-могу-использовать-для-default_dns" hreflang="ru-RU">Что я могу использовать для «default_dns»?</a>*

##### «default_algo» `[string]`
- Определяет, какой алгоритм использовать для всех будущих паролей и сеансов.

```
default_algo
├─PASSWORD_DEFAULT ("PASSWORD_DEFAULT")
├─PASSWORD_BCRYPT ("PASSWORD_BCRYPT")
├─PASSWORD_ARGON2I ("PASSWORD_ARGON2I")
└─PASSWORD_ARGON2ID ("PASSWORD_ARGON2ID (PHP >= 7.3.0)")
```

##### «statistics» `[string]`
- Контролирует, какую статистическую информацию отслеживать.

```
statistics───[IPv4]─[IPv6]─[Другие]
├─Blocked ("Запросы блокированный")
├─Banned ("Запросы запрещенный")
├─Passed ("Запросы прошли")
├─ReportOK ("Запросы, сообщаются внешним API – ОК")
└─ReportFailed ("Запросы, сообщаются внешним API – Не удалось")
```

Примечание: Статистику отслеживания для вспомогательных правил можно контролировать на странице вспомогательных правил.

##### «statistics_captchas» `[string]`
- Контролирует, какую статистическую информацию отслеживать для CAPTCHA.

```
statistics_captchas───[Не удалось]─[Удалось]─[Подано]
├─HCaptcha ("hCaptcha")
├─FriendlyCaptcha ("Friendly Captcha")
└─CloudflareTurnstile ("Cloudflare Turnstile")
```

Примечание: Статистику отслеживания для вспомогательных правил можно контролировать на странице вспомогательных правил.

##### «force_hostname_lookup» `[bool]`
- Поиск имен хостов для всех запросов? True = Да; False = Нет [Стандарт]. Поиск имен хостов обычно выполняется по принципу «по мере необходимости», но может быть принудительно для всех запросов. Это может быть полезно в качестве средства предоставления более подробной информации в логфайлах, но может также иметь слегка отрицательный эффект на производительность.

##### «allow_gethostbyaddr_lookup» `[bool]`
- Разрешить поиск gethostbyaddr, когда UDP недоступен? True = Да [Стандарт]; False = Нет.

Примечание: Поиск IPv6 может работать некорректно в некоторых 32-разрядных системах.

##### «disabled_channels» `[string]`
- Это можно использовать для предотвращения использования CIDRAM определенных каналов при отправке запросов (например, при обновлении, при извлечении метаданных компонента, и т.д.).

```
disabled_channels
├─GitHub ("<span class="origin bgHRdBl">US</span> GitHub")
├─BitBucket ("<span class="origin bgHRdBl">US</span> BitBucket")
├─Codeberg ("<span class="origin bgVBkRd fgYlw">DE</span> Codeberg")
└─GoogleDNS ("<span class="origin bgHRdBl">US</span> GoogleDNS")
```

##### «request_proxy» `[string]`
- Если хотите чтобы исходящие запросы отправлялись через прокси-сервер, укажите этот прокси-сервер здесь. Если нет, оставьте это поле пустым.

##### «request_proxyauth» `[string]`
- Если исходящие запросы отправляются через прокси-сервер и этот прокси-сервер требует имя пользователя и пароль, укажите это имя пользователя и пароль здесь (например, `user:pass`). Если нет, оставьте это поле пустым.

##### «default_timeout» `[int]`
- Тайм-аут по умолчанию для внешних запросов? Стандарт = 12 секунд.

##### «sensitive» `[string]`
- Список путей, которые следует рассматривать как конфиденциальные страницы. При необходимости каждый указанный путь будет сверяться с реконструированным URI. Путь, который начинается с косой черты, будет рассматриваться как литерал и сопоставляться с компонентом пути запроса и далее. В качестве альтернативы, путь, который начинается с символа не буквенно-цифрового, и заканчивается тем же символом (или тем же символом плюс необязательный флаг «i»), будет рассматриваться как регулярное выражение. Любой другой путь будет рассматриваться как литерал и может соответствовать любой части URI. Путь, рассматриваемый как конфиденциальная страница, может повлиять на поведение некоторых модулей, но не имеет никакого эффекта в остальном.

##### «email_notification_address» `[string]`
- Если решили получать уведомления от CIDRAM по электронной почте, например, когда срабатывают определенные вспомогательные правила, здесь вы можете указать адрес получателя этих уведомлений.

##### «email_notification_name» `[string]`
- Если решили получать уведомления от CIDRAM по электронной почте, например, когда срабатывают определенные вспомогательные правила, здесь вы можете указать имя получателя этих уведомлений.

##### «email_notification_when» `[string]`
- Когда отправлять уведомления после их создания.

```
email_notification_when
├─Immediately ("Сразу.")
├─After24Hours ("Через 24 часа, объединенные вместе (или при ручном запуске, например, через cron).")
└─ManuallyOnly ("Только при ручном запуске (например, через cron).")
```

#### «components» (Категория)
Конфигурация для активации и деактивации компонентов, используемых CIDRAM. Обычно заполняется страницей обновлений, но также может управляться отсюда для более точного контроля и для пользовательских компонентов, не распознаваемых страницей обновлений.

##### «ipv4» `[string]`
- Файлы сигнатуры IPv4.

##### «ipv6» `[string]`
- Файлы сигнатуры IPv6.

##### «modules» `[string]`
- Модули.

##### «imports» `[string]`
- Импортов. Обычно используется для передачи информации о конфигурации компонента в CIDRAM.

##### «events» `[string]`
- Обработчики событий. Обычно используется для изменения внутреннего поведения CIDRAM или для предоставления дополнительных функционал.

#### «logging» (Категория)
Конфигурация связанная с журнала (что применимо к другим категориям исключено).

##### «standard_log» `[string]`
- Файл разборчивыми для людей, для регистрации всех заблокированных попыток несанкционированного доступа. Задайте имя файлу, или оставьте пустым чтобы деактивировать опцию.

Полезный совет: Вы можете прикрепить информацию о дате и времени к именам файлов журналов, используя заполнители формата времени. Доступные заполнители формата времени отображаются на <a onclick="javascript:toggleconfigNav('generalRow','generalShowLink')" href="#config_general_time_format">`general➡time_format`</a>.

##### «apache_style_log» `[string]`
- Apache-стиль файл для регистрации всех заблокированных попыток несанкционированного доступа. Задайте имя файлу, или оставьте пустым чтобы деактивировать опцию.

Полезный совет: Вы можете прикрепить информацию о дате и времени к именам файлов журналов, используя заполнители формата времени. Доступные заполнители формата времени отображаются на <a onclick="javascript:toggleconfigNav('generalRow','generalShowLink')" href="#config_general_time_format">`general➡time_format`</a>.

##### «serialised_log» `[string]`
- Сериализованная файл для регистрации всех заблокированных попыток несанкционированного доступа. Задайте имя файлу, или оставьте пустым чтобы деактивировать опцию.

Полезный совет: Вы можете прикрепить информацию о дате и времени к именам файлов журналов, используя заполнители формата времени. Доступные заполнители формата времени отображаются на <a onclick="javascript:toggleconfigNav('generalRow','generalShowLink')" href="#config_general_time_format">`general➡time_format`</a>.

##### «error_log» `[string]`
- Файл для регистрации обнаруженных нефатальных ошибок. Задайте имя файлу, или оставьте пустым чтобы деактивировать опцию.

Полезный совет: Вы можете прикрепить информацию о дате и времени к именам файлов журналов, используя заполнители формата времени. Доступные заполнители формата времени отображаются на <a onclick="javascript:toggleconfigNav('generalRow','generalShowLink')" href="#config_general_time_format">`general➡time_format`</a>.

##### «outbound_request_log» `[string]`
- Файл для регистрации результатов любых исходящих запросов. Задайте имя файлу, или оставьте пустым чтобы деактивировать опцию.

Полезный совет: Вы можете прикрепить информацию о дате и времени к именам файлов журналов, используя заполнители формата времени. Доступные заполнители формата времени отображаются на <a onclick="javascript:toggleconfigNav('generalRow','generalShowLink')" href="#config_general_time_format">`general➡time_format`</a>.

##### «report_log» `[string]`
- Файл для регистрации любых отчетов, отправленных во внешние API. Задайте имя файлу, или оставьте пустым чтобы деактивировать опцию.

Полезный совет: Вы можете прикрепить информацию о дате и времени к именам файлов журналов, используя заполнители формата времени. Доступные заполнители формата времени отображаются на <a onclick="javascript:toggleconfigNav('generalRow','generalShowLink')" href="#config_general_time_format">`general➡time_format`</a>.

##### «truncate» `[string]`
- Усекать лог-файлы, когда они достигают определенного размера? Значение это максимальный размер в Б/КБ/МБ/ГБ/ТБ, до которого файл журнала может увеличиться до усечения. Стандартное значение 0КБ отключает усечение (лог-файлы может расти неограниченно). Примечание: относится к отдельным лог-файлы! Размер файлов журнала не учитывается совместно.

##### «log_rotation_limit» `[int]`
- Лог вращения ограничивает количество журнальных лог-файлов, которые должны существовать в любой момент времени. Когда создаются новые лог-файлы, если общее количество лог-файлов превышает указанный предел, указанное действие будет выполнено. Здесь Вы можете указать желаемый лимит. Значение 0 отключит вращение лог.

##### «log_rotation_action» `[string]`
- Лог вращения ограничивает количество журнальных лог-файлов, которые должны существовать в любой момент времени. Когда создаются новые лог-файлы, если общее количество лог-файлов превышает указанный предел, указанное действие будет выполнено. Здесь Вы можете указать желаемое действие.

```
log_rotation_action
├─Delete ("Удалите самые старые лог-файлы, пока лимит больше не будет превышен.")
└─Archive ("Сначала архивируйте, а затем удалите самые старые лог-файлы, пока лимит больше не будет превышен.")
```

##### «log_banned_ips» `[bool]`
- Включить заблокированные запросы от запрещенных IP-адресов в лог-файлы? True = Да [Стандарт]; False = Нет.

##### «log_sanitisation» `[bool]`
- При использовании фронтенд страницы журналов для просмотра данных журнала, CIDRAM подготавливает данные журнала перед их отображением таким образом, чтобы защитить пользователей от атак XSS. Однако эти меры обычно не происходят, когда данные впервые регистрируются. Это необходимо для обеспечения точного сохранения данных журнала, чтобы помочь любому эвристическому анализу, который может потребоваться в будущем. Однако в случае, если пользователь пытается прочитать данные журнала, используя внешние инструменты, которые не подготавливают данные журнала аналогичным образом для защиты пользователей, пользователь может подвергаться атакам XSS. При необходимости Вы можете изменить поведение по умолчанию с помощью этой директивы конфигурации. True = Очистка данных при записи в журнал (данные сохраняются менее точно, но риск XSS ниже). False = Не очищайте данные при записи в журнал (данные сохраняются более точно, но риск XSS выше) [Стандарт].

#### «frontend» (Категория)
Конфигурация для фронтенда.

##### «frontend_log» `[string]`
- Файл для запись всех попыток входа в фронтенд. Задайте имя файлу, или оставьте пустым чтобы деактивировать опцию.

Полезный совет: Вы можете прикрепить информацию о дате и времени к именам файлов журналов, используя заполнители формата времени. Доступные заполнители формата времени отображаются на <a onclick="javascript:toggleconfigNav('generalRow','generalShowLink')" href="#config_general_time_format">`general➡time_format`</a>.

##### «signatures_update_event_log» `[string]`
- Файл для регистрации при обновлении сигнатурей через фронтенд. Задайте имя файлу, или оставьте пустым чтобы деактивировать опцию.

Полезный совет: Вы можете прикрепить информацию о дате и времени к именам файлов журналов, используя заполнители формата времени. Доступные заполнители формата времени отображаются на <a onclick="javascript:toggleconfigNav('generalRow','generalShowLink')" href="#config_general_time_format">`general➡time_format`</a>.

##### «max_login_attempts» `[int]`
- Максимальное количество попыток входа в систему фронтенда. Стандарт = 5.

##### «theme» `[string]`
- Тема, которая будет использоваться для фронтенда.

```
theme
├─default ("Default")
├─bluemetal ("Blue Metal")
├─fullmoon ("Full Moon")
├─moss ("Moss")
├─primer ("Primer")
├─primerdark ("Primer Dark")
├─rbi ("Red-Blue Inverted")
├─slate ("Slate")
└─…Другие
```

##### «theme_mode» `[string]`
- Режим для тема, которая будет использоваться для фронтенда.

```
theme_mode
├─normal ("Нормальный")
└─inverted ("Перевернутый")
```

##### «magnification» `[float]`
- Увеличение шрифта. Стандарт = 1.

##### «custom_header» `[string]`
- Вставляется как HTML в начале всех фронтенд страниц. Это может быть полезно, если хотите включить логотип веб-сайта, персонализированный заголовок, скрипты, или подобное на всех таких страницах.

##### «custom_footer» `[string]`
- Вставляется как HTML в конце всех фронтенд страниц. Это может быть полезно, если хотите включить юридическое уведомление, контактную ссылку, деловую информацию, или подобное на всех таких страницах.

##### «remotes» `[string]`
- Список адресов, используемых системой обновлений для получения метаданных компонентов. Это может потребоваться скорректировать при обновлении до новой основной версии, или при приобретении нового источника обновлений, но в обычных обстоятельствах его следует оставить в покое.

##### «enable_two_factor» `[bool]`
- Эта директива включает/отключает использование 2FA для фронтенд счетов.

#### «signatures» (Категория)
Конфигурация для сигнатурей, файлов сигнатурей, модулей и т.д.

##### «shorthand» `[string]`
- Управляет что делать с запросом, когда есть положительное совпадение с сигнатурю, в которой используются заданные сокращенные слова.

```
shorthand───[Заблокируйте это.]─[Профилируйте это.]─[При блокировке, подавить шаблон вывода.]
├─Attacks ("Атаки")
├─Bogon ("⁰ Bogon/Марсианин IP")
├─Cloud ("Облачный сервис")
├─Generic ("Общий")
├─Legal ("¹ Юридический")
├─Malware ("Вредоносные программы")
├─Proxy ("² Прокси")
├─Spam ("Спам")
├─Banned ("³ Запрещенный")
├─BadIP ("³ Неверный IP")
├─RL ("³ Скорость ограничена")
├─Conflict ("³ Конфликт")
└─Other ("⁴ Другие")
```

__0.__ Если вашему веб-сайту требуется доступ через локальную сеть или локальный хост, не блокируйте это. В противном случае вы можете заблокировать это.

__1.__ Стандартные файлы сигнатур не используют это, но оно по-прежнему поддерживается на случай, если оно может оказаться полезным для некоторых пользователей.

__2.__ Если ваши пользователи могут получить доступ к вашему сайту через прокси, не блокируйте это. В противном случае вы можете заблокировать это.

__3.__ Прямое использование в сигнатуры не поддерживается, но в определенных обстоятельствах его можно вызвать другими способами.

__4.__ Относится к случаям, когда сокращенные слова вообще не используются или не распознаются CIDRAM.

__Один на сигнатур.__ Сигнатур может вызывать несколько профилей, но может использовать только одно сокращенное слово. Возможно, подойдет несколько сокращенных слов, но поскольку можно использовать только одно, мы стремимся всегда использовать только наиболее подходящие.

__Приоритет.__ Выбранная опция всегда имеет приоритет над невыбранной опцией. Например, если используется несколько сокращенных слов, но только одно из них установлено как заблокированное, запрос все равно будет заблокирован.

__Человеческие конечные точки и облачные сервисы.__ Облачная служба может относиться к провайдерам веб-хостинга, фермам серверов, центрам обработки данных, или ряду других вещей. Конечная точка человека относится к средствам, с помощью которых человек получает доступ к интернету, например, через интернет-провайдера. Сеть обычно предоставляет только одно или другое, но иногда может предоставлять оба. Мы стремимся никогда не идентифицировать потенциальные конечные точки человека как облачные сервисы. Следовательно, облачная служба может быть идентифицирована как нечто другое, если ее диапазон используется известными конечными точками человека. Точно так же мы стремимся всегда идентифицировать облачные сервисы, диапазоны которых не используются никакими известными конечными точками человека, как облачные сервисы. Следовательно, запрос, явно идентифицированный как облачная служба, вероятно не имеет общего диапазона ни с какими известными конечными точками человека. Точно так же запрос, явно идентифицированный атаками или спам риском, вероятно действительно разделяет их. Тем не менее, интернет всегда в движении, цели сетей со временем меняются, а диапазоны всегда покупаются или продаются, поэтому оставайтесь сознательными и бдительными в отношении ложноположительный.

##### «default_tracktime» `[string]`
- Время в течение которого следует отслеживать IP-адреса. Стандарт = 7d0°0′0″ (1 неделя).

##### «infraction_limit» `[int]`
- Максимальное число нарушений IP-разрешено брать на себя, прежде чем она запрещена отслеживание IP. Стандарт = 10.

##### «tracking_override» `[bool]`
- Разрешить модулям переопределять параметры отслеживания? True = Да [Стандарт]; False = Нет.

##### «conflict_response» `[int]`
- Если одновременно происходит слишком много попыток доступа к одним и тем же ресурсам (например, одновременные запросы к нескольким процессам PHP на одном компьютере для одних и тех же ресурсов), некоторые из этих попыток могут завершиться неудачей. В редком и маловероятном случае, если это затронет файлы сигнатурей или модули, CIDRAM может быть лишен возможности принять эффективное решение по запросу. Если это произойдет, следует ли блокировать запрос, и какое сообщение о состоянии HTTP должен отправить CIDRAM?

```
conflict_response
├─0 (Не блокируйте запрос.): Если вы предпочитаете, чтобы запросы
│ блокировались только в том случае если вы
│ уверены что они вредоносные, или хотите
│ проявить осторожность в отношении
│ ложноположительный (за счет
│ нежелательного трафика который иногда
│ проходит), выберите это. Если вы
│ предпочитаете, чтобы запросы
│ блокировались если вы не уверены в их
│ безвредности, или хотите проявить
│ бдительность (пусть и ценой случайных
│ ложноположительный), выберите один из
│ других доступных вариантов.
├─409 (409 Конфликт): Рекомендуется при конфликтах ресурсов
│ (например, конфликтах слияния, конфликтах
│ доступа к файлам, и т.д.). Не рекомендуется
│ в других контекстах.
└─429 (429 Too Many Requests (Слишком много запросов)): Рекомендуется для ограничения скорости,
  при борьбе с DDoS-атаками, и для
  предотвращения флуда. Не рекомендуется в
  других контекстах.
```

#### «verification» (Категория)
Конфигурация для проверки того, откуда исходят запросы.

##### «search_engines» `[string]`
- Элементы управления для проверки запросов от поисковых систем.

```
search_engines───[Попробуй проверить?]─[Блокировать отрицательные?]─[Блокировать непроверенные запросы?]─[Разрешить байпасы отдельных нарушений?]─[Перестать отслеживать положительные?]
├─Amazonbot ("Amazonbot")
├─Applebot ("Applebot")
├─Baidu ("* Baiduspider/百度")
├─Bingbot ("* Bingbot")
├─DuckDuckBot ("* DuckDuckBot")
├─Googlebot ("* Googlebot")
├─MojeekBot ("MojeekBot")
├─PetalBot ("* PetalBot")
├─Qwantify ("Qwantify/Bleriot")
├─SeznamBot ("SeznamBot")
├─Sogou ("* Sogou/搜狗")
├─Yahoo ("Yahoo/Slurp")
├─Yandex ("* Yandex/Яндекс")
└─YoudaoBot ("YoudaoBot")
```

__Что такое «положительные» и «отрицательные»?__ При проверке идентификации, представленной запросом, успешный результат может быть описан как «положительный» или «отрицательный». Когда представленная идентификация подтверждается как истинная идентификация, она будет описана как «положительная». Когда подтвердится, что представленное удостоверение идентификации было сфальсифицировано, оно будет описано как «отрицательное». Однако неудачный результат (например, сбой проверки, или невозможность определить достоверность представленной идентификации) не будет описываться как «положительный» или «отрицательный». Вместо этого неудачный результат будет описан просто как непроверенный. Когда не предпринимается никаких попыток проверить идентификацию, представленную в запросе, запрос также будет описан как непроверенный. Термины имеют смысл только в том контексте, когда идентификация, представленная запросом, распознается и, следовательно, когда возможна проверка. В случаях, когда представленное удостоверение идентификации не соответствует параметрам, указанным выше, или если удостоверение идентификации не представлено, указанные выше параметры становятся неактуальными.

__Что такое «байпасы отдельных нарушений»?__ В некоторых случаях положительно-проверенный запрос может быть заблокирован из-за файлов сигнатуры, модулей, или других условий запроса, и байпасы могут быть необходимы, чтобы избежать ложноположительный. В случае, когда байпас предназначен для устранения ровно одного нарушения, не больше и не меньше, такой байпас можно описать как «обход с отдельных нарушений».

* Эта опция имеет соответствующий байпас под `bypasses➡used`. Рекомендуется убедиться, что флажок для соответствующего байпаса отмечен так же, как флажок для попытки проверки этой опции.

##### «social_media» `[string]`
- Элементы управления для проверки запросов от платформ социальных сетей.

```
social_media───[Попробуй проверить?]─[Блокировать отрицательные?]─[Блокировать непроверенные запросы?]─[Разрешить байпасы отдельных нарушений?]─[Перестать отслеживать положительные?]
├─Embedly ("* Embedly")
├─Facebook ("** Facebook")
├─Pinterest ("* Pinterest")
├─Snapchat ("* Snapchat")
└─Twitterbot ("*!! Twitterbot")
```

__Что такое «положительные» и «отрицательные»?__ При проверке идентификации, представленной запросом, успешный результат может быть описан как «положительный» или «отрицательный». Когда представленная идентификация подтверждается как истинная идентификация, она будет описана как «положительная». Когда подтвердится, что представленное удостоверение идентификации было сфальсифицировано, оно будет описано как «отрицательное». Однако неудачный результат (например, сбой проверки, или невозможность определить достоверность представленной идентификации) не будет описываться как «положительный» или «отрицательный». Вместо этого неудачный результат будет описан просто как непроверенный. Когда не предпринимается никаких попыток проверить идентификацию, представленную в запросе, запрос также будет описан как непроверенный. Термины имеют смысл только в том контексте, когда идентификация, представленная запросом, распознается и, следовательно, когда возможна проверка. В случаях, когда представленное удостоверение идентификации не соответствует параметрам, указанным выше, или если удостоверение идентификации не представлено, указанные выше параметры становятся неактуальными.

__Что такое «байпасы отдельных нарушений»?__ В некоторых случаях положительно-проверенный запрос может быть заблокирован из-за файлов сигнатуры, модулей, или других условий запроса, и байпасы могут быть необходимы, чтобы избежать ложноположительный. В случае, когда байпас предназначен для устранения ровно одного нарушения, не больше и не меньше, такой байпас можно описать как «обход с отдельных нарушений».

* Эта опция имеет соответствующий байпас под `bypasses➡used`. Рекомендуется убедиться, что флажок для соответствующего байпаса отмечен так же, как флажок для попытки проверки этой опции.

** Требуется функциональность поиска ASN (например, через модуль IP-API или BGPView).

*!! Высокая вероятность ложноположительный из-за iMessage.

##### «other» `[string]`
- Элементы управления для проверки других типов запросов, где это возможно.

```
other───[Попробуй проверить?]─[Блокировать отрицательные?]─[Блокировать непроверенные запросы?]─[Разрешить байпасы отдельных нарушений?]─[Перестать отслеживать положительные?]
├─AdSense ("AdSense")
├─AmazonAdBot ("* AmazonAdBot")
├─ChatGPT-User ("!! ChatGPT-User")
├─GPTBot ("!! GPTBot")
├─OAI-SearchBot ("!! OAI-SearchBot")
└─UptimeRobot ("UptimeRobot")
```

__Что такое «положительные» и «отрицательные»?__ При проверке идентификации, представленной запросом, успешный результат может быть описан как «положительный» или «отрицательный». Когда представленная идентификация подтверждается как истинная идентификация, она будет описана как «положительная». Когда подтвердится, что представленное удостоверение идентификации было сфальсифицировано, оно будет описано как «отрицательное». Однако неудачный результат (например, сбой проверки, или невозможность определить достоверность представленной идентификации) не будет описываться как «положительный» или «отрицательный». Вместо этого неудачный результат будет описан просто как непроверенный. Когда не предпринимается никаких попыток проверить идентификацию, представленную в запросе, запрос также будет описан как непроверенный. Термины имеют смысл только в том контексте, когда идентификация, представленная запросом, распознается и, следовательно, когда возможна проверка. В случаях, когда представленное удостоверение идентификации не соответствует параметрам, указанным выше, или если удостоверение идентификации не представлено, указанные выше параметры становятся неактуальными.

__Что такое «байпасы отдельных нарушений»?__ В некоторых случаях положительно-проверенный запрос может быть заблокирован из-за файлов сигнатуры, модулей, или других условий запроса, и байпасы могут быть необходимы, чтобы избежать ложноположительный. В случае, когда байпас предназначен для устранения ровно одного нарушения, не больше и не меньше, такой байпас можно описать как «обход с отдельных нарушений».

* Эта опция имеет соответствующий байпас под `bypasses➡used`. Рекомендуется убедиться, что флажок для соответствующего байпаса отмечен так же, как флажок для попытки проверки этой опции.

!! Большинство пользователей, вероятно, захотят чтобы это было заблокировано, независимо от того, является ли оно реальным или фальсифицированным. Этого можно добиться, не выбирая «попробуй проверить» и выбирая «блокировать непроверенные запросы». Однако, поскольку некоторые пользователи могут захотеть иметь возможность проверять такие запросы (чтобы блокировать отрицательные и разрешать положительные), вместо блокировки таких запросов через модули, здесь предоставляются варианты обработки таких запросов.

##### «adjust» `[string]`
- Элементы управления для настройки других функциональность в контексте проверки.

```
adjust───[Подавить hCaptcha]─[Подавить Friendly Captcha]─[Подавить Cloudflare Turnstile]
├─Negatives ("Заблокированные негативы")
└─NonVerified ("Заблокировано непроверено")
```

#### «captcha» (Категория)
Конфигурация для CAPTCHA (предоставляет людям возможность восстановить доступ при блокировании).

##### «usemode» `[int]`
- Когда следует предлагать CAPTCHA? Здесь вы можете указать предпочтительное поведение для каждого поддерживаемого поставщика.

```
usemode───[hCaptcha]─[Friendly Captcha]─[Cloudflare Turnstile]
├─0 (Никогда.)
├─1 (Только когда блокировке, в пределах лимита сигнатурей, и не забанен.)
├─2 (Только когда заблокирован, специально помечен для использования, в пределах лимита сигнатурей, и не забанен.)
├─3 (Только когда в пределах лимита сигнатурей, и не забанен (вне зависимости от того, заблокирован ли).)
├─4 (Только когда не заблокирован.)
├─5 (Только когда не заблокирован, или специально помечен для использования, в пределах лимита сигнатурей, и не забанен.)
└─6 (Только когда не заблокирован, при запросах конфиденциальных страниц.)
```

Примечание: Запросы из белого списка или проверенные и неблокированные запросы никогда не требуют выполнения CAPTCHA.

Также обратите внимание: CAPTCHA может обеспечить полезный дополнительный уровень защиты от ботов и различных вредоносных автоматических запросов, но не обеспечивает никакой защиты от вредоносных люди.

Запросы можно «пометить для использования» с помощью вспомогательных правил.

Определение того, считается ли запрос «конфиденциальным», осуществляется с помощью <a onclick="javascript:toggleconfigNav('generalRow','generalShowLink')" href="#config_general_sensitive">`general➡sensitive`</a>.

«Предел сигнатуры» определяется с помощью <a onclick="javascript:toggleconfigNav('captchaRow','captchaShowLink')" href="#config_captcha_signature_limit">`captcha➡signature_limit`</a>.

##### «nonblocked_status_code» `[int]`
- Какой код статуса следует использовать при отображении CAPTCHA для неблокированных запросов?

```
nonblocked_status_code───[hCaptcha]─[Friendly Captcha]─[Cloudflare Turnstile]
├─200 (200 OK (Хорошо)): Наименее надежный, но наиболее удобный
│ для пользователя. Автоматизированные
│ запросы, скорее всего, интерпретируют
│ этот ответ как указание на то, что запрос
│ был выполнен успешно. Рекомендуется для
│ не заблокированных запросов.
├─403 (403 Forbidden (Запрещено)): Более надежен, но менее удобен в
│ использовании. Рекомендуется для
│ большинства общих обстоятельств.
├─418 (418 I'm a teapot (Я чайник)): Отсылает к первоапрельской шутке (<a
│ href="https://tools.ietf.org/html/rfc2324" dir="ltr" hreflang="en-US"
│ rel="noopener noreferrer external">RFC 2324</a>). Очень
│ маловероятно, что это будет понято
│ каким-либо клиентом, ботом, браузером, или
│ кем-либо еще. Предоставляется для
│ развлечения и удобства, но обычно не
│ рекомендуется.
├─429 (429 Too Many Requests (Слишком много запросов)): Рекомендуется для ограничения скорости,
│ при борьбе с DDoS-атаками, и для
│ предотвращения флуда. Не рекомендуется в
│ других контекстах.
└─451 (451 Unavailable For Legal Reasons (Недоступно По Юридическим Причинам)): Рекомендуется при блокировке
  преимущественно по юридическим причинам.
  Не рекомендуется в других контекстах.
```

##### «api» `[string]`
- Какой API использовать?

```
api───[hCaptcha]─[Friendly Captcha]─[Cloudflare Turnstile]
├─v0 ("v0")
├─v1 ("v1")
├─Invisible ("v1 (Невидимый)")
└─v2 ("v2")
```

##### «messages» `[string]`
- Сообщения, которые будут отображаться вместе с CAPTCHA.

```
messages───[hCaptcha]─[Friendly Captcha]─[Cloudflare Turnstile]
├─cookie_warning ("Показать предупреждение о файлах куки?): В зависимости от законов о
│ конфиденциальности вашей страны или
│ штата (например, GDPR/DSGVO в ЕС, LGPD в Бразилии,
│ и т.д), это может быть обязательным по
│ закону."
└─api_message ("Показать сообщение API?): Инструкции пользователю по заполнению
  CAPTCHA, соответствующие используемому API."
```

##### «lockto» `[string]`
- К чему привязывать CAPTCHA.

```
lockto───[hCaptcha]─[Friendly Captcha]─[Cloudflare Turnstile]
├─ip ("Привязать CAPTCHA к IP-адресу пользователя прошедшего CAPTCHA, но не к самому пользователю.): Файлы cookie НЕ используются для
│ идентификации пользователей. Если доступ
│ восстановлен в результате успешного
│ прохождения CAPTCHA, он применяется ко всем
│ кто подключается с того же IP-адреса."
├─user ("Привязать CAPTCHA к пользователю прошедшему CAPTCHA, но не к его IP-адресу.): Файлы cookie используются для идентификации
│ пользователей. Если доступ восстановлен
│ в результате успешного прохождения CAPTCHA,
│ он применяется только к пользователю
│ выполнившему CAPTCHA, и будет сохраняться до
│ тех пор, пока его cookie-файл остается
│ действительным, даже если его IP-адрес
│ изменится."
└─both ("Привязать CAPTCHA к пользователю прошедшему CAPTCHA, а также к его IP-адресу.): Файлы cookie используются для идентификации
  пользователей. Если доступ восстановлен
  в результате успешного прохождения CAPTCHA,
  он применяется только к пользователю
  выполнившему CAPTCHA, и не сохранится если
  его IP-адрес изменится."
```

##### «hcaptcha_sitekey» `[string]`
- Если хотите использовать hCaptcha с CIDRAM, вам потребуется ввести здесь значение. Если нет, можете проигнорировать его.

Это значение можно найти на панели управления вашей службы CAPTCHA.

Смотрите также:
- [HCaptcha Dashboard](https://dashboard.hcaptcha.com/overview)

##### «hcaptcha_secret» `[string]`
- Если хотите использовать hCaptcha с CIDRAM, вам потребуется ввести здесь значение. Если нет, можете проигнорировать его.

Это значение можно найти на панели управления вашей службы CAPTCHA.

Смотрите также:
- [HCaptcha Dashboard](https://dashboard.hcaptcha.com/overview)

##### «friendly_sitekey» `[string]`
- Если хотите использовать Friendly Captcha с CIDRAM, вам потребуется ввести здесь значение. Если нет, можете проигнорировать его.

Это значение можно найти на панели управления вашей службы CAPTCHA.

Смотрите также:
- [Friendly Captcha Dashboard](https://app.friendlycaptcha.eu/dashboard)

##### «friendly_apikey» `[string]`
- Если хотите использовать Friendly Captcha с CIDRAM, вам потребуется ввести здесь значение. Если нет, можете проигнорировать его.

Это значение можно найти на панели управления вашей службы CAPTCHA.

Смотрите также:
- [Friendly Captcha Dashboard](https://app.friendlycaptcha.eu/dashboard)

##### «turnstile_sitekey» `[string]`
- Если хотите использовать Cloudflare Turnstile с CIDRAM, вам потребуется ввести здесь значение. Если нет, можете проигнорировать его.

Это значение можно найти на панели управления вашей службы CAPTCHA.

Смотрите также:
- [Cloudflare Dashboard](https://dash.cloudflare.com/)

##### «turnstile_secret» `[string]`
- Если хотите использовать Cloudflare Turnstile с CIDRAM, вам потребуется ввести здесь значение. Если нет, можете проигнорировать его.

Это значение можно найти на панели управления вашей службы CAPTCHA.

Смотрите также:
- [Cloudflare Dashboard](https://dash.cloudflare.com/)

##### «expiry» `[float]`
- Количество часов, чтобы вспомнить инстанция CAPTCHA. Стандарт = 720 (1 месяц).

##### «signature_limit» `[int]`
- Максимально допустимое количество сигнатурей перед снятием CAPTCHA. Стандарт = 1.

##### «log» `[string]`
- Записывать все попытки CAPTCHA? Если да, указать имя использовать для файла журнала. Если нет, оставьте эту переменную пустым.

Полезный совет: Вы можете прикрепить информацию о дате и времени к именам файлов журналов, используя заполнители формата времени. Доступные заполнители формата времени отображаются на <a onclick="javascript:toggleconfigNav('generalRow','generalShowLink')" href="#config_general_time_format">`general➡time_format`</a>.

#### «legal» (Категория)
Конфигурация для юридических требований.

##### «pseudonymise_ip_addresses» `[bool]`
- Псевдонимный IP-адреса при записи файлов журнала? True = Да [Стандарт]; False = Нет.

Смотрите также:
- [9.3.5 IP ADDRESS PSEUDONYMISATION](https://github.com/CIDRAM/Docs/blob/master/readme.en.md#935-ip-address-pseudonymisation)

##### «privacy_policy» `[string]`
- Адрес соответствующей политики конфиденциальности, отображаемый в нижнем колонтитуле любых сгенерированных страниц. Укажите URL-адрес, или оставьте пустым для отключения.

#### «template_data» (Категория)
Конфигурация для шаблонов и темов.

##### «theme» `[string]`
- Тема, которая будет использоваться для событий блокировки и запросов CAPTCHA.

```
theme
├─default ("Default")
├─bluemetal ("Blue Metal")
├─fullmoon ("Full Moon")
├─moss ("Moss")
├─primer ("Primer")
├─primerdark ("Primer Dark")
├─rbi ("Red-Blue Inverted")
├─slate ("Slate")
└─…Другие
```

##### «theme_mode» `[string]`
- Режим для тема, которая будет использоваться для событий блокировки и запросов CAPTCHA.

```
theme_mode
├─normal ("Нормальный")
└─inverted ("Перевернутый")
```

##### «magnification» `[float]`
- Увеличение шрифта. Стандарт = 1.

##### «css_url» `[string]`
- URL файла CSS для пользовательских тем.

##### «block_event_title» `[string]`
- Заголовок страницы для отображения событий блокировки.

```
block_event_title
├─CIDRAM ("CIDRAM")
├─denied ("Доступ запрещен!")
└─…Другие
```

##### «captcha_title» `[string]`
- Заголовок страницы для отображения запросов CAPTCHA.

```
captcha_title
├─CIDRAM ("CIDRAM")
└─…Другие
```

##### «custom_header» `[string]`
- Вставляется как HTML в начало всех страниц «доступ запрещен». Это может быть полезно, если хотите включить логотип веб-сайта, персонализированный заголовок, скрипты, или подобное на всех таких страницах.

##### «custom_footer» `[string]`
- Вставляется как HTML в конце всех страниц «доступ запрещен». Это может быть полезно, если хотите включить юридическое уведомление, контактную ссылку, деловую информацию, или подобное на всех таких страницах.

#### «rate_limiting» (Категория)
Конфигурация для ограничения скорости (не рекомендуется для общего пользования).

Помните, что как и все остальные функции CIDRAM, функция ограничения скорости CIDRAM может применяться только к тем страницам и ресурсам, к которым подключен CIDRAM. Обычно это означает, что не-PHP-ресурсы не будут охвачены, за исключением случаев когда они явно обслуживаются подключенными PHP-ресурсами. Если вы можете использовать серверный модуль, cPanel, или какой-либо другой сетевой инструмент для ограничения скорости, лучше использовать его вместо функции ограничения скорости CIDRAM. Также имейте в виду, что внимательный и решительный пользователь может легко обойти ограничение скорости, сменив их IP-адрес или переключившись на прокси-сервер или VPN-провайдера, о котором CIDRAM пока не знает, и помните, что ограничение скорости может быть очень раздражающим для реальных конечных пользователей. Иногда это может быть необходимо, но редко желательно.

##### «max_bandwidth» `[string]`
- Максимальный размер полосы пропускания, разрешенный в течение периода пособия, до включения ограничения скорости для будущих запросов. Значение 0 отключает этот тип ограничения скорости. Стандарт = 0KB.

##### «max_requests» `[int]`
- Максимальное количество запросов, разрешенных в течение периода пособия, до включения ограничения скорости для будущих запросов. Значение 0 отключает этот тип ограничения скорости. Стандарт = 0.

##### «precision_ipv4» `[int]`
- Точность использования при мониторинге использования IPv4. Значение отражает размер блока CIDR. Установить как 32 для наилучшей точности. Стандарт = 32.

##### «precision_ipv6» `[int]`
- Точность использования при мониторинге использования IPv6. Значение отражает размер блока CIDR. Установить как 128 для наилучшей точности. Стандарт = 128.

##### «allowance_period» `[string]`
- Продолжительность мониторинга использования. Стандарт = 0°0′0″.

##### «exceptions» `[string]`
- Исключения (т.е., запросы, которые не должны ограничиваться). Действует только при включенном ограничении скорости.

```
exceptions
├─Whitelisted ("Запросы отмечены как в белом списке")
├─Verified ("Проверенные запросы от поисковых систем и социальных сетей")
└─FE ("Запросы к фронтенду CIDRAM")
```

##### «segregate» `[bool]`
- Должны ли квоты для разных доменов и хостов храниться раздельно или совместно? True = Квоты будут храниться раздельно. False = Квоты будут храниться совместно [Стандарт].

#### «supplementary_cache_options» (Категория)
Дополнительные параметры кэша. Примечание: Изменение этих значений потенциально может привести к выходу из системы.

##### «prefix» `[string]`
- Указанное здесь значение будет добавлено в начало всех ключей записи кэша. Стандарт = «CIDRAM_». Когда на одном сервере существует несколько установок, это может быть полезно для хранения их кэшей отдельно.

##### «enable_apcu» `[bool]`
- Указывает, использовать ли APCu для кэширования. Стандарт = True.

##### «enable_memcached» `[bool]`
- Указывает, использовать ли Memcached для кэширования. Стандарт = False.

##### «enable_redis» `[bool]`
- Указывает, использовать ли Redis для кэширования. Стандарт = False.

##### «enable_pdo» `[bool]`
- Указывает, использовать ли PDO для кэширования. Стандарт = False.

##### «memcached_host» `[string]`
- Значение хоста Memcached. Стандарт = localhost.

##### «memcached_port» `[int]`
- Значение порта Memcached. Стандарт = «11211».

##### «redis_host» `[string]`
- Значение хоста Redis. Стандарт = localhost.

##### «redis_port» `[int]`
- Значение порта Redis. Стандарт = «6379».

##### «redis_timeout» `[float]`
- Значение тайм-аута Redis. Стандарт = «2.5».

##### «redis_database_number» `[int]`
- Номер базы данных Redis. Стандарт = 0. Примечание: В Redis Cluster нельзя использовать значения, отличные от 0.

##### «pdo_dsn» `[string]`
- Значение DSN PDO. Стандарт = «mysql:dbname=cidram;host=localhost;port=3306».

__FAQ.__ *<a href="https://github.com/CIDRAM/Docs/blob/master/readme.ru.md#user-content-HOW_TO_USE_PDO" hreflang="ru-RU">Что такое «PDO DSN»? Как я могу использовать PDO с CIDRAM?</a>*

##### «pdo_username» `[string]`
- Имя пользователя PDO.

##### «pdo_password» `[string]`
- Пароль PDO.

#### «bypasses» (Категория)
Стандартная сигнатур байпаса конфигурация.

##### «used» `[string]`
- Какие байпасы следует использовать?

```
used
├─AbuseIPDB ("AbuseIPDB")
├─AmazonAdBot ("AmazonAdBot")
├─Baidu ("Baiduspider/百度")
├─Bingbot ("Bingbot")
├─DuckDuckBot ("DuckDuckBot")
├─Embedly ("Embedly")
├─Feedbot ("Feedbot")
├─Feedspot ("Feedspot")
├─GoogleFiber ("Google Fiber")
├─Googlebot ("Googlebot")
├─Jetpack ("Jetpack")
├─PetalBot ("PetalBot")
├─Pinterest ("Pinterest")
├─Redditbot ("Redditbot")
├─Snapchat ("Snapchat")
├─Sogou ("Sogou/搜狗")
├─Yandex ("Yandex/Яндекс")
└─iCloud ("iCloud (iPhone Safari Bypass)")
```

---


### 6. <a name="SECTION6"></a>СИГНАТУР ФОРМАТ

#### 6.0 ОСНОВЫ (ДЛЯ ФАЙЛОВ СИГНАТУРЫ)

Все сигнатуры IPv4 придерживаться формат: `xxx.xxx.xxx.xxx/yy [Функция] [Параметр]`.
- `xxx.xxx.xxx.xxx` представляет начало блока CIDR (октеты для первым IP-адреса в блока).
- `yy` представляет размер блока CIDR [1-32].
- `[Функция]` инструктирует скрипт что делать с сигнатур (как сигнатур должны быть обработаны).
- `[Параметр]` представляет все что дополнительная информация что может потребоваться для `[Функция]`.

Все сигнатуры IPv6 придерживаться формат: `xxxx:xxxx:xxxx:xxxx::xxxx/yy [Функция] [Параметр]`.
- `xxxx:xxxx:xxxx:xxxx::xxxx` представляет начало блока CIDR (октеты для первым IP-адреса в блока). Полное обозначение и сокращенное обозначение являются приемлемыми (и каждый из них ДОЛЖЕН следовать соответствующим стандартам для обозначение IPv6, но с одним исключением: IPv6-адрес никогда не может начинаться с аббревиатуры когда использовании в сигнатуры для этого скрипт, из-за способа в котором они реконструируются посредством скрипт; Например, `::1/128` должны быть выражены, когда использовании в сигнатур, в виде `0::1/128`, и `::0/128` выражены в виде `0::/128`).
- `yy` представляет размер блока CIDR [1-128].
- `[Функция]` инструктирует скрипт что делать с сигнатур (как сигнатур должны быть обработаны).
- `[Параметр]` представляет все что дополнительная информация что может потребоваться для `[Функция]`.

CIDRAM сигнатурные файлы ДОЛЖЕН использовать разрыВы строк Unix-стиле (`%0A`, или `\n`)! Другие типы/стили разрыва строки (например, Windows `%0D%0A` или `\r\n` разрыВы строк, Mac `%0D` или `\r` разрыВы строк, и т.д.) МОЖЕТ быть использовано, но НЕ являются предпочтительными. РазрыВы строк не-Unix-стиле будут нормализованы к разрыВы строк Unix-стиле посредством скрипт.

Точное и правильное обозначение CIDR необходимо, в противном случае скрипт не будет признает сигнатур. Дополнительно, все сигнатуры CIDR для этого скрипт ДОЛЖНА начинаться с IP-адресом чья номер IP которого можно разделить равномерно в блок разделения представляющий от его размер блока CIDR (например, если хотите чтобы заблокировать все IP-адреса из `10.128.0.0` к `11.127.255.255`, `10.128.0.0/8` НЕ будут признаны посредством скрипт, но `10.128.0.0/9` и `11.0.0.0/9` используется в сочетании, БУДУТ признаны посредством скрипт).

Все что в сигнатуры файлы которые не признается как качестве сигнатур ни как относятся синтаксис посредством скрипт будут ПРОИГНОРИРОВАНЫ, поэтому это означает что Вы можете безопасно поставить любые данные несигнатурного что Вы хочешь в файлов сигнатур без разбивая их и без разбивая скрипт. Комментарии являются приемлемыми в файлов сигнатур, без какого-либо специального форматирования требуется. Shell-стиле хэширования для комментарии является предпочтительным, но не принудительная; Функционально, это не имеет никакого значения для сценария ли или не Вы выбираете использовать хэширование Shell-стиле для комментарии, но использовать хэширование Shell-стиле может помогает IDE и простые текстовые редакторы чтобы правильно выделить различные части файлов сигнатур (и так, Shell-стиле хэширования может помочь в качестве наглядного пособия при редактировании).

В возможные значения для `[Функция]`:
- Run
- Whitelist
- Greylist
- Deny

Если «Run» используется, когда сигнатур срабатывает, скрипт будет пытаться выполнить (используя заявление `require_once`) внешний PHP скрипт, определяется значением `[Параметр]` (рабочий каталог должен быть каталог „/vault/“ из скрипт).

Примеры: `127.0.0.0/8 Run example.php`

Это может быть полезно если Вы хотите чтобы выполнить некоторые специфические PHP код для некоторых конкретных IP-адресов и/или CIDR.

Если «Whitelist» используется, когда сигнатур срабатывает, скрипт будет сброса всех обнаружений (если есть какие-либо обнаружений) и нарушить функцию тестирования. `[Параметр]` будут игнорироваться. Эта функция является эквивалентом белого списка конкретный IP или CIDR от обнаружения.

Примеры: `127.0.0.1/32 Whitelist`

Если «Greylist» используется, когда сигнатур срабатывает, скрипт будет сброса всех обнаружений (если есть какие-либо обнаружений) и перейти к следующему файлу сигнатуры чтобы продолжить обработку. `[Параметр]` будут игнорироваться.

Примеры: `127.0.0.1/32 Greylist`

Если «Deny» используется, когда сигнатур срабатывает, предполагая что не сигнатур из белый список были срабатывать для данного IP-адреса и/или данного CIDR, доступ к защищенной странице будет запрещен. «Deny» то что Вы хотите использовать на самом деле блокировать IP-адрес и/или диапазон CIDR. Когда какие-либо сигнатуры срабатывает которые используют «Deny», страница «Доступ Закрыт» из скрипт будет генерироваться и запрос на защищенной странице убит.

Значение `[Параметр]` принимаются с «Deny» будут обрабатываться на страницы для «Доступ Закрыт», поставляется клиенту/пользователю как цитируется причиной их доступа к запрашиваемой странице закрытия. Это может быть коротким и простым предложением, объясняя почему Вы выбрали чтобы блокировать их (что-нибудь должно хватить, даже простой „Я не хочу чтобы Ты на моем сайте“), или один из небольшой кучки сокращённых слов поставляемые из сценария, что если используется, будет заменен скриптом с предварительно подготовленной объяснения для почему клиент/пользователь был заблокирован.

Предварительно подготовленные объяснения имеют поддержку L10N и может быть переведен с помощью скриптом основанный на языке который Вы укажете в директиве `lang` для конфигурации скрипт. Дополнительно, Вы можете поручить скрипт игнорировать сигнатуры с «Deny» на основе их значение `[Параметр]` (если они используют эти сокращенные слова) с помощью директив определяется конфигурацией скриптом (каждая сокращенная слово имеет соответствующую директиву чтобы обрабатывать соответствующие сигнатуриь или игнорировать их). Значение `[Параметр]` которые не используют эти сокращенные слова, однако, не имеют поддержку L10N и поэтому не будет переведен с помощью скриптом, и дополнительно, непосредственно не контролируется с конфигурацией скрипт.

Доступные сокращенные слова:
- Attacks
- Bogon
- Cloud
- Generic
- Legal
- Malware
- Proxy
- Spam

#### 6.1 ТЕГИ

##### 6.1.0 ТЕГИ СЕКЦИЙ

Если хотите разделить ваши собственные сигнатуры на отдельные секции, Вы можете идентифицировать эти отдельные секции к скрипт путем добавления «теги секций» сразу же после того как сигнатуры каждого секция, наряду с названием вашей сигнатур секция (смотрите пример ниже).

```
# Секция 1.
1.2.3.4/32 Deny Bogon
2.3.4.5/32 Deny Cloud
4.5.6.7/32 Deny Generic
5.6.7.8/32 Deny Spam
6.7.8.9/32 Deny Proxy
Tag: Секция 1
```

Чтобы разорвать теги секций и для обеспечения что теги не идентифицированы неправильно для сигнатур секции от ранее в файлов сигнатур, просто убедитесь что есть по крайней мере два последовательных разрывы строк между тегом и ваших предыдущих сигнатур секции. Любые сигнатуры без тегов будут «IPv4» или «IPv6» в стандарта (в зависимости от того, какие типы сигнатур срабатывает).

```
1.2.3.4/32 Deny Bogon
2.3.4.5/32 Deny Cloud

4.5.6.7/32 Deny Generic
5.6.7.8/32 Deny Spam
Tag: Секция 1
```

В приведенном выше примере, `1.2.3.4/32` и `2.3.4.5/32` будут помечены как «IPv4», в то время как `4.5.6.7/32` и `5.6.7.8/32` будут помечены как «Секция 1».

Та же логика может применяться и для разделения других типов тегов.

В частности, теги секций могут быть очень полезны для отладки при возникновении ложноположительный, обеспечивая легкое средство поиска точного источника проблемы, и может быть очень полезна для фильтрации записей в файле журнала при просмотре файлов журнала через фронтенд (имена секций можно щелкнуть по странице журналов фронтенд и их можно использовать в качестве критерия фильтрации). Если теги секций опущены для некоторых определенных сигнатурей, когда эти сигнатуры запускаются, CIDRAM использует имя файла сигнатуры вместе с типом заблокированного IP-адреса (IPv4 или IPv6) в качестве отказоустойчивый, и таким образом, теги секций полностью необязательны. В некоторых случаях они могут быть рекомендованы, например, когда файлы сигнатуры смутно названы или когда в противном случае может быть трудно четко идентифицировать источник сигнатурей, в результате чего запрос блокируется.

##### 6.1.1 ТЕГИ ИСТЕЧЕНИЯ

Если хотите сигнатуры чтобы истекают через какое-то время, аналогичным способом к теги секций, Вы можете использовать «истечение теги» чтобы указать когда сигнатур должна перестать быть действительным. Истечение теги используют формат «ГГГГ.ММ.ДД» (смотрите пример ниже).

```
# Секция 1.
1.2.3.4/32 Deny Generic
2.3.4.5/32 Deny Generic
Expires: 2016.12.31
```

Истекшие сигнатуры никогда не будут инициироваться ни при каких запросах, несмотря ни на что.

##### 6.1.2 ТЕГИ ПРОИСХОЖДЕНИЯ

Если хотите указать страну происхождения для какой-либо определенной сигнатуры, вы можете сделать это, используя «тег происхождения». Тег происхождения принимает код «[ISO 3166-1 Alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2)», соответствующий стране происхождения для сигнатурей, к которым он относится. Эти коды должны быть написаны в верхнем регистре (в нижнем или смешанном случае не будут отображаться правильно). Когда используется тег происхождения, он добавляется в запись поля «Почему Заблокированные» для любых запросов, заблокированных в результате сигнатурей, к которым применяется тег.

Если установлен дополнительный компонент «flags CSS», при просмотре лог-файлов через страницу журналов фронтенд, информация, добавленная тегами происхождения, заменяется флагом страны, соответствующей этой информации. Эта информация, будь то в ее необработанном виде или в качестве флага страны, доступна для кликов, а при нажатии, будет фильтровать записи в журнале посредством других аналогичных идентификационных записей журнала (эффективно позволяя тем, кто обращается к странице журналов, фильтровать по стране происхождения).

Примечание: Технически это не какая-либо форма геолокации, из-за чего она не предполагает поиска какой-либо конкретной информации, относящейся к входящим IP-адресам, а скорее просто позволяет нам явно указать страну происхождения для любых запросов, заблокированных конкретными сигнатурами. В одном секция сигнатуры допустимы несколько тегов происхождения.

Гипотетический пример:

```
1.2.3.4/32 Deny Generic
Origin: CN
2.3.4.5/32 Deny Generic
Origin: FR
4.5.6.7/32 Deny Generic
Origin: DE
6.7.8.9/32 Deny Generic
Origin: US
Tag: Foobar
```

Любые теги могут использоваться совместно, и все теги являются необязательными (смотрите пример ниже).

```
# Пример Секция.
1.2.3.4/32 Deny Generic
Origin: US
Tag: Пример Секция
Expires: 2016.12.31
```

##### 6.1.3 ТЕГИ ОТЛОЖЕННЫЕ

Когда большое количество файлов сигнатур установлено и активно используется, инсталляция могут стать довольно сложными, и могут быть некоторые сигнатуры, которые перекрываются. В этих случаях для предотвращения включения нескольких перекрывающихся сигнатурей во время блочных событий, отложенные теги могут использоваться для отсрочки определенных секция сигнатуры в случаях, когда установлен и активно используется какой-либо другой файл сигнатур. Это может быть полезно в случаях, когда некоторые сигнатуры обновляются чаще других, чтобы отложить менее часто обновляемые сигнатуры в пользу более часто обновляемых сигнатурей.

Отложенные теги используются аналогично другим типам тегов. Значение тега должно соответствовать установленному и активно используемому файлу сигнатуры, от которого будет отложено.

Пример:

```
1.2.3.4/32 Deny Generic
Origin: AA
2.3.4.5/32 Deny Generic
Origin: BB
Defers to: preferred_signatures.dat
```

##### 6.1.4 ТЕГИ ПРОФИЛЯ

Теги профиля позволяют отображать дополнительную информацию на тестовой странице IP и могут использоваться модулями и вспомогательными правилами для более сложного поведения и принятия точных решений.

Теги профиля используются так же, как и другие типы тегов. Значения тегов профиля могут использоваться как условие для модулей и вспомогательных правил. Теги профиля могут предоставлять несколько значений, разделяя их точкой с запятой. Конечный пользователь никогда не видит значения тегов профиля.

Пример:

```
1.2.3.4/32 Deny Generic
2.3.4.5/32 Deny Generic
Profile: Example;Just some generic stuff;Foo;Bar
Origin: BB
```

#### 6.2 YAML

##### 6.2.0 ОСНОВЫ YAML

Упрощенная форма маркап YAML может быть использован в сигнатур файлы для целей определения поведения и установок специфичные для отдельных сигнатур секций. Это может быть полезно если Вы хотите чтобы значение ваших директив конфигурации отличаться на основе индивидуальных сигнатур и сигнатур секций (например; если Вы хотите чтобы предоставить адрес электронной почты для поддержки билетов для любых пользователей что заблокированных с помощью один специфична сигнатур, но не хотите чтобы предоставить адрес электронной почты для поддержки билетов для пользователей что заблокированных с помощью любых других сигнатур; если Вы хотите чтобы некоторые специфический сигнатур чтобы вызвать страницу перенаправления; если Вы хотите чтобы отметить секция сигнатур для использования с hCaptcha; если Вы хотите чтобы войти блокировал попытки доступа к отдельным файлам на основе индивидуальных сигнатурей и/или сигнатур секций).

Применение марка YAML в файлах сигнатур совершенно не обязательно (то есть, можете использовать его, если хотите сделать это, но не обязаны делать это), и способен использовать большинство (но не все) директивы конфигурации.

Заметка: Имплементация в CIDRAM для маркап YAML очень упрощенно и очень ограничено; Это предназначен для выполнения требований конкретных для CIDRAM таким образом что имеет знакомство с маркап YAML, но не следует ни соответствует официальным спецификациям (и поэтому не будет вести себя так же как более тщательный имплементации в другом месте, и может не подходить для других проектов в другом месте).

В CIDRAM, сегменты маркап YAML определены для скрипт с тремя черточками („---“), и заканчиваются вместе со содержащими сигнатур секций с разрывы строк двойной. Типичный сегмент маркап YAML в сигнатуры секция состоит из трех черточек на строка сразу же после того как список CIDR и любые теги, с последующим двухмерной списка пары ключ-значение (первое измерение, категории директива конфигурации; второе измерение, директива конфигурации) для которых директивы конфигурации должны быть изменены (и какие ценности) всякий раз когда сигнатуры в этом сигнатур секция срабатывании (см ниже примеры).

```
# Foobar 1.
1.2.3.4/32 Deny Generic
2.3.4.5/32 Deny Generic
4.5.6.7/32 Deny Generic
Tag: Foobar 1
---
general:
 http_response_header_code: 403
 emailaddr: username@domain.tld
logging:
 standard_log: "logfile.{yyyy}-{mm}-{dd}.txt"
 apache_style_log: "access.{yyyy}-{mm}-{dd}.txt"
 serialised_log: "serial.{yyyy}-{mm}-{dd}.txt"
template_data:
 css_url: "https://domain.tld/cidram.css"

# Foobar 2.
1.2.3.4/32 Deny Generic
2.3.4.5/32 Deny Generic
4.5.6.7/32 Deny Generic
Tag: Foobar 2
---
general:
 http_response_header_code: 503
logging:
 standard_log: "logfile.Foobar2.{yyyy}-{mm}-{dd}.txt"
 apache_style_log: "access.Foobar2.{yyyy}-{mm}-{dd}.txt"
 serialised_log: "serial.Foobar2.{yyyy}-{mm}-{dd}.txt"

# Foobar 3.
1.2.3.4/32 Deny Generic
2.3.4.5/32 Deny Generic
4.5.6.7/32 Deny Generic
Tag: Foobar 3
---
general:
 http_response_header_code: 403
 silent_mode: "http://127.0.0.1/"
```

#### 6.3 ВСПОМОГАТЕЛЬНЫЙ

##### 6.3.0 ИГНОРИРОВАНИЕ СЕКЦИЯ СИГНАТУРЫ

К тому же, если хотите CIDRAM полностью игнорировать некоторые конкретные секций в любой из сигнатур файлы, Вы можете использовать файл `ignore.dat` чтобы указать какие секций игнорировать. На новой строка, писать `Ignore`, а затем пробел, а затем название секций что Вы хотите CIDRAM игнорировать (смотрите пример ниже).

```
Ignore Секция 1
```

Это также может быть достигнуто с помощью фронтенда, предоставленного на странице «списка секций» на фронтенд в CIDRAM.

##### 6.3.1 ВСПОМОГАТЕЛЬНЫЕ ПРАВИЛА

Если Вы считаете, что писать собственные файлы сигнатуры или настраиваемые модули слишком сложны для вас, более простой альтернативой может быть использование фронтенда, предоставляемого страницей «вспомогательных правил» на фронтенде CIDRAM. Выбрав соответствующие параметры и указав детали о конкретных типах запросов, вы можете указать CIDRAM, как реагировать на эти запросы. «Вспомогательные правила» выполняются после того, как все файлы сигнатур и модули уже завершены.

##### 6.3.2 СОХРАНЕНИЕ И АКТИВАЦИЯ ПОЛЬЗОВАТЕЛЬСКИХ ФАЙЛОВ СИГНАТУРЫ

Для CIDRAM v2 и более ранних в хранилище вы найдете два файла: `ipv4_custom.dat.RenameMe` и `ipv6_custom.dat.RenameMe`. В этих файлах можно сохранять пользовательские сигнатуры, или, если хотите, можно создать новые файлы для ваших пользовательских сигнатурей, называя их как угодно. Для CIDRAM v2 и более ранних файлы пользовательских сигнатурей необходимо сохранять в корневом каталоге vault.

В CIDRAM v3 и более поздних отсутствуют предустановленные файлы для пользовательских сигнатурей, но вы также можете создавать новые файлы для своих пользовательских сигнатурей, называя их как угодно. Для CIDRAM v3 и выше файлы пользовательских сигнатурей необходимо сохранять в подготовленной директории «signatures» вашей установки CIDRAM.

Для «активации» пользовательских файлов сигнатурей необходимо указать их в директивах конфигурации «ipv4» или «ipv6» вашего конфигурационного файла (в зависимости от того, предназначены ли пользовательские файлы сигнатурей для IPv4 или IPv6).

В CIDRAM v2 и более ранних директивы конфигурации «ipv4» и «ipv6» находятся в категории конфигурации «signatures».

В CIDRAM v3 и выше директивы конфигурации «ipv4» и «ipv6» находятся в категории конфигурации «components».

#### 6.4 <a name="MODULE_BASICS"></a>ОСНОВЫ (ДЛЯ МОДУЛИ)

Модули могут использоваться для расширения функциональности CIDRAM, выполнения дополнительных задач, или обработки дополнительной логики.

Из-за того что модули написаны в виде файлов PHP, если Вы хорошо знакомы с кодовой базой CIDRAM, Вы можете структурировать свои модули, и писать свои сигнатуры модуля, как Вы хотите (в рамках того, что возможно с PHP).

*Заметка: Если вам неудобно работать с кодом PHP, писать собственные модули не рекомендуется.*

Некоторые функции предоставляются CIDRAM для использования модулей, что упрощает создание собственных модулей. Информация об этой функциональности описана ниже.

#### 6.5 ФУНКЦИОНАЛЬНОСТЬ МОДУЛЯ

##### 6.5.0 «$this->trigger»

Сигнатуры модулей обычно пишутся с помощью `$this->trigger`. В большинстве случаев это method будет более важным, чем что-либо еще для написания модулей.

`$this->trigger` принимает 4 параметра: `$Condition`, `$ReasonShort`, `$ReasonLong` (необязательно), и `$DefineOptions` (необязательно).

Оценивается правдоподобность `$Condition`, и если «true», сигнатур «срабатывает». Если «false», сигнатур *не* «срабатывает». `$Condition` обычно содержит PHP-код для оценки состояния, которое должно вызвать блокировку запроса.

`$ReasonShort` указывается в поле «Почему Заблокированные», когда сигнатур «срабатывает».

`$ReasonLong` – Это необязательное сообщение, которое будет отображаться пользователю/клиенту, когда они заблокированы, чтобы объяснить, почему они были заблокированы. По умолчанию используется стандартное сообщение «Доступ Закрыт» при его отсутствии.

`$DefineOptions` – Это необязательный массив, содержащий пары ключ/значение, используемые для определения параметров конфигурации, специфичных для инстанция запроса. Параметры конфигурации будут применены, когда сигнатур будет срабатывает.

`$this->trigger` возвращает «true», когда сигнатур «срабатывает», а когда нет, «false».

##### 6.5.1 «$this->bypass»

Байпасы сигнатуры обычно пишутся с помощью `$this->bypass`.

`$this->bypass` принимает 3 параметра: `$Condition`, `$ReasonShort`, и `$DefineOptions` (необязательно).

Оценивается правдоподобность `$Condition`, и если «true», сигнатур «срабатывает». Если «false», байпас *не* «срабатывает». `$Condition` обычно содержит PHP-код для оценки состояния, которое *не* должно вызвать блокировку запроса.

`$ReasonShort` указывается в поле «Почему Заблокированные», когда байпас «срабатывает».

`$DefineOptions` – Это необязательный массив, содержащий пары ключ/значение, используемые для определения параметров конфигурации, специфичных для инстанция запроса. Параметры конфигурации будут применены, когда байпас будет срабатывает.

`$this->bypass` возвращает «true», когда байпас «срабатывает», а когда нет, «false».

##### 6.5.2 «$this->dnsReverse»

Это можно использовать для получения имени хоста IP-адреса. Если Вы хотите создать модуль для блокирования имен хостов, это закрытие может быть полезно.

Пример:
```PHP
<?php
/** Fetch hostname. */
if (empty($this->CIDRAM['Hostname'])) {
    $this->CIDRAM['Hostname'] = $this->dnsReverse($this->BlockInfo['IPAddr']);
}

/** Example signature. */
if (strlen($this->CIDRAM['Hostname']) && $this->CIDRAM['Hostname'] !== $this->BlockInfo['IPAddr']) {
    $this->trigger($this->CIDRAM['Hostname'] === 'www.foobar.tld', 'Foobar.tld', 'Hostname Foobar.tld is not allowed.');
}
```

#### 6.6 МОДУЛЬНЫЕ ПЕРЕМЕННЫЕ

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

Ниже перечислены некоторые общие переменные, которые могут быть полезны для вашего модуля:

Переменная | Описание
----|----
`$this->BlockInfo['DateTime']` | Текущая дата и время.
`$this->BlockInfo['IPAddr']` | IP-адрес для текущего запроса.
`$this->BlockInfo['IPAddrResolved']` | Если IP-адрес текущего запроса является адресом 6to4, Teredo, или ISATAP, этот адрес преобразуется в эквивалент IPv4. Если нет, то IP-адрес текущего запроса.
`$this->BlockInfo['ScriptIdent']` | Версия сценария CIDRAM.
`$this->BlockInfo['Query']` | Запрос текущего запроса.
`$this->BlockInfo['Referrer']` | Ссылка для текущего запроса (если таковая существует).
`$this->BlockInfo['UA']` | Пользовательский агент для текущего запроса.
`$this->BlockInfo['UALC']` | Пользовательский агент для текущего запроса (в нижнем регистре).
`$this->BlockInfo['ReasonMessage']` | Сообщение, которое будет отображаться пользователю/клиенту для текущего запроса, если они заблокированы.
`$this->BlockInfo['SignatureCount']` | Количество сигнатурей, инициированных для текущего запроса.
`$this->BlockInfo['Signatures']` | Справочная информация для любых сигнатур, инициированных для текущего запроса.
`$this->BlockInfo['WhyReason']` | Справочная информация для любых сигнатур, инициированных для текущего запроса.
`$this->BlockInfo['Request_Method']` | Метод запроса текущего запроса.
`$this->BlockInfo['Protocol']` | Протокол текущего запроса.

---


### 7. <a name="SECTION7"></a>ИЗВЕСТНЫЕ ПРОБЛЕМЫ СОВМЕСТИМОСТИ

Было обнаружено, что следующие пакеты и продукты несовместимы с CIDRAM:
- __[Endurance Page Cache](https://github.com/CIDRAM/CIDRAM/issues/52)__
- __[Mix.com](https://github.com/CIDRAM/CIDRAM/issues/80)__

Модули были доступны для обеспечения совместимости следующих пакетов и продуктов с CIDRAM:
- __[BunnyCDN](https://github.com/CIDRAM/CIDRAM/issues/56)__
- __[Quic cloud](https://wordpress.org/support/topic/quic-dot-cloud-requires-all-ips-allowed/)__

*Смотрите также: [Графики Совместимости](https://maikuolan.github.io/Compatibility-Charts/).*

---


### 8. <a name="SECTION8"></a>ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ (FAQ)

- [Может CIDRAM блокировать целые страны?](#user-content-BLOCK_ENTIRE_COUNTRIES)
- [Как часто обновляются сигнатуры?](#user-content-SIGNATURE_UPDATE_FREQUENCY)
- [Я столкнулся с проблемой при использовании CIDRAM, и я не знаю, что с этим делать! Пожалуйста помоги!](#user-content-ENCOUNTERED_PROBLEM_WHAT_TO_DO)
- [Я заблокирован CIDRAM с веб-сайта, который я хочу посетить! Пожалуйста помоги!](#user-content-BLOCKED_WHAT_TO_DO)
- [Я хочу использовать CIDRAM v2~v4 с версией PHP ниже 7.2; Вы можете помочь?](#user-content-MINIMUM_PHP_VERSION_V3)
- [Могу ли я использовать одну установку CIDRAM для защиты нескольких доменов?](#user-content-PROTECT_MULTIPLE_DOMAINS)
- [Я не хочу возиться с установкой этого и заставить его работать с моим сайтом; Могу я просто заплатить вам за все это?](#user-content-PAY_YOU_TO_DO_IT)
- [Могу ли я нанять вас или любого из разработчиков этого проекта для частной работы?](#user-content-HIRE_FOR_PRIVATE_WORK)
- [Мне нужны модификации специалиста, настройки и т.д.; Вы можете помочь?](#user-content-SPECIALIST_MODIFICATIONS)
- [Я разработчик, веб-дизайнер, или программист. Могу ли я принять или предложить работу, связанную с этим проектом?](#user-content-ACCEPT_OR_OFFER_WORK)
- [Я хочу внести свой вклад в проект; Я могу сделать это?](#user-content-WANT_TO_CONTRIBUTE)
- [Могу ли я использовать cron для автоматического обновления?](#user-content-CRON_TO_UPDATE_AUTOMATICALLY)
- [Что такое «нарушения»?](#user-content-WHAT_ARE_INFRACTIONS)
- [Может ли CIDRAM блокировать имена хостов?](#user-content-BLOCK_HOSTNAMES)
- [Что я могу использовать для «default_dns»?](#что-я-могу-использовать-для-default_dns)
- [Могу ли я использовать CIDRAM для защиты других вещей, помимо веб-сайтов (например, серверов электронной почты, FTP, SSH, IRC и т.д.)?](#user-content-PROTECT_OTHER_THINGS)
- [Будут ли возникать проблемы, если я буду использовать CIDRAM одновременно с использованием CDN или кэширования?](#user-content-CDN_CACHING_PROBLEMS)
- [Будет ли CIDRAM защищать мой сайт от атак DDoS?](#user-content-DDOS_ATTACKS)
- [Когда я активирую или деактивирую модули или файлы сигнатуры на странице обновлений, он сортирует их по алфавиту в конфигурации. Могу ли я изменить способ сортировки?](#user-content-CHANGE_COMPONENT_SORT_ORDER)
- [Что такое «PDO DSN»? Как я могу использовать PDO с CIDRAM?](#user-content-HOW_TO_USE_PDO)
- [CIDRAM блокирует cronjobs; Как это исправить?](#user-content-BLOCK_CRON)

#### <a name="BLOCK_ENTIRE_COUNTRIES"></a>Может CIDRAM блокировать целые страны?

Да. Самый простой способ сделать это - Установить модуль BGPView или модуль IP-API и настроить его в соответствии с вашими потребностями.

#### <a name="SIGNATURE_UPDATE_FREQUENCY"></a>Как часто обновляются сигнатуры?

Частота обновления зависит от файлов сигнатур. Предпринята попытка обновить файлов сигнатур в максимально возможной степени, но, потому всех нас есть различные другие обязательства, наша жизнь вне проекта, и мы не получаем материальной компенсации (т.е., оплата) за наши усилия по проекту, точный график обновления не может быть гарантирован. В общем, обновления происходят, когда есть время, и мы стараемся расставить приоритеты на основе необходимости и частота изменения между диапазонами. Помощь всегда приветствуется, если Вы готовы предложить любую.

#### <a name="ENCOUNTERED_PROBLEM_WHAT_TO_DO"></a>Я столкнулся с проблемой при использовании CIDRAM, и я не знаю, что с этим делать! Пожалуйста помоги!

- Используете ли Вы последнюю версию программного обеспечения? Используете ли Вы последние версии ваших файлов сигнатуры? Если ответ на любой из этих двух вопросов отрицательный, попробуйте сначала обновить все, и попытайтесь решить проблема. Если оно сохраняется, продолжайте чтение.
- Вы проверили всю документацию? Если нет, сделайте это. Если проблема не может быть решена с помощью документации, продолжите чтение.
- Вы проверили **[странице «issues»](https://github.com/CIDRAM/CIDRAM/issues)**, чтобы узнать упоминалась ли эта проблема ранее? Если это было уже упоминалось, проверить были ли предоставлены какие-либо предложения, идеи и/или решения, и следуйте по необходимости чтобы попытаться решить проблема.
- Если проблема не решена, пожалуйста, обратитесь за помощью, создав новую «issue» на странице «issues».

#### <a name="BLOCKED_WHAT_TO_DO"></a>Я заблокирован CIDRAM с веб-сайта, который я хочу посетить! Пожалуйста помоги!

CIDRAM предоставляет владельцам веб-сайтов возможность блокировать нежелательный трафик, но владельцы веб-сайтов обязаны сами решать, как они хотят использовать CIDRAM. В случае ложноположительный, файлами сигнатуры обычно включается в CIDRAM, поправки могут быть сделаны, но в отношении того чтобы быть разблокированным с определенных веб-сайтов, Вам необходимо связаться с владельцами этих веб-сайтов. В случаях когда исправления сделаны, по крайней мере, они должны будут обновить свои файлов сигнатур и/или инсталляция, и в других случаях (таких как, например, когда они есть модифицировал свою инсталляция, создали свои собственные сигнатуры, и т.д.), ответственность за решение вашей проблемы полностью принадлежит им, и полностью вне нашего контроля.

#### <a name="MINIMUM_PHP_VERSION_V3"></a>Я хочу использовать CIDRAM v2~v4 с версией PHP ниже 7.2; Вы можете помочь?

Нет. PHP≥7.2 является минимальным требованием для CIDRAM v2~v4.

*Смотрите также: [Графики Совместимости](https://maikuolan.github.io/Compatibility-Charts/).*

#### <a name="PROTECT_MULTIPLE_DOMAINS"></a>Могу ли я использовать одну установку CIDRAM для защиты нескольких доменов?

Да. CIDRAM инсталляций не привязаны к определенным домены, и поэтому может использоваться для защиты нескольких доменов. В общем, мы ссылаемся на CIDRAM инсталляций, защищающие только один домен, как «однодоменные инсталляций», и мы ссылаемся на CIDRAM инсталляций, защищающие несколько доменов и/или поддоменов, как «многодоменные инсталляций». Если Вы используете многодоменную инсталляция, и необходимо использовать разные файлы сигнатур для разных доменов, или необходимо настроить CIDRAM по-разному для разных доменов, это можно сделать. После загрузки файла конфигурации (`config.yml`), CIDRAM проверит наличие «файл переопределения конфигурации» специфичные для запрашиваемого домена или поддомена (`xn----7sbaabjijgdno9cdqkbchu3o.tld.config.yml`), и если он будет найден, любые значений конфигурации, определенные в файл переопределения конфигурации, будет использоваться для экземпляра выполнения вместо значений конфигурации, определенных конфигурационным файлом. Конфигурация переопределяет файлы, идентичные конфигурационному файлу, и на Ваше усмотрение, Может содержать все директивы конфигурации, доступные для CIDRAM, или какой бы небольшой подсекция требуется, при необходимости. Имена для конфигурация переопределяет файлов соответствуют домену для которого они предназначены (так, например, если Вам нужен файл переопределения конфигурации для домена, `https://www.some-domain.tld/`, его файл переопределения конфигурации должен иметь имя `some-domain.tld.config.yml`, и должен быть помещен в `vault`, вместе с файлом конфигурации, `config.yml`). Доменные имена извлекаются из заголовка `HTTP_HOST` запроса; «www» игнорируется.

#### <a name="PAY_YOU_TO_DO_IT"></a>Я не хочу возиться с установкой этого и заставить его работать с моим сайтом; Могу я просто заплатить вам за все это?

Может быть. Это рассматривается в каждом конкретном случае. Расскажите, что вам нужно, что вы предлагаете, и мы расскажем вам, можем ли мы помочь.

#### <a name="HIRE_FOR_PRIVATE_WORK"></a>Могу ли я нанять вас или любого из разработчиков этого проекта для частной работы?

*См. Выше.*

#### <a name="SPECIALIST_MODIFICATIONS"></a>Мне нужны модификации специалиста, настройки и т.д.; Вы можете помочь?

*См. Выше.*

#### <a name="ACCEPT_OR_OFFER_WORK"></a>Я разработчик, веб-дизайнер, или программист. Могу ли я принять или предложить работу, связанную с этим проектом?

Да. Наша лицензия не запрещает это.

#### <a name="WANT_TO_CONTRIBUTE"></a>Я хочу внести свой вклад в проект; Я могу сделать это?

Да. Вклады в проект очень приветствуются. Для получения дополнительной информации см. «CONTRIBUTING.md».

#### <a name="CRON_TO_UPDATE_AUTOMATICALLY"></a>Могу ли я использовать cron для автоматического обновления?

Да. API встроен в фронтенд для взаимодействия со обновления страница через внешние скрипты. Имеется отдельный скрипт: «[Cronable](https://github.com/Maikuolan/Cronable)». Он может использоваться вашим cron manager или cron scheduler для автоматического обновления этого и других поддерживаемых пакетов (этот скрипт предоставляет собственную документацию).

#### <a name="WHAT_ARE_INFRACTIONS"></a>Что такое «нарушения»?

«Количество сигнатурей» и «нарушений» относятся к серьезности и количеству сигнатурей, запущенных во время любого конкретного запроса, будь то из-за файлов сигнатурей, модулей, вспомогательных правил, или иным образом, но в то время как «количество сигнатурей» сохраняется только для этого конкретного запроса, «нарушений» могут сохраняться для любого количества запросов, пока это определяется `default_tracktime`.

Это обеспечивает механизм, гарантирующий, что запросы из потенциально опасных источников могут быть заблокированы при вторичных запросах из любого конкретного такого источника, при уже заблокирован во время предыдущего запроса с достаточным количеством нарушений.

#### <a name="BLOCK_HOSTNAMES"></a>Может ли CIDRAM блокировать имена хостов?

Да. Этого можно добиться, создав вспомогательное правило или пользовательский модуль.

![Вспомогательное правило для блокировки имен хостов](https://raw.githubusercontent.com/CIDRAM/Docs/master/assets/auxrule_block_hostname.png)

#### <a name="WHAT_CAN_I_USE_FOR_DEFAULT_DNS"></a>Что я могу использовать для «default_dns»?

Как правило, IP-адрес любого надежного DNS-сервера должен быть достаточным. Если вы ищете предложения, [public-dns.info](https://public-dns.info/) и [OpenNIC](https://servers.opennic.org/) предоставляют обширные списки известных общедоступных DNS-серверов. В качестве альтернативы см. таблицу ниже:

IP | Оператор
---|---
`1.1.1.1` | [Cloudflare](https://www.cloudflare.com/learning/dns/what-is-1.1.1.1/)
`8.8.4.4`<br />`8.8.8.8`<br />`2001:4860:4860::8844`<br />`2001:4860:4860::8888` | [Google Public DNS](https://developers.google.com/speed/public-dns/)
`9.9.9.9`<br />`149.112.112.112` | [Quad9 DNS](https://www.quad9.net/)
`84.200.69.80`<br />`84.200.70.40`<br />`2001:1608:10:25::1c04:b12f`<br />`2001:1608:10:25::9249:d69b` | [DNS.WATCH](https://dns.watch/index)
`208.67.220.220`<br />`208.67.222.220`<br />`208.67.222.222` | [OpenDNS Home](https://www.opendns.com/)
`77.88.8.1`<br />`77.88.8.8`<br />`2a02:6b8::feed:0ff`<br />`2a02:6b8:0:1::feed:0ff` | [Yandex.DNS](https://dns.yandex.com/advanced/)
`8.20.247.20`<br />`8.26.56.26` | [Comodo Secure DNS](https://www.comodo.com/secure-dns/)
`216.146.35.35`<br />`216.146.36.36` | [Dyn](https://help.dyn.com/internet-guide-setup/)
`64.6.64.6`<br />`64.6.65.6` | [Verisign Public DNS](https://www.verisign.com/en_US/security-services/public-dns/index.xhtml)
`37.235.1.174`<br />`37.235.1.177`<br />`45.33.97.5`<br />`172.104.237.57`<br />`172.104.49.100` | [FreeDNS](https://freedns.zone/en/)
`156.154.70.1`<br />`156.154.71.1`<br />`2610:a1:1018::1`<br />`2610:a1:1019::1` | [Neustar Security](https://www.security.neustar/dns-services/free-recursive-dns-service)
`45.32.36.36`<br />`45.77.165.194` | [Fourth Estate](https://dns.fourthestate.co/)
`74.82.42.42` | [Hurricane Electric](https://dns.he.net/)
`195.46.39.39`<br />`195.46.39.40` | [SafeDNS](https://www.safedns.com/en/features/)
`89.233.43.71`<br />`91.239.100.100 `<br />`2001:67c:28a4::`<br />`2a01:3a0:53:53::` | [UncensoredDNS](https://blog.uncensoreddns.org/)
`208.76.50.50`<br />`208.76.51.51` | [SmartViper](https://www.markosweb.com/free-dns/)

*Заметка: Я не предъявляю никаких претензий или гарантий относительно практики конфиденциальности, безопасности, эффективности и надежности любых DNS-сервисов, перечисленных или иным образом. Пожалуйста, сделайте собственное исследование, когда принимаете решения о них.*

#### <a name="PROTECT_OTHER_THINGS"></a>Могу ли я использовать CIDRAM для защиты других вещей, помимо веб-сайтов (например, серверов электронной почты, FTP, SSH, IRC и т.д.)?

Вы можете (юридически), но не должны (технически; практически). Наша лицензия не ограничивает какие технологии используют CIDRAM, но CIDRAM является WAF (брандмауэром веб-приложений) и всегда предназначался для защиты веб-сайтов. Поскольку он не был разработан с учетом других технологий, он вряд ли будет эффективным или обеспечит надежную защиту других технологий, реализация, вероятно, будет сложной, и риск ложноположительный и пропущенных обнаружений очень высок.

#### <a name="CDN_CACHING_PROBLEMS"></a>Будут ли возникать проблемы, если я буду использовать CIDRAM одновременно с использованием CDN или кэширования?

Возможно. Это зависит от характера рассматриваемой услуги и того, как вы ее используете. Как правило, если вы только кэшируете статические активы (изображения, CSS, и т.д.; все, что обычно не меняется со временем), проблем не должно быть. Однако могут возникнуть проблемы, если вы кэшируете данные, которые в противном случае обычно генерировались бы динамически при запросе, или если вы кэшируете результаты запросов POST (это по существу сделает ваш сайт и его среду обязательным статическим, и CIDRAM вряд ли обеспечит какую-либо значимую выгоду в обязательной статической среде). Также могут быть особые требования к конфигурации для CIDRAM, в зависимости от того какой CDN или кэширующий сервис вы используете (вам необходимо убедиться, что CIDRAM настроен правильно для конкретной службы CDN или кэширования, которую вы используете). Неправильное конфигурирование CIDRAM может привести к значительно проблематичным ложным срабатываниям и пропущенным обнаружениям.

#### <a name="DDOS_ATTACKS"></a>Будет ли CIDRAM защищать мой сайт от атак DDoS?

Краткий ответ: Нет.

Чуть более длинный ответ: CIDRAM поможет уменьшить влияние нежелательного трафика на ваш сайт (таким образом снижая затраты на пропускную способность вашего веб-сайта), поможет уменьшить влияние нежелательного трафика на ваше оборудование (например, способность вашего сервера обрабатывать и обслуживать запросы), и может помочь уменьшить различные другие потенциальные негативные последствия, связанные с нежелательным трафиком. Однако для понимания этого вопроса необходимо помнить две важные вещи.

Во-первых, CIDRAM является пакетом PHP и, следовательно, работает на компьютере, где установлен PHP. Это означает, что CIDRAM может видеть и блокировать запрос только *после* того, как сервер уже получил его. Во-вторых, эффективное смягчение DDoS должно отфильтровывать запросы *до* того, как они достигнут сервера, на который нацелена атака DDoS. В идеале, атаки DDoS должны быть обнаружены и смягчены решениями, способными отбрасывать или перенаправлять трафик, связанный с атаками, прежде чем он достигнет целевого сервера в первую очередь.

Это может быть реализовано с использованием специализированных, локальных аппаратных решений, и/или облачные решения, такие как специализированные службы смягчения DDoS, маршрутизация DNS домена через сети, устойчивые к DDoS, облачная фильтрация, или их комбинацию. В любом случае, этот предмет слишком сложный, чтобы подробно объяснить всего лишь параграф или два, поэтому я бы рекомендовал продолжить исследования, если это предмет, который вы хотите продолжить. Когда истинный характер атак DDoS будет правильно понят, этот ответ будет иметь больше смысла.

#### <a name="CHANGE_COMPONENT_SORT_ORDER"></a>Когда я активирую или деактивирую модули или файлы сигнатуры на странице обновлений, он сортирует их по алфавиту в конфигурации. Могу ли я изменить способ сортировки?

Да. Если вам нужно заставить некоторые файлы выполнить в определенном порядке, вы можете добавить некоторые произвольные данные до их имен в директиве конфигурации, где они указаны, разделенные двоеточием. Когда страница обновлений впоследствии сортирует файлы снова, эти добавленные произвольные данные будут влиять на порядок сортировки, в результате чего они должны выполняться в том порядке, в котором вы хотите, без необходимости переименовывать их.

Например, предполагая конфигурационную директиву с файлами, перечисленными ниже:

```YAML
modules: |
 file1.php
 file2.php
 file3.php
 file4.php
 file5.php
```

Если хотите, чтобы `file3.php` выполнялся первым, вы могли бы добавить что-то вроде `aaa:` перед именем файла:

```YAML
modules: |
 file1.php
 file2.php
 aaa:file3.php
 file4.php
 file5.php
```

Затем, если новый файл, `file6.php`, активирован, когда страница обновлений снова сортирует их все, это должно закончиться следующим образом:

```YAML
modules: |
 aaa:file3.php
 file1.php
 file2.php
 file4.php
 file5.php
 file6.php
```

Такая же ситуация, когда файл деактивирован. Наоборот, если хотите, чтобы файл выполнялся последним, вы могли бы добавить что-то вроде `zzz:` перед именем файла. В любом случае вам не нужно будет переименовывать указанный файл.

#### <a name="HOW_TO_USE_PDO"></a>Что такое «PDO DSN»? Как я могу использовать PDO с CIDRAM?

«PDO» является акроним для «[PHP Data Objects](https://www.php.net/manual/ru/intro.pdo.php)» (объектов данных PHP). Он предоставляет интерфейс для PHP, чтобы иметь возможность подключаться к некоторым системам баз данных, обычно используемым различными приложениями PHP.

«DSN» является акроним для «[data source name](https://en.wikipedia.org/wiki/Data_source_name)» (имени источника данных). «PDO DSN» описывает как PDO должен подключаться к базе данных.

CIDRAM предоставляет возможность использовать PDO для целей кэширования. Чтобы это работало должным образом, вам необходимо соответствующим образом настроить CIDRAM, включив PDO, создать новую базу данных для CIDRAM использовать (если вы еще не имеете в виду базу данных для CIDRAM использовать), и создать новую Таблица в вашей базе данных в соответствии со структурой, описанной ниже.

Когда соединение с базой данных успешно, но необходимая таблица не существует, автоматическое создание таблицы будет предпринято. Тем не менее, это поведение не было тщательно проверено, и успех не может быть гарантирован.

Это, конечно, применимо, только если вы действительно хотите, чтобы CIDRAM использовал PDO. Если вы достаточно довольны тем, что CIDRAM использует кэширование плоских файлов (в соответствии с его конфигурацией по умолчанию) или любые другие предоставляемые опции кэширования, вам не нужно беспокоиться о настройке баз данных, таблиц, и т.д.

Структура, описанная ниже, использует «cidram» в имени базы данных, но вы можете использовать любое имя, которое вы хотите для своей базы данных, при условии, что это же имя реплицируется в конфигурации DSN.

```
╔══════════════════════════════════════════════╗
║ DATABASE "cidram"                            ║
║ │╔═══════════════════════════════════════════╩═════╗
║ └╫─TABLE "Cache" (UTF-8)                           ║
║  ╠═╪═FIELD══CHARSET═DATATYPE═════KEY══NULL═DEFAULT═╣
║  ║ ├─"Key"──UTF-8───VARCHAR(128)─PRI──×────×       ║
║  ║ ├─"Data"─UTF-8───TEXT─────────×────×────×       ║
╚══╣ └─"Time"─×───────INT(>=10)────×────×────×       ║
   ╚═════════════════════════════════════════════════╝
```

Директива конфигурации CIDRAM `pdo_dsn` должна быть настроена, как описано ниже.

```
Согласно базе данных драйвер используется...
├─4d (Предупреждение: экспериментально, не проверено, не рекомендуется!)
│ │
│ │         ╔═══════╗
│ └─4D:host=localhost;charset=UTF-8
│           ╚╤══════╝
│            └Хост, с которым нужно связаться, чтобы найти базу данных.
├─cubrid
│ │
│ │             ╔═══════╗      ╔═══╗        ╔═════╗
│ └─cubrid:host=localhost;port=33000;dbname=example
│               ╚╤══════╝      ╚╤══╝        ╚╤════╝
│                │              │            └Имя базы данных для
│                │              │             использования.
│                │              │
│                │              └Номер порта для подключения к хосту.
│                │
│                └Хост, с которым нужно связаться, чтобы найти базу данных.
├─dblib
│ │
│ │ ╔═══╗      ╔═══════╗        ╔═════╗
│ └─dblib:host=localhost;dbname=example
│   ╚╤══╝      ╚╤══════╝        ╚╤════╝
│    │          │                └Имя базы данных для использования.
│    │          │
│    │          └Хост, с которым нужно связаться, чтобы найти базу данных.
│    │
│    └Возможные значения: «mssql», «sybase», «dblib».
├─firebird
│ │
│ │                 ╔═══════════════════╗
│ └─firebird:dbname=/path/to/database.fdb
│                   ╚╤══════════════════╝
│                    ├Может быть путем к файлу локальной базы данных.
│                    │
│                    ├Может соединиться с хостом и номером порта.
│                    │
│                    └Вам следует обратиться к документации Firebird, если вы
│                     хотите использовать это.
├─ibm
│ │
│ │         ╔═════╗
│ └─ibm:DSN=example
│           ╚╤════╝
│            └Каталогизированная база данных для связи.
├─informix
│ │
│ │              ╔═════╗
│ └─informix:DSN=example
│                ╚╤════╝
│                 └Каталогизированная база данных для связи.
├─mysql (Наиболее рекомендуется!)
│ │
│ │              ╔═════╗      ╔═══════╗      ╔══╗
│ └─mysql:dbname=example;host=localhost;port=3306
│                ╚╤════╝      ╚╤══════╝      ╚╤═╝
│                 │            │              └Номер порта для подключения к
│                 │            │               хосту.
│                 │            │
│                 │            └Хост, с которым нужно связаться, чтобы найти
│                 │             базу данных.
│                 │
│                 └Имя базы данных для использования.
├─oci
│ │
│ │            ╔═════╗
│ └─oci:dbname=example
│              ╚╤════╝
│               ├Может ссылаться на конкретную каталогизированную базу данных.
│               │
│               ├Может соединиться с хостом и номером порта.
│               │
│               └Вам следует обратиться к документации Oracle, если хотите
│                использовать это.
├─odbc
│ │
│ │      ╔═════╗
│ └─odbc:example
│        ╚╤════╝
│         ├Может ссылаться на конкретную каталогизированную базу данных.
│         │
│         ├Может соединиться с хостом и номером порта.
│         │
│         └Вам следует обратиться к документации ODBC/DB2, если хотите
│          использовать это.
├─pgsql
│ │
│ │            ╔═══════╗      ╔══╗        ╔═════╗
│ └─pgsql:host=localhost;port=5432;dbname=example
│              ╚╤══════╝      ╚╤═╝        ╚╤════╝
│               │              │           └Имя базы данных для использования.
│               │              │
│               │              └Номер порта для подключения к хосту.
│               │
│               └Хост, с которым нужно связаться, чтобы найти базу данных.
├─sqlite
│ │
│ │        ╔════════╗
│ └─sqlite:example.db
│          ╚╤═══════╝
│           └Путь к файлу локальной базы данных для использования.
└─sqlsrv
  │
  │               ╔═══════╗ ╔══╗          ╔═════╗
  └─sqlsrv:Server=localhost,1521;Database=example
                  ╚╤══════╝ ╚╤═╝          ╚╤════╝
                   │         │             └Имя базы данных для использования.
                   │         │
                   │         └Номер порта для подключения к хосту.
                   │
                   └Хост, с которым нужно связаться, чтобы найти базу данных.
```

Если не уверены, что использовать для какой-либо конкретной части вашего DSN, попробуйте сначала выяснить, работает ли она как есть, ничего не меняя.

Обратите внимание, что `pdo_username` и `pdo_password` должны совпадать с именем пользователя и паролем, которые Вы выбрали для своей базы данных.

#### <a name="BLOCK_CRON"></a>CIDRAM блокирует cronjobs; Как это исправить?

Если Вы используете выделенный файл для целей cronjobs и если этот файл не нужно вызывать во время обычных пользовательских запросов (т.е., вне контекста cronjobs), убедиться, что CIDRAM вообще не выполняется во время ваших cronjobs (т.е., не подключайте CIDRAM к файлу, ответственному за обработку ваших cronjobs) – Это самый простой способ исправить это.

В качестве альтернативы, если это невозможно, но IP-адрес вашего сервера cron является относительно последовательным и предсказуемым, Вы можете попробовать занести в белый список IP-адрес вашего сервера cron, например, путем создания сигнатуры в индивидуальный файле сигнатуры, или путем создания вспомогательного правила. Если IP-адрес вашего сервера cron регулярно вращается и не особенно предсказуемо, но тем не менее остается внутри той же конкретной сети, Вы можете попробовать указать в своем файле `ignore.dat` имя раздела сигнатуры, ответственного за его блокировку.

Если Вы попробовали все эти идеи и ни одна из них не сработала для вас, или если вам нужна помощь, чтобы выяснить, как это сделать, Вы можете создать новую issue на странице issues CIDRAM, чтобы попросить о помощи.

---


### 9. <a name="SECTION9"></a>ЛЕГАЛЬНАЯ ИНФОРМАЦИЯ

#### 9.0 ПРЕАМБУЛА РАЗДЕЛА

Этот раздел документации предназначен для описания возможных юридических соображений, касающихся использования и имплементации пакета, и предоставления некоторой базовой связанной информации. Это может быть важно для некоторых пользователей в качестве средства обеспечения соответствия любым юридическим требованиям, которые могут существовать в странах, в которых они работают, и некоторым пользователям, возможно, придется корректировать свои политики веб-сайта в соответствии с этой информацией.

Прежде всего, поймите, что я (автор пакета) не квалифицированный юрист любого рода. Поэтому я не имею юридической силы для предоставления юридических консультаций. Кроме того, в некоторых случаях, точные законодательные требования могут различаться между различными странами и юрисдикциями, и эти различные юридические требования могут иногда противоречить (таких как, например, в случае стран, которые поддерживают права на [неприкосновенность частной жизни](https://ru.wikipedia.org/wiki/%D0%9D%D0%B5%D0%BF%D1%80%D0%B8%D0%BA%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%B5%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D1%8C_%D1%87%D0%B0%D1%81%D1%82%D0%BD%D0%BE%D0%B9_%D0%B6%D0%B8%D0%B7%D0%BD%D0%B8), и [право быть забытым](https://ru.wikipedia.org/wiki/%D0%9F%D1%80%D0%B0%D0%B2%D0%BE_%D0%BD%D0%B0_%D0%B7%D0%B0%D0%B1%D0%B2%D0%B5%D0%BD%D0%B8%D0%B5), по сравнению с странами, которые предпочитают [расширенное хранение данных](https://ru.wikipedia.org/wiki/%D0%97%D0%B0%D0%BA%D0%BE%D0%BD_%D0%AF%D1%80%D0%BE%D0%B2%D0%BE%D0%B9)). Учтите также, что доступ к пакету не ограничивается конкретными странами или юрисдикциями, и, следовательно, пользовательская база пакетов, вероятно, будет географически разнообразной. При рассмотрении этих вопросов, я не в состоянии заявить, что это означает быть «юридически совместимым» для всех пользователей, во всех отношениях. Однако я надеюсь, что приведенная здесь информация поможет вам самим принять решение о том, что вы должны сделать, чтобы оставаться юридически совместимым в контексте пакета. Если у вас есть какие-либо сомнения относительно информации, или если вам нужна дополнительная помощь и рекомендации с юридической точки зрения, Я бы рекомендовал обратиться к квалифицированному юристу.

#### 9.1 ОТВЕТСТВЕННОСТЬ

В соответствии с уже заявленной лицензией на пакет, пакет предоставляется без каких-либо гарантий. Это включает (но не ограничивается) всю сферу ответственности. Пакет предоставляется вам для вашего удобства, в надежде, что он будет полезен, и что он принесет вам определенную пользу. Однако, независимо от того, используете ли вы или реализуете пакет, это ваш собственный выбор. Вы не обязаны использовать или внедрять пакет, но когда вы это делаете, вы несете ответственность за это решение. Ни я, ни другие участники пакета не несут юридическую ответственность за последствия решений, которые вы принимаете, независимо от того, являются ли они прямыми, косвенными, подразумеваемыми или нет.

#### 9.2 ТРЕТЬИ ЛИЦА

В зависимости от его точной конфигурации и имплементации пакет может передавать и обмениваться информацией с третьими лицами в некоторых случаях. Эта информация может быть определена как «[персональные данные](https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D1%80%D1%81%D0%BE%D0%BD%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D0%B5)» (PII/ПИИ) в некоторых контекстах, в некоторых юрисдикциях.

Как эта информация может использоваться этими третьими лицами, зависит от различных политик, установленных этими третьими лицами, и выходит за рамки этой документации. Однако, во всех таких случаях обмен информацией с этими третьими лицами может быть отключен. Во всех таких случаях, если вы решите включить его, вы несете ответственность за исследование любых проблем, которые могут возникнуть в отношении конфиденциальности, безопасности и использования PII/ПИИ этими третьими лицами. Если существуют какие-либо сомнения, или если вы неудовлетворены действиями этих третьих сторон в отношении PII/ПИИ, лучше всего отключить весь обмен информацией с этими третьими лицами.

В целях прозрачности тип информации, совместно используемой, и с кем, описан ниже.

##### 9.2.0 ПОИСК ИМЯ ХОСТА

Если вы используете какие-либо функции или модули, предназначенные для работы с именами хостов (например, "модуль блокатор для плохие хосты", "tor project exit nodes block module", или "проверка поисковой системы"), CIDRAM должен иметь возможность получить имя хоста входящих запросов. Как правило, он делает это, запрашивая имя хоста IP-адреса входящих запросов с DNS-сервера, или путем запроса информации через функциональные возможности, предоставляемые системой, где установлен CIDRAM (это обычно называют «поиском имени хоста»). DNS-серверы, определенные по умолчанию, принадлежат службе [Google DNS](https://dns.google.com/) (но это можно легко изменить с помощью конфигурации). Точные услуги, которые связаны с, зависят от конфигурации (это можно легко отрегулировать). В случае использования функциональных возможностей, предоставляемых системой, где установлен CIDRAM, вам необходимо обратиться к системному администратору, чтобы определить, какие поисковые запросы маршрутов используются. Поиск имени хоста можно предотвратить в CIDRAM, избегая затронутых модулей, или изменяя конфигурацию пакета в соответствии с вашими потребностями.

*Соответствующие директивы конфигурации:*
- `general` -> `allow_gethostbyaddr_lookup`
- `general` -> `default_dns`
- `general` -> `force_hostname_lookup`
- `verification` -> `other`
- `verification` -> `search_engines`
- `verification` -> `social_media`

##### 9.2.1 ПРОВЕРКА ПОИСКОВЫХ СИСТЕМ И СОЦИАЛЬНЫХ СЕТЕЙ

Когда проверка поисковых систем включена, CIDRAM пытается выполнить «переадресацию DNS-запросов», чтобы проверить, являются ли запросы, утверждающие, что они происходят из поисковых систем, являются подлинными. По аналогии, когда включена проверка социальных сетей, CIDRAM делает то же самое для кажущихся запросов социальных сетях. Для этого он использует службу [Google DNS](https://dns.google.com/) для попытки разрешить IP-адреса из имен хостов этих входящих запросов (в этом процессе имена хостов этих запросов совместно используются службой).

*Соответствующие директивы конфигурации:*
- `verification` -> `other`
- `verification` -> `search_engines`
- `verification` -> `social_media`

##### 9.2.2 CAPTCHA

CIDRAM поддерживает CAPTCHA. Для правильной работы им требуются ключи API. Стандартно они отключены, но их можно включить, настроив необходимые ключи API. При включении может происходить обмен данными между службой и CIDRAM или браузером пользователя. Это может потенциально включать передачу информации, такой как IP-адрес пользователя, пользовательский агент, операционная система, и другие детали, доступные для запроса.

##### 9.2.3 STOP FORUM SPAM

[Stop Forum Spam](https://www.stopforumspam.com/) – Это фантастический бесплатный сервис, который может помочь защитить форумы, блоги и веб-сайты от спамеров. Он делает это, предоставляя базу данных известных спамеров и API, который может быть использован для проверки того, указан ли IP-адрес, имя пользователя или адрес электронной почты в его базе данных.

CIDRAM предоставляет необязательный модуль, который использует этот API для проверки того, принадлежит ли IP-адрес входящих запросов к подозреваемому спамеру. Когда модуль установлен и активирован, пользовательские IP-адреса могут использоваться совместно с сервисом в соответствии с конфигурацией и назначением модуля.

##### 9.2.4 ABUSEIPDB

CIDRAM предоставляет необязательный модуль для блокировки оскорбительный IP-адресов с помощью API [AbuseIPDB](https://www.abuseipdb.com/). Когда модуль установлен и активирован, пользовательские IP-адреса могут использоваться совместно с сервисом в соответствии с конфигурацией и назначением модуля.

##### 9.2.5 BGPVIEW, IP-API

CIDRAM предоставляет дополнительные модули для выполнения поиска ASN и кода страны с помощью [BGPView](https://bgpview.io/) API и [IP-API](https://ip-api.com/) API. Эти поиски предоставляют возможность блокировать или вносить в белый список запросы на основе их ASN или страны происхождения. Когда один из них установлен и активирован, пользовательские IP-адреса могут использоваться совместно с сервисом в соответствии с конфигурацией и назначением модуля.

##### 9.2.6 PROJECT HONEYPOT

CIDRAM предоставляет необязательный модуль для блокировки оскорбительный IP-адресов с помощью API [Project Honeypot](https://www.projecthoneypot.org/). Когда модуль установлен и активирован, пользовательские IP-адреса могут использоваться совместно с сервисом в соответствии с конфигурацией и назначением модуля.

#### 9.3 ЖУРНАЛОВ

Журналов (альтернативно: регистрация, логгинг) – Это важная часть CIDRAM по ряду причин. Может быть трудно диагностировать и разрешать ложные-срабатывания, когда события блока, вызывающие их, не регистрируются. Без регистрируются событий блока может быть трудно точно определить, насколько эффективная CIDRAM в любом конкретном контексте, и может быть трудно определить, где его недостатки могут быть, и какие изменения могут потребоваться для его конфигурации или сигнатуры соответственно, чтобы он продолжал функционировать по назначению. Несмотря на это, регистрация может быть нежелательна для всех пользователей и остается полностью необязательной. В CIDRAM регистрация по умолчанию отключена. Чтобы включить его, CIDRAM должен быть настроен соответствующим образом.

Дополнительно, ли ведение журнала разрешено законом, и в какой степени (например, типы информации, которые могут быть зарегистрированы, как долго, и при каких обстоятельствах), может варьироваться в зависимости от юрисдикции и контекста, в котором реализуется CIDRAM (например, если вы работаете как индивидуальный лицо, корпоративный лицо, если вы работаете на коммерческой или некоммерческой основе). Поэтому это может быть полезно для вас внимательно прочитать этот раздел.

CIDRAM может выполнять несколько типов ведения журнала. Различные типы ведения журнала включают различные типы информации по разным причинам.

##### 9.3.0 БЛОКИРОВАТЬ СОБЫТИЯ

Основной тип ведения журнала, который может выполнять CIDRAM, относится к «блочным событиям». Этот тип ведения журнала относится к тому, когда CIDRAM блокирует запрос, и может предоставляться в трех разных форматах:
- Человекочитаемые лог-файлы.
- Лог-файлы в стиле Apache.
- Сериализованные лог-файлы.

Событие блока, записанное в человекочитаемые лог-файлы, обычно выглядит примерно так (в качестве примера):

```
ИД: 1234
Скрипт версия: CIDRAM v1.6.0
Дата/Время: Day, dd Mon 20xx hh:ii:ss +0000
IP-адрес: x.x.x.x
Имя хоста: dns.hostname.tld
Количество сигнатурей: 1
Идентификаторы для сигнатурей: x.x.x.x/xx
Почему Заблокированные: Облачный сервис ("Имя Сети", Lxx:Fx, [XX])!
Пользовательский агент: Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.181 Safari/537.36
Реконструированный URI: https://your-site.tld/index.php
Статус CAPTCHA: Включается.
```

Это же событие блока, записанное в лог-файл в стиле Apache, будет выглядеть примерно так:

```
x.x.x.x - - [Day, dd Mon 20xx hh:ii:ss +0000] "GET /index.php HTTP/1.1" 200 xxxx "-" "Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.181 Safari/537.36"
```

Зарегистрированное событие блокировки обычно включает следующую информацию:
- Идентификационный номер, ссылающийся на событие блока.
- Версия используемой CIDRAM.
- Дата и время, когда произошло событие блока.
- IP-адрес заблокированного запроса.
- Имя хоста IP-адреса заблокированного запроса (если доступно).
- Количество сигнатурей, вызванных запросом.
- Ссылки на сигнатуры срабатывают.
- Ссылки на причины блочного события и некоторые основные связанные данные об отладке.
- Пользовательский агент заблокированного запроса (как запрашивающий объект идентифицировал себя с запросом).
- Реконструкция идентификатора запрашиваемого ресурса.
- Состояние CAPTCHA для текущего запроса (при необходимости).

*Директивы конфигурации, отвечающие за этот тип ведения журнала, и для каждого из трех доступных форматов:*
- `logging` -> `apache_style_log`
- `logging` -> `serialised_log`
- `logging` -> `standard_log`

Когда эти директивы остаются пустыми, этот тип ведения журнала останется отключенным.

##### 9.3.1 CAPTCHA ЖУРНАЛОВ

Этот тип ведения журнала относится конкретно к экземплярам CAPTCHA и возникает только тогда, когда пользователь пытается завершить экземпляр CAPTCHA.

Запись журнала CAPTCHA содержит IP-адрес пользователя, пытающегося выполнить экземпляр CAPTCHA, дату и время, в которое произошла попытка, и состояние CAPTCHA. Запись журнала CAPTCHA обычно выглядит примерно так (в качестве примера):

```
IP-адрес: x.x.x.x - Дата/Время: Day, dd Mon 20xx hh:ii:ss +0000 - Статус CAPTCHA: Успех!
```

*Директива конфигурации, ответственная за ведение журнала CAPTCHA:*
- `captcha` -> `log`

##### 9.3.2 ФРОНТЕНД ЖУРНАЛОВ

Этот тип ведения журнала связан с попытками входа в фронтенд и возникает только тогда, когда пользователь пытается войти в фронтенд (при условии, что фронтенд включен).

Эти записи журнала содержат IP-адрес пользователя, пытающегося войти в систему, дату и время совершения попытки, и результаты попытки (успешно вошел в систему или не смог войти в систему). Обычно они выглядят примерно так (в качестве примера):

```
x.x.x.x - Day, dd Mon 20xx hh:ii:ss +0000 - "admin" - Вошли в систему.
```

*Соответствующие директивы конфигурации:*
- `frontend` -> `frontend_log`

##### 9.3.3 ВРАЩЕНИЕ ЖУРНАЛА

Возможно, вы захотите очистить журналы через определенный промежуток времени или, возможно, потребуется сделать это по закону (то есть, количество времени, которое законно допустимо для вас сохранять журналы, может быть ограничено законом). Вы можете достичь этого, включив маркеры даты/времени в имена ваших файлов журналов в соответствии с настройками вашего пакета (например, `{yyyy}-{mm}-{dd}.log`), и затем разрешить вращение журнала (поворот журнала позволяет выполнять некоторые действия на лог-файлах при превышении указанных пределов).

Например: Если мне было необходимо закончить журналы через 30 дней, я мог бы указать `{dd}.log` в именах моих лог-файлов (`{dd}` представляет дни), установить значение `log_rotation_limit` в 30, и установить значение `log_rotation_action` в `Delete`.

И наоборот, если вам необходимо сохранять журналы в течение длительного периода времени, вы можете либо не использовать поворот журнала вообще, либо вы можете установить значение `log_rotation_action` в `Archive`, чтобы сжать лог-файлы, тем самым уменьшив общий объем занимаемого ими дискового пространства.

*Соответствующие директивы конфигурации:*
- `logging` -> `log_rotation_action`
- `logging` -> `log_rotation_limit`

##### 9.3.4 УСЕЧЕНИЕ ЖУРНАЛА

Также возможно обрезать отдельные лог-файлы, если они превышают определенный размер, если это то, что вы хотите/нуждаетесь сделать.

*Соответствующие директивы конфигурации:*
- `logging` -> `truncate`

##### 9.3.5 ПСЕВДОНИМИЗАЦИЯ IP-АДРЕСА

Во-первых, если вы не знакомы с термином, «псевдонимизация» относится к обработке персональных данных таким образом, что она не может быть идентифицирована ни с каким конкретным объектом данных без дополнительной информации, и при условии, что такая дополнительная информация поддерживается отдельно и подлежит техническим и организационным мерам для обеспечения того, чтобы личные данные не могли быть идентифицированы ни одному физическому лицу.

В некоторых случаях вам может быть юридически требуется анонимизировать или псевдонимизировать любого PII/ПИИ, собранного, обработанного, или сохраненного. Хотя эта концепция существует уже довольно давно, GDPR/DSGVO особенно упоминает и специально поощряет «псевдонимизация».

CIDRAM может псевдонимизировать IP-адреса при входе в журналы, если это то, что вы хотите/нуждаетесь сделать. Когда CIDRAM псевдонимизирует IP-адреса, при входе в журналы, окончательный октет адресов IPv4, и все после второй части адресов IPv6 представлено символом «x» (эффективно округляя адреса IPv4 до начального адреса 24-й подсети, в которую они входят, и адреса IPv6 на начальный адрес 32-й подсети, в которую они входят).

*Заметка: Процесс псевдонимизации IP-адреса в CIDRAM не влияет на функцию отслеживания IP-адресов в CIDRAM. Если это проблема для вас, лучше всего отключить IP-отслеживание.*

*Соответствующие директивы конфигурации:*
- `legal` -> `pseudonymise_ip_addresses`

##### 9.3.6 ОПУСКАЯ ИНФОРМАЦИЮ ЖУРНАЛА

Если хотите сделать еще один шаг, не позволяя полностью регистрировать определенные типы информации, это также можно сделать. На странице конфигурации обратитесь к директиве конфигурации `fields`, чтобы контролировать, какие поля будут отображаться в записях журнала и на странице «Доступ Закрыт».

![fields](https://raw.githubusercontent.com/CIDRAM/Docs/master/assets/fields.png)

*Заметка: Нет никаких оснований для псевдонимизировать IP-адресов при полном исключении их из журналов.*

*Соответствующие директивы конфигурации:*
- `general` -> `fields`

##### 9.3.7 СТАТИСТИКА

CIDRAM необязательно может отслеживать статистику, такую как общее количество событий блока или экземпляров CAPTCHA, которые произошли с определенного момента времени. Эта функция отключена по умолчанию, но можно включить с помощью конфигурации пакета. Эта функция отслеживает только общее количество произошедших событий и не содержит никакой информации о конкретных событиях (и поэтому не следует рассматривать как PII/ПИИ).

*Соответствующие директивы конфигурации:*
- `general` -> `statistics`

##### 9.3.8 ШИФРОВАНИЕ

CIDRAM не шифрует свой кэш или какую-либо информацию журнала. [Шифрование](https://ru.wikipedia.org/wiki/%D0%A8%D0%B8%D1%84%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5) кэша и журналов могут быть введены в будущем, но в настоящее время нет конкретных планов. Если вы обеспокоены тем, что несанкционированные сторонние лица получают доступ к частям CIDRAM, которые могут содержать PII/ПИИ или конфиденциальную информацию, такую как ее кэш или журналы, я бы рекомендовал, чтобы CIDRAM не был установлен в общедоступном месте (например, установить CIDRAM за пределами стандартного каталога `public_html` или его эквивалента, доступного большинству стандартных веб-серверов) и я рекомендую применять соответствующие ограничительные разрешения для каталога установки (в частности, для каталога «vault»). Если этого недостаточно для решения ваших проблем, настройте CIDRAM таким образом, чтобы типы информации, вызывающие ваши проблемы, не собирались или не регистрировались в первую очередь (например, путем отключения ведения журнала).

#### 9.4 КУКИ

CIDRAM устанавливает файлы [куки](https://ru.wikipedia.org/wiki/Cookie) в двух точках своей кодовой базы. Во-первых, в зависимости от настроек `lockto`, CIDRAM может установить cookie-файл чтобы запомнить когда пользователь прошел проверку CAPTCHA. Во-вторых, когда пользователь успешно входит в фронтенд, CIDRAM устанавливает куки, чтобы иметь возможность запоминать пользователя для последующих запросов (то есть, куки используются для аутентификации пользователя в сеансе фронтенд).

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

*Заметка: «Невидимые» CAPTCHA API могут быть несовместимы с законами о файлах куки в некоторых юрисдикциях, и следует избегать на любых сайтах, на которые распространяются такие законы. Может быть предпочтительнее использовать вместо этого другие предоставленные API, или просто полностью отключить CAPTCHA.*

*Соответствующие директивы конфигурации:*
- `captcha` -> `lockto`
- `captcha` -> `api`

#### 9.5 МАРКЕТИНГ И РЕКЛАМА

CIDRAM не собирает и не обрабатывает какую-либо информацию для маркетинговых или рекламных целей и не продает и не получает прибыль от любой собранной или занесенной в журнал информации. CIDRAM не коммерческим предприятием и не имеет отношения к каким-либо коммерческим интересам, поэтому делать это не имеет смысла. Это имело место с самого начала проекта и по-прежнему имеет место сегодня. Кроме того, делать эти вещи было бы контрпродуктивным для духа и намеченной цели проекта в целом, и до тех пор, пока я продолжаю поддерживать проект, никогда не произойдет.

#### 9.6 ПОЛИТИКА КОНФИДЕНЦИАЛЬНОСТИ

В некоторых случаях вам может быть юридически необходимо четко отображать ссылку на вашу политику конфиденциальности на всех страницах и разделах вашего сайта. Это может быть важно как средство обеспечения того, чтобы пользователи были хорошо информированы о ваших точных правилах конфиденциальности, типах PII/ПИИ, которые вы собираете, и о том, как вы собираетесь их использовать. Чтобы иметь возможность включить такую ссылку на странице CIDRAM «Доступ Закрыт», предоставляется директива конфигурации для указания URL-адреса вашей политики конфиденциальности.

*Заметка: Настоятельно рекомендуется, чтобы страница политики конфиденциальности не была помещена за защитой CIDRAM. Если CIDRAM защищает вашу страницу политики конфиденциальности, а пользователь, заблокированный CIDRAM, нажимает ссылку на вашу политику конфиденциальности, они будут снова заблокированы и не смогут увидеть вашу политику конфиденциальности. В идеале вы должны ссылаться на статическую копию вашей политики конфиденциальности, такую как HTML-страница или текстовый файл, который не защищен CIDRAM.*

*Соответствующие директивы конфигурации:*
- `legal` -> `privacy_policy`

#### 9.7 GDPR/DSGVO

«Общее Регулирование Защиты Данных» – Это регламент Европейского Союза, который вступает в силу с 25 Мая 2018 года. Основная цель регулирования – Дать контроль гражданам и жителям ЕС в отношении их личных данных, и унифицировать регулирование в ЕС относительно конфиденциальности и личных данных.

Регулирование содержит конкретные положения, касающиеся обработки «[личной идентифицируемой информации](https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D1%80%D1%81%D0%BE%D0%BD%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D0%B5)» (PII/ПИИ) любых «субъектов данных», (любое идентифицированное или идентифицируемое физическое лицо) из или в пределах ЕС. Чтобы соответствовать регулированию, «предприятия» (согласно определению, указанным в регулирование), и любые соответствующие системы и процессы должны реализовать «конфиденциальность по дизайну» по умолчанию, должны использовать максимально возможные настройки конфиденциальности, должны обеспечивать необходимые гарантии для любой сохраненной или обработанной информации (включая, но не ограничиваясь, внедрение псевдонимизированный или полную анонимизированный данных), должны четко и недвусмысленно объявлять типы собираемых ими данных, как они обрабатывают его, по каким причинам, как долго они его сохраняют, и делится ли они этими данными с любыми третьими лицами, типами данных, совместно используемыми с третьими лицами, как, почему, и т.д.

Данные не могут быть обработаны, если нет законных оснований для этого, в соответствии с определением правила. Как правило, это означает, что для обработки данных субъекта данных на законной основе, это должно выполняться в соответствии с юридическими обязательствами, или только после того, как явное, хорошо информированное, однозначное согласие было получено от субъекта данных.

Поскольку аспекты регулирования могут развиваться во времени, чтобы избежать распространения устаревшей информации, лучше узнать о регулировании из авторитетного источника, а не просто включать соответствующую информацию в документацию к пакету (которые в конечном итоге могут устареть, поскольку регулирование развивается).

Некоторые рекомендуемые ресурсы для получения дополнительной информации:
- [Новый европейский регламент по защите данных – последствия для российских организаций](https://www.buzko.legal/content-ru/general-data-protection-regulation)
- [GDPR — новые правила обработки персональных данных в Европе для международного IT-рынка](https://habr.com/company/digitalrightscenter/blog/344064/)
- [Общий регламент по защите данных](https://ru.wikipedia.org/wiki/%D0%9E%D0%B1%D1%89%D0%B8%D0%B9_%D1%80%D0%B5%D0%B3%D0%BB%D0%B0%D0%BC%D0%B5%D0%BD%D1%82_%D0%BF%D0%BE_%D0%B7%D0%B0%D1%89%D0%B8%D1%82%D0%B5_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85)
- [REGULATION (EU) 2016/679 OF THE EUROPEAN PARLIAMENT AND OF THE COUNCIL](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=celex:32016R0679)

---


### 10. <a name="SECTION10"></a>ОБНОВЛЕНИЕ С ПРЕДЫДУЩИХ ОСНОВНЫХ ВЕРСИЙ

#### 10.0 Обновление до CIDRAM v3

Существуют значительные различия между v3 и предыдущими основными версиями. Как работают точки входа, как структурированы модули, и как работает средство обновления для v3, отличается от того, как все это работало в предыдущих основных версиях. Из-за этих различий лучший способ обновить предыдущие основные версии до v3 — выполнить новую установку.

Если хотите сохранить свою конфигурацию и вспомогательные правила, перед началом процесса обновления перейдите на страницу фронтенд резервного копирования. Оттуда можно экспортировать конфигурацию и вспомогательные правила. Экспорт приведет к загрузке файла. После обновления до новой основной версии этот файл можно использовать для импорта ранее экспортированных данных в установку.

Модули, предназначенные для предыдущих основных версий, должны быть переписаны, чтобы правильно работать в v3, из-за изменений в структуре модулей. Прямая миграция не работает. То же самое верно и для событий.

Структура файлов сигнатур не изменилась, поэтому файлы сигнатур, предназначенные для предыдущих основных версий, могут быть напрямую перенесены в v3 без каких-либо ожидаемых проблем.

Модули, файлы сигнатур и события имеют свои собственные выделенные каталоги, что является новым дополнением начиная с v3 (поэтому для v3 каждый из них будет заходить в свои соответствующие выделенные каталоги, а не в корень vault).

Некоторые файлы сигнатур, модули и списки блокировки, общедоступные для предыдущих основных версий, устарели, поэтому не все будет доступно для v3. В большинстве случаев они все равно не понадобятся из-за новых функций, добавленных с v3.

Есть некоторые тонкие изменения в том, как структурированы вспомогательные правила, и есть изменения в конфигурации, но если вы используете функцию импорта/экспорта на странице резервного копирования фронтэнда, вам не нужно будет вручную переписывать, настраивать или воссоздавать что-либо. При импорте CIDRAM знает, что нужно, и автоматически сделает это за вас.

Чтобы просмотреть список изменений внесенных в v3 (например, добавленные функции, удаленные функции, и т.д), обратитесь к [журналу изменений v3](https://github.com/CIDRAM/CIDRAM/blob/v3/Changelog.md#v300).

#### 10.1 Обновление до CIDRAM v4 с версии более ранней чем CIDRAM v3

См. выше: Рекомендуется новая установка.

#### 10.2 Обновление до CIDRAM v4 с CIDRAM v3

1. Сначала перейдите на страница обновлений фронтенда, и если есть какие-либо доступные обновления, обязательно установите их все. Это гарантирует что любой недавно написанный код, который может потребоваться для корректного обновления основных версий, будет доступен для обновления, а также помогает сократить объем работы которую придется выполнить обновителю при последующем обновлении основных версий.

2. Перейдите на страница конфигурации фронтенда и найдите __`frontend➡remotes`__. В списке, где вы видите `/v3/`, измените его на `/v4/`. Нажмите «Обновить» чтобы сохранить конфигурацию. Это изменение указывает программе обновления на необходимость ориентироваться на предполагаемую основную версию при поиске обновлений.

3. Перейдите на страницу резервного копирования фронтенда. Выберите экспорт, отметьте флажками конфигурацию, статистику, и вспомогательные правила, а затем нажмите «ОК» чтобы загрузить резервную копию. Произошли некоторые изменения. Например, действие «не регистрировать» было удалено из вспомогательных правил (вместо него можно использовать опцию «подавить ведение журнала» для достижения того же результата). После обновления вам потребуется импортировать эту резервную копию обратно в CIDRAM.

4. Вернитесь на страницу обновлений фронтенда. Теперь должны появиться обновления для новой основной версии. Чтобы избежать тайм-аутов, перед обновлением всех компонентов сначала попробуйте обновить только ядро или фронтенд CIDRAM (поскольку оба они взаимозависимы, обновление одного из них в любом случае должно автоматически обновить оба). Поскольку структура страницы и стили CSS для фронтенда существенно изменились между основными версиями, после обновления он может сначала показаться неисправным, но это не так. Перейдите на любую другую страницу фронтенда и нажмите Ctrl+F5 чтобы попытаться выполнить жесткое обновление (т.е., обновление, при котором браузер загружает новую копию стилей CSS и других периферийных элементов, а не использует свой кэш). После этого структура страницы и стили CSS должны отображаться правильно. Если этого не произошло, попробуйте очистить кэш браузера.

5. После этого вы можете обновить все остальное. Вернитесь на страницу обновлений фронтенда и, если вы видите кнопку в верхней части страницы, нажмите «Обновить все».

6. Чтобы убедиться в отсутствии каких-либо устаревших или текущих неудачных обновлений, а также поврежденных файлов в установке и убедиться, что все работает как надо, нажмите «Починить все». Реальная проблема может возникнуть крайне редко, но лучше перестраховаться.

7. Вернитесь на страницу резервного копирования фронтенда. Выберите импорт, отметьте флажками конфигурацию, статистику, и вспомогательные правила, нажмите кнопку чтобы выбрать файл, найдите и выберите ранее загруженную резервную копию, и нажмите «ОК» чтобы импортировать эту резервную копию. CIDRAM автоматически выполнит все необходимые корректировки для учета изменений.

8. На этом вы завершили обновление. Поскольку вы успешно обновили основные версии, вам возможно захочется вкратце изучить страницу конфигурации фронтенда, поскольку изменения внесенные новой основной версией (например, для ознакомления с новыми функциями). Новая основная версия не вносит никаких изменений в файлы сигнатур, модули, или события, поэтому вам не нужно беспокоиться об этом при обновлении.

Чтобы просмотреть список изменений внесенных в v4 (например, добавленные функции, удаленные функции, и т.д), обратитесь к [журналу изменений v4](https://github.com/CIDRAM/CIDRAM/blob/v4/Changelog.md#v400).

---


Последнее обновление: 6 Июня 2026 г (2026.06.06).