Soenneker.Hashing.Argon2 3.0.202

Soenneker.Hashing.Argon2

A utility library for Argon2 hashing and verification

Features

• Password Hashing: Generates a secure, Base64-encoded hash for a plaintext password.
• Password Verification: Verifies a plaintext password against a hashed value.
• Fully customizable parameters for salt size, hash size, iterations, memory usage, and parallelism.

Installation

dotnet add package Soenneker.Hashing.Argon2

Usage

1. Hashing a Password

string password = "SecurePassword123";
string hash = await Argon2HashingUtil.Hash(password);

// Result: A Base64-encoded hash string
Console.WriteLine(hash);

2. Verifying a Password

string password = "SecurePassword123";
string hash = await Argon2HashingUtil.Hash(password);

bool isValid = await Argon2HashingUtil.Verify(password, hash);

// Result: True if the password matches the hash
Console.WriteLine(isValid ? "Password is valid!" : "Invalid password.");

3. Custom Parameters

string password = "CustomPassword";
int saltSize = 32;       // Custom salt size (bytes)
int hashSize = 64;       // Custom hash size (bytes)
int iterations = 8;      // Custom iteration count
int memorySize = 131072; // Custom memory size (KB)
int parallelism = 4;     // Custom thread count

string hash = await Argon2HashingUtil.Hash(password, saltSize, hashSize, iterations, memorySize, parallelism);
bool isValid = await Argon2HashingUtil.Verify(password, hash, saltSize, hashSize, iterations, memorySize, parallelism);

Default Parameters

• Salt Size: 16 bytes
• Hash Size: 32 bytes
• Iterations: 4
• Memory Size: 65536 KB
• Parallelism: 2