OneGraph Auth
The main helper library for automating all-things and/or authorization in the browser. Many services are supported for logging in/out of applications, and more details about the library can be found on the OneGraph docs site.
Installation
Add the onegraph-auth library to your app:
npm install onegraph-auth --save
Create an Auth Client
For our example, we'll log in to Stripe.
First, we'll construct a new OneGraphAuth instance. It requires the name of the service and an appId.
import OneGraphAuth from 'onegraph-auth';
const APP_ID = YOUR_APP_ID;
const auth = new OneGraphAuth({
appId: APP_ID,
});
The OneGraphAuth client has 3 methods, isLoggedIn
, login
, logout
.
Check if the user is loggedIn
The isLoggedIn
method takes a service name as its only argument and
will return a promise with a boolean indicating if the user is logged
in to that service.
auth.isLoggedIn('github').then((isLoggedIn) => {
if (isLoggedIn) {
console.log('Already logged in to GitHub');
} else {
console.log('Not logged in to GitHub.');
}
});
Log the user in
The login
method takes a service name as its only argument and will
take the client through the OAuth login flow for the service and
return a promise that resolves after the client finishes the flow.
After the client finishes, you can call isLoggedIn
again to check if the
user successfully made it through the flow.
auth
.login('github')
.then(() => {
auth.isLoggedIn('github').then((isLoggedIn) => {
if (isLoggedIn) {
console.log('Successfully logged in to GitHub');
} else {
console.log('Did not grant auth for GitHub');
}
});
})
.catch((e) => console.error('Problem logging in', e));
Log the user out
The logout
method takes a service name as its only argument and will
log the client out and return a promise wrapping an object with a
result
key whose value is either 'success' or 'failure' to indicate
whether the user is still logged in.
auth.logout('github').then((response) => {
if (response.result === 'success') {
console.log('Logout succeeded');
} else {
console.log('Logout failed');
}
});
Use OneGraphAuth with Apollo
OneGraphAuth maintains an OAuth token that authenticates you with
OneGraph. We need to tell Apollo how to send that token to OneGraph in
the Authentication
header.
We'll set up our Apollo client to use the token:
import ApolloClient from 'apollo-boost';
import OneGraphAuth from 'onegraph-auth';
const APP_ID = YOUR_APP_ID;
const auth = new OneGraphAuth({
appId: APP_ID,
});
const client = new ApolloClient({
uri: 'https://serve.onegraph.com/graphql?app_id=' + APP_ID,
request: (operation) => operation.setContext({headers: auth.authHeaders()}),
});
In the example, we added a request handler that will run every time Apollo sends a new request to OneGraph. The token could change as the user signs in and out of new services, so we should always send the newest token.
OneGraph also provides its own Apollo client that will handle this for you.
First install the client:
npm install onegraph-apollo-client --save
Then use the client in place of ApolloClient in your app:
import OneGraphApolloClient from 'onegraph-apollo-client';
import OneGraphAuth from 'onegraph-auth';
const APP_ID = YOUR_APP_ID;
const auth = new OneGraphAuth({
appId: APP_ID,
});
const client = new OneGraphApolloClient({
oneGraphAuth: auth,
});