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: 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.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.

arguments

• callback: the callback function contains the current logged in user.

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