Skip to content

Setup Discord

Configuring Discord for apps using global keys differs from apps using app-specific keys.

Pre-requisites

  • Log in to the Arcana Developer Dashboard: https://dashboard.arcana.network

  • Before you can configure, the app should be registered by creating a new app entry in the dashboard through the 'Create New App' wizard.

Register & Configure

Each app is assigned a unique Client ID upon registration. A default Testnet configuration is linked with the registered app. No social authentication providers are enabled for the app. Passwordless login is enabled for all registered apps automatically.

A registered app can be deployed only at the Arcana Testnet. Developers must create a Mainnet profile using the Arcana Developer Dashboard to deploy a registered app on the Mainnet. Each profile can use identical or different Social Auth settings.

App Identifier
Unique App Identifier: ClientID

Global Keys

Apps that require global keys feature do not need to configure the Social Auth settings in the Arcana Developer Dashboard.

User onboarding via Discord is automatically turned on for the app when global keys are enabled.

Global Keys Setting
Global Keys Setting

Global Keys Configuration Change

In the earlier versions of the Arcana Auth SDK, apps using global keys were required to configure Social Auth settings for the providers. This behavior has changed in the latest release of the Arcana Auth SDK.

If an app was configured for any social login providers and switches over from app-specific to global keyspace later, the Social Auth settings will be disabled altogether.

Global Keys, Social Auth Settings Disabled
Global Keys: Social Auth Settings Disabled

App-specific Keys

Follow these steps to configure the Social Auth settings and enable user onboarding via Discord. It requires developers to use the Arcana Developer Dashboard and the Discord Developer Portal.

Step 1: Get Redirect URI

Select the app in the Manage Apps dashboard screen and click Testnet/Mainnet to configure Discord in the respective configuration profile. Go to Configure > Social Auth. Copy the redirect URI shown on the top right.

Get Redirect URI
Get Redirect URI

Do not close the Social Auth browser tab in the Arcana Developer Dashboard. Open another tab to access the Discord Developer Console and configure Discord OAuth.

Step 2: Get Discord Application ID, Public Key

Go to the Discord Developer Portal and create a new application.

Discord Developer Portal
Discord Developer Portal

Configure OAuth 2.0 credentials for the newly created app entry in the Discord Developer Portal. Select OAuth2 in the Discord Developer Portal and refer to the Redirects field. Use the Redirect URI value copied in the previous step from the Arcana Developer Dashboard.

discord console
Discord OAuth Settings

Save the app settings in the Discord Developer Portal.

Refer to the General Information page in the Discord Developer Portal. Copy the Application ID and the public key. It will be required in the next step while configuring Discord settings using the Arcana Developer Dashboard.

Copy Application ID and Public Key
Copy Application ID and Public Key

Step 3: Update Discord Social Auth Settings

In the Arcana Developer Dashboard, click Configure > Social Auth. Refer to the empty fields next to the "Discord" setting. Paste the Application ID and public key obtained in the previous step as the ClientID and secret, respectively.

Dashboard Update Application ID and Public Key
Dashboard: Update Application ID and Public Key

Save the Social Auth settings.

You are all set with the Discord configuration!


Last update: March 15, 2024 by shaloo, shaloo