Версия 6 - это еще одно крупное изменение базовой функциональности дополнения, направленное на улучшение процесса отправки сообщений о вновь обнаруженных пользовательских агентах и повышение производительности.
Важно для пользователей версии 4: с этим выпуском я отказываюсь от API v1 - аддоны версий 4.x и более ранних продолжат функционировать некоторое время, но затем начнут возвращать коды ошибок 404, как только я отключу API версии v1. Все, кто все еще использует KnownBots версии 4.x, должны обновиться как можно скорее.
Важно для пользователей версии 5: API версии v2, используемый в аддоне v5.x для получения новых ботов, останется работоспособным, однако я отказываюсь от системы отправки сообщений по электронной почте в пользу новой системы отправки пользовательских агентов на основе API. По истечении переходного периода система входящей электронной почты будет отключена, и все электронные письма, отправленные на
knownbots@hampel.io адрес, будут возвращены как недоставленные. Любой, кто все еще использует KnownBots версии 5.x, должен либо обновить, либо, по крайней мере, отключить опцию "Агенты пользователей электронной почты" в настройках дополнения версии 5.x.
Важно для всех, кто переходит на версию 6: новая система отправки сообщений в версии 6 использует процесс аутентификации, чтобы гарантировать, что будут отправлены только действительные сообщения. После обновления до версии 6, чтобы продолжить отправку новых пользовательских агентов для анализа, необходимо сначала настроить систему аутентификации - это очень простой процесс - смотрите инструкции на странице дополнения. Параметры для версии 6 изменились - вы должны проверить их после обновления.
Новая система отправки в версии 6 использует API проверки подлинности клиентов XenForo для аутентификации сайтов при отправке агентов через наш новый API.
Чтобы настроить API, введите токен проверки лицензии для вашего сайта, найденный в клиентском интерфейсе XenForo. Токен проверки будет отправлен в API проверки клиента XenForo системой KnownBots, и если он действителен, будет сгенерирован токен KnownBots API и возвращен обратно на запрашивающий форум для последующей аутентификации.
При наличии подтвержденной лицензии процесс аутентификации происходит автоматически. Токены API обновляются каждые 28 дней и автоматически проходят повторную аутентификацию. Данные клиента автоматически удаляются из базы данных KnownBots после 30 дней бездействия (см. Информацию о конфиденциальности на главной странице дополнения). Повторное использование вашего токена проверки лицензии автоматически приведет к сбою повторной проверки API и удалению данных клиента - если только вы не настроите параметры дополнения заново с помощью нового токена проверки лицензии.
Список Изменений для версии 6:
- известен новый инструмент командной строки-bots:parse для анализа лог-файлов веб-сервера и отображения обнаруженных ботов
- известен новый инструмент командной строки-боты: отправить для отправки вновь обнаруженных пользовательских агентов в KnownBots API для анализа
- известен новый инструмент командной строки-боты: проверка токена для подтверждения успешной аутентификации токена API - и, при необходимости, повторной установки системой нового токена API, если срок его действия истек
- knownbots@hampel.io адрес электронной почты устарел и скоро будет удален - электронные письма больше не следует отправлять на этот адрес
- новая опция конфигурации для "Отправки пользовательских агентов через API", которая требует настройки путем ввода токена проверки лицензии XenForo. Новые агенты отправляются напрямую через api, а не по электронной почте
- опция "Агенты пользователей электронной почты" остается, но используется только для того, чтобы администраторы форума могли сами отправлять электронные письма, если захотят. При обновлении дополнения до версии 6 из этого параметра конфигурации удаляется любая ссылка на knownbots@hampel.io.
- теперь аддон использует версию v3 API выборки ботов, которая включает в себя новые функциональные возможности
- версия API bot fetch API остается работоспособной для сайтов, все еще использующих аддон версии 5.x
- версия API bot fetch API устарела и скоро перестанет функционировать - сайты, все еще использующие аддон версии 4.x, должны обновиться как можно скорее
- новая функциональность для дополнения - список игнорируемых строк на основе регулярных выражений для удаления из анализа искаженных или запутанных пользовательских агентов. Это также позволяет нам игнорировать пользовательские агенты, содержащие sql-инъекции и другие формы атак, которые обычно заполняют систему большим количеством уникальных пользовательских агентов за короткий промежуток времени.
- повышение производительности - мы больше не выполняем проверки в браузере или игнорируем пользовательские агенты пользователей, вошедших в систему. Мы предполагаем, что любой, кто вошел в систему с действительным идентификатором пользователя XenForo, использует действительный браузер. Обратите внимание, что обнаружение ботов все еще запущено, на всякий случай. Это значительно сокращает объем обработки, выполняемой аддоном для действительных пользователей.