# Cifrar e decifrar dados com uma chave

> Transforme objetos em tokens opacos com ENCRYPT() e leia-os de volta com DECRYPT(), para ligações assinadas e tokens de curta duração.

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

`ENCRYPT(value, key)` serializa um valor para JSON e devolve um texto opaco. `DECRYPT(text, key)` devolve o valor original, ou `null` quando o texto foi alterado, não é válido ou foi cifrado com outra chave. A definição `secret` da sua config é misturada na chave, pelo que os tokens criados numa instalação não abrem noutra.

Use-o para ligações de redefinição de palavra-passe, tokens de convite e tudo o que entrega a um cliente e verifica mais tarde sem guardar. Coloque uma expiração dentro do valor (um carimbo de data/hora) e verifique-a depois de decifrar.

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