0.2.2 • Published 10 months ago

passport-eveonline-oauth2-2023 v0.2.2

Weekly downloads
-
License
MIT
Repository
github
Last release
10 months ago

Passport strategy for EVE Online SSO OAuth 2.0

Passport strategies for authenticating with EVE Online using ONLY OAuth 2.0.

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

Install

$ npm install passport-eveonline-oauth2-2023

Usage of OAuth 2.0

Create an Application

Before using passport-eveonline-sso, you must register your application with EVE Online Developers site

You will also need to configure an Endpoint redirect URI (callbackURL) and scopes your application has access to.

Configure Strategy

The EVE Online SSO authentication strategy authenticates users using a EVE Online account and OAuth 2.0 tokens. The clientID and clientSecret obtained when creating an application are supplied as options when creating the strategy. The strategy also requires a verify callback, which receives the access token and optional refresh token, as well as profile which contains the authenticated user's profile. The verify callback must call cb providing a user to complete authentication.

passport.use(new EveOnlineSsoStrategy({
    clientID: EVEONLINE_CLIENT_ID,
    clientSecret: EVEONLINE_CLIENT_SECRET,
    callbackURL: 'http://localhost:3000/auth/eveonline'
    scope: ''
  },
  function(accessToken, refreshToken, profile, cb) {
    // We have a new authenticated session, you can now store and/or use the accessToken and refreshToken to call EVE Swagger Interface (ESI) end points.

    return done(null, profile);
  }
));

Note about Local environment

Avoid usage of Private IP, otherwise you will get the device_id device_name issue for Private IP during authentication.

A workaround consist to set up thru the google cloud console a fully qualified domain name such as http://mydomain:3000/ for the callback then edit your /etc/hosts on your computer and/or vm to point on your private IP.

Also both sign-in button + callbackURL has to be share the same url, otherwise two cookies will be created and it will lead to lost your session

Authenticate Requests

Use passport.authenticate(), specifying the 'eveonline-sso' strategy, to authenticate requests.

For example, as route middleware in an Express application:

app.get('/auth/eveonline',
  passport.authenticate('eveonline-sso'));

app.get( '/auth/eveonline/callback',
	passport.authenticate( 'eveonline-sso', {
		successRedirect: '/auth/eveonline/success',
		failureRedirect: '/auth/eveonline/failure'
}));

Credits

License

The MIT License