ember-oauther
v3.0.1
Published
Ember OAuther is a set of providers and routers to connect OAuth 1.0a and OAuth 2.0 services like facebook, google etc.
Downloads
30
Maintainers
Readme
ember-oauther
OAuther is a set of providers and routes to connect OAuth 1.0a and OAuth 2.0 services like facebook, google etc.
Very similar to Torii but no session manager and no adapter.
Compatibility
- Ember.js v3.28 or above
- Ember CLI v3.28 or above
- Node.js v14 or above
Installation
ember install ember-oauther
Usage
OAuth 1.0a is a 4 step process. Some steps in some providers are not allowed to use in clients (CORS). Which this is understandable because client secret must be secret. Clients are not a good place for this.
| Provider | Request Token (requestTokenEndpoint) | Authentication (authenticationEndpoint) | Access Token (accessTokenEndpoint) | User Information (userInformationEndpoint) | | -------- | ------------------------------------ | --------------------------------------- | ---------------------------------- | ------------------------------------------ | | Twitter | :x: | :heavy_check_mark: | :x: | :x: |
Oauth 2.0 is a 3 step process. Some steps in some providers are not allowed to use in clients (CORS). Which this is understandable because client secret must be secret. Clients are not a good place for this.
| Provider | Authorization (authorizationEndpoint) | Access Token (tokenEndpoint) | User Information (userInformationEndpoint) | | ------------- | ------------------------------------- | ---------------------------- | ------------------------------------------ | | Google | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | Microsoft | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | Facebook | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | Instagram | :heavy_check_mark: | :x: | :x: | | GitHub | :heavy_check_mark: | :x: | :heavy_check_mark: | | LinkedIn | :heavy_check_mark: | :x: | :x: | | Yandex | :heavy_check_mark: | :heavy_check_mark: | :x: | | Twitch | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | StackExchange | :heavy_check_mark: | :x: | :x: |
All required parameters should be in environment with a name ember-oauther
.
If you are seeing :x: in the provider line that you want to use and it's ok to send client secret in plain text. You have 3 options;
- Set your own endpoint
url
. For example:
ENV['ember-oauther'] = {
instagram: {
clientId: '...',
clientSecret: '....',
redirectUri: 'https://localhost:4200/instagram-sign-in',
scope: 'user_profile',
fields: 'id,username',
tokenEndpoint: {
url: 'your token endpoint url',
}
}
- Use
useCorsProxy
parameter withoutcorsProxyEndpoint
parameter. For example:
ENV['ember-oauther'] = {
instagram: {
clientId: '...',
clientSecret: '....',
redirectUri: 'https://localhost:4200/instagram-sign-in',
scope: 'user_profile',
fields: 'id,username',
tokenEndpoint: {
useCorsProxy: true,
}
}
By default it will use https://cors-anywhere.herokuapp.com
.
- Use
useCorsProxy
parameter withcorsProxyEndpoint
parameter. For example:
ENV['ember-oauther'] = {
instagram: {
clientId: '...',
clientSecret: '....',
redirectUri: 'https://localhost:4200/instagram-sign-in',
scope: 'user_profile',
fields: 'id,username',
tokenEndpoint: {
useCorsProxy: true,
corsProxyEndpoint: "your cors proxy endpoint"
}
}
If you want to open a opup window instead of redirection add popup: true
to env. For example;
ENV['ember-oauther'] = {
popup: true,
// for popupOptions: https://developer.mozilla.org/en-US/docs/Web/API/Window/open#window_features
popupOptions: {
width: 640,
heigth: 480,
},
};
Or just for a single provider;
ENV['ember-oauther'] = {
instagram: {
popup: true,
// for popupOptions: https://developer.mozilla.org/en-US/docs/Web/API/Window/open#window_features
popupOptions: {
width: 640,
heigth: 480,
},
clientId: '...',
clientSecret: '....',
redirectUri: 'https://localhost:4200/instagram-sign-in',
scope: 'user_profile',
fields: 'id,username',
tokenEndpoint: {
useCorsProxy: true,
corsProxyEndpoint: "your cors proxy endpoint"
}
}
ember-outher has a service named oauther
. All functions returns Promise.
For sign in process use;
import Controller from '@ember/controller';
import { action } from '@ember/object';
import { inject as service } from '@ember/service';
export default class LoginController extends Controller {
@service
oauther;
@action
signIn(providerName) {
this.oauther.signIn(providerName);
}
}
For exchange token process use;
import Controller from '@ember/controller';
import { action } from '@ember/object';
import { inject as service } from '@ember/service';
export default class LoginController extends Controller {
@service
oauther;
@action
exchangeAccessToken(providerName, codeOrToken, verifier) {
this.oauther.exchangeAccessToken(providerName, codeOrToken, verifier);
}
}
For exchange user information use;
import Controller from '@ember/controller';
import { action } from '@ember/object';
import { inject as service } from '@ember/service';
export default class LoginController extends Controller {
@service
oauther;
@action
exchangeUserInformation(providerName, accessToken, accessTokenSecret) {
this.oauther.exchangeUserInformation(
providerName,
accessToken,
accessTokenSecret
);
}
}
You can close popup anytime with popupClose
method on oauther service.
import Controller from '@ember/controller';
import { action } from '@ember/object';
import { inject as service } from '@ember/service';
export default class LoginController extends Controller {
@service
oauther;
@action
popupClose() {
this.oauther.popupClose();
}
}
ember-oauther also provides 2 routes for redirection routes. Oauth1SignInRoute
(just twitter for now) and Oauth2CodeSignInRoute
.
Routes has 2 helper functions. getAccessToken
and getUserInformation
.
Both functions takes params which also inherited from super and returns Promise.
OAuth 1.0a params
queryParams = {
oauth_token: '',
oauth_verifier: '',
provider: '',
};
OAuth 2.0 params:
queryParams = {
code: '',
state: '',
scope: '',
provider: '',
};
Simply extend your redirection route from the right route.
import Oauth2CodeSignInRoute from 'ember-oauther/routes/oauth2-code-sign-in';
export default class GoogleSignInRoute extends Oauth2CodeSignInRoute {
model(params) {
this.getAccessToken(params).then((accessToken) => {
console.log(accessToken);
});
// getUserInformation calls getAccessToken already, you don't need both. This is for demo purpose.
this.getUserInformation(params).then((data) => {
console.log(data);
});
}
}
Also if you are using ember-simple-auth addon there is a complementary addon called ember-simple-auth-oauther.
It has 3 authenticators.
- oauther: For whatever you return json data.
- oauther-token: For same token logic with ember-simple-auth-token
- oauther-jwt: For same jwt logic with ember-simple-auth-token
Of course you should set all required parameters in environment like;
ENV['ember-simple-auth-oauther'] = {
tokenPropertyName: 'access_token',
serverTokenEndpoint: `${ENV.apiURL}/oauth/login`,
tokenExpirationInvalidateSession: false,
refreshAccessTokens: true,
refreshTokenPropertyName: 'refresh_token',
serverTokenRefreshEndpoint: `${ENV.apiURL}/users/refresh_token`,
refreshLeeway: 300,
};
For example; you want to use your own backend and you are providing jwt access and refresh token then simply use,
import Oauth2CodeSignInRoute from 'ember-oauther/routes/oauth2-code-sign-in';
import { inject as service } from '@ember/service';
export default class Oauth2SignInRoute extends Oauth2CodeSignInRoute {
@service
session;
model(params) {
this.session
.authenticate('authenticator:oauther-jwt', params)
.then(() => {
console.log('Logged in');
})
.catch((e) => {
console.error('error', e);
});
}
}
For dummy app: oauther-test
Contributing
See the Contributing guide for details.
If you want another provider please open an issue or send a PR.
Thank you.
License
This project is licensed under the MIT License.