# Cifra y descifra datos con una clave

> Convierte objetos en tokens opacos con ENCRYPT() y léelos con DECRYPT(), para enlaces firmados y tokens de corta duración.

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

`ENCRYPT(value, key)` serializa un valor a JSON y devuelve un texto opaco. `DECRYPT(text, key)` devuelve el valor original, o `null` cuando el texto se modificó, no es válido o se cifró con otra clave. El ajuste `secret` de tu config se mezcla con la clave, así que los tokens creados en una instalación no se abren en otra.

Úsalo para enlaces de restablecimiento de contraseña, tokens de invitación y todo lo que debas entregar a un cliente y verificar después sin guardarlo. Incluye una caducidad dentro del valor (una marca de tiempo) y compruébala tras descifrar.

```text config
secret : change-this-secret-in-production
```

```js controllers/tokens.js
exports.install = function() {
	ROUTE('GET /token/', create);
	ROUTE('GET /verify/', verify);
};

function create($) {
	var token = ENCRYPT({ userid: '123', expire: Date.now() + 60000 }, 'reset-password');
	$.json({ token: token });
}

function verify($) {

	var data = DECRYPT($.query.token || '', 'reset-password');

	if (!data || data.expire < Date.now()) {
		$.invalid(401);
		return;
	}

	$.json({ userid: data.userid });
}
```