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 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