Intro to the Dashboard

Get a run down on how the bot is managed through the external dashboard.

SajuukBot will be ceasing operations on March 31st 2024, due to a variety of factors. For more information, please refer to the announcement provided on the SajuukBot discord server and your options for migrating to a new bot.

The dashboard is the method in which the configuration for a guild is managed. Although the dashboard exists to allow this, it is fundamentally a separate system and has no link to anything within your guild, so permissions on roles or presence in the server has no bearing on anything. For other people to be able to edit (or view) your bot configuration, they need to be granted access to do so and must be a member of the dashboard.

So how does access grants work with the dashboard? Accessing a page associated to a guild is controlled by a permission that matches what you can view on the page. Permissions work on the simple basis of a yes/no system, where if you can access the page, you can do whatever is associated with that page (the exception is config management and the guild information pages).

Logging In

The logging in process of the dashboard has been made very secure and seamless. Rather than having you set up an account with a password and requiring security measures like 2FA, we use Discord authentication. This works because all you need is a discord account and authorise the dashboard login flow to request access to your profile data that allows the dashboard to know what it should show you (ie the guilds you're able to manage).

When authorising, the dashboard will ask for one permission only:

• identity: This allows the dashboard backend to know what your User ID, Username and Discriminator are. The point of the ID is to associate you with what permissions you have. Username and Discriminator are purely for ease of access reasons, so other users know who is represented by a User ID.

When authorised, you will be directed to the guild home page. In some cases, you might authorise with Discord but be directed to an archive and not the homepage: this is a convenience feature if you happen to click on archive URLs generated by the bot in modlogs or by the appropriate command, allowing you to bypass the need to click the URL again after authorising.

Now you've logged in and you'll see what guilds you can manage, if any. But what are the different permissions and levels? Head to the Permissions page to find out more.