Tokeny vázané na prohlížeč pomocí ENCRYPTREQ() a DECRYPTREQ()
ENCRYPTREQ($, value, key, [strict]) zašifruje hodnotu společně s user agentem požadavku a vrátí textový token. DECRYPTREQ($, token, key) přečte hodnotu zpět a nevrátí nic (undefined), když je klíč chybný, token je prázdný nebo požadavek pochází od jiného klienta. Když je strict nastaveno na true, součástí tokenu je i IP adresa požadavku, takže přestane fungovat také tehdy, když se adresa změní.
Použijte to pro hodnoty, které předáte prohlížeči a očekáváte je zpět od téhož prohlížeče: krátkodobý odkaz, adresu ke stažení, token formuláře. Nenahrazuje relaci: user agent lze snadno zkopírovat. Pro tokeny, které na požadavku nezávisejí, viz recept o šifrování a dešifrování.
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 });
}