// Copyright (C) 2024, The Duplicati Team // https://duplicati.com, hello@duplicati.com // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), // to deal in the Software without restriction, including without limitation // the rights to use, copy, modify, merge, publish, distribute, sublicense, // and/or sell copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. #nullable enable using Duplicati.Library.Utility; using DeviceId; using System.Collections.Generic; using System.Linq; /// /// Helper class to get the device ID string and computed hash /// public static class DeviceIDHelper { /// /// Generates an empty ID /// /// An empty ID private static string? GenerateEmptyId() { var builder = new DeviceIdBuilder(); builder.Components.Clear(); return builder.ToString(); } /// /// The empty ID produced by DeviceIdBuilder if no information is available /// private static readonly HashSet EMPTY_DEVICE_IDS = new[] { // Known empty Id "WERC8GMRZGE196QVYK49JVXS4GKTWGF4CJDS6K54JPCHPY2JQ1AG", // In case the library changes GenerateEmptyId() } .Where(x => !string.IsNullOrWhiteSpace(x)) .Select(x => x!) // Don't allow empty strings either .Append(string.Empty) .ToHashSet(); /// /// Hashes a set of device IDs /// /// The deviceIds to hash /// The list of hashed ids private static HashSet HashDeviceIds(IEnumerable deviceIds) { var hasher = HashFactory.CreateHasher("SHA256"); return deviceIds.Select(x => x.ComputeHashToHex(hasher)).ToHashSet(); } /// /// The empty deviceId hashes /// public static readonly HashSet EMPTY_DEVICE_ID_HASHES = HashDeviceIds(EMPTY_DEVICE_IDS); /// /// Returns a configured builder /// /// The builder private static DeviceIdBuilder GetBuilder() => new DeviceIdBuilder() .OnWindows(deviceid => deviceid .AddMotherboardSerialNumber()) .OnLinux(deviceid => deviceid .AddMotherboardSerialNumber()) .OnMac(deviceid => deviceid .AddPlatformSerialNumber()); /// /// Get the device ID string (motherboard serial number on Windows and Linux, platform serial number on Mac) /// /// The device Id public static string? GetDeviceID() { var id = GetBuilder().ToString(); if (string.IsNullOrWhiteSpace(id)) return EMPTY_DEVICE_IDS.First(); return id; } /// /// Checks if the deviceId is a meaningful value /// /// true if a deviceId can be obtained, false otherwise public static bool CanGetDeviceId() { var builder = GetBuilder(); builder.UseFormatter(new DeviceId.Formatters.StringDeviceIdFormatter(new DeviceId.Encoders.PlainTextDeviceIdComponentEncoder())); return !string.IsNullOrWhiteSpace(builder.ToString()); } /// /// Get the device ID hashed in SHA256 and in hex format /// /// public static string GetDeviceIDHash() { using var hasher = HashFactory.CreateHasher("SHA256"); return (GetDeviceID() ?? "").ComputeHashToHex(hasher); } }