How to use Auth

Auth (Authentication)

Some plugins require the user to be authenticated before continuing on to a particular feature. Auth is used to login and to register on the BuildFire auth server. This article goes through the steps for using Auth.

---

How to use Auth

Methods:

buildfire.auth.login([options], callback);

This method will check if the current user is logged in or not. If not, buildfire.js will open the login UI.

arguments

• options: {allowCancel: true|false , showMenu: true|false }.
  • allowCancel: a flag to show or hide the cancel link on the login screen. default: true
  • showMenu: a flag to show or hide the menu link on the login screen. default: true
• callback(err, user): is a function that is called when the data is retrieved from the datastore. The callback function is called after login or registration is successful.

buildfire.auth.logout();

This method is seen when you logout from auth.

arguments

• options: default: null .. not used.
• callback: is a function that is called when the data is retrieved from the datastore. The callback function is called after login or registration is successful.

buildfire.auth.getCurrentUser(callback);

This method gives the current logged in user in the callback function.

arguments

• callback(err,user): is a function that is called with the current logged in user if exists.
  • err: if there was an error when attempting to retrieve the user
  • user: the user object containing public user properties

buildfire.auth.onLogin(callback, [allowMultipleHandlers]);

This method allows you to pass a callback function that is called whenever the user is logged in.

arguments

• callback: the callback function contains the current loggedin user.
• allowMultipleHandlers: optional bool param that tells the method to override all other handlers. Default false

buildfire.auth.onLogout(callback, [allowMultipleHandlers]);

This method allows you to pass a callback function that is called whenever the user is logged out.

arguments

• callback it’s a callback function contains the current loggedin user.
• allowMultipleHandlers: optional bool param that tells the method to override all other handlers. Default false

buildfire.auth. getUserProfile(options,callback);

This method will pull a public profile for a user if you have the userId.

arguments

• options: {userId: 'XXX' }
• callback (err, profile) it’s a callback function contains the profile user.

buildfire.auth.openProfile(userId);

This method will redirect the app to view user profile page.

arguments

• userId: 'XXX'

buildfire.auth.getUserPictureUrl(params);

This method will return user picture url by userId or email.

arguments

• params: {userId: 'XXX' } or {email:'[email protected]'}