Eventos de auditoria de ação com uma auditoria nativa

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

Uma ação pode definir audit como um modelo de texto. Ao concluir com sucesso, o framework envia um registo de auditoria para DEF.onAudit(name, data, context). O registo automático usa o nome de sumidouro actions e inclui o id da ação. Uma ação também pode chamar explicitamente $.audit(message, type); isto emite o seu próprio registo e pode levar um tipo como info.

O exemplo substitui o sumidouro de auditoria por um recolhedor em memória para inspecionar o seu contrato. Regista apenas o nome, o id da ação, a mensagem e o tipo. O framework também prepara dados de contexto e dados do pedido serializados: um sumidouro real precisa de uma política explícita para segredos, retenção, acesso e falhas. Um evento de auditoria não é prova de que uma transação de negócio foi confirmada; a ação só deve chamar o seu callback de sucesso depois de a escrita pretendida ter tido sucesso.

Nesta versão, o evento de auditoria automática ocorre após o caminho de chamada de ação bem sucedido. não registra automaticamente falhas de validação ou ações fracassadas.

definitions/audit.js

MAIN.auditEvents = [];
DEF.onAudit = function(name, data) {
	MAIN.auditEvents.push({ sink: name || null, action: data.action, message: data.message || '', type: data.type || null });
};

NEWACTION('AuditExample|save', {
	input: '*name:String',
	audit: 'Saved the example',
	action: function($) {
		$.callback({ ok: true });
	}
});

NEWACTION('AuditExample|explicit', {
	action: function($) {
		$.audit('Explicit example event', 'info');
		$.success();
	}
});

NEWACTION('AuditExample|fail', {
	audit: 'This must not become a success event',
	action: function($) {
		$.invalid(409);
	}
});

controllers/audit.js

exports.install = function() {
	ROUTE('POST /save/ --> *AuditExample|save');
	ROUTE('POST /explicit/ --> *AuditExample|explicit');
	ROUTE('POST /fail/ --> *AuditExample|fail');
	ROUTE('GET /events/', function($) { $.json(MAIN.auditEvents); });
};