diff options
| author | nanalelfe <nargiza.nosirova@mail.utoronto.ca> | 2016-07-21 06:40:43 +0000 |
|---|---|---|
| committer | nanalelfe <nargiza.nosirova@mail.utoronto.ca> | 2016-07-21 06:40:43 +0000 |
| commit | 39ef1b6fd37bb9b725676d3a98f13e3450798200 (patch) | |
| tree | eeec60d5b56e5c69a3ba251d98a27f4684d47066 /node_modules/tsscmp/README.md | |
| parent | ee8e1a13b60a6adfdc691b2a9b57289188397641 (diff) | |
| parent | 76757d227f64e35a093d47facc260d9266e2bf38 (diff) | |
MERGED
Diffstat (limited to 'node_modules/tsscmp/README.md')
| -rw-r--r-- | node_modules/tsscmp/README.md | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/node_modules/tsscmp/README.md b/node_modules/tsscmp/README.md new file mode 100644 index 0000000..cba99d0 --- /dev/null +++ b/node_modules/tsscmp/README.md @@ -0,0 +1,48 @@ +# Timing safe string compare using double HMAC + +[](https://nodejs.org/en/download) +[](https://npmjs.org/package/tsscmp) +[](https://npmjs.org/package/tsscmp) +[](https://travis-ci.org/suryagh/tsscmp) +[](https://ci.appveyor.com/project/suryagh/tsscmp) +[](https://david-dm.org/suryagh/tsscmp) +[](LICENSE) + + +Prevents [timing attacks](http://codahale.com/a-lesson-in-timing-attacks/) using Brad Hill's +[Double HMAC pattern](https://www.nccgroup.trust/us/about-us/newsroom-and-events/blog/2011/february/double-hmac-verification/) +to perform secure string comparison. Double HMAC avoids the timing atacks by blinding the +timing channel using random time per attempt comparison against iterative brute force attacks. + + +## Install + +``` +npm install tsscmp +``` +## Why +To compare secret values like **authentication tokens**, **passwords** or +**capability urls** so that timing information is not +leaked to the attacker. + +## Example + +```js +var timingSafeCompare = require('tsscmp'); + +var sessionToken = '127e6fbfe24a750e72930c'; +var givenToken = '127e6fbfe24a750e72930c'; + +if (timingSafeCompare(sessionToken, givenToken)) { + console.log('good token'); +} else { + console.log('bad token'); +} +``` +##License: +[MIT](LICENSE) + +**Credits to:** [@jsha](https://github.com/jsha) | +[@bnoordhuis](https://github.com/bnoordhuis) | +[@suryagh](https://github.com/suryagh) | +
\ No newline at end of file |
