Require a user or a permission in an action

Total.js 5 · total5@0.0.19 actionsauthsecurity Executed against Total.js 5

An action can protect itself:

user: true requires an authenticated user (otherwise 401); user: false allows only anonymous requests
permissions: 'a,b' requires the user to have at least one of the listed permissions. Total.js reads user.permissions (or user.roles), which can be an array of strings or an object
users with sa: true or su: true (super admins) pass every check

The user comes from AUTH(), as in the authentication recipe.

definitions/auth.js

AUTH(function($) {

	var users = {
		'token-reports': { id: '1', name: 'Anna', permissions: ['reports'] },
		'token-sales': { id: '2', name: 'Boris', permissions: ['sales'] },
		'token-admin': { id: '3', name: 'Root', sa: true }
	};

	var user = users[$.cookie('auth')];
	user ? $.success(user) : $.invalid();
});

definitions/reports.js

NEWACTION('Reports/read', {
	name: 'Read reports',
	user: true,
	permissions: 'reports,audit',
	action: function($) {
		$.success($.user.name);
	}
});

controllers/reports.js

exports.install = function() {
	ROUTE('GET /reports/ --> *Reports/read');
};