hw-fingerprint

hw-fingerprint

Hardware-based fingerprint for Node and Electron

About

This library provides a getFingerprint() function that produces a 512-bit signature based on the host machine's hardware information, suitable for use in Electron or Node client apps that require authentication against a server. To get the information used to generate the fingerprint, use getFingerprintingInfo()

It uses information provided by Node's OS module and systeminformation library and has no other dependencies.

Usage

getFingerprint() is always asynchronous and returns a Node Buffer. The returned promise is internally cached, so the actual implementation gets called just once.

  const { getFingerprint } = require('hw-fingerprint')

  // with async/await
  async function(){
    const fingerprint = await getFingerprint()
    // do something
  }

  // with promises
  function(){
    getFingerprint.then(function(fingerprint){
      // do something
    })
  }

Changelog

v3.0.0

• Switches from CommonJS to ESM
• Uses top-level await to provide sync functions
• Makes getFingerprint() function accept an optional object with two properties: only and except. Each is an array of properties to filter which system parameters to use in fingerprint calculation.
• Corrects FINGERPRINTING_INFO property for system endianness being incorrectly spelled endianess
• Provided JSDoc annotations