KNM.CryptoHelper

Description

KNM.CryptoHelper is a comprehensive C# cryptographic library providing AES encryption with HMAC integrity, API key generation, JWT token handling, and TOTP MFA support. Designed for enterprise .NET applications with full configuration control and dependency injection integration.

Installation

Single NuGet Package - Everything included!

Install-Package KNM.CryptoHelper

No additional dependencies required - OtpNet, QRCoder, and all cryptographic primitives are already bundled.

Quick Start

1. Object Initializer (Your Preferred Style)

services.AddKnmCryptoCollection(options =>
{
    options.Crypto.CryptoPassword = "miaPasswordSicura!";
    options.Crypto.Iterations = 100_000;
    options.Mfa.Algorithm = "SHA256";
});

2. Fluent Configuration

services.AddKnmCryptoCollection()
    .WithCrypto(crypto => crypto.Iterations = 200_000)
    .WithMfa(mfa => mfa.Digits = 6);

3. Direct Constructor

var options = new Options 
{ 
    Crypto = new CryptoOptions { CryptoPassword = "test123" }
};
var cryptoHelper = new CryptoHelper(options);

Core Features

🔐 Text Encryption/Decryption

string encrypted = cryptoHelper.EncryptText("Secret data");
string decrypted = cryptoHelper.DecryptText(encrypted); // Throws on tamper

🔑 API Key Management

string apiKey = cryptoHelper.GenerateApiKey(userGuid, DateTime.UtcNow.AddDays(30));
bool isValid = cryptoHelper.VerifyApiKey(userGuid, expirationDate, apiKey);

🪪 JWT Token Handling

string jwt = cryptoHelper.GenerateJwtToken("user123", "user@domain.com", "username");
var (isValid, expires) = cryptoHelper.JwtTokenIsValid(jwt);

🔐 MFA TOTP (Everything Included!)

// Setup MFA
string encryptedSecret = cryptoHelper.GenerateMfaSecret(); // Save to DB
string qrCodeBase64 = cryptoHelper.GenerateMfaQrCode(userEmail, encryptedSecret);

// Verify login
bool valid = cryptoHelper.VerifyMfaCode(user.EncryptedMfaSecret, "123456");

Technical Details

All dependencies transitive - OtpNet, QRCoder bundled in KNM.CryptoHelper package!

Dependency Injection (.NET 10)

using KNM.CryptoHelper;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddKnmCryptoCollection(options =>
{
    options.Crypto.CryptoPassword = "SecurePassword123!";
});

Zero configuration headaches - One package, one extension method, full crypto suite! 🚀