$auth

service in module stormpath.authService

Methods

• authenticate(credentialData)

  Logs the user in.

  Sends the provided credential data to your backend server. The server handler should verify the credentials and return an access token, which is stored in an HTTP-only cookie.

  Parameters

  Param	Type	Details
  credentialData	Object	An object literal for passing username & password, or social provider token.

  Returns

  promise

  A promise that is resolved with the authentication response or error response (both are response objects from the $http service).

  Example

  Username & Password example

  myApp.controller('LoginCtrl', function ($scope, $auth, $state) {
    $scope.errorMessage = null;
    $scope.formData = {
      username: '',         // Expose to user as email/username field
      password: '',
    };
  
    // Use this method with ng-submit on your form
    $scope.login = function login(formData){
      $auth.authenticate(formData)
       .then(function(){
         console.log('login success');
         $state.go('home');
       })
       .catch(function(err){
         $scope.errorMessage = err.message;
       });
    }
  
  });
  

  Social Login example

  myApp.controller('LoginCtrl', function ($scope, $auth, $state) {
    $scope.errorMessage = null;
    $scope.formData = {
      providerId: 'facebook',         // Get access token from FB sdk login
      accessToken: 'CABTmZxAZBxBADbr1l7ZCwHpjivBt9T0GZBqjQdTmgyO0OkUq37HYaBi4F23f49f5',
    };
  
    // Use this method with ng-submit on your form
    $scope.login = function login(formData){
      $auth.authenticate(formData)
       .then(function(){
         console.log('login success');
         $state.go('home');
       })
       .catch(function(err){
         $scope.errorMessage = err.message;
       });
    }
  
  });
  

• endSession()

  Use this method to log the user out. It triggers a request to the /logout endpoint on the server. This will delete the cookies that are used for authentication. The $sessionEnd event will be emitted after a successful logout.

  Returns

  promise

  A promise that is resolved when the logout request of the server is complete.