Configuration Discord

Inviter le bot QuantumLogs

Pour que QuantumLogs puisse vérifier l'appartenance à votre serveur Discord et les rôles de vos membres, vous devez inviter le bot officiel sur votre serveur :

Inviter le bot QuantumLogs sur votre serveur Discord

Le bot n'a besoin d'aucune permission particulière. Il sert uniquement à vérifier que les membres possèdent bien le rôle requis. Il ne lit pas les messages, ne modère pas, et n'interagit pas avec votre serveur.

Sans le bot, seul le propriétaire pourra se connecter au dashboard.

Configurer les rôles

La configuration se fait directement dans l'interface QuantumLogs :

1. Connectez-vous en tant que propriétaire

2. Allez dans Administration > Extensions

3. Cliquez sur Configure à côté de Discord Authentication

Bouton Configure de Discord Authentication

1. Modifiez les champs disponibles :

Champ	Description
Guild ID	ID de votre serveur Discord (pour restreindre l'accès aux membres)
Required Role ID	ID du rôle requis pour accéder au dashboard
Admin Role ID	ID du rôle admin (bypass des restrictions par extension)

1. Cliquez sur Sauvegarder

Obtenir un ID Discord

Pour récupérer les IDs nécessaires, activez d'abord le mode développeur dans Discord : Paramètres > Avancé > Mode développeur.

ID serveur (Guild ID)

Clic droit sur le nom du serveur > Copier l'identifiant

ID rôle (Required Role ID / Admin Role ID)

Paramètres du serveur > Rôles > Clic droit sur le rôle > Copier l'identifiant

Dépannage

"Mauvais rôle" après connexion

• Vérifiez que le Required Role ID correspond bien au rôle attribué à l'utilisateur

• Vérifiez que le Guild ID correspond au bon serveur Discord

• Vérifiez que le bot QuantumLogs est bien présent sur votre serveur Discord

Le bot ne vérifie pas les rôles

• Assurez-vous que le bot est bien invité sur votre serveur Discord

• Vérifiez que le bot n'a pas été kick ou ban du serveur

---

Offre Enterprise : Mode Custom

Le mode Custom est réservé aux offres Enterprise. Il vous permet d'utiliser votre propre application Discord à la place du bot QuantumLogs.

En mode Custom, vous gérez vous-même l'application Discord OAuth. Cela vous donne un contrôle total sur le branding et l'authentification.

1. Créer une application Discord

1. Rendez-vous sur le portail développeur Discord

2. Cliquez sur New Application

3. Donnez un nom à votre application (ex: "QuantumLogs - Mon Serveur")

2. Configurer OAuth2

1. Dans votre application, allez dans OAuth2

2. Ajoutez l'URL de redirection :

   https://votre-instance.quantumlogs.cloud/auth/discord/callback

3. Notez le Client ID et le Client Secret

3. Créer un bot

Un bot est nécessaire pour vérifier l'appartenance au serveur et les rôles :

1. Dans votre application Discord, allez dans Bot

2. Cliquez sur Reset Token et notez le token

3. Activez Server Members Intent dans la section Privileged Gateway Intents

4. Invitez le bot sur votre serveur Discord

4. Configurer dans QuantumLogs

En mode Custom, tous les champs sont accessibles dans l'éditeur de configuration Discord Authentication :

Champ	Description
Client ID	Client ID de votre application Discord
Client Secret	Client Secret de votre application
Bot Token	Token du bot Discord
JWT Secret	Secret pour la signature des tokens (généré automatiquement si vide)
Guild ID	ID de votre serveur Discord
Required Role ID	ID du rôle requis
Admin Role ID	ID du rôle admin

Dépannage mode Custom

Erreur de redirection

• Vérifiez que l'URL de callback dans Discord correspond exactement à celle de votre instance

• Attention : http et https doivent correspondre

Le bot ne voit pas les membres

• Vérifiez que Server Members Intent est activé dans le portail développeur Discord

• Vérifiez que le bot est bien invité sur le serveur