Linkwarden - Discord Link Scanner Bot
Этот бот Discord, разработанный для личного использования и сообщества, повышает безопасность сервера за счет изучения ссылок, разделенных в каналах Discord. Он использует Virustotal API, WHOIS поиск, и сканирование urlscan.io для обеспечения всестороннего анализа в реальном времени, помогая поддерживать безопасную онлайн-среду для участников.
Функции
- Анализ ссылок в режиме реального времени : автоматически проверяет ссылки, используемые в Discord против базы данных Virustotal, выполняет поиск WHOIS и передает URL-адреса URLSCAN.IO для сканирования.
- Комплексные отчеты о безопасности : генерирует подробные отчеты, включая анализ Virustotal, детали регистрации доменов от WHOIS, а также снимки веб -страницы и понимание безопасности от urlscan.io.
- Гибкие режимы проверки : предлагает как краткий обзор (простой режим), так и подробные отчеты (подробный режим) в соответствии с различными пользовательскими предпочтениями.
- Простота использования : бот внедрит скриншот ссылки, отправленной для проверки прямо в чате в обоих режимах сканирования, простых или подробных.
- Автоматическое сканирование ссылок : бот будет искать ссылки, отправляемые через сервер, и автоматически сканируют их, если они не из доверенного домена.
- Настраиваемый список достоверных доменов - с добавлением
trusted_domains.json вы можете настроить, какие домены следует отсканировать. - Команда конкретной роли - бот не выполняет пользователей команд, которые не имеют конкретной роли, указанной в файле
config.py . - Источник ссылки - бот внедрит ссылку на сообщение, где была найдена отсканированная ссылка при облегчении модерации.
- История ссылок - боты регистрирует все ссылки, которые отправляются для сканирования, и сохраняют их для будущей ссылки
- Настраиваемое состояние - встроенные встроенные сообщения о состоянии статуса.
- Чистая консоль - пользовательские печатные сообщения для каждого действия и взаимодействия с ботом.
☕ Поддержите мою работу на KO-Fi
Начиная
Прежде чем вы сможете использовать бот, вам нужно будет настроить его с помощью сервера Discord и настроить его с помощью клавиш API.
Предварительные условия
- Учетная запись Discord с административными привилегиями на вашем сервере.
- Python 3.6 или выше.
- Ключи API для virustotal и urlscan.io (доступны на их соответствующих веб -сайтах).
Присоединяйтесь к моему серверу Discord
Установка
- Клонировать этот репозиторий на местную машину.
- Установите требуемые зависимости, выполнив
pip install -r requirements.txt . - Создайте файл
config.py в том же каталоге, что и ваш скрипт бота (или используйте предварительный файл config.py ''), и добавьте свой токен бота, вирустотальный API, ключ API urlscan.io, идентификатор гильдии, идентификатор модератора и идентификатор канала, где вы хотите вывод автоматического канала, чтобы перейти в следующем формате: идентификатор канала, где вы хотите вывод автоматического канала Scans в следующем формате: идентификатор канала.
TOKEN = 'your_discord_bot_token_here'
VIRUSTOTAL_API_KEY = 'your_virustotal_api_key_here'
URLSCAN_API_KEY = 'your_urlscan_io_api_key_here'
guild_ids = [ your_guild_id_here ]
SCAN_CHANNEL_ID = CHANNEL_WHERE_SCANS_SHOULD_GO
ALLOWED_ROLE_IDS = [ MOD_ROLE_ID_GOES_HERE ]
- Запустить
main.py
Зависимости
Этот бот требует следующих пакетов Python:
- пирог
- запросы
- Python, который они могут быть установлены с помощью PIP:
pip install py - cord requests python - whois
Или вы можете установить их, используя файл Telect.txt.
pip install - r requirements . txt
Использование
Бот прост в использовании с простой командной структурой. Он поддерживает следующую команду:
Структура команды
/checklink [LINK] [MODE]
- Простой режим : предоставляет удобную резюме, включая статус безопасности ссылки, резюме регистрации домена WHOIS, и ссылку на отчет urlscan.io.
/checklink https://example.com simple
- Подробный режим : предлагает исчерпывающий отчет с оценками поставщика от virustotal, подробной информации о WHOIS, и отчет о комплексной безопасности от urlscan.io.
/checklink https://example.com detailed
- История : выводит простой список прошлых ссылок, которые использовались для сканирования и отслеживают, сколько раз была замечена каждая ссылка.
/checklhistory
Режимы объяснены
- Simple : отображает краткое встроенное с 10 лучшими предупреждениями от virustotal, сводкой информации о WHOIS и ссылкой на отчет urlscan.io.
- Подробно : представляет собой всеобъемлющий отчет, отмечающий каждого поставщика с цветовой точкой в соответствии с легендой ниже, наряду с подробной информацией WHOIS и отчетом о безопасности urlscan.io.
Статусные точки легенды
- Безвредный:?
- Злоучредитель:?
- Подозрительный: ?
- Не обнаружен: ⚪
Будущие улучшения
- Интеграция на панели панели : разработка веб-панели мониторинга, которая предоставляет обзор прошлых сканирований, включая подробные результаты и статистику. Эта панель инструментов предложит представление о типах ссылок, используемых на сервере, и эффективности бота в определении угроз, повышении прозрачности и доверия к возможностям бота.
- Дополнительные интеграции сканирования : расширить возможности сканирования бота, интегрируя дополнительные инструменты и услуги безопасности. Это расширение обеспечит более комплексный охват и защиту от более широкого спектра онлайн -угроз.
- Система обратной связи с пользователями : внедрить систему для пользователей для предоставления отзывов о результатах сканирования, таких как отчетность ложных срабатываний или пропущенные угрозы. Этот цикл обратной связи поможет повысить точность и эффективность бота с течением времени.
Внося
- Ваши вклад приветствуются! Будь то добавление новых функций, улучшение документации или отчеты об ошибках, пожалуйста, не стесняйтесь раскошелиться на этот репозиторий и отправить запрос на вытяжение.
Участники
- Cazaira - помог уточнить и сделать файл
trusted_domains.json сильнее против ложных срабатываний. - Nitrrine - обнаружил критическую ошибку, которая привела к сбою бота по определенным ссылкам.
Лицензия
Этот проект открыт по лицензии MIT.
