20230908

anbs_cp/Interfaces/IEncryptor.cs

@@ -0,0 +1,37 @@
+namespace anbs_cp.Interfaces;
+
+/// <summary>
+/// Интерфейс шифрования
+/// </summary>
+public interface IEncryptor
+{
+    /// <summary>
+    /// Метод для шифрования строки <paramref name="value"/>
+    /// </summary>
+    /// <param name="value">Строка, которая должна быть зашифрована</param>
+    /// <param name="salt">Ключ шифрования</param>
+    /// <returns>Этот метод возвращает зашифрованную строку <paramref name="value"/></returns>
+    string Encrypt (string value, string salt);
+
+    /// <summary>
+    /// Метод для дешифрования строки <paramref name="encryptedValue"/>
+    /// </summary>
+    /// <param name="encryptedValue">Строка, которая должна быть дешифрована</param>
+    /// <param name="salt">Ключ шифрования</param>
+    /// <returns>Этот метод возвращает дешифрованную строку <paramref name="encryptedValue"/></returns>
+    string Decrypt (string encryptedValue, string salt);
+
+    /// <summary>
+    /// Декодирует зашифрованную строку в HTML-пригодный формат
+    /// </summary>
+    /// <param name="text">Зашифрованная строка</param>
+    /// <returns>Этот метод возвращает дешифрованную строку <paramref name="text"/></returns>
+    string Base64UrlEncode (string text);
+
+    /// <summary>
+    /// Раскодирует из декодированной строки в HTML-пригодный формат
+    /// </summary>
+    /// <param name="text">Декодированная строка</param>
+    /// <returns>Этот метод возвращает шифрованную строку <paramref name="text"/></returns>
+    string Base64UrlDecode (string text);
+}