# Tokens ligados a um navegador com ENCRYPTREQ() e DECRYPTREQ()

> Cifre um valor juntamente com o user agent (e opcionalmente o endereço IP) do pedido e leia-o de volta apenas a partir do mesmo cliente.

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

`ENCRYPTREQ($, value, key, [strict])` cifra um valor **juntamente com o user agent do pedido** e devolve um token de texto. `DECRYPTREQ($, token, key)` lê o valor de volta e não devolve nada (`undefined`) quando a chave está errada, o token está vazio ou o pedido vem de um cliente diferente. Com `strict` definido como `true`, o endereço IP do pedido também faz parte do token, pelo que deixa de funcionar também quando o endereço muda.

Use-o para valores que entrega ao navegador e espera receber de volta do mesmo navegador: uma ligação de curta duração, um endereço de descarga, um token de formulário. Não substitui uma sessão: o user agent é fácil de copiar. Para tokens que não dependem do pedido, veja a receita sobre cifrar e decifrar.

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