Discord

Sign in to the Discord Developer PortalCopy Anchor Link

Go to the Discord Developer Portal and sign in with the Discord account that should own the application.

Create a new applicationCopy Anchor Link

Press New Application, give it the name visitors will see on the authorization screen, and accept the terms.

Add the redirect URLCopy Anchor Link

Open OAuth2 in the left navigation and, under Redirects, press Add Redirect. Paste the URI for the origin you are running and save.

VitNode builds this URI from VITNODE_WEB_URL, so it has to match exactly, with no trailing slash and no locale prefix.

Add both entries so one application covers local development and your live site.

Copy the client ID and secretCopy Anchor Link

Still on the OAuth2 page, the Client ID and Client Secret are in the client information block at the top. Discord shows the secret once, so press Reset Secret if it was never revealed or you have lost it.

Set the environment variablesCopy Anchor Link

These are server-side variables, so leave them out of clientEnv. That list publishes a value to the browser bundle, and a client secret in the browser bundle is a client secret you have published.

DISCORD_CLIENT_ID=1234567890123456789
DISCORD_CLIENT_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Add the adapterCopy Anchor Link

Add DiscordSSOApiPlugin to authorization.ssoAdapters in the API's vitnode.api.config.ts (where it lives), next to any adapters you already have. Keep the rest of the config as it is:

import { DiscordSSOApiPlugin } from '@vitnode/core/api/adapters/sso/discord'
import { buildApiConfig } from '@vitnode/core/vitnode.config'

export const vitNodeApiConfig = buildApiConfig({
  // ...
  authorization: {
    ssoAdapters: [
      // ...
      DiscordSSOApiPlugin({
        clientId: process.env.DISCORD_CLIENT_ID,
        clientSecret: process.env.DISCORD_CLIENT_SECRET,
      }),
    ],
  },
})

No authorization block yet? Create one with just ssoAdapters, as in the SSO setup. Then restart the dev server, since .env and the API config are only read at start-up.

Check the resultCopy Anchor Link

Open /login in a private window and press the Discord button under Continue with. You should see Discord's "connect to" authorization prompt listing your username and email, get bounced back to /login/sso/discord?code=...&state=..., and land on the front page signed in.