LinkWarden Bot

Linkwarden - Discord Link Scanner Bot

Ce bot Discord, conçu pour une utilisation personnelle et communautaire, améliore la sécurité du serveur en examinant les liens partagés dans les canaux Discord. Il tire parti de l'API Virustotal, des recherches WHOIS et des analyses URLScan.io pour fournir une analyse complète en temps réel, aidant à maintenir un environnement en ligne sûr pour les membres.

Caractéristiques

• Analyse des liens en temps réel : vérifie automatiquement les liens partagés dans Discord contre la base de données Virustotal, effectue des recherches WHOIS et soumet URL à URLScan.io pour la numérisation.
• Rapports de sécurité complets : génère des rapports détaillés, notamment l'analyse de Virustotal, les détails d'enregistrement du domaine de WHOIS et les instantanés de page Web et les informations de sécurité de URLScan.io.
• Modes de vérification flexibles : offre à la fois un aperçu concis (mode simple) et des rapports détaillés (mode détaillé) pour s'adapter aux différentes préférences des utilisateurs.
• Facilité d'utilisation : le bot incorporera une capture d'écran du lien envoyé pour vérifier directement dans le chat dans les deux modes de numérisation, simple ou détaillée.
• Analyses de liens automatiques : le bot recherchera les liens envoyés sur le serveur et les analysera automatiquement s'ils ne sont pas à partir d'un domaine de confiance.
• Liste de domaine de confiance personnalisable - Avec l'ajout de trusted_domains.json , vous pouvez personnaliser les domaines qui doivent être analysés.
• Commande spécifique de rôle - Le bot n'exécutera pas les commandes du formulaire utilisateurs qui n'ont pas le rôle spécifique répertorié dans le fichier config.py .
• Source du lien - Le bot intégre le lien de message où le lien numérisé a été trouvé pour faciliter la modération.
• Historique des liens - Le bot enregistre tous les liens qui sont envoyés pour être scannés et les maintient pour référence future
• État personnalisable - Messages d'état personnalisés intégrés.
• Console propre - Messages d'impression personnalisés pour chaque action et interaction avec le bot.

☕ Soutenir mon travail sur le ko-fi

Commencer

Avant de pouvoir utiliser le bot, vous devrez le configurer avec votre serveur Discord et le configurer avec vos touches API.

Condition préalable

• Un compte Discord avec des privilèges administratifs sur votre serveur.
• Python 3,6 ou plus.
• Clés API pour Virustotal et URLScan.io (disponibles à partir de leurs sites Web respectifs).

Rejoignez mon serveur Discord

Installation

1. Clone ce référentiel à votre machine locale.
2. Installez les dépendances requises en exécutant pip install -r requirements.txt .
3. Créez un fichier config.py dans le même répertoire que votre script BOT (ou utilisez le fichier «config.py» pré-psemade) et ajoutez votre token Discord Bot, la touche API Virustotal, la touche API URLScan.io, l'ID de guild (s), le rôle de modérateur et l'ID de la chaîne où vous souhaitez que la sortie des scans de liaison automatique se présente dans le format suivant:

 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 ]

4. Run main.py

Dépendances

Ce bot nécessite les packages Python suivants:

• py
• demandes
• Python-qui peuvent être installés à l'aide de PIP:

 pip install py - cord requests python - whois

Ou vous pouvez les installer à l'aide du fichier exigence.txt.

 pip install - r requirements . txt 

Usage

Le bot est simple à utiliser avec une structure de commande simple. Il prend en charge la commande suivante:

Structure de commandement

/checklink [LINK] [MODE]

• Mode simple : fournit un résumé convivial, y compris l'état de sécurité du lien, le résumé d'enregistrement du domaine WHOIS et un lien vers le rapport URLScan.io.

/checklink https://example.com simple

• Mode détaillé : offre un rapport exhaustif avec les notes spécifiques aux fournisseurs de Virustotal, des informations détaillées WHOIS et un rapport de sécurité complet de URLScan.io.

/checklink https://example.com detailed

• Historique : publie une liste simple de liens passés qui ont été utilisés pour les analyses et gardent une trace du nombre de fois où chaque lien a été vu.

/checklhistory

Modes expliqués

• Simple : affiche une intégration concise avec les 10 principaux avertissements de Virustotal, un résumé des informations WHOIS et un lien vers le rapport URLScan.io.
• Détaillé : présente un rapport complet, marquant chaque fournisseur avec un point codé en couleur selon la légende ci-dessous, ainsi que des informations détaillées WHOIS et un rapport de sécurité URLScan.io.

Légende des points de statut

• Inoffensif: ?
• Malveillant:?
• Suspect: ?
• Non détecté: ⚪

Améliorations futures

• Intégration du tableau de bord : développez un tableau de bord en ligne qui donne un aperçu des analyses antérieures, y compris des résultats détaillés et des statistiques. Ce tableau de bord offrira des informations sur les types de liens partagés au sein du serveur et l'efficacité du bot dans l'identification des menaces, l'amélioration de la transparence et la confiance dans les capacités du bot.
• Intégrations de numérisation supplémentaires : élargissez les capacités de balayage du bot en intégrant des outils et services de sécurité supplémentaires. Cette expansion fournira une couverture et une protection plus complètes contre un plus large éventail de menaces en ligne.
• Système de rétroaction des utilisateurs : implémentez un système pour que les utilisateurs puissent fournir des commentaires sur les résultats de la numérisation, tels que la déclaration de faux positifs ou des menaces manquées. Cette boucle de rétroaction aidera à améliorer la précision et l'efficacité du bot au fil du temps.

Contributif

• Vos contributions sont les bienvenues! Qu'il s'agisse d'ajouter de nouvelles fonctionnalités, d'améliorer la documentation ou de signaler les bogues, n'hésitez pas à débarrasser ce référentiel et à soumettre une demande de traction.

Contributeurs

• CAZAIRA - Aidé affiner et rendre le fichier de trusted_domains.json plus fort contre les faux positifs.
• Nitrrine - a découvert un bogue critique qui a provoqué un plan de bot sur certains liens.

Licence

Ce projet est open source sous la licence du MIT.