ForgeTotal.js 5
pl

Total.js 5

Rejestracja wydarzeń audytu z native audit sink

Total.js 5 · total5@0.0.19 actionsauditsecurity Uruchomiono z Total.js 5

Akcja może ustawić audit na szablon tekstowy. Po pomyślnym zakończeniu framework wysyła rekord audytu do DEF.onAudit(name, data, context). Rekord automatyczny używa nazwy odbiornika actions i zawiera id akcji. Akcja może też jawnie wywołać $.audit(message, type); to emituje własny rekord i może nieść typ taki jak info.

Przykład zastępuje odbiornik audytu kolektorem w pamięci, aby sprawdzić jego kontrakt. Rejestruje tylko nazwę, id akcji, wiadomość i typ. Framework przygotowuje też dane kontekstowe i zserializowane dane żądania: prawdziwy odbiornik potrzebuje jawnej polityki dla sekretów, retencji, dostępu i awarii. Zdarzenie audytu nie jest dowodem, że transakcja biznesowa została zatwierdzona; akcja powinna wywołać swój callback sukcesu dopiero po powodzeniu zamierzonego zapisu.

W tej wersji zdarzenie audytu automatycznego występuje po udanej ścieżce powrotnej działania. nie rejestruje automatycznie awarii lub nieudanych działań.

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