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
| Aspect | Rôle classique | Rôle lié |
|---|---|---|
| Attribution | Manuelle, par un modérateur | Automatique, par Discord, selon un critère certifié |
| Vérifiabilité | Repose sur la parole du membre | Repose sur une donnée certifiée par l'application |
| Mise à jour | Aucune, sauf action manuelle | Actualisée lors de chaque synchronisation |
| Consentement | Non requis | Autorisation explicite du membre, révocable |
| Portabilité | Limitée à un serveur | La liaison vaut pour tous les serveurs utilisant ElSigm |
| Charge de modération | Élevée | Nulle 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é | Type | Signification | Exemple de règle |
|---|---|---|---|---|
verifie | Compte vérifié | Booléen | La modération a autorisé les publications de ce compte | Est vrai |
premium | Membre Premium | Booléen | Le compte bénéficie du programme d'annonces automatiques | Est vrai |
proprietaire_serveur | Propriétaire d'un serveur du réseau | Booléen | Le compte possède au moins un serveur où ElSigm est installé | Est vrai |
pubs_envoyees | Annonces diffusées | Entier | Nombre total d'annonces diffusées via le réseau | Supérieur ou égal à 10 |
serveurs_geres | Serveurs connectés | Entier | Nombre de serveurs du réseau détenus par le compte | Supérieur ou égal à 1 |
points | Points de contribution | Entier | Score de participation cumulé | Supérieur ou égal à 100 |
niveau | Niveau | Entier | Niveau de progression atteint | Supérieur ou égal à 5 |
avertissements | Avertissements | Entier | Nombre d'avertissements reçus | Inférieur ou égal à 0 |
membre_depuis | Membre du réseau depuis | Date | Date de la première annonce validée | Antérieure à 30 jours |
compte_cree_le | Compte Discord créé le | Date | Date de création du compte Discord | Anté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 }
]
| Type | Nom technique | Comparaison effectuée |
|---|---|---|
1 | INTEGER_LESS_THAN_OR_EQUAL | La valeur doit être inférieure ou égale au seuil |
2 | INTEGER_GREATER_THAN_OR_EQUAL | La valeur doit être supérieure ou égale au seuil |
3 | INTEGER_EQUAL | La valeur doit être exactement égale au seuil |
4 | INTEGER_NOT_EQUAL | La valeur doit être différente du seuil |
5 | DATETIME_LESS_THAN_OR_EQUAL | La date doit précéder le seuil en jours |
6 | DATETIME_GREATER_THAN_OR_EQUAL | La date doit suivre le seuil en jours |
7 | BOOLEAN_EQUAL | La valeur doit valoir 1 |
8 | BOOLEAN_NOT_EQUAL | La 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é)
- Ouvrez le serveur concerné
Rendez-vous sur le serveur Discord qui propose un rôle lié fondé sur ElSigm.
- 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.
- 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.
- Lancez la vérification
Cliquez sur Vérifier en face d'ElSigm. Discord ouvre alors cette page dans votre navigateur.
- Autorisez la connexion
Un écran d'autorisation Discord s'affiche, détaillant précisément les accès demandés. Cliquez sur Autoriser.
- 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
- Cliquez sur le bouton de liaison
Utilisez le bouton Lier mon compte Discord en haut de cette page.
- 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.
- 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.
- Autorisez
La liaison est enregistrée. Elle vaut pour l'ensemble des serveurs utilisant ElSigm comme source de rôles liés.
- 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
1361056395524313158identify · role_connections.writecode (flux d'autorisation avec code)à configurerstate aléatoire, vérifié au retour—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.
| Action | Autorisée | Précision |
|---|---|---|
| Lire votre identifiant Discord | Oui | Nécessaire pour retrouver vos statistiques |
| Lire votre nom d'utilisateur et votre avatar | Oui | Inclus dans identify, non conservé |
| Écrire les métadonnées d'ElSigm dans votre profil | Oui | Objet même de la liaison |
| Lire votre adresse électronique | Non | Portée email non demandée |
| Lire la liste de vos serveurs | Non | Portée guilds non demandée |
| Rejoindre des serveurs en votre nom | Non | Portée guilds.join non demandée |
| Lire vos messages ou vos conversations privées | Non | Aucune portée OAuth ne le permet |
| Vous ajouter ou vous retirer des rôles directement | Non | L'attribution est opérée par Discord, pas par ElSigm |
| Modifier votre profil, votre pseudonyme ou votre avatar | Non | Hors périmètre des portées demandées |
| Accéder à votre mot de passe | Non | Techniquement impossible pour toute application tierce |
| Accéder à vos moyens de paiement | Non | Aucune 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
- Ouvrez vos paramètres utilisateur
Cliquez sur l'engrenage situé en bas à gauche de l'interface Discord.
- Allez dans « Applications autorisées »
La rubrique se trouve sous « Paramètres avancés » ou « Connexions » selon la version de l'application.
- Repérez ElSigm
L'entrée porte le nom de l'application et rappelle les portées accordées.
- 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
- Ouvrez les paramètres du serveur
Clic droit sur le nom du serveur, puis Paramètres du serveur.
- 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.
- Ouvrez l'onglet « Liens »
Cet onglet apparaît dans les paramètres du rôle sélectionné.
- Ajoutez une condition
Cliquez sur Ajouter une condition puis choisissez ElSigm dans la liste des applications proposées.
- 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.
- Combinez si nécessaire
Plusieurs conditions peuvent être ajoutées à un même rôle. Elles se cumulent : toutes doivent être satisfaites simultanément.
- Enregistrez
Le rôle devient immédiatement disponible dans la rubrique Rôles liés accessible à vos membres.
- Communiquez
Annoncez la disponibilité du rôle dans un salon d'annonces, en expliquant la démarche à suivre.
Exemples de configurations éprouvées
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.
Vétéran du réseau
Conditions : pubs_envoyees ≥ 50 et membre_depuis antérieur à 90 jours. Distingue les contributeurs de longue date.
Soutien Premium
Condition : premium égal à vrai. Ouvre un salon d'échange privilégié et un accès prioritaire au support.
Cercle des propriétaires
Condition : serveurs_geres ≥ 1. Réunit les personnes gérant effectivement une communauté du réseau.
Dossier vierge
Conditions : avertissements ≤ 0 et verifie égal à vrai. Réserve un rôle de confiance aux comptes sans historique de sanction.
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.
- Ouvrez le portail développeur
Rendez-vous sur discord.com/developers/applications et connectez-vous avec le compte propriétaire de l'application.
- Sélectionnez l'application
Choisissez ElSigm, identifiant
1361056395524313158. - 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.
- 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. - 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.
- 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.
- 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 portail | Valeur à renseigner | Obligatoire |
|---|---|---|
| Terms of Service URL | Adresse de conditions-utilisation.html | Recommandé |
| Privacy Policy URL | Adresse de politique-confidentialite.html | Recommandé |
| Linked Roles Verification URL | Adresse de verification-roles-lies.html | Requis pour les rôles liés |
| Interactions Endpoint URL | Voir la page dédiée | Non requis en mode passerelle |
| OAuth2 Redirects | Adresse exacte de votre point de retour | Requis pour le flux OAuth |
Dépannage
| Symptôme | Cause probable | Résolution |
|---|---|---|
| ElSigm n'apparaît pas dans la liste des applications | URL de vérification non renseignée dans le portail | Compléter le champ Linked Roles Verification URL et patienter quelques minutes |
invalid_redirect_uri | L'adresse de redirection ne figure pas dans la liste déclarée | L'ajouter à l'identique dans l'onglet OAuth2, en respectant le protocole et la barre oblique finale |
invalid_scope | Portée mal orthographiée ou séparateur incorrect | Utiliser exactement identify role_connections.write, séparés par une espace encodée |
invalid_grant | Code 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 liaison | Les seuils configurés ne sont pas atteints | Consulter les critères affichés par Discord et vérifier vos valeurs actuelles |
| Les valeurs affichées sont obsolètes | Aucune synchronisation depuis la dernière évolution | Refaire la liaison pour forcer une mise à jour immédiate |
| Erreur 401 lors de l'écriture des métadonnées | Jeton expiré ou révoqué par l'utilisateur | Rafraîchir le jeton, ou inviter l'utilisateur à relier son compte |
| Erreur 403 lors de l'écriture | Portée role_connections.write non accordée | Vérifier la portée demandée dans l'URL d'autorisation |
| Erreur 429 | Limite de débit atteinte | Respecter l'en-tête Retry-After et espacer les requêtes |
| La page de vérification ne s'ouvre pas | Bloqueur de fenêtres, extension de navigateur, hébergement indisponible | Autoriser 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 invalide | Vé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
statealé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
| Terme | Définition |
|---|---|
| OAuth 2.0 | Protocole 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'autorisation | Jeton temporaire à usage unique remis après votre consentement, échangé ensuite contre un jeton d'accès. |
| Jeton d'accès | Clé 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îchissement | Clé permettant d'obtenir un nouveau jeton d'accès sans nouvelle intervention de votre part. |
| State | Valeur 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 connexion | Espace de votre compte Discord où les applications inscrivent leurs métadonnées certifiées. |
| Adresse de redirection | Adresse vers laquelle Discord vous renvoie après autorisation. Elle doit être déclarée au préalable. |
| Secret d'application | Clé 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.