ElSigm Documentation
Linked Roles Verification URL

Vérification des rôles liés

Cette page est l'adresse officielle de vérification des rôles liés d'ElSigm. Elle permet à un membre de connecter son compte Discord au réseau InterPub afin que ses statistiques réelles — annonces diffusées, statut de vérification, appartenance Premium, ancienneté — puissent servir de critère automatique d'attribution de rôles sur n'importe quel serveur Discord.

Type : Linked Roles Verification URL Application : 1361056395524313158 Portées : identify, role_connections.write Révocable : à tout moment Mise à jour : 9 février 2026

Qu'est-ce qu'un rôle lié ?

Les rôles liés — Linked Roles dans la terminologie de Discord — constituent un mécanisme natif de la plateforme permettant à un serveur de conditionner l'attribution automatique d'un rôle à des critères vérifiés par une application externe.

Le principe est le suivant. Une application, ici ElSigm, déclare auprès de Discord une liste de critères mesurables qu'elle est capable de certifier pour un utilisateur donné : par exemple le nombre d'annonces diffusées, le fait d'être vérifié, ou l'ancienneté de participation au réseau. Un administrateur de serveur configure alors un rôle en indiquant : « ce rôle est attribué automatiquement à quiconque satisfait tel critère certifié par ElSigm ».

Lorsqu'un membre du serveur souhaite obtenir ce rôle, Discord lui propose de « vérifier » son éligibilité. Il est alors redirigé vers la présente page, autorise ElSigm à écrire ses statistiques dans son profil Discord, et le rôle lui est attribué instantanément si les seuils configurés sont atteints.

Ce qui distingue un rôle lié d'un rôle classique

AspectRôle classiqueRôle lié
AttributionManuelle, par un modérateurAutomatique, par Discord, selon un critère certifié
VérifiabilitéRepose sur la parole du membreRepose sur une donnée certifiée par l'application
Mise à jourAucune, sauf action manuelleActualisée lors de chaque synchronisation
ConsentementNon requisAutorisation explicite du membre, révocable
PortabilitéLimitée à un serveurLa liaison vaut pour tous les serveurs utilisant ElSigm
Charge de modérationÉlevéeNulle une fois configuré

Pourquoi ElSigm propose ce dispositif

Le réseau InterPub repose sur la confiance. Un serveur qui souhaite réserver un salon d'échange de partenariats aux propriétaires réellement actifs du réseau se heurtait jusqu'ici à un problème de vérification manuelle fastidieuse. Les rôles liés résolvent cette difficulté : le critère est certifié par le bot lui-même, sans qu'aucun modérateur n'ait à vérifier quoi que ce soit.

Cas d'usage concrets

Un salon « partenariats sérieux » réservé aux comptes vérifiés par la modération. Un rôle « Vétéran du réseau » attribué au-delà de cinquante annonces diffusées. Un accès prioritaire au support réservé aux membres Premium. Un salon d'entraide réservé aux propriétaires de serveurs ayant installé le bot. Un filtre anti-comptes jetables exigeant une ancienneté minimale.

Les critères certifiés par ElSigm

ElSigm déclare auprès de Discord les métadonnées suivantes. Chacune correspond à une information déjà détenue par le bot dans le cadre de son fonctionnement normal, telle que documentée dans la Politique de Confidentialité.

CléLibelléTypeSignificationExemple de règle
verifieCompte vérifiéBooléenLa modération a autorisé les publications de ce compteEst vrai
premiumMembre PremiumBooléenLe compte bénéficie du programme d'annonces automatiquesEst vrai
proprietaire_serveurPropriétaire d'un serveur du réseauBooléenLe compte possède au moins un serveur où ElSigm est installéEst vrai
pubs_envoyeesAnnonces diffuséesEntierNombre total d'annonces diffusées via le réseauSupérieur ou égal à 10
serveurs_geresServeurs connectésEntierNombre de serveurs du réseau détenus par le compteSupérieur ou égal à 1
pointsPoints de contributionEntierScore de participation cumuléSupérieur ou égal à 100
niveauNiveauEntierNiveau de progression atteintSupérieur ou égal à 5
avertissementsAvertissementsEntierNombre d'avertissements reçusInférieur ou égal à 0
membre_depuisMembre du réseau depuisDateDate de la première annonce validéeAntérieure à 30 jours
compte_cree_leCompte Discord créé leDateDate de création du compte DiscordAntérieure à 90 jours

Nature des comparateurs

Discord met à disposition plusieurs types de comparaison, que l'administrateur choisit lors de la configuration du rôle :

  • Entier supérieur ou égal — « au moins N annonces diffusées ».
  • Entier inférieur ou égal — « au plus N avertissements ».
  • Entier égal et entier différent — pour des correspondances exactes.
  • Date antérieure à X jours — « inscrit depuis plus de trente jours ».
  • Date postérieure à X jours — « inscrit depuis moins de sept jours ».
  • Booléen égal et booléen différent — pour les critères binaires.

Les booléens sont transmis en nombres

L'interface de programmation de Discord ne prévoit pas de type booléen natif pour les métadonnées de rôles liés. Les critères binaires sont donc déclarés comme des entiers valant 1 pour vrai et 0 pour faux, avec un comparateur d'égalité. C'est une contrainte de la plateforme, pas un choix de conception d'ElSigm.

Déclaration des métadonnées auprès de Discord

Les métadonnées ci-dessus correspondent à l'enregistrement suivant, effectué une seule fois par l'application auprès de Discord.

PUT https://discord.com/api/v10/applications/1361056395524313158/role-connections/metadata
Authorization: Bot <TOKEN_DU_BOT>
Content-Type: application/json

[
  { "key": "verifie",              "name": "Compte vérifié",        "description": "La modération a validé ce compte",        "type": 7 },
  { "key": "premium",              "name": "Membre Premium",        "description": "Bénéficie des annonces automatiques",     "type": 7 },
  { "key": "proprietaire_serveur", "name": "Propriétaire",          "description": "Possède un serveur du réseau",            "type": 7 },
  { "key": "pubs_envoyees",        "name": "Annonces diffusées",    "description": "Nombre total d'annonces publiées",        "type": 2 },
  { "key": "serveurs_geres",       "name": "Serveurs connectés",    "description": "Serveurs du réseau détenus",              "type": 2 },
  { "key": "points",               "name": "Points",                "description": "Score de contribution cumulé",            "type": 2 },
  { "key": "niveau",               "name": "Niveau",                "description": "Niveau de progression atteint",           "type": 2 },
  { "key": "avertissements",       "name": "Avertissements",        "description": "Nombre d'avertissements reçus",           "type": 3 },
  { "key": "membre_depuis",        "name": "Membre depuis",         "description": "Date de la première annonce validée",     "type": 5 },
  { "key": "compte_cree_le",       "name": "Compte créé le",        "description": "Date de création du compte Discord",      "type": 5 }
]
TypeNom techniqueComparaison effectuée
1INTEGER_LESS_THAN_OR_EQUALLa valeur doit être inférieure ou égale au seuil
2INTEGER_GREATER_THAN_OR_EQUALLa valeur doit être supérieure ou égale au seuil
3INTEGER_EQUALLa valeur doit être exactement égale au seuil
4INTEGER_NOT_EQUALLa valeur doit être différente du seuil
5DATETIME_LESS_THAN_OR_EQUALLa date doit précéder le seuil en jours
6DATETIME_GREATER_THAN_OR_EQUALLa date doit suivre le seuil en jours
7BOOLEAN_EQUALLa valeur doit valoir 1
8BOOLEAN_NOT_EQUALLa valeur doit valoir 0

Le champ key est limité à 50 caractères, en minuscules, chiffres et tirets bas uniquement. Le champ name est limité à 100 caractères et le champ description à 200. Une application peut déclarer cinq métadonnées au maximum — au-delà, une sélection doit être opérée parmi la liste ci-dessus en fonction des usages réellement souhaités.

Limite à connaître avant configuration

Discord n'autorise que cinq clés de métadonnées par application. La liste de dix critères présentée ici constitue le catalogue des possibilités ; il convient d'en retenir cinq lors de l'enregistrement effectif. La sélection recommandée est : verifie, premium, pubs_envoyees, serveurs_geres et membre_depuis.

Comment lier votre compte

Deux chemins mènent au même résultat. Le premier part de Discord, le second de cette page.

Chemin A — Depuis Discord (recommandé)

  1. Ouvrez le serveur concerné

    Rendez-vous sur le serveur Discord qui propose un rôle lié fondé sur ElSigm.

  2. Accédez aux rôles liés

    Cliquez sur le nom du serveur en haut à gauche, puis sur Rôles liés. Sur mobile, appuyez sur le nom du serveur puis faites défiler jusqu'à la même entrée.

  3. Sélectionnez le rôle

    La liste affiche les rôles liés configurés et, pour chacun, les critères à remplir. Choisissez celui qui vous intéresse.

  4. Lancez la vérification

    Cliquez sur Vérifier en face d'ElSigm. Discord ouvre alors cette page dans votre navigateur.

  5. Autorisez la connexion

    Un écran d'autorisation Discord s'affiche, détaillant précisément les accès demandés. Cliquez sur Autoriser.

  6. Retour automatique

    Vos statistiques sont écrites dans votre profil de connexion et Discord vous ramène à l'application. Le rôle est attribué immédiatement si les seuils sont atteints.

Chemin B — Depuis cette page

  1. Cliquez sur le bouton de liaison

    Utilisez le bouton Lier mon compte Discord en haut de cette page.

  2. Connectez-vous si nécessaire

    Si vous n'êtes pas déjà connecté à Discord dans votre navigateur, vos identifiants vous seront demandés — par Discord uniquement, jamais par ElSigm.

  3. Vérifiez l'écran d'autorisation

    Contrôlez que l'application affichée est bien ElSigm et que les accès demandés correspondent à ceux documentés plus bas.

  4. Autorisez

    La liaison est enregistrée. Elle vaut pour l'ensemble des serveurs utilisant ElSigm comme source de rôles liés.

  5. Réclamez vos rôles

    Retournez sur les serveurs concernés et suivez le chemin A à partir de l'étape 3. Les critères étant déjà certifiés, l'attribution est instantanée.

Paramètres de la liaison

ApplicationElSigm · 1361056395524313158
Portées demandéesidentify · role_connections.write
Type de réponsecode (flux d'autorisation avec code)
Adresse de redirectionà configurer
Protection anti-rejeustate aléatoire, vérifié au retour
URL générée—

Vérifiez toujours le domaine

L'écran d'autorisation doit impérativement se trouver sur discord.com. Aucune page légitime ne vous demandera votre mot de passe Discord en dehors de ce domaine. Si une page ressemblant à Discord vous demande vos identifiants sur une autre adresse, il s'agit d'une tentative d'hameçonnage : fermez-la immédiatement et signalez-la sur le serveur de support.

Données consultées pendant la liaison

La liaison met en œuvre deux portées d'autorisation OAuth 2.0, et deux seulement. Leur périmètre exact est le suivant.

Portée identify

Elle donne accès aux informations de base du profil : identifiant numérique, nom d'utilisateur, discriminateur historique, avatar, bannière, drapeaux publics et langue d'interface.

ElSigm n'exploite de cet ensemble que l'identifiant numérique, qui sert exclusivement à retrouver vos statistiques dans les fichiers du bot. Le nom d'utilisateur peut être affiché à l'écran pour confirmation visuelle, sans enregistrement supplémentaire.

La portée identify ne donne pas accès à votre adresse électronique. Celle-ci relève de la portée distincte email, qu'ElSigm ne demande pas.

Portée role_connections.write

Elle autorise l'application à écrire ses propres métadonnées dans votre profil de connexion, pour elle-même uniquement. Cette portée est délibérément restreinte par Discord : elle ne permet ni de lire les métadonnées écrites par d'autres applications, ni de les modifier, ni d'agir sur vos rôles directement.

ActionAutoriséePrécision
Lire votre identifiant DiscordOuiNécessaire pour retrouver vos statistiques
Lire votre nom d'utilisateur et votre avatarOuiInclus dans identify, non conservé
Écrire les métadonnées d'ElSigm dans votre profilOuiObjet même de la liaison
Lire votre adresse électroniqueNonPortée email non demandée
Lire la liste de vos serveursNonPortée guilds non demandée
Rejoindre des serveurs en votre nomNonPortée guilds.join non demandée
Lire vos messages ou vos conversations privéesNonAucune portée OAuth ne le permet
Vous ajouter ou vous retirer des rôles directementNonL'attribution est opérée par Discord, pas par ElSigm
Modifier votre profil, votre pseudonyme ou votre avatarNonHors périmètre des portées demandées
Accéder à votre mot de passeNonTechniquement impossible pour toute application tierce
Accéder à vos moyens de paiementNonAucune portée de facturation demandée

Données écrites dans votre profil

À l'issue de la liaison, ElSigm écrit dans votre profil de connexion un nom de plateforme (« ElSigm — Réseau InterPub »), un nom d'utilisateur de plateforme (votre pseudonyme Discord) et les valeurs des métadonnées déclarées.

Ces valeurs sont visibles par vous dans vos paramètres Discord, et par les serveurs auxquels vous demandez un rôle lié, uniquement pour les critères que ces serveurs ont configurés.

Ce qui est conservé côté ElSigm

La liaison n'entraîne la création d'aucune donnée nouvelle relative à votre personne, au-delà d'un jeton d'accès et d'un jeton de rafraîchissement permettant de mettre à jour vos métadonnées lors des synchronisations ultérieures. Ces jetons sont des chaînes techniques, sans valeur informative sur vous, et sont invalidés dès la révocation.

Les statistiques transmises proviennent intégralement de fichiers déjà existants, documentés dans la Politique de Confidentialité : statuts de vérification, appartenance Premium, points et niveaux, avertissements.

Révoquer la liaison

La liaison est réversible à tout moment, sans justification et sans conséquence sur les autres fonctionnalités du bot.

Depuis les paramètres Discord

  1. Ouvrez vos paramètres utilisateur

    Cliquez sur l'engrenage situé en bas à gauche de l'interface Discord.

  2. Allez dans « Applications autorisées »

    La rubrique se trouve sous « Paramètres avancés » ou « Connexions » selon la version de l'application.

  3. Repérez ElSigm

    L'entrée porte le nom de l'application et rappelle les portées accordées.

  4. Retirez l'accès

    Cliquez sur Déconnecter ou Révoquer l'accès, puis confirmez.

Effets immédiats de la révocation

  • Les jetons détenus par ElSigm sont invalidés instantanément par Discord.
  • Les métadonnées écrites dans votre profil de connexion sont supprimées.
  • Tout rôle lié dépendant de ces métadonnées vous est automatiquement retiré, sur l'ensemble des serveurs concernés.
  • Vos autres fonctionnalités demeurent intactes : vos annonces, votre statut de vérification et votre éventuel statut Premium ne sont pas affectés.

Relier ultérieurement

Rien n'empêche de relier à nouveau votre compte plus tard : il suffit de reprendre la procédure depuis le début. Aucune pénalité, aucun délai d'attente et aucune limite du nombre de liaisons successives ne s'appliquent.

Demande de suppression complémentaire

Si vous souhaitez, en plus de la révocation, obtenir la suppression des données conservées par le bot, adressez une demande au serveur de support en invoquant votre droit à l'effacement. Les modalités sont détaillées dans la Politique de Confidentialité.

Guide de configuration pour les administrateurs

Cette section s'adresse aux administrateurs souhaitant créer un rôle lié fondé sur les critères d'ElSigm dans leur propre serveur.

Prérequis

  • Disposer de la permission Gérer les rôles sur le serveur.
  • Avoir créé au préalable le rôle à attribuer, avec les permissions souhaitées.
  • Le rôle doit être positionné en dessous du rôle le plus élevé de votre propre compte dans la hiérarchie.

Procédure

  1. Ouvrez les paramètres du serveur

    Clic droit sur le nom du serveur, puis Paramètres du serveur.

  2. Accédez à la rubrique Rôles

    Sélectionnez le rôle que vous souhaitez transformer en rôle lié, ou créez-en un nouveau.

  3. Ouvrez l'onglet « Liens »

    Cet onglet apparaît dans les paramètres du rôle sélectionné.

  4. Ajoutez une condition

    Cliquez sur Ajouter une condition puis choisissez ElSigm dans la liste des applications proposées.

  5. Sélectionnez le critère et le seuil

    Choisissez par exemple « Annonces diffusées » avec un seuil de 10, ou « Compte vérifié » avec la valeur vraie.

  6. Combinez si nécessaire

    Plusieurs conditions peuvent être ajoutées à un même rôle. Elles se cumulent : toutes doivent être satisfaites simultanément.

  7. Enregistrez

    Le rôle devient immédiatement disponible dans la rubrique Rôles liés accessible à vos membres.

  8. Communiquez

    Annoncez la disponibilité du rôle dans un salon d'annonces, en expliquant la démarche à suivre.

Exemples de configurations éprouvées

confiance
Partenaire vérifié

Condition : verifie égal à vrai. Donne accès à un salon de recherche de partenariats réservé aux comptes ayant franchi la modération.

ancienneté
Vétéran du réseau

Conditions : pubs_envoyees ≥ 50 et membre_depuis antérieur à 90 jours. Distingue les contributeurs de longue date.

premium
Soutien Premium

Condition : premium égal à vrai. Ouvre un salon d'échange privilégié et un accès prioritaire au support.

propriétaires
Cercle des propriétaires

Condition : serveurs_geres ≥ 1. Réunit les personnes gérant effectivement une communauté du réseau.

qualité
Dossier vierge

Conditions : avertissements ≤ 0 et verifie égal à vrai. Réserve un rôle de confiance aux comptes sans historique de sanction.

sécurité
Anti-comptes jetables

Condition : compte_cree_le antérieur à 90 jours. Filtre les comptes fraîchement créés à des fins de contournement.

Un rôle lié n'est pas un rempart absolu

Les rôles liés certifient une donnée à un instant donné ; ils ne remplacent ni la modération humaine, ni les règles de votre serveur. Ne fondez pas sur ce seul mécanisme l'accès à des permissions sensibles telles que la gestion des messages, la gestion des rôles ou l'expulsion de membres.

Fonctionnement technique du flux

Cette section détaille le déroulement complet de la liaison, à l'attention des personnes souhaitant comprendre ou reproduire le mécanisme.

Vue d'ensemble

Membre                Discord                    ElSigm
  |                      |                          |
  |-- Clic « Vérifier »->|                          |
  |                      |-- Redirection ---------->|  (cette page)
  |                      |                          |
  |<----- Écran d'autorisation OAuth2 --------------|  (sur discord.com)
  |                      |                          |
  |-- « Autoriser » ---->|                          |
  |                      |-- code + state --------->|  (adresse de redirection)
  |                      |                          |
  |                      |<-- échange code/jeton ---|  POST /oauth2/token
  |                      |--- access + refresh ---->|
  |                      |                          |
  |                      |<-- écriture métadonnées -|  PUT role-connection
  |                      |                          |
  |<-- Rôle attribué ----|                          |

Étape 1 — Construction de l'URL d'autorisation

https://discord.com/oauth2/authorize
  ?client_id=1361056395524313158
  &redirect_uri=https%3A%2F%2Felsigm.botix.fr%2Foauth%2Fcallback
  &response_type=code
  &scope=identify%20role_connections.write
  &state=<valeur_aleatoire_signee>
  &prompt=consent

La valeur state est un jeton aléatoire à usage unique, stocké côté serveur ou dans un cookie signé, et vérifié au retour. Elle protège contre les attaques par requête forgée.

Étape 2 — Échange du code contre un jeton

POST https://discord.com/api/v10/oauth2/token
Content-Type: application/x-www-form-urlencoded

client_id=1361056395524313158
&client_secret=<SECRET_APPLICATION>
&grant_type=authorization_code
&code=<CODE_RECU>
&redirect_uri=https://elsigm.botix.fr/oauth/callback

La réponse comporte un jeton d'accès valable une semaine, un jeton de rafraîchissement, la durée de validité et les portées effectivement accordées.

Étape 3 — Identification du membre

GET https://discord.com/api/v10/users/@me
Authorization: Bearer <ACCESS_TOKEN>

Étape 4 — Écriture des métadonnées

PUT https://discord.com/api/v10/users/@me/applications/1361056395524313158/role-connection
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "platform_name": "ElSigm — Réseau InterPub",
  "platform_username": "Pseudonyme#0000",
  "metadata": {
    "verifie": 1,
    "premium": 0,
    "pubs_envoyees": 42,
    "serveurs_geres": 2,
    "membre_depuis": "2026-02-14T09:30:00+00:00"
  }
}

Étape 5 — Rafraîchissement périodique

Le jeton d'accès expirant au bout d'une semaine, un rafraîchissement est nécessaire pour maintenir les métadonnées à jour.

POST https://discord.com/api/v10/oauth2/token
Content-Type: application/x-www-form-urlencoded

client_id=1361056395524313158
&client_secret=<SECRET_APPLICATION>
&grant_type=refresh_token
&refresh_token=<REFRESH_TOKEN>

Implémentation de référence en Python

import os, secrets, urllib.parse
import aiohttp
from aiohttp import web

CLIENT_ID     = "1361056395524313158"
CLIENT_SECRET = os.environ["DISCORD_CLIENT_SECRET"]
REDIRECT_URI  = "https://elsigm.botix.fr/oauth/callback"
API           = "https://discord.com/api/v10"
SCOPES        = "identify role_connections.write"

_states = {}   # en production : stockage persistant avec expiration

async def start(request):
    state = secrets.token_urlsafe(24)
    _states[state] = True
    params = {
        "client_id":     CLIENT_ID,
        "redirect_uri":  REDIRECT_URI,
        "response_type": "code",
        "scope":         SCOPES,
        "state":         state,
        "prompt":        "consent",
    }
    url = "https://discord.com/oauth2/authorize?" + urllib.parse.urlencode(params)
    raise web.HTTPFound(url)

async def callback(request):
    code  = request.query.get("code")
    state = request.query.get("state")
    if not code or not _states.pop(state, None):
        return web.Response(status=400, text="Requête invalide.")

    async with aiohttp.ClientSession() as s:
        # 1) échange du code contre un jeton
        async with s.post(f"{API}/oauth2/token", data={
            "client_id":     CLIENT_ID,
            "client_secret": CLIENT_SECRET,
            "grant_type":    "authorization_code",
            "code":          code,
            "redirect_uri":  REDIRECT_URI,
        }) as r:
            tokens = await r.json()

        access = tokens["access_token"]
        auth   = {"Authorization": f"Bearer {access}"}

        # 2) identification
        async with s.get(f"{API}/users/@me", headers=auth) as r:
            user = await r.json()

        # 3) calcul des métadonnées depuis les fichiers du bot
        meta = build_metadata(user["id"])

        # 4) écriture dans le profil de connexion
        async with s.put(
            f"{API}/users/@me/applications/{CLIENT_ID}/role-connection",
            headers={**auth, "Content-Type": "application/json"},
            json={
                "platform_name":     "ElSigm — Réseau InterPub",
                "platform_username": user["username"],
                "metadata":          meta,
            },
        ) as r:
            if r.status not in (200, 204):
                return web.Response(status=502, text="Écriture refusée par Discord.")

    save_tokens(user["id"], tokens)      # pour le rafraîchissement ultérieur
    return web.Response(text="Compte lié. Vous pouvez retourner sur Discord.")

def build_metadata(user_id: str) -> dict:
    verif   = load_verif()
    premium = load_premium()
    points  = load_points().get(user_id, {})
    warns   = load_warnings().get(user_id, [])
    return {
        "verifie":        1 if verif.get(user_id) is True else 0,
        "premium":        1 if user_id in premium else 0,
        "pubs_envoyees":  int(points.get("points", 0)),
        "serveurs_geres": count_owned_guilds(user_id),
        "avertissements": len(warns),
    }

app = web.Application()
app.add_routes([web.get("/verify", start), web.get("/oauth/callback", callback)])

Le secret d'application ne doit jamais apparaître côté navigateur

Le client_secret permet d'obtenir des jetons au nom de l'application. Il doit résider exclusivement sur le serveur, être chargé depuis une variable d'environnement et ne jamais être inscrit dans le code source, dans un dépôt public ou dans une page HTML. En cas de fuite, régénérez-le immédiatement depuis le portail développeur.

Déclaration dans le portail développeur

Pour qu'ElSigm apparaisse dans la liste des applications proposées lors de la configuration d'un rôle lié, l'adresse de cette page doit être renseignée dans le portail développeur de Discord.

  1. Ouvrez le portail développeur

    Rendez-vous sur discord.com/developers/applications et connectez-vous avec le compte propriétaire de l'application.

  2. Sélectionnez l'application

    Choisissez ElSigm, identifiant 1361056395524313158.

  3. Renseignez l'URL de vérification

    Dans l'onglet General Information, complétez le champ Linked Roles Verification URL avec l'adresse publique de cette page.

  4. Déclarez l'adresse de redirection

    Dans l'onglet OAuth2, ajoutez l'adresse de redirection exacte utilisée par votre serveur, par exemple https://elsigm.botix.fr/oauth/callback. Elle doit correspondre au caractère près à celle envoyée dans la requête d'autorisation.

  5. Enregistrez les métadonnées

    Exécutez la requête d'enregistrement des métadonnées décrite plus haut. Cette opération n'est à réaliser qu'une fois, puis à chaque modification du catalogue de critères.

  6. Complétez les autres champs légaux

    Renseignez également l'URL des Conditions d'Utilisation et celle de la Politique de Confidentialité dans l'onglet General Information.

  7. Vérifiez

    Créez un rôle lié de test sur un serveur d'essai et effectuez la liaison de bout en bout avant toute annonce publique.

Champ du portailValeur à renseignerObligatoire
Terms of Service URLAdresse de conditions-utilisation.htmlRecommandé
Privacy Policy URLAdresse de politique-confidentialite.htmlRecommandé
Linked Roles Verification URLAdresse de verification-roles-lies.htmlRequis pour les rôles liés
Interactions Endpoint URLVoir la page dédiéeNon requis en mode passerelle
OAuth2 RedirectsAdresse exacte de votre point de retourRequis pour le flux OAuth

Dépannage

SymptômeCause probableRésolution
ElSigm n'apparaît pas dans la liste des applicationsURL de vérification non renseignée dans le portailCompléter le champ Linked Roles Verification URL et patienter quelques minutes
invalid_redirect_uriL'adresse de redirection ne figure pas dans la liste déclaréeL'ajouter à l'identique dans l'onglet OAuth2, en respectant le protocole et la barre oblique finale
invalid_scopePortée mal orthographiée ou séparateur incorrectUtiliser exactement identify role_connections.write, séparés par une espace encodée
invalid_grantCode d'autorisation déjà consommé ou expiréRecommencer la liaison ; un code n'est utilisable qu'une fois et expire rapidement
Le rôle n'est pas attribué malgré la liaisonLes seuils configurés ne sont pas atteintsConsulter les critères affichés par Discord et vérifier vos valeurs actuelles
Les valeurs affichées sont obsolètesAucune synchronisation depuis la dernière évolutionRefaire la liaison pour forcer une mise à jour immédiate
Erreur 401 lors de l'écriture des métadonnéesJeton expiré ou révoqué par l'utilisateurRafraîchir le jeton, ou inviter l'utilisateur à relier son compte
Erreur 403 lors de l'écriturePortée role_connections.write non accordéeVérifier la portée demandée dans l'URL d'autorisation
Erreur 429Limite de débit atteinteRespecter l'en-tête Retry-After et espacer les requêtes
La page de vérification ne s'ouvre pasBloqueur de fenêtres, extension de navigateur, hébergement indisponibleAutoriser l'ouverture, désactiver temporairement les extensions, vérifier l'hébergement
« Cette application ne peut pas être vérifiée »URL déclarée inaccessible ou certificat invalideVérifier que la page répond en HTTPS avec un certificat valide, sans redirection en boucle

Questions fréquentes

La liaison est-elle obligatoire pour utiliser ElSigm ?

Non, en aucune manière. L'intégralité des fonctionnalités du bot — publication d'annonces, configuration InterPub, commandes utilitaires, programme Premium — fonctionne sans liaison. Les rôles liés constituent un service additionnel entièrement facultatif.

Une seule liaison suffit-elle pour tous les serveurs ?

Oui. La liaison s'établit entre votre compte et l'application ElSigm, non entre votre compte et un serveur particulier. Une fois établie, elle est utilisable par tous les serveurs configurant des rôles liés fondés sur ElSigm.

Mes statistiques sont-elles visibles par tout le monde ?

Non. Un serveur ne voit que ce qu'il a lui-même configuré comme critère, et sous forme de satisfaction ou non du seuil. Un serveur exigeant « au moins dix annonces » sait que vous atteignez ce seuil, sans connaître votre nombre exact.

Que se passe-t-il si mes statistiques évoluent ?

Les métadonnées sont actualisées lors des synchronisations. Si une valeur passe en dessous d'un seuil, Discord retire automatiquement le rôle correspondant. Le mécanisme fonctionne dans les deux sens.

Puis-je lier plusieurs comptes Discord ?

Chaque compte se lie indépendamment, avec ses propres statistiques. En revanche, la création de comptes multiples destinée à contourner une mesure de modération constitue une violation des Conditions d'Utilisation.

La liaison expose-t-elle mon compte à un risque ?

Les portées demandées ne permettent ni de publier en votre nom, ni de rejoindre des serveurs, ni de lire vos messages, ni d'accéder à votre adresse électronique. Le risque est donc structurellement très faible. La seule précaution réellement importante consiste à vérifier que l'écran d'autorisation se trouve bien sur discord.com.

Que devient la liaison si le bot est retiré de mon serveur ?

La liaison subsiste, puisqu'elle concerne votre compte et non un serveur. En revanche, les critères dépendant de la présence du bot — comme le nombre de serveurs gérés — évolueront lors de la prochaine synchronisation.

Combien de temps les jetons sont-ils conservés ?

Le jeton d'accès est valable une semaine et renouvelé automatiquement au moyen du jeton de rafraîchissement. Les deux sont invalidés instantanément dès que vous révoquez l'accès depuis vos paramètres Discord.

Puis-je consulter les valeurs transmises ?

Oui, dans vos paramètres Discord, à la rubrique des applications autorisées. La commande /profil du bot affiche par ailleurs les mêmes informations sous une forme plus lisible.

Que faire en cas de valeur erronée ?

Signalez-le sur le serveur de support en précisant votre identifiant et la valeur contestée. Une correction sera opérée si une erreur est constatée.

Sécurité et bonnes pratiques

Reconnaître une page légitime

  • L'écran d'autorisation se trouve toujours sur discord.com, jamais ailleurs.
  • Aucune page d'ElSigm ne vous demandera jamais votre mot de passe Discord.
  • Aucun code d'authentification à deux facteurs ne vous sera jamais réclamé par ElSigm.
  • Aucun jeton de compte ne vous sera jamais demandé, sous aucun prétexte, par aucun membre de l'équipe.
  • Les portées affichées doivent correspondre exactement à celles documentées sur cette page.

En cas de doute

Fermez l'onglet, n'entrez aucun identifiant et signalez l'adresse suspecte sur le serveur de support. Si vous avez saisi vos identifiants sur une page douteuse, changez immédiatement votre mot de passe Discord, activez l'authentification à deux facteurs et révoquez toutes les sessions actives depuis vos paramètres.

Mesures appliquées côté ElSigm

  • Le secret d'application n'est jamais exposé au navigateur.
  • Un paramètre state aléatoire à usage unique protège contre les requêtes forgées.
  • Les jetons sont stockés hors de portée du code exécuté côté client.
  • Seules deux portées, strictement nécessaires, sont demandées.
  • L'ensemble des échanges emprunte des connexions chiffrées.
  • Aucune donnée de liaison n'est transmise à un tiers.

Principe de moindre privilège

ElSigm ne demande que ce dont il a strictement besoin. Si vous constatez un jour un écran d'autorisation réclamant des portées supplémentaires — accès aux serveurs, à l'adresse électronique, à la possibilité de rejoindre des communautés — n'autorisez pas et signalez-le : cette page fait foi quant aux portées légitimement demandées.

Aspects juridiques de la liaison

Base légale

Le traitement mis en œuvre par la liaison repose sur votre consentement, au sens de l'article 6.1.a du RGPD. Ce consentement est libre, spécifique, éclairé et univoque : vous cliquez volontairement sur un bouton d'autorisation présentant explicitement le périmètre des accès demandés.

Retrait du consentement

Le retrait s'opère par la révocation décrite plus haut. Il est aussi simple à exercer que le consentement lui-même l'a été, conformément à l'article 7.3 du RGPD.

Finalité

La finalité est unique et déterminée : permettre l'attribution automatique de rôles Discord sur la base de critères vérifiés. Aucune autre exploitation n'est faite des données consultées à cette occasion.

Durée de conservation

Les jetons sont conservés le temps nécessaire au maintien de la liaison et supprimés à la révocation. Les statistiques transmises préexistaient à la liaison et suivent les durées documentées dans la Politique de Confidentialité.

Vos droits

Les droits d'accès, de rectification, d'effacement, de limitation, d'opposition et de portabilité s'appliquent pleinement. Leurs modalités d'exercice sont détaillées dans la section correspondante de la Politique de Confidentialité.

Documents applicables

L'usage de cette page est soumis aux Conditions d'Utilisation et à la Politique de Confidentialité d'ElSigm, ainsi qu'aux Conditions de Service de Discord.

Glossaire technique

TermeDéfinition
OAuth 2.0Protocole standard d'autorisation permettant à une application d'agir dans un périmètre limité au nom d'un utilisateur, sans jamais connaître son mot de passe.
Portée (scope)Périmètre d'autorisation demandé. Chaque portée délimite précisément ce que l'application peut faire.
Code d'autorisationJeton temporaire à usage unique remis après votre consentement, échangé ensuite contre un jeton d'accès.
Jeton d'accèsClé technique permettant d'appeler l'interface de programmation en votre nom, dans les limites des portées accordées. Valable une semaine.
Jeton de rafraîchissementClé permettant d'obtenir un nouveau jeton d'accès sans nouvelle intervention de votre part.
StateValeur aléatoire transmise à l'aller et vérifiée au retour, protégeant contre les requêtes forgées.
Métadonnée de rôle liéValeur certifiée par une application et comparée à un seuil pour décider de l'attribution d'un rôle.
Profil de connexionEspace de votre compte Discord où les applications inscrivent leurs métadonnées certifiées.
Adresse de redirectionAdresse vers laquelle Discord vous renvoie après autorisation. Elle doit être déclarée au préalable.
Secret d'applicationClé confidentielle de l'application, à ne jamais exposer publiquement.

Pour aller plus loin

La documentation officielle de Discord relative aux rôles liés et au protocole OAuth 2.0 est disponible sur le portail développeur. La page relative au point de terminaison des interactions complète ce dispositif du point de vue de l'architecture serveur.