Socket
Socket
Sign inDemoInstall

request-hash

Package Overview
Dependencies
1
Maintainers
1
Versions
7
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

request-hash

Generate a hash from an express Request or http.IncomingMessage


Version published
Maintainers
1
Weekly downloads
1,232
decreased by-15.73%

Weekly downloads

Readme

Source

request-hash

NPM version Build Status Coverage percentage License MIT

Generate a hash from an express Request or http.IncomingMessage

Features

  • Highly configurable
    • Options to hand-pick / filter which headers and cookies to use in order to create the hash
    • BYO serialization, encoding and hashing algorithm with sane defaults
  • Works with any http.IncomingMessage or express.Request

Installation

$ npm install --save request-hash

Usage

Here's a simple example using an express app:

const requestHash = require('request-hash');
const express = require('express')
const app = express()
const port = 3000

// Initialize hash method using custom options
const hash = requestHash({ serializer: JSON.stringify, algorithm: 'md5' });

app.get('/', (req, res) => res.send(hash(req)))

app.listen(port, () => console.log(`Example app listening on port ${port}!`))

API

The API exposes an initialization function which receives the options in order to customize the hash, this main funciton returns another function that actually performs the hashing.

requestHash(options)

const requestHash = require('request-hash');
requestHash({
  algorithm: 'sha256',
  encoding: 'hex',
  expand: false,
  cookies: undefined, // undefined means all cookies are going to be used as-is
  headers: undefined, // undefined means all headers are going to be used as-is
  serializer: undefined // undefined means custom serialize function is going to be used
});
Options
  • algorithm: <string> Defines which hash algorithm to use, possible values depends on the supported OpenSSL version in the platform. Examples are sha256, sha512, md5, etc.
  • digest: <string> Defines a custom encoding to be used, possible values are: hex, latin1, base64.
  • serializer <function> An object serialization function to be used, if undefined uses a custom implementation
  • expand: <boolean> Allows you to bypass the hash algorithm, just returns the concatenated elements
  • cookies: <array> List of cookie keys to be used to create the unique hash, defaults to using all elements
  • headers: <array> List of header keys to be used to create the unique hash, defaults to using all elements

hash(request:http.IncomingMessage)

const requestHash = require('request-hash');
const hash = requestHash();

hash(req);

Alternatives

License

MIT © Ruy Adorno

Keywords

FAQs

Last updated on 01 Dec 2022

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc