Gestion des permissions

Le site lit la liste de tes serveurs directement auprès de Discord, à chaque chargement de page, avec ton compte connecté. Un serveur apparaît dans ton tableau de bord et peut être configuré si tu remplis une de ces conditions :

• tu es propriétaire du serveur ;
• un de tes rôles a la permission Administrateur ;
• un de tes rôles a la permission Gérer le serveur.

• Sans ces droits, l'adresse du serveur affiche une page introuvable.
• Si le bot n'est pas sur le serveur, chaque page affiche « Dispatch.IO™ n'est pas sur ce serveur » avec le bouton Ajouter Dispatch.IO™ ; la page se met à jour toute seule dès que le bot arrive.
• Un changement de rôle sur Discord est pris en compte au prochain chargement de page.

Une fois sur le tableau de bord d'un serveur, le menu de gauche affiche trois groupes : Mon serveur, Configuration et Administration.

1. Mon serveur : traitement des tickets, membres et XP, classements.
2. Configuration : tous les modules du bot.
3. Administration : statistiques et journaux.

Sur le site, il n'existe pas de droits plus fins par page : toute personne qui peut ouvrir le tableau de bord d'un serveur peut en modifier tous les réglages. Pour limiter qui configure le bot, limite qui a Administrateur ou Gérer le serveur sur Discord.

Pour chaque serveur, le bot peut enregistrer des rôles avec un type. Ils n'ont aucun effet sur l'accès au site : ils servent au bot sur Discord.

Le détail (quelles commandes, quelles protections) est dans Permissions et rôles.

Chaque compte du site a un ou plusieurs rôles d'équipe. Tout nouveau compte reçoit le rôle Utilisateur à sa première connexion ; les autres rôles sont attribués par l'équipe Dispatch.IO.

Quand une personne a plusieurs rôles, elle cumule leurs permissions et son rang est le plus élevé. Le rang sert à la hiérarchie : on ne peut modifier les droits que d'une personne de rang strictement inférieur.

Les pages d'administration du site sont décrites dans Configuration globale du bot (réservé à l'équipe).

En plus de ses rôles, une personne peut recevoir une exception sur une permission précise :

Il ne peut y avoir qu'une exception par personne et par permission. Pour décider, le site applique cet ordre :

Aujourd'hui, les exceptions se gèrent pour les permissions de la documentation, dans l'onglet Permissions du back-office de la documentation (section Membres et exceptions). Il faut la permission PERMISSION_ASSIGNMENT_GRANT pour en ajouter, PERMISSION_ASSIGNMENT_REVOKE pour en supprimer, et un rang strictement supérieur à celui de la personne (sinon : « Tu ne peux pas modifier les droits d'un membre de rang égal ou supérieur. »). Chaque exception ajoutée ou retirée est notée dans les Logs d'audit du site.

Les rôles et permissions sont lus depuis la base de données à travers le cache Redis partagé du site et du bot. Chaque changement fait depuis le site vide le cache concerné, il s'applique donc immédiatement :

Un changement fait directement en base (par l'équipe technique, hors site) peut donc mettre jusqu'à 5 minutes (rôles, exceptions) ou 1 heure (permissions par rôle) à s'appliquer. Le blocage d'un compte banni peut lui aussi prendre jusqu'à 5 minutes. Le fonctionnement du cache est détaillé dans Redis et base de données (réservé à l'équipe).

La documentation que tu lis est publique, sauf les espaces, catégories ou pages réservés à une permission. Sept permissions gèrent son back-office :

• Un élément réservé (« Lecture réservée à ») n'est visible que des personnes qui ont la permission choisie : DOCUMENTATION_VIEW, DASHBOARD_VIEW_STATS, BOT_MANAGE, SANCTIONS_VIEW ou AUDIT_VIEW. La restriction s'applique à tout ce qui se trouve dessous.
• Un brouillon n'est visible que des personnes qui ont la permission Voir ou une permission d'édition (Créer, Modifier, Traduire, Publier, Administrer).
• L'onglet Permissions du back-office montre les Droits par rôle (modifiables pour tous les rôles sauf Root et Utilisateur, avec DOCUMENTATION_MANAGE et les permissions d'attribution) et les Membres et exceptions.

Le mode d'emploi complet est dans Permissions de la documentation (réservé à l'équipe).

• Gérer ses serveurs
• Permissions et rôles : les permissions côté bot.
• Connexion et compte
• Synchronisation avec le bot