Fingerprinty

Fingerprinty is a library providing its users with various kinds of machine fingerprints. The library is .NET Standard and works with Windows and Linux albeit to a different extent.

Fingerprinty is available from NuGet.org:

Supported Fingerprint Providers

Fingerprint Provider	Description	Supported Platforms
AllMacAddressesFingerprintProvider	Provides fingerprint based on all MAC addresses of all network cards on the machine.	Windows and Linux
MachineNameFingerprintProvider	Provides fingerprint based on the machine name.	Windows and Linux
DriveFingerprintProvider	Provides fingerprint based on serial number of disk on which C drive is located.	Windows
AllDrivesFingerprintProvider	Provides fingerprint based on serial numbers of all installed hard drives.	Windows
WindowsProductIdFingerprintProvider	Provides fingerprint based on Windows ProductId.	Windows
ProcessorIdFingerprintProvider	Provides fingerprint based on all processors ids. For single CPU it is based on single id, the CPU cores' number is not relevant.	Windows
MotherboardFingerprintProvider	Provides fingerprint based on motherboard's serial.	Windows

Fingerprint Format

The default fingerprint format is matching [a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4} regex. For example a035-1234-acda-09df. This format can be overriden by providing custom implementations of FingerprintFactory and Fingerprint classes.

DI Support

Fingerprinty is DI container agnostic. You can register the FingerprintProviderFactory as singleton (the class is stateless) or use FingerprintProviderFactory.Default property to access a static instance. Each FingerprintProvider has a public constructor and they can be registered separately in the containter of your choice.

Examples

Get Fingerprint of Current Machine

var provider = FingerprintProviderFactory.Default.CreateMachineNameProvider();
var fingerprint = provider.Get();
var fingerprintText = fingerprint.ToString(); //e.g. adc2-2387-d2a0-022c

Check Supported Platforms

var provider = FingerprintProviderFactory.Default.CreateAllMacAddressesProvider();
var supportedPlatforms = provider.SupportedPlatforms; //SupportedPlatforms.Linux | SupportedPlatforms.Windows

Custom Fingerprint Format

If you would like to provide a custom fingerprint format you need to override two classes FingerprintFactory and Fingerprint.

public class CustomFingerprintFactory : FingerprintFactory
{
  public override Fingerprint Create(byte[] bytes)
  {
    //custom code goes here
  }
  
  //the Fingerprint Create(string text) will by default call the byte[] version internally. It's however possible to override this method as well
}

In the Fingerprint class there is protected constructor which accepts a string and a Func<string, bool> which validates the first argument. Use it in the custom implementations. For example:

public class AlwaysValidFingerprint : Fingerprint
{
  public AlwaysValidFingerprint(string value) : base(value, x => true)
  {
  }
}

Each FingerprintProvider accepts instance of FingerprintFactory in its constructor.

var provider = new MachineNameFingerprintProvider(CreateSha512FingerprintFactory());

Build Status