#163 Support UTF-8 and special character encryption

Added `Example_6_Wokring_With_Special_Character_Text` to demonstrate encryption and decryption of text with special characters (e.g., emojis) using UTF-8 encoding. Updated `Program.cs` to include the new example and re-enable previously commented-out AES and RSA examples.

Modified `BytesToString` and `StringToBytes` in `ExtShared.cs` to use UTF-8 encoding instead of ASCII for better handling of non-ASCII characters. Updated `migration.md` with a TODO note about encrypting strings with special characters and suggested using byte arrays for clarity.

Author: maythamfahmi

CryptoNet.Examples/ExampleRsa.cs

@@ -92,6 +92,24 @@ public static void Example_5_Export_Public_Key_For_X509_Certificate()
         Debug.Assert(!string.IsNullOrEmpty(publicKey));
     }
 
+    public static void Example_6_Wokring_With_Special_Character_Text()
+    {
+        string ConfidentialDummyDataWithSpecialText = "Top secret 😃😃"; //
+
+        ICryptoNetRsa cryptoNet = new CryptoNetRsa();
+        var privateKey = cryptoNet.GetKey(true);
+        var publicKey = cryptoNet.GetKey(false);
+
+        ICryptoNet encryptClient = new CryptoNetRsa(publicKey);
+        var encrypted = encryptClient.EncryptFromBytes(Encoding.UTF8.GetBytes(ConfidentialDummyDataWithSpecialText));
+
+        ICryptoNet decryptClient = new CryptoNetRsa(privateKey);
+        var decrypted = decryptClient.DecryptToBytes(encrypted);
+        var decryptedString = Encoding.UTF8.GetString(decrypted);
+
+        Debug.Assert(ConfidentialDummyDataWithSpecialText == decryptedString);
+    }
+
     /// <summary>
     /// CryptoNet interact with .net 5/6 for customization, like import/export PEM
     /// Work in Progress, not finished

CryptoNet.Examples/Program.cs

@@ -1,38 +1,23 @@
-//using CryptoNet;
-//using System.Diagnostics;
-
-//const string ConfidentialDummyData = "Top secret 🤣🤣"; //
-
-//ICryptoNetAes cryptoNet = new CryptoNetAes();
-//var key = cryptoNet.GetKey();
-
-//ICryptoNet encryptClient = new CryptoNetAes(key);
-//var encrypted = encryptClient.EncryptFromBytes(ConfidentialDummyData);
-
-//ICryptoNet decryptClient = new CryptoNetAes(key);
-//var decrypted = decryptClient.DecryptToString(encrypted);
-
-//Debug.Assert(ConfidentialDummyData == decrypted);
-
-using CryptoNet.Examples;
+using CryptoNet.Examples;
 
 ExampleDsa.Example_1_Sign_Validate_Content_With_SelfGenerated_AsymmetricKey();
 ExampleDsa.Example_2_SelfGenerated_And_Save_AsymmetricKey();
 
-//ExampleAes.Example_1_Encrypt_Decrypt_Content_With_SelfGenerated_SymmetricKey();
-//ExampleAes.Example_2_SelfGenerated_And_Save_SymmetricKey();
-//ExampleAes.Example_3_Encrypt_Decrypt_Content_With_Own_SymmetricKey();
-//ExampleAes.Example_4_Encrypt_Decrypt_Content_With_Human_Readable_Key_Secret_SymmetricKey();
-//ExampleAes.Example_5_Encrypt_And_Decrypt_File_With_SymmetricKey_Test("TestFiles\\test.docx");
-//ExampleAes.Example_5_Encrypt_And_Decrypt_File_With_SymmetricKey_Test("TestFiles\\test.xlsx");
-//ExampleAes.Example_5_Encrypt_And_Decrypt_File_With_SymmetricKey_Test("TestFiles\\test.pdf");
-//ExampleAes.Example_5_Encrypt_And_Decrypt_File_With_SymmetricKey_Test("TestFiles\\test.png");
-
-//ExampleRsa.Example_1_Encrypt_Decrypt_Content_With_SelfGenerated_AsymmetricKey();
-//ExampleRsa.Example_2_SelfGenerated_And_Save_AsymmetricKey();
-//ExampleRsa.Example_3_Encrypt_With_PublicKey_Decrypt_With_PrivateKey_Of_Content();
-//ExampleRsa.Example_4_Using_X509_Certificate();
-//ExampleRsa.Example_5_Export_Public_Key_For_X509_Certificate();
-//ExampleRsa.Example_7_Customize();
+ExampleAes.Example_1_Encrypt_Decrypt_Content_With_SelfGenerated_SymmetricKey();
+ExampleAes.Example_2_SelfGenerated_And_Save_SymmetricKey();
+ExampleAes.Example_3_Encrypt_Decrypt_Content_With_Own_SymmetricKey();
+ExampleAes.Example_4_Encrypt_Decrypt_Content_With_Human_Readable_Key_Secret_SymmetricKey();
+ExampleAes.Example_5_Encrypt_And_Decrypt_File_With_SymmetricKey_Test("TestFiles\\test.docx");
+ExampleAes.Example_5_Encrypt_And_Decrypt_File_With_SymmetricKey_Test("TestFiles\\test.xlsx");
+ExampleAes.Example_5_Encrypt_And_Decrypt_File_With_SymmetricKey_Test("TestFiles\\test.pdf");
+ExampleAes.Example_5_Encrypt_And_Decrypt_File_With_SymmetricKey_Test("TestFiles\\test.png");
+
+ExampleRsa.Example_1_Encrypt_Decrypt_Content_With_SelfGenerated_AsymmetricKey();
+ExampleRsa.Example_2_SelfGenerated_And_Save_AsymmetricKey();
+ExampleRsa.Example_3_Encrypt_With_PublicKey_Decrypt_With_PrivateKey_Of_Content();
+ExampleRsa.Example_4_Using_X509_Certificate();
+ExampleRsa.Example_5_Export_Public_Key_For_X509_Certificate();
+ExampleRsa.Example_6_Wokring_With_Special_Character_Text();
+ExampleRsa.Example_7_Customize();
 
 

CryptoNet.ExtShared/ExtShared.cs

@@ -106,23 +106,23 @@ public static RSAParameters GetParameters(X509Certificate2? certificate, KeyType
     }
 
     /// <summary>
-    /// Converts a byte array to an ASCII-encoded string.
+    /// Converts a byte array to an UTF8-encoded string.
     /// </summary>
     /// <param name="bytes">The byte array to convert.</param>
-    /// <returns>An ASCII-encoded string representation of the byte array.</returns>
+    /// <returns>An UTF8-encoded string representation of the byte array.</returns>
     public static string BytesToString(byte[] bytes)
     {
-        return Encoding.ASCII.GetString(bytes);
+        return Encoding.UTF8.GetString(bytes);
     }
 
     /// <summary>
-    /// Converts an ASCII-encoded string to a byte array.
+    /// Converts an UTF8-encoded string to a byte array.
     /// </summary>
     /// <param name="content">The string to convert.</param>
-    /// <returns>A byte array representing the ASCII-encoded string.</returns>
+    /// <returns>A byte array representing the UTF8-encoded string.</returns>
     public static byte[] StringToBytes(string content)
     {
-        return Encoding.ASCII.GetBytes(content);
+        return Encoding.UTF8.GetBytes(content);
     }
 
     /// <summary>

docs/migration.md

@@ -3,6 +3,7 @@
 This document describes the main breaking and behavioral changes for the **AES** and **RSA** examples when migrating from **v2.4.0** to **v3.4.3** of CryptoNet.
 
 ---
+TODO: Issue encrypting 🤣🤣 in case of string, use bytes. an example to clarify this.
 
 ## 1. Common Changes