This module provides the following features:
This project comes bundled with a test app. You can run the demo locally by following these instructions, or you can use it here in production.
auth:login-successauth:login-errorauth:validation-successauth:validation-errorauth:logout-successauth:logout-errorauth:registration-email-successauth:registration-email-errorauth:email-confirmation-successauth:email-confirmation-errorauth:password-reset-request-successauth:password-reset-request-errorauth:password-reset-confirm-successauth:password-reset-confirm-errorauth:password-change-successauth:password-change-errorauth:account-update-successauth:account-update-errorauth:account-destroy-successauth:account-destroy-errorThis module relies on token based authentication. This requires coordination between the client and the server. Diagrams are included to illustrate this relationship.
This module was designed to work out of the box with the outstanding devise token auth gem, but it's seen use in other environments as well (go, gorm and gomniauth for example).
About security: read here for more information on securing your token auth system. The devise token auth gem has adequate security measures in place, and the gem works seamlessly with this module.
Download this module and its dependencies:
# from the terminal at the root of your project
bower install ng-auth --save
Ensure that angularjs, ng-cookies, and ng-auth are included on your page:
<!-- in your index.html file -->
<script src="/js/angular/angular.js"></script>
<script src="/js/angular-cookies/angular-cookies.js"></script>
<script src="/js/ng-auth/dist/ng-auth.js"></script>
Include ng-auth in your module's dependencies:
// in your js app's module definition
angular.module('myApp', ['ng-auth'])
The $authProvider is available for injection during the app's configuration phase. Use $authProvider.configure to configure the module for use with your server.
The following settings correspond to the paths that are available when using the devise token auth gem for Rails. If you're using this gem, you will only need to set the apiUrl option.
angular.module('myApp', ['ng-auth'])
.config(function($authProvider) {
$authProvider.configure({
apiUrl: 'http://api.example.com'
});
});
angular.module('myApp', ['ng-auth'])
.config(function($authProvider) {
// the following shows the default values. values passed to this method
// will extend the defaults using angular.extend
$authProvider.configure({
apiUrl: '/api',
tokenValidationPath: '/auth/validate_token',
signOutUrl: '/auth/sign_out',
emailRegistrationPath: '/auth',
accountUpdatePath: '/auth',
accountDeletePath: '/auth',
confirmationSuccessUrl: window.location.href,
passwordResetPath: '/auth/password'
passwordUpdatePath: '/auth/password'
passwordResetSuccessUrl: window.location.href
emailSignInPath: '/auth/sign_in',
storage: 'cookies',
proxyIf: function() { return false; },
proxyUrl: '/proxy',
authProviderPaths: {
github: '/auth/github',
facebook: '/auth/facebook',
google: '/auth/google'
},
tokenFormat: {
"access-token": "{{ token }}",
"token-type": "Bearer",
"client": "{{ clientId }}",
"expiry": "{{ expiry }}",
"uid": "{{ uid }}"
},
parseExpiry: function(headers) {
// convert from UTC ruby (seconds) to UTC js (milliseconds)
return (parseInt(headers['expiry']) * 1000) || null;
},
handleLoginResponse: function(response) {
return response.data;
},
handleAccountResponse: function(response) {
return response.data;
},
handleTokenValidationResponse: function(response) {
return response.data;
}
});
});
| param | description |
|---|---|
| apiUrl | the base route to your api. Each of the following paths will be relative to this URL. Authentication headers will only be added to requests with this value as the base URL. |
| authProviderPaths | an object containing paths to auth endpoints. keys are names of the providers, values are their auth paths relative to the apiUrl. Read more. |
| tokenValidationPath | relative path to validate authentication tokens. Read more. |
| signOutUrl | relative path to sign user out. this will destroy the user's token both server-side and client-side. |
| emailRegistrationPath | path for submitting new email registrations. Read more. |
| accountUpdatePath | path for submitting account update requests. Read more. |
| accountDeletePath | path for submitting account deletion requests. Read more. |
| confirmationSuccessUrl | the url to which the API should redirect after users visit the link contained in email-registration emails. Read more. |
| emailSignInPath | path for signing in using email credentials. Read more |
| passwordResetPath | path for requesting password reset emails. Read more. |
| passwordUpdatePath | path for submitting new passwords for authenticated users. Read more |
| passwordResetSuccessUrl | the URL to which the API should redirect after users visit the links contained in password-reset emails. Read more. |
| storage | the method used to persist tokens between sessions. cookies are used by default, but window.localStorage can be used as well. allowed values are cookies and localStorage. |
| proxyIf | older browsers have trouble with CORS (read more). pass a method here to determine whether or not a proxy should be used. example: function() { return !Modernizr.cors } |
| proxyUrl | proxy url if proxy is to be used |
| tokenFormat | a template for authentication tokens. the template will be provided a context with the following params:
|
| parseExpiry | a function that will return the token's expiry from the current headers. Returns null if no headers or expiry are found. Read more. |
| handleLoginResponse | a function that will identify and return the current user's info (id, username, etc.) in the response of a successful login request. Read more. |
| handleAccountUpdateResponse | a function that will identify and return the current user's info (id, username, etc.) in the response of a successful account update request. Read more. |
| handleTokenValidationResponse | a function that will identify and return the current user's info (id, username, etc.) in the response of a successful token validation request. Read more. |
The $auth module is available for dependency injection during your app's run phase (for controllers, directives, filters, etc.). Each API method returns a $q deferred promise that will be resolved on success,
###$auth.authenticate Initiate an OAuth2 authentication. This method accepts 2 arguments:
provider: a string that is also the name of the target provider service. For example, to authenticate using github:
$auth.authenticate('github')
options: (optional) an object containing the following params:
params: additional params to be passed to the OAuth provider. For example, to pass the user's favorite color on sign up:
$auth.authenticate('github', {params: {favorite_color: 'green'})
This method is also added to the $rootScope for use in templates. Read more.
This method emits the following events:
angular.module('ngTokenAuthTestApp')
.controller('IndexCtrl', function($auth) {
$scope.handleBtnClick = function() {
$auth.authenticate('github')
.then(function(resp) {
// handle success
})
.catch(function(resp) {
// handle errors
});
};
});
<button ng-click="authenticate('github')">
Sign in with Github
</button>
###$auth.validateUser This method returns a promise that will resolve if a user's auth token exists and is valid. This method does not accept any arguments. Read more
This method automatically is called on page load during the app's run phase so that returning users will not need to manually re-authenticate themselves.
This method will broadcast the following events:
The promise returned by this method can be used to prevent users from viewing certain pages when using angular ui router resolvers.
angular.module('myApp', [
'ui.router',
'ng-auth'
])
.config(function($stateProvider) {
$stateProvider
// this state will be visible to everyone
.state('index', {
url: '/',
templateUrl: 'index.html',
controller: 'IndexCtrl'
})
// only authenticated users will be able to see routes that are
// children of this state
.state('admin', {
url: '/admin',
abstract: true,
template: '<ui-view/>',
resolve: {
auth: function($auth) {
return $auth.validateUser();
}
}
})
// this route will only be available to authenticated users
.state('admin.dashboard', {
url: '/dash',
templateUrl: '/admin/dash.html',
controller: 'AdminDashCtrl'
});
});
This example shows how to implement access control on the client side, however access to restricted information should be limited on the server as well (using something like pundit if you're using Rails).
###$auth.submitRegistration Users can register by email using this method. Read more. Accepts an object with the following params:
This method broadcasts the following events:
angular.module('ngTokenAuthTestApp')
.controller('IndexCtrl', function($auth) {
$scope.handleRegBtnClick = function() {
$auth.submitRegistration($scope.registrationForm)
.then(function(resp) {
// handle success response
})
.catch(function(resp) {
// handle error response
});
};
});
<form ng-submit="submitRegistration(registrationForm)" role="form" ng-init="registrationForm = {}">
<div class="form-group">
<label>email</label>
<input type="email" name="email" ng-model="registrationForm.email" required="required" class="form-control"/>
</div>
<div class="form-group">
<label>password</label>
<input type="password" name="password" ng-model="registrationForm.password" required="required" class="form-control"/>
</div>
<div class="form-group">
<label>password confirmation</label>
<input type="password" name="password_confirmation" ng-model="registrationForm.password_confirmation" required="required" class="form-control"/>
</div>
<button type="submit" class="btn btn-primary btn-lg">Register</button>
</form>
###$auth.submitLogin Authenticate a user that registered via email. Read more. Accepts an object with the following params:
This method broadcasts the following events:
angular.module('ngTokenAuthTestApp')
.controller('IndexCtrl', function($auth) {
$scope.handleLoginBtnClick = function() {
$auth.submitLogin($scope.loginForm)
.then(function(resp) {
// handle success response
})
.catch(function(resp) {
// handle error response
});
};
});
<form ng-submit="submitLogin(loginForm)" role="form" ng-init="loginForm = {}">
<div class="form-group">
<label>email</label>
<input type="email" name="email" ng-model="loginForm.email" required="required" class="form-control"/>
</div>
<div class="form-group">
<label>password</label>
<input type="password" name="password" ng-model="loginForm.password" required="required" class="form-control"/>
</div>
<button type="submit" class="btn btn-primary btn-lg">Sign in</button>
</form>
###$auth.signOut
De-authenticate a user. This method does not take any arguments. This method will change the user's auth_token server-side, and it will destroy the uid and auth_token cookies saved client-side.
This method broadcasts the following events:
angular.module('ngTokenAuthTestApp')
.controller('IndexCtrl', function($auth) {
$scope.handleSignOutBtnClick = function() {
$auth.signOut()
.then(function(resp) {
// handle success response
})
.catch(function(resp) {
// handle error response
});
};
});
<button class="btn btn-primary btn-lg" ng-click='signOut()'>Sign out</button>
###$auth.requestPasswordReset Send password reset instructions to a user. This only applies to users that have registered using email. This method accepts an object with the following param:
This method broadcasts the following events:
angular.module('ngTokenAuthTestApp')
.controller('IndexCtrl', function($auth) {
$scope.handlePwdResetBtnClick = function() {
$auth.requestPasswordReset($scope.pwdResetForm)
.then(function(resp) {
// handle success response
})
.catch(function(resp) {
// handle error response
});
};
});
<form ng-submit="requestPasswordReset(passwordResetForm)" role="form" ng-init="passwordResetForm = {}">
<div class="form-group">
<label>email</label>
<input type="email" name="email" ng-model="passwordResetForm.email" required="required" class="form-control"/>
</div>
<button type="submit" class="btn btn-primary btn-lg">Request password reset</button>
</form>
###$auth.updatePassword Change an authenticated user's password. This only applies to users that have registered using email. This method accepts an object with the following params:
The two params must match.
This method broadcasts the following events:
angular.module('ngTokenAuthTestApp')
.controller('IndexCtrl', function($auth) {
$scope.handleUpdatePasswordBtnClick = function() {
$auth.updatePassword($scope.updatePasswordForm)
.then(function(resp) {
// handle success response
})
.catch(function(resp) {
// handle error response
});
};
});
<form ng-submit="updatePassword(changePasswordForm)" role="form" ng-init="changePasswordForm = {}">
<div class="form-group">
<label>password</label>
<input type="password" name="password" ng-model="changePasswordForm.password" required="required" class="form-control"/>
</div>
<div class="form-group">
<label>password confirmation</label>
<input type="password" name="password_confirmation" ng-model="changePasswordForm.password_confirmation" required="required"/>
</div>
<button type="submit">Change your password</button>
</form>
###$auth.updateAccount
Change an authenticated user's account info. This method accepts an object that contains valid params for your API's user model. The following shows how to update a user's zodiac_sign param:
<form ng-submit="updateAccount(updateAccountForm)" role="form" ng-init="updateAccountForm = {zodiac_sign: null}">
<fieldset ng-disabled="!user.signedIn">
<div>
<label>zodiac sign</label>
<input type="text" name="text" ng-model="updateAccountForm.zodiac_sign">
</div>
<button type="submit">Update your zodiac sign</button>
</fieldset>
</form>
This method broadcasts the following events:
angular.module('ngTokenAuthTestApp')
.controller('IndexCtrl', function($auth) {
$scope.handleUpdateAccountBtnClick = function() {
$auth.updateAccount($scope.updateAccountForm)
.then(function(resp) {
// handle success response
})
.catch(function(resp) {
// handle error response
});
};
});
###$auth.destroyAccount Destroy a logged in user's account. This method does not accept any params.
This method broadcasts the following events:
angular.module('ngTokenAuthTestApp')
.controller('IndexCtrl', function($auth) {
$scope.handleDestroyAccountBtnClick = function() {
$auth.destroyAccount()
.then(function(resp) {
// handle success response
})
.catch(function(resp) {
// handle error response
});
};
});
<button ng-click="destroyAccount()" ng-class="{disabled: !user.signedIn}">
Close my account
</button>
This module broadcasts events after the success or failure of each API method. Using these events to build your app can result in more flexibility while reducing code spaghetti.
For example, any template can initiate an authentication, and any controller can subscribe to the auth:login-success event to provide success notifications, redirects, etc.
###auth:login-success Broadcast after successful user authentication. Event message contains the user object. This event is broadcast by the following methods:
$rootScope.$on('auth:login-success', function(ev, user) {
alert('Welcome ', user.email);
});
###auth:login-error Broadcast after user fails authentication. This event is broadcast by the following methods:
$rootScope.$on('auth:login-error', function(ev, reason) {
alert('auth failed because', reason.errors[0]);
});
###auth:validation-success
Broadcast when a user's token is successfully verified using the $auth.validateUser method.
###auth:validation-error
Broadcast when a user's token fails validation using the $auth.validateUser method.
###auth:logout-success
Broadcast after user is successfully logged out using the $auth.signOut method. This event does not contain a message.
$rootScope.$on('auth:logout-success', function(ev) {
alert('goodbye');
});
###auth:logout-error
Broadcast after failed logout attempts using the $auth.signOut method. Message contains the failed logout response.
$rootScope.$on('auth:logout-error', function(ev, reason) {
alert('logout failed because ' + reason.errors[0]);
});
###auth:registration-email-success
Broadcast after email registration requests complete successfully using the $auth.submitRegistration method. Message contains the params that were sent to the server.
$scope.$on('auth:registration-email-success', function(ev, message) {
alert("A registration email was sent to " + message.email);
});
###auth:registration-email-error
Broadcast after failed email registration requests using the $auth.submitRegistration method. Message contains the error response.
This event is broadcast by the $auth.submitRegistration method.
$scope.$on('auth:registration-email-error', function(ev, reason) {
alert("Registration failed: " + reason.errors[0]);
});
###auth:email-confirmation-success Broadcast when users arrive from links contained in password-reset emails. This can be used to trigger "welcome" notifications to new users.
This event is broadcast by the $auth.validateUser method.
$scope.$on('auth:email-confirmation-success', function(ev, user) {
alert("Welcome, "+user.email+". Your account has been verified.");
});
###auth:email-confirmation-error Broadcast when a user arrives from a link contained in a password-reset email, but the confirmation token fails to validate.
This event is broadcast by the $auth.validateUser method.
$scope.$on('auth:email-confirmation-error', function(ev, reason) {
alert("There was an error with your registration.");
});
###auth:password-reset-request-success
Broadcast when users successfully submit the password reset form using the $auth.requestPasswordReset method.
$scope.$on('auth:password-reset-request-success', function(ev, data) {
alert("Password reset instructions were sent to " + data.email);
});
###auth:password-reset-request-error
Broadcast after failed requests using the $auth.requestPasswordReset method. Message contains the error response.
$scope.$on('auth:password-reset-request-error', function(ev, resp) {
alert("Password reset request failed: " + resp.errors[0]);
});
###auth:password-reset-confirm-success Broadcast when users arrive from links contained in password reset emails. This will be the signal for your app to prompt the user to reset their password. Read more.
This event is broadcast by the $auth.validateUser method.
The following example demonstrates one way to handle an auth:password-reset-confirm-success event. This example assumes that angular ui-router is used for routing, and that there is a state called account.password-reset that contains instructions for changing the user's password.
angular.module('myApp')
.run(function($rootScope, $state) {
$rootScope.$on('auth:password-reset-confirm-success', function() {
$state.go('account.password-reset');
});
});
You could also choose to display a modal, or you can ignore the event completely. What you do with the auth:password-reset-confirm-success event is entirely your choice.
###auth:password-reset-confirm-error Broadcast when users arrive from links contained in password reset emails, but the server fails to validate their password reset token.
This event is broadcast by the $auth.validateUser method.
$scope.$on('auth:password-reset-confirm-error', function(ev, reason) {
alert("Unable to verify your account. Please try again.");
});
###auth:password-change-success
Broadcast when users successfully update their password using the $auth.updatePassword method. Read more.
$scope.$on('auth:password-change-success', function(ev) {
alert("Your password has been successfully updated!");
});
###auth:password-change-error
Broadcast when requests resulting from the $auth.updatePassword method fail. Read more.
$scope.$on('auth:registration-change-error', function(ev, reason) {
alert("Registration failed: " + reason.errors[0]);
});
###auth:account-update-success
Broadcast when users successfully update their account info using the $auth.updateAccount method.
$scope.$on('auth:account-update-success', function(ev) {
alert("Your account has been successfully updated!");
});
###auth:account-update-error
Broadcast when requests resulting from the $auth.updateAccount method fail.
$scope.$on('auth:account-update-error', function(ev, reason) {
alert("Registration failed: " + reason.errors[0]);
});
###auth:account-destroy-success
Broadcast when users successfully delete their account info using the $auth.destroyAccount method.
$scope.$on('auth:account-destroy-success', function(ev) {
alert("Your account has been successfully destroyed!");
});
###auth:account-destroy-error
Broadcast when requests resulting from the $auth.destroyAccount method fail.
$scope.$on('auth:account-destroy-error', function(ev, reason) {
alert("Account deletion failed: " + reason.errors[0]);
});
By default, this module (and the devise token auth gem) use the RFC 6750 Bearer Token format. You can customize this using the tokenFormat and parseExpiry config params.
The following example will provide support for this header format:
Authorization: token={{ token }} expiry={{ expiry }} uid={{ uid }}
angular.module('myApp', ['ng-auth'])
.config(function($authProvider) {
$authProvider.configure({
apiUrl: 'http://api.example.com'
// provide the header template
tokenFormat: {
"Authorization": "token={{ token }} expiry={{ expiry }} uid={{ uid }}"
},
// parse the expiry from the 'Authorization' param
parseExpiry: function(headers) {
return (parseInt(headers['Authorization'].match(/expiry=([^ ]+) /)[1], 10)) || null
}
});
});
The tokenFormat param accepts an object as an argument. Each param of the object will be added as an auth header to requests made to the API url provided. Each value of the object will be interpolated using the following context:
The parseExpiry param accepts a method that will be used to parse the expiration date from the auth headers. The current valid headers will be provided as an argument.
By default, this module expects user info (id, name, etc.) to be contained within the data param of successful login / token-validation responses. The following example shows an example of an expected response:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"data": {
"id":"123",
"name": "Slemp Diggler",
"etc": "..."
}
}
The above example follows the format used by the devise token gem. This format requires no additional configuration.
But not all APIs use this format. Some APIs simply return the serialized user model with no container params:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"id":"123",
"name": "Slemp Diggler",
"etc": "..."
}
Functions can be provided to identify and return the relevant user data from successful authentication responses. The above example response can be handled with the following configuration:
angular.module('myApp', ['ng-auth'])
.config(function($authProvider) {
$authProvider.configure({
apiUrl: 'http://api.example.com'
handleLoginResponse: function(response) {
return response;
},
handleAccountUpdateResponse: function(response) {
return response;
},
handleTokenValidationResponse: function(response) {
return response;
}
})
});
This module allows for the use of multiple user authentication configurations. The following example assumes that the API supports two user classes, User an EvilUser. The following examples assume that User authentication routes are mounted at /auth, and the EvilUser authentication routes are mounted at evil_user_auth.
To set up an application for multiple users, pass an array of configuration objects to the $auth.configure method. The keys of these configuration objects (default and evilUser in this example) will be used to select the desired configuration for authentication.
$authProvider.configure([
{
default: {
apiUrl: CONFIG.apiUrl,
proxyIf: function() { window.isOldIE() },
authProviderPaths: {
github: '/auth/github',
facebook: '/auth/facebook',
google: '/auth/google_oauth2'
}
}
}, {
evilUser: {
apiUrl: CONFIG.apiUrl,
proxyIf: function() { window.isOldIE() },
signOutUrl: '/evil_user_auth/sign_out',
emailSignInPath: '/evil_user_auth/sign_in',
emailRegistrationPath: '/evil_user_auth',
accountUpdatePath: '/evil_user_auth',
accountDeletePath: '/evil_user_auth',
passwordResetPath: '/evil_user_auth/password',
passwordUpdatePath: '/evil_user_auth/password',
tokenValidationPath: '/evil_user_auth/validate_token',
authProviderPaths: {
github: '/evil_user_auth/github',
facebook: '/evil_user_auth/facebook',
google: '/evil_user_auth/google_oauth2'
}
}
}
]);
The following API methods accept a config option that can be used to specify the desired configuration.
$auth.authenticate$auth.validateUser$auth.submitRegistration$auth.submitLogin$auth.requestPasswordResetAll other methods ($auth.signOut, $auth.updateAccount, etc.) derive the configuration type from the current signed-in user.
The first available configuration will be used if none is provided (default in this example).
// OAuth
$auth.authenticate('github', {
config: 'evilUser',
params: {
favorite_color: $scope.favoriteColor
}
});
// Email Registration
$auth.submitRegistration({
email: $scope.email,
password: $scope.password,
password_confirmation: $scope.passwordConfirmation,
favorite_color: $scope.favoriteColor
}, {
config: 'evilUser'
});
// Email Sign In
$auth.submitLogin({
email: $scope.email,
password: $scope.password
}, {
config: 'evilUser'
});
// Password reset request
$auth.requestPasswordReset({
email: $scope.passwordResetEmail
}, {
config: 'evilUser'
});
Some file upload libraries interfere with the authentication headers set by this module. Workarounds are documented below:
The upload method accepts a headers option. Manually pass the current auth headers to the upload method as follows:
$scope.onFileSelect = function($files, $auth) {
var file = $files[0];
$scope.upload = $upload.upload({
url: 'api/users/update_image',
method: 'POST',
headers: $auth.retrieveData('auth_headers'),
file: file
});
}
The following is a high-level overview of this module's implementation.
The following diagram illustrates the steps necessary to authenticate a client using an oauth2 provider.
When authenticating with a 3rd party provider, the following steps will take place.
postMessage event, and then close the external window.The postMessage event must include the following a parameters:
"deliverCredentials"Rails example: controller, layout, view.
<!DOCTYPE html>
<html>
<head>
<script>
window.addEventListener("message", function(ev) {
// this page must respond to "requestCredentials"
if (ev.data === "requestCredentials") {
ev.source.postMessage({
message: "deliverCredentials", // required
auth_token: 'xxxx', // required
uid: 'yyyy', // required
// additional params will be added to the user object
name: 'Slemp Diggler'
// etc.
}, '*');
// close window after message is sent
window.close();
}
});
</script>
</head>
<body>
<pre>
Redirecting...
</pre>
</body>
</html>
The client's tokens are stored in cookies using the ngCookie module. This is done so that users won't need to re-authenticate each time they return to the site or refresh the page.
This module also provides support for email registration. The following diagram illustrates this process.
The password reset flow is similar to the email registration flow.
When the user visits the link contained in the resulting email, they will be authenticated for a single session. An event will be broadcast that can be used to prompt the user to update their password. See the auth:password-reset-confirm-success event for details.
Tokens should be invalidated after each request to the API. The following diagram illustrates this concept:
During each request, a new token is generated. The access-token header that should be used in the next request is returned in the access-token header of the response to the previous request. The last request in the diagram fails because it tries to use a token that was invalidated by the previous request.
The benefit of this measure is that if a user's token is compromised, the user will immediately be forced to re-authenticate. This will invalidate the token that is now in use by the attacker.
The only case where an expired token is allowed is during batch requests.
Token management is handled by default when using this module with the devise token auth gem.
By default, the API should update the auth token for each request (read more). But sometimes it's neccessary to make several concurrent requests to the API, for example:
$scope.getResourceData = function() {
$http.get('/api/restricted_resource_1').success(function(resp) {
// handle response
$scope.resource1 = resp.data;
});
$http.get('/api/restricted_resource_2').success(function(resp) {
// handle response
$scope.resource2 = resp.data;
});
};
In this case, it's impossible to update the access-token header for the second request with the access-token header of the first response because the second request will begin before the first one is complete. The server must allow these batches of concurrent requests to share the same auth token. This diagram illustrates how batch requests are identified by the server:
The "5 second" buffer in the diagram is the default used by the devise token auth gem.
The following diagram details the relationship between the client, server, and access tokens used over time when dealing with batch requests:
Note that when the server identifies that a request is part of a batch request, the user's auth token is not updated. The auth token will be updated for the first request in the batch, and then that same token will be returned in the responses for each subsequent request in the batch (as shown in the diagram).
The devise token auth gem automatically manages batch requests, and it provides settings to fine-tune how batch request groups are identified.
The user's authentication information is included by the client in the access-token header of each request. If you're using the devise token auth gem, the header must follow the RFC 6750 Bearer Token format:
"access-token": "wwwww",
"token-type": "Bearer",
"client": "xxxxx",
"expiry": "yyyyy",
"uid": "zzzzz"
Replace xxxxx with the user's auth_token and zzzzz with the user's uid. The client field exists to allow for multiple simultaneous sessions per user. The client field defaults to default if omitted. expiry is used by the client to invalidate expired tokens without making an API request. A more in depth explanation of these values is here.
This will all happen automatically when using this module.
Note: You can customize the auth headers however you like. Read more.
Internet Explorer (8, 9, 10, & 11) present the following obstacles:
postMessage implementations don't work for our purposes.The following measures are necessary when dealing with these older browsers.
IE8 + IE9 will try to cache ajax requests. This results in an issue where the request return 304 status with Content-Type set to html and everything goes haywire.
The solution to this problem is to set the If-Modified-Since headers to '0' on each of the request methods that we use in our app. This is done by default when using this module.
The solution was lifted from this stackoverflow post.
You will need to set up an API proxy if the following conditions are both true:
var express = require('express');
var request = require('request');
var httpProxy = require('http-proxy');
var CONFIG = require('config');
// proxy api requests (for older IE browsers)
app.all('/proxy/*', function(req, res, next) {
// transform request URL into remote URL
var apiUrl = 'http:'+CONFIG.API_URL+req.params[0];
var r = null;
// preserve GET params
if (req._parsedUrl.search) {
apiUrl += req._parsedUrl.search;
}
// handle POST / PUT
if (req.method === 'POST' || req.method === 'PUT') {
r = request[req.method.toLowerCase()]({
uri: apiUrl,
json: req.body
});
} else {
r = request(apiUrl);
}
// pipe request to remote API
req.pipe(r).pipe(res);
});
The above example assumes that you're using express, request, and http-proxy, and that you have set the API_URL value using node-config.
Most modern browsers can communicate across tabs and windows using postMessage. This doesn't work for certain flawed browsers. In these cases the client must take the following steps when performing provider authentication (facebook, github, etc.):
These steps are taken automatically when using this module with IE8+.
There is a test project in the test directory of this app. To start a dev server, perform the following steps.
cd to the root of this project.npm installcd test && bower installcd ..gulp devA dev server will start on localhost:7777.
Assuming the dev server has already been set up, start karma using the following command:
karma start test/test/karma.conf.coffee
This module was built against this API. You can use this, or feel free to use your own.
There are more detailed instructions in test/README.md.
Just send a pull request. You will be granted commit access if you send quality pull requests.
src/ng-auth.coffee) and not the compiled distribution file (dist/ng-auth.js). If the dev server is running, the coffescript will be compiled automatically. You can also run gulp transpile from the project root to compile the code.###Satellizer
Satellizer occupies the same problem domain as ng-auth. Advantages of ng-auth (at the time of this writing) include:
This project uses the MIT License.
FAQs
We found that ng-auth demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.
Security News
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.