# Влизане на потребители с вграденото удостоверяване със сесии

> Подайте обект с опции на AUTH(), за да получите подписани бисквитки на сесията, хранилище за сесии и изход без да пишете инфраструктурата.

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

Вместо функция `AUTH(options)` приема обект с опции и инсталира пълно удостоверяване със сесийна бисквитка:

- `secret` подписва бисквитката, `cookie` е нейното име, а `expire` е колко дълго остава една сесия в паметта без активност
- `onread(meta, next, $)` зарежда потребителя, когато пристигне валидна бисквитка на сесия, която не е в паметта (например след рестарт); извикайте `next(null, user)` или `next('not found')`, за да откажете. **Проверете тук, че сесията още съществува във вашето собствено хранилище**, иначе копирана бисквитка продължава да работи, след като потребителят е излязъл
- `onlogout(session)` и `onremove(sessionid)` се изпълняват, когато сесия бъде премахната: изтрийте я от вашето хранилище
- `options.authcookie($, sessionid, userid, expiration)` вкарва потребителя в системата: записва подписаната бисквитка в отговора
- `options.logout($)` премахва сесията и бисквитката

Пазете обекта с опции в променлива: това е дръжката, с която вкарвате и изкарвате потребители. След това `$.user` е зададен, а маршрутите с `+` и `-` работят както в рецептата за AUTH.

```js definitions/auth.js
var users = {
	'1': { id: '1', name: 'Anna', password: 'secret' }
};

// sessionid -> userid. In a real app this is a database table.
MAIN.sessions = {};

MAIN.auth = {
	secret: 'change-this-secret',
	cookie: 'forge_session',
	expire: '1 day',
	onread: function(meta, next) {
		var user = users[MAIN.sessions[meta.sessionid]];
		user ? next(null, { id: user.id, name: user.name }) : next('session not found');
	},
	onlogout: function(session) {
		delete MAIN.sessions[session.sessionid];
	},
	onremove: function(sessionid) {
		delete MAIN.sessions[sessionid];
	}
};

AUTH(MAIN.auth);
```

```js controllers/account.js
exports.install = function() {
	ROUTE('POST /login/', login);
	ROUTE('+POST /logout/', logout);
	ROUTE('+GET /me/', me);
};

function login($) {

	var user = $.body.id && $.body.id === '1' && $.body.password === 'secret' ? { id: '1', name: 'Anna' } : null;

	if (!user) {
		$.invalid(401);
		return;
	}

	var sessionid = UID();
	MAIN.sessions[sessionid] = user.id;
	MAIN.auth.authcookie($, sessionid, user.id, '1 day');
	$.json({ name: user.name });
}

function logout($) {
	MAIN.auth.logout($);
	$.json({ ok: true });
}

function me($) {
	$.json({ name: $.user.name });
}
```