ForgeTotal.js 5
pt

Total.js 5

Exigir um utilizador ou uma permissão numa ação

Total.js 5 · total5@0.0.19 actionsauthsecurity Executada com o Total.js 5

Uma ação pode proteger-se a si própria:

  • user: true exige um utilizador autenticado (caso contrário 401); user: false permite apenas pedidos anónimos
  • permissions: 'a,b' exige que o utilizador tenha pelo menos uma das permissões indicadas. O Total.js lê user.permissions (ou user.roles), que pode ser um array de strings ou um objeto
  • os utilizadores com sa: true ou su: true (super administradores) passam todas as verificações

O utilizador vem de AUTH(), como na receita de autenticação.

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');
};