# Tokeny związane z przeglądarką dzięki ENCRYPTREQ() i DECRYPTREQ()

> Zaszyfruj wartość razem z user agentem (i opcjonalnie adresem IP) żądania i odczytaj ją z powrotem tylko od tego samego klienta.

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

`ENCRYPTREQ($, value, key, [strict])` szyfruje wartość **razem z user agentem żądania** i zwraca token tekstowy. `DECRYPTREQ($, token, key)` odczytuje wartość z powrotem i nie zwraca nic (`undefined`), gdy klucz jest błędny, token jest pusty albo żądanie pochodzi od innego klienta. Gdy `strict` ma wartość `true`, częścią tokenu jest także adres IP żądania, więc token przestaje działać również wtedy, gdy adres się zmieni.

Używaj go dla wartości, które przekazujesz przeglądarce i oczekujesz z powrotem od tej samej przeglądarki: krótkotrwały link, adres pobierania, token formularza. Nie zastępuje sesji: user agent łatwo skopiować. Dla tokenów niezależnych od żądania zobacz przepis o szyfrowaniu i odszyfrowywaniu.

```js controllers/tokens.js
exports.install = function() {
	ROUTE('GET /issue/', issue);
	ROUTE('GET /read/', read);
	ROUTE('GET /read-wrong-key/', wrongkey);
};

function issue($) {
	$.json({ token: ENCRYPTREQ($, { id: 5 }, 'my-secret'), strict: ENCRYPTREQ($, 'only-here', 'my-secret', true) });
}

function read($) {
	$.json({ value: DECRYPTREQ($, $.query.token, 'my-secret') || null });
}

function wrongkey($) {
	$.json({ value: DECRYPTREQ($, $.query.token, 'another-secret') || null });
}
```