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 🌲
The setup process is simple like any other provider for AdonisJs.
adonis install @adonisjs/ally
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.
- Github
- Foursquare
## Config
Configuration is defined inside a file called config/services.js
under ally
object.
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.
Get the redirect url for the 3rd party website.
const url = await ally.driver('facebook').getRedirectUrl()
Redirect to the 3rd party website.
await ally.driver('facebook').redirect()
Get the user details on the redirect URL.
const user = await ally.driver('facebook').getUser()
The user
is an instance of AllyUser
which has following methods to access the user details.
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)
user.toJSON() // get user JSON representation
user.getOriginal() // get the original response object from 3rd party website
👉 Read the Official Documentation
Checkout the official documentation at the AdonisJs website for more info.
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
Checkout CHANGELOG.md file for release history.
AdonisJs – @adonisframework – virk@adonisjs.com
Checkout LICENSE.txt for license information
Harminder Virk (Aman) - https://github.com/thetutlage