Sonoran Bot
SupportServer HostingAbout
  • Sonoran Bot
  • Other Products
    • ⌨️Sonoran CAD
    • 📝Sonoran CMS
    • 📡Sonoran Radio
    • 🖥️Sonoran Servers
  • Tutorials
    • Getting Started
    • Sonoran CMS Integration
      • Account Link
      • Role Mapping
      • Import Discord Roles
      • Calendar Event Sync
      • Discord Sync Logic
    • Sonoran CAD Integration
    • Usage
      • Settings
      • Commands
      • Moderation
  • Other
    • Report A Bug
    • Contact Us!
Powered by GitBook
On this page
  • Sync Discord Roles to CAD Permissions
  • 1. Via Sonoran CMS
  • 2. Via Sonoran CAD
  • Setup Guide
  • Permissions Synchronization
  • User Setup
  • Best Practices and FAQ

Was this helpful?

Edit on GitHub
  1. Tutorials

Sonoran CAD Integration

Link Sonoran Bot to Sonoran CAD to sync permissions to Discord roles and other handy features!

PreviousDiscord Sync LogicNextUsage

Last updated 6 months ago

Was this helpful?

Sync Discord Roles to CAD Permissions

Easily manage Sonoran CAD permissions by syncing them with Discord roles.

To sync Discord roles with CAD permissions you will need either:

: The FREE version of Sonoran CAD and Sonoran CMS

: The PLUS version of Sonoran CAD

1. Via Sonoran CMS

In addition to automatically adding users to your CAD when applications are accepted, can also manage your community's CAD and permissions!

2. Via Sonoran CAD

Role mapping via Sonoran CAD and Discord directly requires the PLUS version of Sonoran CAD or higher.

Setup Guide

Permissions Synchronization

Additionally, you must have the Manage Server permission on the Discord server in order to set up this process.

The bot provides a brand new menu to assist you with assigning roles to permissions. To start, select the role you wish to map permissions to from the dropdown.

Once you've selected a role, you can use the linked tool to toggle what permissions that a user with this role should receive. It will generate a number corresponding to the selected permissions that you can copy and input in the next step.

Clicking Set Mapping will present an option to specify a code (generated using the linked tool) or an existing permission key. Enter "0" as the permission mask to delete the current mapping instead.

Successfully entering this information will bring you back to the main role mapping screen with the new permission set.

User Setup

  1. Every user in the Discord will then use /linkme to link their Sonoran CAD account to their current Discord account. This will automatically populate their API ID.

  2. Community members can use the /sync command in Discord to force a permissions sync.

  3. Communities should no longer use public permission keys in the CAD, as the bot will automatically remove CAD permissions from users if they don't have a Discord role for it.

Whenever a role is added or removed, the bot will automatically update the user's permissions to match.

If the user ever leaves the server, the bot will immediately remove all permissions from their account, although they will still be in the community.

Changing your Account Secret ID

Sometimes, you may wish to change your secret ID. If you do so, you must run /linkme again or the bot will remove all your permissions on Sonoran CAD (if the optional security setting below is enabled).

Best Practices and FAQ

  • It is advised to not sync potentially dangerous permissions (such as Admin Access permissions) with Discord roles unless you trust staff with that role, or it's just you.

  • The community owner is completely ignored during the synchronization process.

  • "Principle of Least Privilege" should be exercised during this setup. Don't give out permissions you don't think users performing the role would need.

  • Discontinue use of permission keys ASAP. The bot "takes over" synchronization and will remove permissions granted by permission keys if they don't have a role that grants it.

    • Same goes for manual permission grants, unless there is no role granting that permission.

Every user in the Discord will get their .

Secret ID from their Settings page
Sonoran CMS
Radio
Add Sonoran Bot to your Discord
Map Discord Roles to CMS Ranks
Map CAD Permissions to CMS Ranks
Option 1
Option 2
SonoranBot - CAD Role Mapping
SonoranBot - CAD Role Mapping
SonoranBot - CAD Role Mapping
SonoranBot - CAD Role Mapping