AgileTech.DbConnStringCrypto 1.0.0

AgileTech.DbConnStringCrypto

A lightweight .NET utility library for encoding and decoding database connection strings using AES encryption. Designed to keep connection strings out of plaintext in configuration files, with a built-in license key check for authorized use.

Developed and maintained by AgileTech.

Features

• 🔐 AES-based Encode / Decode methods for connection strings
• 🔑 License key validation gate before use
• ⚡ Simple static API — no dependency injection or setup required
• 🧩 Targets .NET 8

Installation

dotnet add package AgileTech.DbConnStringCrypto

Or via the NuGet Package Manager:

Install-Package AgileTech.DbConnStringCrypto

Getting Started

1. Validate your license key

Every consumer must call ValidateLicense once (e.g., at application startup) before Encode or Decode will work.

using AgileTech.DbConnStringCrypto;

ConnectionStringCipher.ValidateLicense("YOUR-LICENSE-KEY");

If the key is missing or invalid, this throws UnauthorizedAccessException.

2. Encode a connection string

string plain = "Server=myServer;Database=myDb;User Id=myUser;Password=myPass;";
string encoded = ConnectionStringCipher.Encode(plain);

Console.WriteLine(encoded);
// e.g. "U2FsdGVkX1+abc123..."

Store encoded in your appsettings.json, environment variables, or wherever your config lives — instead of the raw connection string.

3. Decode it back at runtime

string encoded = Configuration["ConnectionStrings:Default"];
string plain = ConnectionStringCipher.Decode(encoded);

using var connection = new SqlConnection(plain);

Full Example

using AgileTech.DbConnStringCrypto;

class Program
{
    static void Main()
    {
        // Step 1: Validate license (required)
        ConnectionStringCipher.ValidateLicense("YOUR-LICENSE-KEY");

        // Step 2: Encode
        string original = "Server=localhost;Database=AppDb;User Id=sa;Password=P@ssw0rd;";
        string encoded = ConnectionStringCipher.Encode(original);
        Console.WriteLine($"Encoded: {encoded}");

        // Step 3: Decode
        string decoded = ConnectionStringCipher.Decode(encoded);
        Console.WriteLine($"Decoded: {decoded}");
    }
}

API Reference

Notes & Limitations

• This library uses a static encryption key internal to the package, meaning encoded values are only "obfuscated," not protected by a secret unique to your deployment. It is intended to prevent connection strings from sitting in plaintext in config files — not to replace a secrets manager (e.g., Azure Key Vault, AWS Secrets Manager) for high-security scenarios.
• License validation is a client-side check. It prevents accidental/unauthorized use in good-faith scenarios but is not a substitute for server-side license enforcement in adversarial contexts.

Licensing

This package is proprietary to AgileTech and requires a valid license key to use. Contact licensing@agiletech.com to obtain a key.

Support

For issues, questions, or feature requests, contact the AgileTech development team at support@agiletech.com or open an issue in the project repository.

Changelog

1.0.0

• Initial release
• Encode / Decode methods using AES encryption
• Static license key validation