# Изискване на потребител или право в действие

> Използвайте опциите user и permissions на NEWACTION, за да стои авторизацията до действието, а не във всеки маршрут.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: bg
Content-SHA256: 6434bc3cd9584aad2bb32f5e8b8ba1a78edf69a3d1833c8672e3ea2e1e31b95c
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

Едно действие може да се защити само:

- `user: true` изисква удостоверен потребител (иначе 401); `user: false` допуска само анонимни заявки
- `permissions: 'a,b'` изисква потребителят да има поне едно от изброените права. Total.js чете `user.permissions` (или `user.roles`), които могат да бъдат масив от низове или обект
- потребителите с `sa: true` или `su: true` (суперадминистратори) минават всяка проверка

Потребителят идва от `AUTH()`, както в рецептата за удостоверяване.

```js 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();
});
```

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

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