12 stable releases
3.0.0 | Sep 18, 2024 |
---|---|
2.1.0 | Jun 30, 2024 |
2.0.0 | Mar 24, 2024 |
1.2.0 | Mar 21, 2024 |
1.0.1 | Nov 29, 2023 |
#92 in Operating systems
1,177 downloads per month
Used in 2 crates
(via public-ip-address)
21KB
327 lines
Made with ❤️ for Tauri
mid
Creating a Machine ID hash for MacOS/Windows/Linux.
Utilizes the most static system parameters possible to generate reliable device hashes for licensing your software.
Change Log
v3.0.0 - September 18, 2024
- Important!
Platform ID
has been removed from the mac device hash dataset because after upgrading from macos 14.x to 15.0, it changed, causing the device hash to change. Use this version only for new projects or update the device hashes of your current users.
v2.1.0 - June 30, 2024
- Added
mid::additional_data
function that returns additional device data that is not involved in forming the device hash. Currently available for MacOS only.
v2.0.0 - March 24, 2024
- Returned
to_lowercase()
for Windows MID result, which was mistakenly removed in v1.1.3. This will change the current Windows device hashes! If necessary, use version 2.0.0 for new projects only, or ask users to re-bind the license for new hashes in the current project. - Added
mid::data
function that returns data structure: key, result, hash. mid::print
outputs data to the console only in debug mode, it will not be included in the release build of the project.- Linux uses 3 sources to get machine-id.
- The secret key for hashing cannot be empty.
- Complete code refactoring has been performed.
List of parameters that are used on each platform.
MacOS
system_profiler SPHardwareDataType
The command returns information about the computer's hardware characteristics. Parameters used:
-
Model Number: This parameter represents the computer or device model number. It is used for uniquely identifying a specific model within the manufacturer's range.
-
Serial Number: This parameter is the unique serial number of the computer or device. It is used to identify a specific unit within a particular model.
-
Hardware UUID: This parameter represents the hardware UUID of the computer or device. It serves to provide unique identification of a specific unit across different systems and environments.
-
Provisioning UDID: This parameter represents the device's unique device identifier (UDID), which can be used in the provisioning process or device setup, usually in a corporate or managed environment.
system_profiler SPSecureElementDataType
The command returns information about the Secure Element. This element is used to store encrypted data, such as information about payment cards and other confidential data. Parameters used:
- Platform ID: The unique identifier of the platform to which the Secure Element belongs.
- SEID: The unique identifier of the Secure Element. Created during the NFC chip firmware at the manufacturer's factory.
Windows
PowerShell - expandable automation tool. Parameters used:
-
powershell -command "Get-WmiObject Win32_ComputerSystemProduct"
: Returns the unique product identifier (UUID) of the computer. Usually associated with the computer's motherboard. In rare cases, it may change after replacing or reinstalling the motherboard or after changing the device's BIOS/UEFI. -
powershell -command "Get-WmiObject Win32_BIOS"
: Returns the computer's BIOS serial number. It usually remains constant and does not change. -
powershell -command "Get-WmiObject Win32_BaseBoard"
: Returns the serial number of the computer's baseboard. It usually remains constant and does not change. -
powershell -command "Get-WmiObject Win32_Processor"
: Returns the computer's processor identifier. It should remain unchanged, except in cases of processor replacement.
Linux
- machine-id: A machine identifier (ID) that is used to uniquely identify a computer on Linux systems.
Unfortunately this parameter is subject to user modification and no reliable solution for Linux has been found yet.
Installation
Add the dependency to Cargo.toml
[dependencies]
mid = "3.0.0"
Or install using Cargo CLI
cargo add mid
How to Use
Get machine ID hash
let machine_id = mid::get("mySecretKey").unwrap();
Example: 3f9af06fd78d3390ef35e059623f58af03b7f6ca91690f5af031b774fd541977
Get MID key/result/hash data
let mid_data = mid::data("mySecretKey").unwrap();
MacOS example: MidData { key: "mySecretKey", result: ["ModelNumber", "SerialNumber", "HardwareUUID", "ProvisioningUDID", "PlatformID", "SEID"], hash: "3f9af06fd78d3390ef35e059623f58af03b7f6ca91690f5af031b774fd541977" }
Output the MID key/result/hash to the console in debug_assertions
mode
mid::print("mySecretKey");
MacOS example:
MID.print[key]: mySecretKey
MID.print[result]: ["ModelNumber", "SerialNumber", "HardwareUUID", "ProvisioningUDID", "PlatformID", "SEID"]
MID.print[hash]: 3f9af06fd78d3390ef35e059623f58af03b7f6ca91690f5af031b774fd541977
MID key
- The secret key for hashingMID result
- Array of OS parametersMID hash
- SHA-256 hash from result
Get additional device data
This data does not contribute to the device hash. Currently available for MacOS
only.
let additional_data = mid::additional_data().unwrap();
println!("{:?}", additional_data);
AdditionalData { username: "doroved", hostname: "MacBook-Pro--doroved.local", os_name: "Sonoma", os_version: "14.5", os_full: "Sonoma 14.5", chip: "Apple M1 Pro", memsize: 16, cpu_core_count: 8, languages: ["ru-RU", "bg-RU", "en-RU"] }
Subscribe to my X
Here I will share my developments and projects https://x.com/doroved
References
Dependencies
~40KB