Setup Discord Single Sign-on with Drupal OAuth Client

Overview

Drupal Discord SSO integration will allow you to configure Single Sign-On ( SSO ) login between your Drupal site and Discord using OAuth/OpenID protocol. Drupal OAuth 2.0/OpenID connect module gives the ability to enable login using OAuth 2.0/OIDC Single Sign-On to Drupal Site. We provide the Drupal OAuth/OpenID Client module for Drupal 7, Drupal 8, Drupal 9 and Drupal 10, Drupal 11.

Installation Steps

• Using Composer
• Using Drush
• Manual Installation

• Download the module:

  composer require 'drupal/miniorange_oauth_client'

• Navigate to Extend menu on your Drupal admin console and search for miniOrange OAuth Client Configuration using the search box.
• Enable the module by checking the checkbox and click on the Install button.
• You can configure the module at:

  {BaseURL}/admin/config/people/miniorange_oauth_client/config_clc

• Install the module:

  drush en drupal/miniorange_oauth_client

• Clear the cache:

   drush cr

• You can configure the module at:

  {BaseURL}/admin/config/people/miniorange_oauth_client/config_clc

• Navigate to Extend menu on your Drupal admin console and click on Install new module.
• Install the Drupal OAuth & OpenID Connect Login - OAuth2 Client SSO Login module either by downloading the zip or from the URL of the package (tar/zip).
• Click on Enable newly added modules.
• Enable this module by checking the checkbox and click on install button.
• You can configure the module at:

  {BaseURL}/admin/config/people/miniorange_oauth_client/config_clc

Configuration Steps

Setup Drupal as OAuth Client

• After installing the module, navigate to the Configuration -> miniOrange OAuth Client Configuration -> Configure OAuth tab and select Discord from the Select Application dropdown list.
• Copy the Callback/Redirect URL and keep it handy.

Note: If your provider only supports HTTPS Callback/Redirect URLs and you have an HTTP site, please make sure to enable the 'Enforce HTTPS Callback URL' checkbox at the bottom of the tab.

• Enter the application name in the Display Name text field. For example, Discord.

Create Application in Discord

• Log in to the Discord Developer portal.
• Select Application from the left navigation panel, then click the New Application button.

• A popup will display, in which you can enter the name of the application in the Name text field.
• Then, click the checkbox to agree to the Discord Developer terms and conditions before clicking the Create button.

• Under OAuth2 click the Add Redirect button and enter the copied Callback/Redirect URL from Drupal into the Redirects text field.
• Once completed, click the Save Changes button.

Integrating Drupal with Discord

• Navigate to the Discord portal.
• Under the OAuth2 panel, copy the CLIENT ID from the Client information section.

• In Drupal’s Configure OAuth tab paste the copied Client ID into the Client ID textfield.

• Go, back to the Discord portal.
• Click the Reset Secret button under CLIENT SECRET in the Client information section.

• Open a REGENERATE SECRET KEY? popup and click the Yes, do it! button.

• By clicking the Copy button, you can copy CLIENT SECRET from the Client information area.

• Navigate to the Drupal's Configure OAuth tab and paste the CLIENT SECRET into the Client Secret text field.

• Please confirm the Scope and Endpoints from the table below and click on the Save Configuration button.

Scope	identify+email
Authorize Endpoint	https://discordapp.com/api/oauth2/authorize
Access Token Endpoint	https://discordapp.com/api/oauth2/token
Get User Info Endpoint	https://discordapp.com/api/users/@me

Test Configuration of Drupal with Discord

• Click on the Perform Test Configuration button to test the connection.

• On a Test Configuration popup, if you don't have an active session in Discord on the same browser, you'll be prompted to sign in to Discord. Once successfully logged in, you'll receive a list of attributes retrieved from Discord.
• Select the Email Attribute from the dropdown menu in which the user's email ID is obtained and click on the Done button.

• Once clicked on Done button, you will be redirected to the Attribute & Role Mapping tab, in which you can select the Username Attribute from the dropdown list and click on Save Configuration button

Please note: Mapping the Email Attribute is mandatory for your login to work.

How to perform the SSO

• Open a new browser/private window and navigate to the Drupal site login page.
• Click on the Login using Discord link to initiate the SSO from Drupal.
• If you want to add the SSO link on other pages, please follow the steps given in the image below: