Documentation de Protector

Démarrage rapide

1. Ajoute le bot à ton serveur avec le bouton Ajouter à Discord.
2. Place le rôle « Protector » tout en haut de la liste des rôles (Paramètres du serveur, Rôles). Un rôle ne peut jamais agir sur un rôle situé au-dessus de lui : sans cela, l'anti-nuke, la restauration et les sanctions échouent.
3. Lance /autoconfig, choisis ta langue et un niveau de protection (1 léger, 2 standard, 3 strict). Protector active et règle tous les modules, crée un salon de logs et un portail de vérification. Tu peux la relancer : ce qui existe déjà est réutilisé, sans doublon.
4. Vérifie avec /diagnostic que chaque protection a bien les permissions dont elle a besoin.

Configuration

Le panneau /config

/config ouvre un panneau interactif dans un message visible par toi seul. Chaque module a un bouton pour l'activer ou le couper, des formulaires pour les seuils et les durées, et des menus pour choisir les salons et les rôles. Tout est enregistré instantanément, serveur par serveur.

Seuls les membres ayant la permission Gérer le serveur peuvent ouvrir la configuration.

Langue du serveur

Le bouton Langue du panneau définit la langue dans laquelle Protector écrit sur le serveur : français, anglais, espagnol ou allemand. La commande /informations change la langue pour toi seul, le temps de lire.

Modules protégés et rôle de sécurité

Un administrateur qui prépare une trahison n'aurait qu'à couper les protections avant d'attaquer. Les systèmes les plus importants sont donc réservés au propriétaire du serveur :

• anti-raid, anti-nuke, anti-spam, anti-webhook, quarantaine des bots et raid coordonné ;
• la liste des rôles staff, qui sont exemptés de l'anti-spam.

Les autres gestionnaires voient ces réglages, sans pouvoir les modifier. Dans /config, Général, le propriétaire peut désigner un rôle de sécurité autorisé à les modifier. Seul le propriétaire peut donner ce rôle : si un administrateur ou un bot l'attribue à quelqu'un, Protector le retire aussitôt et prévient le propriétaire en message privé.

Tableau de bord web

Sur protector-bot.com, connecte-toi avec Discord pour retrouver les serveurs dont tu es propriétaire ou où tu as Gérer le serveur, et activer ou couper chaque module en un clic.

Le site ne touche jamais ton serveur. Il enregistre une demande, que Protector récupère en quelques secondes. Le bot revérifie alors sur Discord que tu es toujours membre, que tu as toujours la permission, et que le module n'est pas protégé, puis applique ou refuse. Chaque changement est noté dans ton salon de logs avec la mention « via le tableau de bord web ».

Tout régler depuis le site

Sur la page d'un serveur, le lien Configurer d'un module ouvre ses réglages : seuils, durées, pourcentages, textes, salons et rôles. C'est exactement ce que permet /config sur Discord, avec les mêmes limites et les mêmes protections. Une barre apparaît en bas de l'écran dès qu'une valeur change : tant que tu n'as pas cliqué sur Enregistrer, rien n'est envoyé.

Le site contrôle ce qu'il peut tout de suite (bornes, format, type de salon), mais c'est toujours Protector qui décide : au moment d'appliquer, il revérifie chaque valeur et chaque permission sur Discord. Une demande passe entière ou pas du tout : si un champ est refusé, sa raison s'affiche juste en dessous et rien n'est écrit.

Les réglages généraux (langue, salon de logs, rôles staff, rôle de sécurité) et le réseau multi-serveurs ont leur propre page, en haut de la liste des modules. Les modules protégés restent réservés au propriétaire et au rôle de sécurité : les autres gestionnaires les voient en lecture seule.

Image de fond de la carte de bienvenue

C'est le seul réglage qui se fait uniquement sur le site, dans le module Bienvenue. Choisis une image PNG ou JPEG (8 Mo maximum, au moins 440 × 130 pixels) : Protector la télécharge et l'analyse avec son filtre anti-NSFW avant de l'utiliser, plus strictement que dans les salons, nudité suggestive comprise. Si le modèle d'analyse n'est pas disponible, l'image est refusée : aucune image n'est mise en place sans avoir été analysée.

Une image acceptée est recadrée au centre au format de la carte (880 × 260) et réencodée sans ses métadonnées, puis enregistrée par le bot. Refusée, elle est effacée du site aussitôt ; personne d'autre que la personne qui l'a envoyée ne la voit avant son acceptation. Le bouton Revenir au fond par défaut l'efface du bot comme du site.

Systèmes de protection

Anti-raid

Détecte un afflux anormal d'arrivées sur une courte période et passe le serveur en verrouillage : le niveau de vérification monte, et les comptes trop récents sont expulsés ou bannis pendant la durée du raid. Tout se règle : seuil et fenêtre d'arrivées, âge minimum du compte, action, durée.

Le verrouillage est enregistré : un redémarrage du bot ne l'interrompt pas. À la fin, le niveau de vérification d'origine est remis, sauf si le staff l'a changé entre-temps, auquel cas son choix est respecté.

Anti-spam et messages géants

Bloque le flood, les messages identiques répétés, les mentions de masse et les liens d'invitation. Les applications ajoutées à un profil (apps utilisateur) sont aussi surveillées : en cas de spam, l'auteur est expulsé, l'app bannie si possible et les messages supprimés. Un même message répandu dans plusieurs salons alerte l'équipe Protector.

Protector repère aussi les messages géants qui font couler un salon : titres « # », caractères très larges comme « ﷽ », lignes vides ou invisibles. Il estime la hauteur du message à l'écran et le traite comme du spam au-delà de 50 lignes, ou dès vingt lignes vides. La hauteur se règle dans /config, Anti-spam.

Si l'auteur d'un spam de mentions ne peut pas être rendu muet (permission manquante, rôle trop bas), le propriétaire est prévenu en privé.

Raid coordonné

L'anti-spam raisonne par membre. Vingt comptes qui publient chacun deux messages identiques restent donc sous tous ses seuils. Ce module observe une fenêtre de temps : si plusieurs membres distincts publient un contenu très proche en moins d'une minute, les messages sont supprimés et les participants réduits au silence le temps que le staff regarde. La comparaison est faite localement, et le staff du serveur en est toujours exempté.

Anti-nuke et restauration

Si un membre ou un bot enchaîne des actions destructrices (suppression de salons ou de rôles, bannissements en rafale, webhooks), Protector le neutralise, prévient le propriétaire, puis restaure la structure depuis une sauvegarde récente : salons, rôles, permissions, positions, nom et icône. Ta configuration est automatiquement reliée aux salons recréés.

Les attaques qui ne suppriment rien comptent aussi :

• Élagage : il vaut autant d'expulsions que de membres retirés.
• @everyone qui reçoit Administrateur, Bannir, Gérer les rôles… : Protector réagit dès la première fois et retire ces pouvoirs.
• Salons privés ouverts à tous : chacun compte, et Protector les referme.
• Lien d'invitation personnalisé changé ou retiré : le propriétaire est prévenu aussitôt, pour le reprendre avant qu'un autre serveur ne le réserve.

La sanction est graduée pour les humains : la blacklist globale n'est appliquée qu'au-delà d'un certain nombre d'actions destructrices. En dessous, c'est une sanction locale et une restauration. Un bot raideur est toujours blacklisté.

Salons privés et 16 novembre 2026

À cette date, Discord cesse de donner aux bots le nom et les permissions des salons qu'ils ne voient pas. Protector enregistre l'état de chaque salon au fil de l'eau : après un nuke, un salon privé est recréé avec le nom et les permissions qu'il lui connaissait. Un salon dont il n'a jamais connu les permissions n'est pas recréé de travers : le récapitulatif le signale. Avant l'échéance, le propriétaire reçoit en privé la liste des salons concernés.

Anti-phishing, anti-webhook et anti-bot

• Anti-phishing : supprime les liens d'arnaque (faux Nitro, vols de compte, domaines imités) et sanctionne leur auteur.
• Anti-webhook : quand un webhook publie du spam ou du phishing, c'est le webhook lui-même qui est supprimé.
• Anti-bot : les bots signalés comme malveillants sont bannis dès leur arrivée. Les bots de confiance peuvent être mis en liste blanche.

Quarantaine des nouveaux bots

Activée par défaut. Tout bot ajouté perd ses permissions et ses rôles supplémentaires jusqu'à ce que le propriétaire décide, en message privé, de l'autoriser ou de l'expulser. Tant qu'il attend, toute tentative de lui redonner des rôles ou des permissions est annulée.

À l'autorisation, Protector lui rend ses permissions. Discord ne le laisse donner que celles qu'il possède lui-même : celles qu'il ne peut pas rendre sont nommées, avec le rôle où les rajouter. Les bots validés par l'équipe Protector ne sont pas concernés.

Bots récents. Un bot dont le compte a moins de 7 jours arrive avec un avertissement dans le message au propriétaire, et un bouton Bannir en plus. Un bot de moins de 30 jours reste ensuite surveillé : dès sa première action destructrice (suppression d'un salon, d'un rôle, d'un webhook ou d'un émoji, bannissement, expulsion, élagage, ajout d'un autre bot, pouvoirs donnés à @everyone, salon privé ouvert à tous), ses permissions lui sont retirées, ce qu'il a fait est restauré quand c'est possible, et le propriétaire choisit en privé : autoriser, expulser ou bannir. Protector ne le bannit jamais de lui-même. Un bot inscrit sur la liste blanche du serveur n'est pas concerné.

Filtre NSFW

Analyse le texte, avec une liste tolérante aux contournements (« p.o.r.n », leet) sans bloquer les mots innocents, et les images, avec un modèle exécuté localement. Les GIF partagés depuis Tenor, Giphy ou Imgur sont analysés sur plusieurs images. Tu peux autoriser des salons précis et choisir l'action : supprimer, ou supprimer et exclure temporairement.

Salon piège

Un salon où personne n'a de raison d'écrire, et qui le dit en toutes lettres. Les comptes piratés et les robots de raid écrivent partout sans lire : un message dans ce salon les trahit. Protector agit aussitôt (softban par défaut, ou bannissement, expulsion, exclusion temporaire) et efface leurs messages récents, jusqu'à 7 jours en arrière. Après une expulsion ou un softban, un lien pour revenir peut leur être envoyé : utile pour un compte piraté, une fois récupéré par son propriétaire. Le staff, le propriétaire, la liste blanche, les bots et les webhooks ne déclenchent jamais le piège. À activer dans /config, Salon piège ; Protector peut créer le salon lui-même.

Score de risque

À chaque arrivée, Protector calcule une note de 0 à 100 en combinant l'âge du compte, sa réputation dans le réseau (déjà blacklisté ailleurs ?), l'avatar par défaut et la ressemblance du pseudo ou de l'avatar avec des raiders connus. Le résultat est journalisé ; une action automatique au-delà d'un score élevé est possible, désactivée par défaut.

Surveillance du staff

Quand un rôle à permissions sensibles (Administrateur, Gérer le serveur, Bannir, Webhooks…) est attribué à un compte jugé à risque (trop récent, arrivé depuis peu), Protector alerte le propriétaire et retire le rôle si possible.

Compte staff compromis. Les filtres épargnent le staff, ce qui laissait un compte volé libre d'agir. Protector surveille donc les signaux qui n'ont aucune raison d'apparaître chez un modérateur légitime : lien de phishing, salve de mentions, rafale de messages. Au-delà d'un seuil, ses rôles sont retirés et mémorisés, il est rendu muet, et une alerte part vers le propriétaire. Les accès sont restaurables à tout moment.

Anti-usurpation

Détecte les membres qui copient le pseudo ou l'avatar du propriétaire ou du staff, à l'arrivée et après un changement de nom. L'action se choisit dans /config : alerte ou expulsion.

Fonctions natives de Discord

Protector pilote aussi les protections intégrées à Discord. Elles agissent à la source : avant qu'un message soit publié, qu'une invitation soit utilisée ou qu'un MP soit envoyé.

Invitations et MP suspendus pendant un raid

Quand l'anti-raid verrouille le serveur, Protector demande à Discord de suspendre les invitations et les messages privés entre membres jusqu'à la fin du verrouillage (24 heures au plus, limite de Discord). Les membres voient le bandeau officiel « activité inhabituelle » de Discord. C'est la seule parade aux raideurs qui envoient des MP d'arnaque à tes membres : aucun bot ne voit ni ne bloque un message privé.

La suspension est levée à la fin du verrouillage. Une suspension posée à la main par ton staff n'est jamais levée par Protector. Réglage : Suspendre invitations et MP dans l'Anti-raid (activé par défaut). Protector a besoin de la permission Gérer le serveur.

Bouclier AutoMod de Discord

Protector lit un message puis le supprime : il agit toujours après la publication. Avec le bouclier AutoMod de Discord (module Anti-spam), Protector tient aussi à jour des règles AutoMod natives à partir de sa propre configuration :

• Mots interdits et invitations : les mots du filtre de mots et les liens d'invitation Discord ;
• Mentions de masse : la limite de mentions de l'anti-spam, avec la protection anti-raid de mentions de Discord ;
• Spam : le contenu que Discord reconnaît lui-même comme du spam.

Discord bloque ces messages avant leur publication, sans aucun délai, et continue de protéger même si Protector est hors ligne. Les rôles staff et les rôles de la liste blanche sont exemptés, comme les salons exclus de l'anti-spam et du filtre de mots. Une alerte part dans ton salon de journaux.

Les règles s'appellent « Protector · … » et Protector ne modifie que les siennes : tes règles AutoMod ne sont jamais touchées. Discord n'accepte qu'une règle de spam et une règle de mentions par serveur : si ton staff en a déjà une, Protector la laisse en place. Éteint, le bouclier retire ses règles. /autoconfig l'active.

Accueil Discord (Onboarding)

/autoconfig et le créateur de serveur configurent l'accueil natif de Discord : les salons par défaut montrés aux nouveaux et, avec le créateur, une question « Choisis tes rôles » avec les rôles décoratifs du serveur.

• Discord ne propose l'accueil que sur les serveurs Communauté (Paramètres du serveur, Activer la communauté), avec au moins 7 salons visibles par tous, dont 5 où l'on peut écrire. Sinon, Protector t'indique ce qui manque.
• /autoconfig ne remplace jamais un accueil déjà configuré par ton staff. Le créateur de serveur, qui refait tout le serveur, le remplace.

Rôles liés : « Vérifié par Protector »

Discord permet à une application de fournir des conditions pour des rôles liés. Protector en propose deux :

• Vérifié par Protector : le compte est relié à Protector et absent de sa blacklist globale ;
• Âge du compte (jours) : le compte Discord a été créé il y a au moins ce nombre de jours.

Pour un serveur : Paramètres du serveur, Rôles, choisis un rôle, Liens, Ajouter une condition, Protector. Les membres qui remplissent les conditions réclament eux-mêmes le rôle depuis le menu du serveur. Ça marche même sur les serveurs où Protector n'est pas installé.

Pour un membre : la liaison se fait une fois, sur protector-bot.com/linked-roles, et te suit sur tous les serveurs. Si ton statut change (blacklisté, par exemple), Discord est mis à jour automatiquement. Tu peux délier ton compte à tout moment.

Vérification des arrivants

Les nouveaux membres sont mis en quarantaine : ils ne voient que le salon de vérification. Trois modes au choix dans /config, Vérification :

• Bouton : un clic sur « Vérifier » débloque l'accès.
• Captcha image : un code est posté avec la mention du membre, qui le recopie dans le salon. Bon code : les messages sont supprimés et l'accès est débloqué.
• Site (Premium) : le bouton donne un lien privé vers protector-bot.com. Le membre se connecte avec Discord et Protector repère les doubles comptes à l'appareil. Un compte lié à un membre banni du serveur est expulsé (ou banni, ou laissé au staff, au choix) ; un autre double compte probable reste en quarantaine et le staff décide avec les boutons de l'alerte. En Premium Plus, une connexion par VPN, proxy ou Tor est aussi repérée. Réglages : tableau de bord, Vérification, Vérification par le site.

Mise en place : /verification-setup, avec le rôle de quarantaine et le salon de vérification. Tu peux aussi définir un rôle ajouté automatiquement après la vérification.

Si le message de vérification est supprimé, il revient tout seul à l'arrivée du membre suivant. Les rôles donnés par d'autres bots à un membre pas encore vérifié lui sont retirés, puis rendus dès qu'il se vérifie. Après la mise en place, Protector contrôle ce que le rôle de quarantaine voit réellement et nomme tout salon resté visible.

Modération et casier

• /warn /mute /kick /banSanctions, chacune exigeant la permission Discord correspondante.
• /tempbanBannissement temporaire, levé automatiquement.
• /unmute /unbanLevée d'une sanction.
• /historyCasier d'un membre sur ce serveur.
• /clearSuppression en masse, jusqu'à 500 messages : tous, ceux d'un membre ou ceux qui contiennent un mot.
• /slowmodeMode lent d'un salon.
• /lockdown /unlockVerrouillage d'urgence de tout le serveur.
• /panicUrgence élargie : verrouillage, révocation de toutes les invitations et filtre des arrivées.

Chaque sanction est enregistrée dans un casier par serveur. Les sanctions faites en dehors du bot, via le journal d'audit Discord, sont aussi captées avec leur motif. Avec /clear, les messages épinglés sont gardés ; au-delà de 14 jours, Discord interdit la suppression en masse et la réponse le précise.

Filtre de mots

Bloque une liste de mots que tu définis, majuscules et accents ignorés. Active-le dans /config et gère la liste avec /wordfilter.

Amélioration de la modération

Quand un filtre intervient sur un message, Protector peut soumettre ce contenu à son équipe pour vérifier que l'intervention était justifiée. Les auteurs sont remplacés par un pseudonyme irréversible et le contenu est effacé au bout de 90 jours. Désactivable à tout moment dans /config, Amélioration. Le détail figure dans la politique de confidentialité.

Signalements

• Signaler le message (clic droit sur un message, Applications) : un formulaire envoie le message au salon de signalements de ton serveur, où le staff peut sanctionner ou ignorer.
• Signaler l'utilisateur (clic droit sur un membre, Applications) : un rapport avec raison, liens et images part vers l'équipe Protector, qui l'examine sans rejoindre ton serveur.
• Signaler à Protector (clic droit sur un message) : transmet une arnaque à l'équipe, même hors des serveurs protégés.
• Sur le serveur support : ouvre un signalement sur le serveur support, avec une description détaillée et tes preuves (captures, vidéos, journaux).

Un compte signalé plusieurs fois et confirmé par l'équipe peut rejoindre la blacklist réseau, ce qui protège tous les serveurs d'un coup.

Journal d'évènements

Désactivé par défaut. Une fois activé, tu choisis les catégories à journaliser et un salon par défaut ; chaque catégorie peut avoir son propre salon. Les logs sont envoyés par un webhook propre à chaque salon.

Lire un log de modification

Chaque changement s'écrit avant, puis après. Le champ « Par » distingue trois situations : un membre nommé (c'est lui), « Permission manquante » (accorde à Protector Voir le journal d'audit), ou « Non attribuable » (Discord n'a écrit aucune entrée d'audit).

Qui a supprimé un message

• Protector, avec le motif (« Protector, anti-spam ») : le bot note ses propres suppressions.
• Un membre nommé : la suppression vient du journal d'audit Discord.
• « Aucune trace, vraisemblablement l'auteur » : Discord n'a rien écrit. C'est très probablement l'auteur, sans certitude, et le log ne prétend pas le contraire.

Sauvegarde et restauration

Réservé au propriétaire, et indépendant des sauvegardes automatiques de l'anti-nuke.

• /backup createCapture la structure complète : rôles, salons, permissions et derniers messages texte.
• /backup listListe tes sauvegardes.
• /backup deleteSupprime une sauvegarde.
• /restoreAffiche le contenu d'une sauvegarde, te laisse choisir de restaurer ou non les messages, puis restaure.

Une sauvegarde est créée automatiquement à l'arrivée du bot. Deux sauvegardes au plus par serveur, cinq pour un serveur Premium, dix en Premium Plus.

Blacklist réseau et appels

Quand un utilisateur atteint un niveau d'infraction très élevé, ou lors d'un nuke confirmé, il est blacklisté globalement : banni de tous les serveurs que Protector protège, et bloqué s'il tente d'en rejoindre un. Il est prévenu en message privé au préalable. Le pouvoir de blacklist est réservé à l'équipe Protector : les administrateurs de serveur n'y ont pas accès.

Tu peux choisir de l'accueillir quand même. S'il revient sur ton serveur, Protector lui retire tout accès et t'envoie un message avec deux boutons. Sans réponse sous cinq minutes, il est banni. Dans tous les cas, ce compte reste privé des commandes du bot.

Le seul endroit où un compte blacklisté garde la parole est le serveur de support, où /appeal permet de demander un réexamen.

Premium et Premium Plus

Toute la protection décrite plus haut est gratuite, y compris la modération par IA des messages signalés. Les offres ajoutent des analyses et des outils optionnels ; le comparatif complet et les liens d'abonnement sont sur la page Premium.

Protector à tes couleurs (Premium) : sur ton serveur, le bot prend le surnom, l'avatar, la bannière et la bio que tu choisis dans Personnalisation, sans changer ailleurs. Les images passent par le filtre anti-NSFW, un surnom qui imite Discord ou un autre bot est refusé, la bio garde la mention « Propulsé par Protector », et tout revient à l'apparence Protector à la fin de l'offre.

Outils communautaires : le fond de la carte de niveau, 10 salons vocaux créateurs, des notifications pour tous vos comptes et 25 réponses automatiques avec Premium ; salons créateurs illimités et 50 réponses automatiques avec Premium Plus. Le Premium ajoute aussi les statistiques de modération avancées ; le Premium Plus, la contestation des sanctions et un formulaire de candidature propres au serveur.

Dans /config, un module réservé à une offre reste affiché avec une étoile et un cadenas, mais ne se règle pas sans l'offre : le régler sans effet donnerait l'illusion d'une protection active. À la fin de l'abonnement, ses avantages s'arrêtent sans que la configuration soit perdue. Les offres s'obtiennent dans la boutique Discord du bot.

Réseau multi-serveurs

Relie plusieurs serveurs dont tu es propriétaire en un seul réseau (offre Premium). Un serveur principal porte l'abonnement et la configuration ; les serveurs liés n'ont besoin de rien. Un réseau compte au plus 9 serveurs liés en plus du principal.

• Bannissements partagés : bannir quelqu'un sur un serveur du réseau le bannit partout. Seuls les bannissements circulent, et seulement s'ils ont réussi à la source.
• Journaux remontés : les journaux des serveurs liés arrivent dans un salon du principal, par webhook, chacun au nom de son serveur d'origine.
• Salons partagés : un message publié d'un côté apparaît de l'autre avec le nom et l'avatar de son auteur. Chaque salon émet, reçoit, ou les deux.

Aucune mention ne traverse un pont : rôles, @everyone et @here sont neutralisés dans le texte et refusés par l'API. Les fichiers ne sont pas recopiés, seul leur nom est signalé. Pourquoi seulement tes propres serveurs ? Lier un serveur donne le pouvoir d'y bannir : la restriction garantit que le réseau ne te donne aucun pouvoir que tu n'aies déjà. La condition est revérifiée à chaque bannissement.

Webhook sortant

Avec Premium Plus, Protector envoie chaque incident de sécurité vers ton propre serveur HTTPS, pour l'archiver ou déclencher tes alertes. Chaque requête est signée : tu peux prouver qu'elle vient de Protector et qu'elle n'a pas été modifiée.

Mise en place

• /webhook setDéfinit l'adresse et affiche la clé de signature (propriétaire uniquement).
• /webhook keyRéaffiche la clé, en message privé.
• /webhook rotateRégénère la clé si elle a fuité ; l'ancienne cesse aussitôt de fonctionner.
• /webhook testEnvoie un évènement de test.
• /webhook statusÉtat, dernier envoi, échecs consécutifs.
• /webhook disableCoupe l'envoi sans effacer la configuration.

L'adresse doit être en HTTPS, et les adresses locales ou privées sont refusées (localhost, 127.x, 10.x, 192.168.x, 172.16.x à 172.31.x, 169.254.x, .local). Après 20 échecs consécutifs, l'envoi se désactive automatiquement.

Ce que Protector envoie

Une requête POST au corps JSON, avec ces en-têtes :

{
  "type": "incident.nuke",
  "guild": { "id": "123456789012345678", "name": "Mon serveur", "member_count": 1250 },
  "culprit_id": "987654321098765432",
  "adder_id": null,
  "description": "Actions destructrices en masse détectées",
  "guild_id": "123456789012345678",
  "sent_at": "2026-07-31T02:14:07.512Z"
}

Vérifier la signature

La signature est un HMAC-SHA256 de la chaîne horodatage + "." + corps brut, calculé avec ta clé. Utilise le corps brut, avant tout décodage JSON : le réencoder changerait les octets.

import express from 'express';
import { createHmac, timingSafeEqual } from 'node:crypto';

const SECRET = process.env.PROTECTOR_SECRET; // la clé donnée par /webhook set
const app = express();

app.post('/protector', express.raw({ type: 'application/json' }), (req, res) => {
  const ts = req.get('X-Protector-Timestamp');
  const sig = (req.get('X-Protector-Signature') || '').replace('sha256=', '');
  const raw = req.body.toString('utf8');

  // 1) Refuser les requêtes trop anciennes (rejeu)
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return res.sendStatus(408);

  // 2) Comparer à temps constant
  const expected = createHmac('sha256', SECRET).update(`${ts}.${raw}`).digest('hex');
  const a = Buffer.from(expected), b = Buffer.from(sig);
  if (a.length !== b.length || !timingSafeEqual(a, b)) return res.sendStatus(401);

  const event = JSON.parse(raw);
  console.log('Incident reçu :', event.type, event.guild.name);
  res.sendStatus(200);
});

app.listen(3000);

import hmac, hashlib, time
from flask import Flask, request

SECRET = "ta_cle"
app = Flask(__name__)

@app.post("/protector")
def protector():
    ts = request.headers.get("X-Protector-Timestamp", "0")
    sig = request.headers.get("X-Protector-Signature", "").replace("sha256=", "")
    raw = request.get_data(as_text=True)
    if abs(time.time() - int(ts)) > 300:
        return "", 408
    expected = hmac.new(SECRET.encode(), f"{ts}.{raw}".encode(), hashlib.sha256).hexdigest()
    if not hmac.compare_digest(expected, sig):
        return "", 401
    print("Incident reçu :", request.json["type"])
    return "", 200

Bonnes pratiques

• Réponds vite par un code 2xx : au-delà de 8 secondes, l'envoi est compté comme un échec.
• Refuse les requêtes de plus de 5 minutes pour empêcher le rejeu.
• Compare les signatures à temps constant, jamais avec ==.
• Ne publie jamais ta clé. Au moindre doute : /webhook rotate.

Outils communautaires

• Bienvenue : message d'accueil avec carte image optionnelle et rôle automatique (désactivé si la vérification gère déjà les arrivées). Variables du message : {user} (mention du membre), {server} (nom du serveur) et {count} (nombre de membres). Les variantes courantes, comme {mention} ou {server name}, sont aussi comprises.
• Tickets : salons privés entre un membre et l'équipe, prise en charge, notes internes, fermeture avec transcription remise au demandeur, fermeture automatique des tickets inactifs et note de satisfaction. /ticket panel publie le panneau. Depuis le site, le panneau se personnalise : motifs proposés, couleur, texte du bouton et message d'ouverture.
• Suggestions : /suggest publie une idée avec votes, barre de progression et fil de discussion ; le staff accepte ou refuse avec une raison.
• Concours : /giveaway avec tirage au sort automatique. Un concours actif à la fois en gratuit, illimité en Premium.
• Rôles à bouton : /roles add crée des boutons pour que les membres s'attribuent des rôles, 25 par salon.
• Compteurs : /counters crée des salons affichant le nombre de membres, d'humains ou de bots, mis à jour toutes les 10 minutes.
• Rôles temporaires (Premium) : /temprole attribue un rôle qui se retire tout seul à l'échéance.
• Invitations : /invites montre qui a invité qui. Quand Discord ne permet pas de savoir qui a invité un membre (Découverte de serveurs, application qui ajoute des membres, lien créé pendant une coupure de Protector), le log le dit au lieu d'inventer un nom.
• Embeds : depuis le site, compose des messages enrichis avec un aperçu fidèle à Discord, pars d'un modèle, et programme leur envoi ou leur répétition.
• Niveaux : de l'XP en écrivant (un gain par période, jamais pour un message arrêté par les filtres) et, en option, en vocal. /level affiche la carte d'un membre (avatar, pseudo, niveau, barre de progression, XP). Annonce d'un nouveau niveau dans le salon du message, un salon choisi ou en message privé, avec un texte personnalisable : {user} (mention), {username} (pseudo), {level} (niveau atteint), {xp} (XP totale), {rank} (place au classement), {server} (nom du serveur). Rôles de récompense par niveau, courbe, multiplicateurs et salons ou rôles sans XP se règlent sur le site. Le fond de la carte est Premium et passe par le filtre anti-NSFW.
• Salons vocaux temporaires : rejoindre un salon créateur ouvre un salon vocal au nom du membre, supprimé dès qu'il est vide. Son propriétaire reçoit un panneau : ouvert, fermé ou privé, listes blanche et noire, purge, micro, vidéo, soundboards, statut, transfert, réglages (nom, places) et sauvegarde pour son prochain salon. Les salons sont inscrits en base : après un redémarrage, Protector les retrouve, supprime ceux vidés entre-temps et sert les membres restés dans un salon créateur. Salons créateurs : 1 en gratuit, 10 en Premium, illimités en Premium Plus.
• Notifications : nouvelles vidéos YouTube et TikTok, lives Twitch, annoncés dans le salon choisi avec un rôle à mentionner et un message personnalisable ({name}, {title}, {link}, {platform}). 1 compte suivi en gratuit, tous en Premium. Suivre un compte n'annonce pas ses anciennes vidéos.
• Réponses automatiques : un déclencheur (contenu, mot entier, message exact ou début du message), une réponse, dans tous les salons ou un seul. Majuscules et accents sont ignorés, une réponse ne mentionne jamais @everyone ni un rôle, et les messages arrêtés par les filtres ne déclenchent rien. 5 réponses en gratuit, 25 en Premium, 50 en Premium Plus.

Permissions et diagnostic

Une protection peut être activée et pourtant inerte si la permission dont elle a besoin manque. Le cas le plus grave : l'anti-nuke sans Voir le journal d'audit. Discord n'envoie alors aucun évènement d'audit, et rien n'est détecté.

/diagnostic affiche, module par module, ce qui fonctionne, ce qui est dégradé et ce qui est hors service, en nommant la permission exacte qui manque. La hiérarchie est vérifiée au même titre : un rôle placé trop bas rend « Gérer les rôles » inopérant. Si une protection est hors service, le propriétaire est prévenu en privé, une seule fois tant que la situation ne change pas.

Pendant une attaque, si une contre-mesure échoue faute de permission (expulser les comptes d'un raid, neutraliser l'auteur d'un nuke, restaurer le serveur…), le propriétaire reçoit aussitôt un message privé qui dit quoi corriger.

État du bot. Protector est réparti en plusieurs « shards », chacun chargé d'une partie des serveurs. La page État des shards montre si chacun répond, et la page de ton serveur indique de quel shard il dépend : si une protection semble muette, c'est le premier endroit à regarder.

Application utilisateur

Protector peut s'installer sur ton compte, et pas seulement sur un serveur. Il te suit alors dans tes messages privés, tes groupes et les serveurs où le bot n'est pas. Une application installée sur un profil ne reçoit aucun évènement des serveurs : ce sont des outils personnels, qui ne protègent pas un serveur.

• /scan : vérifie un lien ou une image avant de cliquer, avec la même liste de domaines d'arnaque et le même modèle d'image que sur les serveurs protégés. Réponse visible par toi seul ; dix secondes entre deux analyses, trente avec une image. Pour un lien, la page est aussi ouverte dans un navigateur isolé, sur les serveurs de Protector et coupé de leur réseau interne, qui en joint une capture : tu vois où mène le lien sans l'ouvrir toi-même.
• Signaler à Protector (clic droit sur un message, Applications) : transmet une arnaque à l'équipe. Dix signalements par jour, chacun lu par un humain.

Liste des commandes

• /autoconfigConfiguration automatique complète.
• /configPanneau de configuration interactif.
• /informationsGuide interactif de tous les systèmes.
• /diagnosticBilan de santé de l'installation.
• /verification-setupPortail de vérification.
• /warn /mute /kick /banSanctions de modération.
• /tempban /unmute /unbanBannissement temporaire et levée de sanction.
• /historyCasier d'un membre.
• /clear /slowmodeSuppression en masse, mode lent.
• /lockdown /unlock /panicMesures d'urgence.
• /backup /restoreSauvegarde et restauration du serveur.
• /wordfilterListe des mots interdits.
• /invites /statsInvitations, statistiques de modération.
• /info-server /info-user /avatarFiches d'information.
• /ticket /suggest /giveawayTickets, suggestions, concours.
• /roles /counters /temproleRôles à bouton, compteurs, rôles temporaires.
• /audit /logs /webhookAudit, journal persistant et webhook sortant (Premium Plus).
• /levelCarte de niveau d'un membre.
• /scanVérifier un lien ou une image.
• /appealContester une blacklist.
• /support /voteInvitation au serveur de support, vote sur top.gg.
• Signaler…Menus du clic droit : signaler le message, l'utilisateur, ou à Protector.

Langues

Le bot et ce site existent en français, en anglais, en espagnol et en allemand. Sur Discord, le choix se fait dans /config, Langue, et s'applique à tout ce que le bot écrit sur le serveur. Une phrase pas encore traduite s'affiche en anglais plutôt qu'en texte brut. Sur le site, le sélecteur en haut de page garde ton choix.

FAQ

Protector est-il gratuit ?

Oui. Toute la protection, la modération et la gestion sont gratuites. Les offres payantes n'ajoutent que des analyses optionnelles.

L'anti-nuke dit « action impossible », pourquoi ?

Le rôle de Protector n'est pas assez haut, ou une permission manque. Place-le tout en haut de la liste des rôles et lance /diagnostic.

La restauration récupère-t-elle les messages ?

Elle recrée les derniers messages texte de chaque salon par webhook, si l'option est activée dans /config, Anti-nuke. Les autres contenus ne sont pas conservés.

Pourquoi un module est-il grisé sur le tableau de bord ?

Soit il est protégé et tu n'es ni le propriétaire ni membre du rôle de sécurité, soit il demande une offre Premium que le serveur n'a pas.

Mes données sont-elles en sécurité ?

Protector ne stocke que le strict nécessaire et analyse les messages en temps réel sans les conserver, sauf les exceptions décrites dans la politique de confidentialité.

Je n'ai pas trouvé ma réponse.

Rejoins le serveur de support : l'équipe répond aux questions et aux retours.