ForgeTotal.js 5
pt

Total.js 5

Autenticar utilizadores com a autenticação por sessão integrada

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

Em vez de uma função, AUTH(options) aceita um objeto de opções e instala uma autenticação completa por cookie de sessão:

  • secret assina o cookie, cookie é o seu nome e expire quanto tempo uma sessão fica em memória sem atividade
  • onread(meta, next, $) carrega o utilizador quando chega um cookie válido de uma sessão que não está em memória (por exemplo, após um reinício); chame next(null, user), ou next('not found') para recusar. Verifique aqui que a sessão ainda existe no seu próprio armazém, caso contrário um cookie copiado continua a funcionar depois de o utilizador terminar a sessão
  • onlogout(session) e onremove(sessionid) correm quando uma sessão é removida: apague-a do seu armazém
  • options.authcookie($, sessionid, userid, expiration) inicia a sessão do utilizador: escreve o cookie assinado na resposta
  • options.logout($) remove a sessão e o cookie

Guarde o objeto de opções numa variável: é a pega que usa para iniciar e terminar sessões. Depois disso, $.user fica definido e as rotas + e - funcionam como na receita de AUTH.

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