Discord-Bot anlegen

Bereich: Einrichtung externer Dienste · Status: aktiv (Modul discord) Verfügbar für: Betreiber; bei Bedarf auch Veranstalter

In einem Satz

Einmalig wird eine Discord-Anwendung mit Bot angelegt – in der Regel vom Betreiber, bei Bedarf auch vom Veranstalter selbst; danach verbindet die Orga ihren Discord-Server im Panel.

Wofür brauche ich das?

• Voraussetzung dafür, dass Cofys Discord-Rollen automatisch vergibt.

Wo finde ich es?

Bei Discord: Developer Portal. In Cofys: GlobalAccessKeys::discord (gilt für alle Instanzen).

So funktioniert es

1. Im Developer Portal New Application anlegen.
2. General Information: die Application ID kopieren (botId).
3. Installation:
   • Installation Contexts: Guild Install
   • Install Link: Discord Provided Link
   • Default Install Settings: Scopes applications.commands und bot, Permission Manage Roles
4. Bot: den Bot-Token erzeugen und kopieren (botToken).
5. OAuth2:
   • Unter Client Secret Reset Secret klicken und das Secret kopieren (oAuthSecret).
   • Unter Redirects beide Adressen eintragen (bei Standard-returnUrl):

     https://oauth.cofys.de/oauth/discord/return/
     https://oauth.cofys.de/oauth/discord/install/

6. Die Werte an den Betreiber übergeben. Er trägt sie in GlobalAccessKeys::discord ein und aktiviert das Modul discord.

Einstellungen und Optionen

Parameter (GlobalAccessKeys::discord)	Inhalt
botId	Application ID
botToken	Bot-Token
oAuthSecret	Client Secret
returnUrl	Basisadresse der Weiterleitung, Standard https://oauth.cofys.de/oauth/discord/

Was passiert automatisch?

Discord leitet nach Anmeldung bzw. Bot-Installation an die zentrale Weiterleitung (oauth.cofys.de). Diese erkennt die Instanz am Parameter state und leitet weiter – so muss bei Discord nur eine Adresse für alle Instanzen hinterlegt werden.

Grenzen und Besonderheiten

• Die Redirects lauten <returnUrl>return/ und <returnUrl>install/. Die alte Anleitung nannte Adressen ohne /oauth/ und alternativ [Instanz]/auth/discord/… – solche Routen gibt es nicht mehr.

Hängt zusammen mit

• Discord-Server verbinden, App-Anbindungen, Verknüpfte Dienste