passport-discordapp

Passport strategy for authenticating with Discord using the OAuth 2.0 API.

This module lets you authenticate using Discord in your Node.js applications. By plugging into Passport, Discord authentication can be easily and unobtrusively integrated into any application or framework that supports Connect-style middleware, including Express.

Install

// Not yet added to npm

Usage

Create an Application

Before using passport-discord, you must register an application with Discord. If you have not already done so, a new application can be created at Discord's Developer Site. Your application will be issued a Client ID and Client Secret, which need to be provided to the strategy. You will also need to configure a callback URL which matches the route in your application.

Configure Strategy

The Dircord authentication strategy authenticates users using a Dircord account and OAuth tokens. The strategy requires a verify callback, which accepts these credentials and calls done providing a user, as well as options specifying a Client ID, Client Sectret, and callback URL.

A scope is required, all scopes are available here

At a miminum, your application must request the identify scope for this strategy to access the authenticating user's profile.

passport.use(new DiscordStrategy({
    clientID: DISCORD_CLIENT_ID,
    clientSecret: DISCORD_CLIENT_SECRET,
    callbackURL: "http://127.0.0.1:3000/auth/discord/callback",
    scope: ["identify"]
  },
  function(accessToken, refreshToken, profile, done) {
    User.findOrCreate({ discordId: profile.id }, function (err, user) {
      return done(err, user);
    });
  }
));

Authenticate Requests

Use passport.authenticate(), specifying the 'discord' strategy, to authenticate requests.

For example, as route middleware in an Express application:

app.get('/auth/discord', passport.authenticate('discord'));
 
app.get('/auth/discord/callback', 
  passport.authenticate('discord', { failureRedirect: '/login' }),
  function(req, res) {
    // Successful authentication, redirect home.
    res.redirect('/');
  }
);

Credits

• John Kernke

License

The MIT License

Copyright for portions of Passport-Discord are held by John Kernke, 2014 as part of Passport-Twitchtv. All other copyright for Passport-Discord are held by Matthew Odette, 2016.