Thuro.Utility 1.2.1

Thuro.Utility

A comprehensive utility library for .NET Standard 2.0 providing common helper methods and services for Azure integration, encryption, caching, and more.

Features

• Azure Blob Storage Service - Upload, download, delete, and manage files in Azure Blob Storage
• Azure Key Vault Service - Secure secret management with caching support
• AES CBC Encryption Service - Encrypt and decrypt data using AES CBC with HMAC verification
• Password Hasher Service - Secure password hashing using BCrypt
• SMTP Service - Send emails via Microsoft Graph API (Exchange Online)
• Cache Service - In-memory caching with expiration support
• String Extensions - Helper methods for file path formatting

Installation

Install the package via NuGet Package Manager:

Install-Package Thuro.Utility

Or via .NET CLI:

dotnet add package Thuro.Utility

Requirements

• .NET Standard 2.0 or higher
• Azure services (for Azure-related features)
• Microsoft Graph API credentials (for email functionality)

Usage

Azure Blob Storage Service

using Thuro.Utility.Services;

var blobService = new BlobService(connectionString, containerName);

// Upload a file
var stream = File.OpenRead("path/to/file.pdf");
var blobUrl = await blobService.UploadStreamToBlobAsync(stream, "folder/file.pdf");

// Download a file
var downloadedStream = await blobService.GetBlobStreamAsync("folder/file.pdf");

// Delete a file
await blobService.DeleteBlobAsync("folder/file.pdf");

// Generate SAS token
var sasToken = blobService.GenerateSasToken("folder/file.pdf", expiryMinutes: 60);

Azure Key Vault Service

using Thuro.Utility.Services;
using Microsoft.Extensions.DependencyInjection;

// Register cache service
services.AddMemoryCacheService();

// Configure Key Vault options
var options = new AzureKeyVaultService.AzureKeyVaultOptions
{
    VaultName = "your-key-vault-name",
    Keys = "Secret1,Secret2,Secret3" // Optional: specific keys, or leave empty for all
};

var cacheService = services.BuildServiceProvider().GetService<ICacheService>();
var keyVaultService = new AzureKeyVaultService(cacheService, options);

// Initialize (loads and caches secrets)
await keyVaultService.InitializeAsync();

// Get a secret
var secret = keyVaultService.GetSecret("SecretName");

// Get all secrets
var allSecrets = await keyVaultService.GetAllSecretsAsync();

AES CBC Encryption Service

using Thuro.Utility.Services;

// Generate a 64-byte key (32 bytes for AES key + 32 bytes for HMAC key)
byte[] key = new byte[64];
using (var rng = System.Security.Cryptography.RandomNumberGenerator.Create())
{
    rng.GetBytes(key);
}

// Encrypt
string plaintext = "Sensitive data";
byte[] encrypted = AesCbcEncryptionService.Encrypt(plaintext, key);

// Decrypt
string decrypted = AesCbcEncryptionService.Decrypt(encrypted, key);

// Get last 4 digits of SSN
string last4 = AesCbcEncryptionService.GetLast4Digits("123-45-6789");

Password Hasher Service

using Thuro.Utility.Services;

string password = "userPassword123";
string pepper = "your-pepper-value";

// Hash password
string hashedPassword = PasswordHasherService.HashPassword(password, pepper);

// Verify password
bool isValid = PasswordHasherService.VerifyPassword(password, hashedPassword, pepper);

SMTP Service (Microsoft Graph API)

using Thuro.Utility.Services;
using System.Net.Mail;

// Configure Key Vault options (must include Graph credentials)
var keyVaultOptions = new AzureKeyVaultService.AzureKeyVaultOptions
{
    VaultName = "your-key-vault-name"
};

var smtpService = new SMTPService(keyVaultOptions);

// Create and send email
var mailMessage = new MailMessage
{
    From = new MailAddress("sender@domain.com"),
    Subject = "Test Email",
    Body = "<h1>Hello World</h1>",
    IsBodyHtml = true
};

mailMessage.To.Add("recipient@domain.com");

await smtpService.SendEmailAsync(mailMessage);

Cache Service

using Thuro.Utility.Services;
using Microsoft.Extensions.DependencyInjection;

// Register cache service
services.AddMemoryCacheService();

var cacheService = services.BuildServiceProvider().GetService<ICacheService>();

// Set cache with expiration
cacheService.Set("myKey", "myValue", TimeSpan.FromMinutes(30));

// Get from cache
var value = cacheService.Get<string>("myKey");

// Remove from cache
cacheService.Remove("myKey");

String Extensions

using Thuro.Utility;

// Format file path (Windows to Unix style)
string path = "C:\\Users\\Documents\\file.pdf";
string formatted = path.FormatFilePath(); // "Users/Documents/file.pdf"

// Remove filename from path
string directory = "folder/subfolder/file.pdf".RemoveFileNameFromFilePath(); // "folder/subfolder/"

Dependencies

• Azure.Identity (1.13.2)
• Azure.Security.KeyVault.Secrets (4.7.0)
• Azure.Storage.Blobs (12.24.0)
• BCrypt.Net-Next (4.0.3)
• NLog (5.4.0)
• Microsoft.Extensions.Caching.Memory (2.2.0)
• Microsoft.Extensions.DependencyInjection (2.2.0)
• Microsoft.Extensions.Options (2.2.0)
• Microsoft.Graph (5.47.0)

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Thuro

Version

Current version: 1.2.0