Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including @adonisjs/ally with all npm packages installed. Try it out:

@adonisjs/ally lists no main file and has no index.js, so it can't be directly required. If this is a mistake, please let us know. It may however contain internal files that you can require manually:

// require("@adonisjs/ally/[??]")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

@adonisjs/ally v2.1.3

Social authenticator for AdonisJs Framework

Adonis Ally

NPM Version Build Status Appveyor Coveralls

Adonis Ally is a 1st party authentication provider for AdonisJs apps. It gives you the functionality to authenticate users using social websites like Facebook, Twitter, Google, Github etc :evergreen_tree:

Setup

The setup process is simple like any other provider for AdonisJs.

Install Via Npm

adonis install @adonisjs/ally

Register The Provider

The provider needs to be registered inside start/app.js file.

const providers = [
  '@adonisjs/ally/providers/AllyProvider'
]

BOOM! Now you are good to make use of the ally provider and authenticate your users via available drivers.


Available Drivers

Below is the list of available drivers and you are free to add more.

  1. Facebook
  2. Github
  3. Google
  4. LinkedIn
  5. Twitter
  6. Instagram
  7. Foursquare


Config

Configuration is defined inside a file called config/services.js under ally object.

config/services.js

ally: {
  facebook: {
    clientId: '',
    clientSecret: '',
    redirectUri: ''
  }
}


Getting Started

Below is the list of methods you can make use of to redirect the user and fetch their profile details.

getRedirectUrl()

Get the redirect url for the 3rd party website.

const url = await ally.driver('facebook').getRedirectUrl()

redirect

Redirect to the 3rd party website.

await ally.driver('facebook').redirect()

getUser

Get the user details on the redirect URL.

const user = await ally.driver('facebook').getUser()

If you are working with api and you have an OAuth2 access token you can get the user calling the getUserByToken method.

const user = await ally.driver('facebook').getUserByToken(accessToken)

When you have a OAuth1 access token and Access secret key you can call

const user = await ally.driver('facebook').getUserByToken(accessToken, accessSecret)

All this methods the user is an instance of AllyUser which has following methods to access the user details.

e7f272b... get user from access token

user.getId() // user id
user.getName() // get user name
user.getEmail() // get user email address
user.getNickname() // get user nick name
user.getAvatar() // get user profile picture url
user.getAccessToken() // get access token
user.getRefreshToken() // get refresh token (only when using OAuth2)
user.getExpires() // get access token expiry (only when using OAuth2)
user.getTokenSecret() // get token secret (only when using OAuth1)

Additional Methods

user.toJSON() // get user JSON representation
user.getOriginal() // get the original response object from 3rd party website

:point_right: Read the Official Documentation


Moving Forward

Checkout the official documentation at the AdonisJs website for more info.

Tests

Tests are written using japa. Run the following commands to run tests.

npm run test:local

# report coverage
npm run test

# on windows
npm run test:win

Release History

Checkout CHANGELOG.md file for release history.

Meta

AdonisJs – @adonisframework – virk@adonisjs.com

Checkout LICENSE.txt for license information

Harminder Virk (Aman) - https://github.com/thetutlage

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free