一个小型 AngularJS 服务,用于与 Devise 身份验证进行交互。
A small AngularJS Service to interact with Devise Authentication.
This service requires Devise to respond to JSON. To do that, simply add
# config/application.rb
module RailsApp
class Application {id: 1, ect: '...'}
}, function(error) {
// unauthenticated error
});
});Auth._currentUser will be either null or the currentUser's object
representation. It is not recommended to directly access
Auth._currentUser, but instead use
Auth.currentUser().
angular.module('myModule', ['Devise']).
controller('myCtrl', function(Auth) {
console.log(Auth._currentUser); // => null
// Log in user...
console.log(Auth._currentUser); // => {id: 1, ect: '...'}
});Auth.isAuthenticated() is a helper method to determine if a
currentUser is logged in with Auth.
angular.module('myModule', ['Devise']).
controller('myCtrl', function(Auth) {
console.log(Auth.isAuthenticated()); // => false
// Log in user...
console.log(Auth.isAuthenticated()); // => true
});Use Auth.login() to authenticate with the server. Keep in mind,
credentials are sent in plaintext; use a SSL connection to secure them.
creds is an object which should contain any credentials needed to
authenticate with the server. Auth.login() will return a promise that
will resolve to the logged-in user. See
Auth.parse(response) to customize how the response
is parsed into a user.
Upon a successful login, two events will be broadcast, devise:login and
devise:new-session, both with the currentUser as the argument. New-Session will only
be broadcast if the user was logged in by Auth.login({...}). If the server
has a previously authenticated session, only the login event will be broadcast.
Pass any additional config options you need to provide to $http with
config.
…By default, login will POST to '/users/sign_in.json' using the
resource name user. The path, HTTP method, and resource name used to
login are configurable using:
angular.module('myModule', ['Devise']).
config(function(AuthProvider) {
AuthProvider.loginPath('path/on/server.json');
AuthProvider.loginMethod('GET');
AuthProvider.resourceName('customer');
});Use Auth.logout() to de-authenticate from the server. Auth.logout()
returns a promise that will be resolved to the old currentUser. Then a
devise:logout event will be broadcast with the old currentUser as the argument.
Pass any additional config options you need to provide to $http with
config.
angular.module('myModule', ['Devise']).
controller('myCtrl', function(Auth) {
var config = {
headers: {
'X-HTTP-Method-Override': 'DELETE'
}
};
// Log in user...
// ...
Auth.logout(config).then(function(oldUser) {
// alert(oldUser.name + "you're signed out now.");
}, function(error) {
// An error occurred logging out.
});
$scope.$on('devise:logout', function(event, oldCurrentUser) {
// ...
});
});By default, logout will DELETE to '/users/sign_out.json'. The path and
HTTP method used to logout are configurable using:
angular.module('myModule', ['Devise']).
config(function(AuthProvider) {
AuthProvider.logoutPath('path/on/server.json');
AuthProvider.logoutMethod('GET');
});This is the method used to parse the $http response into the appropriate
user object. By default, it simply returns response.data. This can be
customized either by specifying a parse function during configuration:
angular.module('myModule', ['Devise']).
config(function(AuthProvider) {
// Customize user parsing
// NOTE: **MUST** return a truth-y expression
AuthProvider.parse(function(response) {
return response.data.user;
});
});or by directly overwriting it, perhaps when writing a custom version of the Auth service which depends on another service:
angular.module('myModule', ['Devise']).
factory('User', function() {
// Custom user factory
}).
factory('CustomAuth', function(Auth, User) {
Auth['parse'] = function(response) {
return new User(response.data);
};
return Auth;
});Use Auth.register() to register and authenticate with the server. Keep
in mind, credentials are sent in plaintext; use a SSL connection to
secure them. creds is an object that should contain any credentials
needed to register with the server. Auth.register() will return a
promise that will resolve to the registered user. See
Auth.parse(response) to customize how the response
is parsed into a user. Then a devise:new-registration event will be
broadcast with the user object as the argument.
Pass any additional config options you need to provide to $http with
config.
…By default, register will POST to '/users.json' using the resource
name user. The path, HTTP method, and resource name used to register
are configurable using:
angular.module('myModule', ['Devise']).
config(function(AuthProvider) {
AuthProvider.registerPath('path/on/server.json');
AuthProvider.registerMethod('GET');
AuthProvider.resourceName('customer');
});Use Auth.sendResetPasswordInstructions() to send reset password mail to user. Keep
in mind, credentials are sent in plaintext; use a SSL connection to
secure them. creds is an object that should contain the email associated with the user.
Auth.sendResetPasswordInstructions() will return a promise with no params.
Then a devise:send-reset-password-instructions-successfully event will be broadcast.
angular.module('myModule', ['Devise']).
controller('myCtrl', function(Auth) {
var parameters = {
email: '[email protected]'
};
Auth.sendResetPasswordInstructions(parameters).then(function() {
// Sended email if user found otherwise email not sended...
});
$scope.$on('devise:send-reset-password-instructions-successfully', function(event) {
// ...
});
});By default, sendResetPasswordInstructions will POST to '/users/password.json'. The path and HTTP
method used to send the reset password instructions are configurable using:
angular.module('myModule', ['Devise']).
config(function(AuthProvider) {
AuthProvider.sendResetPasswordInstructionsPath('path/on/server.json');
AuthProvider.sendResetPasswordInstructionsMethod('POST');
});Use Auth.resetPassword() to reset user password. Keep
in mind, credentials are sent in plaintext; use a SSL connection to
secure them. creds is an object that should contain password, password_confirmation and reset_password_token.
Auth.resetPassword() will return a
promise that will resolve to the new user data. See
Auth.parse(response) to customize how the response
is parsed into a user. Then a devise:reset-password-successfully event will be broadcast.
angular.module('myModule', ['Devise']).
controller('myCtrl', function(Auth) {
var parameters = {
password: 'new_password',
password_confirmation: 'new_password',
reset_password_token: 'reset_token',
};
Auth.resetPassword(parameters).then(function(new_data) {
console.log(new_data); // => {id: 1, ect: '...'}
}, function(error) {
// Reset password failed...
});
$scope.$on('devise:reset-password-successfully', function(event) {
// ...
});
});By default, resetPassword will PUT to '/users/password.json'. The path and HTTP
method used to reset password are configurable using:
angular.module('myModule', ['Devise']).
config(function(AuthProvider) {
AuthProvider.resetPasswordPath('path/on/server.json');
AuthProvider.resetPasswordMethod('PUT');
});AngularDevise comes with a $http
Interceptor
that may be enabled using the interceptAuth config. Its purpose is to
listen for 401 Unauthorized responses and give you the ability to
seamlessly recover. When it catches a 401, it will:
devise:unauthorized event passing:Since the deferred is passed to the devise:unauthorized event, you are
free to resolve it (and the request) inside of the event listener. For
instance:
…The Interceptor can be enabled globally or on a per-request basis using the
interceptAuth setting on the AuthIntercept provider.
angular.module('myModule', ['Devise']).
config(function(AuthInterceptProvider) {
// Intercept 401 Unauthorized everywhere
AuthInterceptProvider.interceptAuth(true);
}).
controller('myCtrl', function($http) {
// Disable per-request
$http({
url: '/',
interceptAuth: false,
// ...
});
});By default, AngularDevise uses the following HTTP methods/paths:
| Method | HTTP Method | HTTP Path |
|---|---|---|
| login | POST | /users/sign_in.json |
| logout | DELETE | /users/sign_out.json |
| register | POST | /users.json |
| sendResetPasswordInstructions | POST | /users/password.json |
| resetPassword | POST | /users/password.json |
All credentials will be under the users namespace, and the following
parse function will be used to parse the response:
function(response) {
return response.data;
};All of these can be configured using a .config block in your module.
…AngularDevise is maintained by Cloudspace, and is distributed under the MIT License.
暂无开放 Issues,或尚未同步最近议题。