DMS.Security 1.0.1

DMS.Security

Paquete Nuget: DMS.Security Autor: Fredy Fuentes Versión Actual: 1.0.0

📜 Descripción

DMS.Security Biblioteca de seguridad para .NET que implementa cifrado simétrico (AES) y asimétrico (RSA, ECC). Ideal para proteger datos sensibles, gestionar claves con expiración y garantizar integridad en comunicaciones.

📝 Características Principales

• Cifrado Asimétrico: ECC (ECDH + AES-GCM) y RSA.
• Cifrado Simétrico: AES con soporte para claves/IV personalizados.
• Gestión de Claves: Generación de claves públicas y privadas, metadatos y fechas de expiracion.
• Validación Automática: Verificación de claves expiradas o metadatos inconsistentes.

📖 Ejemplos de Uso

📖 Encriptar y Desencriptar una Cadena de Texto con AES

using DMS.Security;

// Generar clave y vector de inicialización
var aes = new AesEncryption(out string key, out string iv);

// Encriptar texto
string encryptedText = aes.Encrypt("Hello, World!");

// Desencriptar texto
var aesWithExistingKey = new AesEncryption(key, iv);
string decryptedText = aesWithExistingKey.Decrypt(encryptedText);

Console.WriteLine($"Encrypted Text: {encryptedText}");
Console.WriteLine($"Decrypted Text: {decryptedText}");
// Output:
// Encrypted Text: <encrypted-text>
// Decrypted Text: Hello, World!

📖 Encriptar y Desencriptar una Cadena de Texto con RSA

using DMS.Security;

// Generar clave pública y privada
var sender = RsaEncryption.GenerateKeys(out string senderPublicKey, out string senderPrivateKey);
var receiver = RsaEncryption.GenerateKeys(out string receiverPublicKey, out string receiverPrivateKey);

// Encriptar texto con clave pública del receptor
string encryptedText = sender.Encrypt("Hello, World!", receiverPublicKey);

// Desencriptar texto con clave privada del receptor
string decryptedText = receiver.Decrypt(encryptedText, receiverPrivateKey);

Console.WriteLine($"Encrypted Text: {encryptedText}");
Console.WriteLine($"Decrypted Text: {decryptedText}");
// Output:
// Encrypted Text: <encrypted-text>
// Decrypted Text: Hello, World!

📖 Encriptar y Desencriptar una Cadena de Texto con ECC

using DMS.Security;

// Generar clave pública y privada
var sender = EccEncryption.GenerateKeys(out string senderPublicKey, out string senderPrivateKey);
var receiver = EccEncryption.GenerateKeys(out string receiverPublicKey, out string receiverPrivateKey);

// Encriptar texto con clave pública del receptor
string encryptedText = sender.Encrypt("Hello, World!", receiverPublicKey);

// Desencriptar texto con clave privada del receptor
string decryptedText = receiver.Decrypt(encryptedText, senderPublicKey);

Console.WriteLine($"Encrypted Text: {encryptedText}");
Console.WriteLine($"Decrypted Text: {decryptedText}");
// Output:
// Encrypted Text: <encrypted-text>
// Decrypted Text: Hello, World!

🚀 Instalación

Puedes instalar el paquete desde NuGet con:

dotnet add package DMS.Security

🛠 Compatibilidad

• .NET 7.0+

⚠️ Mejores Prácticas

• Claves ECC/RSA: Nunca almacenes claves privadas en código fuente o en repositorios públicos. Usa Azure Key Vault o servicios de administración de claves.
• IV en AES: No reutilices el vector de inicialización (IV) para cifrar múltiples mensajes. Genera un IV único para cada mensaje.

📄 Documentación Completa

📄 Licencia

Este proyecto se encuentra bajo la licencia Apache2-0.

📌 Cómo Contribuir

Si deseas contribuir, revisa el archivo CONTRIBUTING.md para más detalles.

📜 Changelog

Para ver los cambios en cada versión, consulta el archivo CHANGELOG.md.