Walter.Cypher 2024.9.17.1417

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package Walter.Cypher --version 2024.9.17.1417                
NuGet\Install-Package Walter.Cypher -Version 2024.9.17.1417                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Walter.Cypher" Version="2024.9.17.1417" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Walter.Cypher --version 2024.9.17.1417                
#r "nuget: Walter.Cypher, 2024.9.17.1417"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Walter.Cypher as a Cake Addin
#addin nuget:?package=Walter.Cypher&version=2024.9.17.1417

// Install Walter.Cypher as a Cake Tool
#tool nuget:?package=Walter.Cypher&version=2024.9.17.1417                

WALTER

Introducing the WALTER Framework: Workable Algorithms for Location-aware Transmission, Encryption Response. Designed for modern developers, WALTER is a groundbreaking suite of NuGet packages crafted for excellence in .NET Standard 2.0, 2.1, Core 3.1, and .NET 6, 7, 8, as well as C++ environments. By integrating Delphi's native development strengths, we�ve enhanced WALTER�s encryption capabilities to be not only robust but also future-proof, ensuring that it excels in performance, stability, and cross-platform support.

Whether you're tackling networking, encryption, or secure communication, WALTER offers unparalleled efficiency and precision in processing, making it an essential tool for developers who prioritize speed, security, and memory management in their applications.

About this Walter.Cypher Nuget Package

The Walter.Cypher package is a testament to our commitment to providing developers with state-of-the-art cryptographic capabilities. By leveraging Delphi�s potent native development environment, we�ve engineered the package to offer hashing, symmetric, and asymmetric encryption methods that are secure, efficient, and cross-platform. This ensures that data encrypted with Walter.Cypher remains secure against both current and emergent cyber threats, including those posed by quantum computing advancements.

For detailed insights into how Delphi underpins our cryptographic solutions, offering a blend of speed, efficiency, and future-readiness, refer to the DelphiInside.md document. This document elaborates on our strategic choice of Delphi for native calls and AoT compilation, ensuring that the Walter.Cypher package delivers exceptional performance and security across all platforms.

Online documentation and sample code are available to help you integrate Walter.Cypher into your projects seamlessly.

Walter.Cypher

This repository showcases how to utilize the Walter.Cypher NuGet package effectively in your projects with minimal code snippets.

Walter.Web.CypherTests sample code

This sample code shows the use of

  1. Fixed cypher using a password to protect your code.
  2. Generating checksum for tamper detection.
  3. PGP using various key strengths to protect data
  4. The use of Numeric encryption that can be used to defeat base64 scanning tools to detect cyphered constants for password probing as values can be stored in int64 type values

Get Started

Show how to cipher large amounts of text using the Crypto class


[TestMethod()]
public void CipherZip()
{
    var sb = new StringBuilder();
    for (var i = 0; i < 1024; i++)
    {
        sb.Append(DateTime.Now.ToString());
    }
    var test = sb.ToString();

    var cypkered = Crypto.Zip(test);
    var expect = Crypto.UnZip(cypkered);
    Assert.AreEqual(test, expect);
}

Alternatively you can use the extension method

[TestMethod()]
public void CypherExtesnionTest()
{
    var testpw = "65654616540546546";
    var cypher = Environment.MachineName.Encrypt(testpw);
    var clear = cypher.Decrypt(testpw);

    Assert.AreEqual(Environment.MachineName, clear);
}

The extension method for cypher also allow encryption using public/private key encryption using certificates for text of any length

[TestMethod]
public void TestSmallStringAsBytes()
{
    using X509Certificate2 encryptCertificate = GetCert(".cer");
    using X509Certificate2 decryptCertificate = GetCert(".pfx", "01234456");

    var certCypher = Environment.MachineName.AsEncryptedBytes(encryptCertificate);
    var clearBytes = certCypher.AsDecryptFromBytes(decryptCertificate);

    Assert.AreEqual(Environment.MachineName, UTF8Encoding.UTF8.GetString(clearBytes));

    // helper method load embedded test certificate resource from assembly
    static X509Certificate2 GetCert(string extension, string password = null)
    {
        var asam = Assembly.GetExecutingAssembly();
        using (var memory = new MemoryStream())
        using (var stream = asam.GetManifestResourceStream(asam.GetManifestResourceNames().First(f => f.EndsWith(extension))))
        {
            stream.CopyTo(memory);
            return new X509Certificate2(memory.ToArray(), password);
        }
    }
}

[TestMethod]
public void TestLargeStringAsBytes()
{
    using X509Certificate2 encryptCertificate = GetCert(".cer");
    using X509Certificate2 cecryptCertificate = GetCert(".pfx","01234456");

    var sb = new StringBuilder();
    for (int i = 0; i < 100; i++)
    {
        sb.Append(Guid.NewGuid());
    }
    var text = sb.ToString();

    var certCypher = text.AsEncryptedBytes(encryptCertificate);
    Assert.AreNotEqual(certCypher.Length, text.Length);

    var clearBytes = certCypher.AsDecryptFromBytes(cecryptCertificate);
    Assert.AreEqual(text, UTF8Encoding.UTF8.GetString(clearBytes));

    X509Certificate2 GetCert(string extension, string password = null)
    {
        var asam = Assembly.GetExecutingAssembly();
        using (var memory = new MemoryStream())
        using (var stream = asam.GetManifestResourceStream(asam.GetManifestResourceNames().First(f => f.EndsWith(extension))))
        {
            stream!.CopyTo(memory);
            return new X509Certificate2(memory.ToArray(), password);
        }
    }
}


You also have the possibility to encrypt and decrypt persisted text based on the hosting machine, user executing the application, the application or process name this feature works on all platforms that support where that support the concept of users, processes and machine names in .NET and is ideal for storing secure data in memory that should not be possible to access when creating an application dump file but should survive a reboot.

There are some limitations on some IOT devices that might prevent you from using these features

public void RoundTrip_EncryptionScope_Process()
{
    var sb = new StringBuilder();
    for (int i = 0; i < 100; i++)
    {
        sb.Append(Guid.NewGuid());
    }
    var text = sb.ToString();

    var certCypher = text.AsEncryptedBytes(scope: EncryptionScope.Process);
    Assert.AreNotEqual(certCypher.Length, text.Length);

    var clearText = certCypher.AsDecryptFromBytes(scope: EncryptionScope.Process);
    Assert.AreEqual(text, clearText);

}

[TestMethod()]
public void RoundTrip_EncryptionScope_User()
{
    var sb = new StringBuilder();
    for (int i = 0; i < 100; i++)
    {
        sb.Append(Guid.NewGuid());
    }
    var text = sb.ToString();

    var certCypher = text.AsEncryptedBytes(scope: EncryptionScope.User);
    Assert.AreNotEqual(certCypher.Length, text.Length);

    var clearText = certCypher.AsDecryptFromBytes(scope: EncryptionScope.User);
    Assert.AreEqual(text, clearText);
}

[TestMethod()]
public void RoundTrip_EncryptionScope_Machine()
{
    var sb = new StringBuilder();
    for (int i = 0; i < 100; i++)
    {
        sb.Append(Guid.NewGuid());
    }
    var text = sb.ToString();

    var certCypher = text.AsEncryptedBytes(scope: EncryptionScope.Machine);
    Assert.AreNotEqual(certCypher.Length, text.Length);

    var clearText = certCypher.AsDecryptFromBytes(scope: EncryptionScope.Machine);
    Assert.AreEqual(text, clearText);
}

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net8.0-windows7.0 is compatible. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 is compatible. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Walter.Cypher:

Package Downloads
Walter.BOM

Internal NuGet package with business objects used by several ASP-WAF products Documentation available at https://firewallapi.asp-waf.com/?topic=html/N-Walter.BOM.htm

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2024.10.28.1605 357 10/28/2024
2024.10.28.1335 355 10/28/2024
2024.10.19.1525 332 10/20/2024
2024.9.17.1417 1,275 9/17/2024
2024.9.12.1923 477 9/12/2024
2024.9.6.1352 494 9/7/2024
2024.9.4.1300 143 9/4/2024
2024.9.1.1143 495 9/1/2024
2024.8.19.1400 941 8/19/2024
2024.8.14.1256 893 8/14/2024
2024.8.12.958 511 8/12/2024
2024.8.5.1010 416 8/5/2024
2024.7.26.543 604 7/26/2024
2024.7.11.1604 460 7/11/2024
2024.7.9.1509 475 7/9/2024
2024.7.4.1424 477 7/4/2024
2024.7.3.1001 475 7/3/2024
2024.6.26.1408 884 6/28/2024
2024.6.6.1320 313 6/8/2024
2024.5.19.712 103 6/8/2024
2024.5.15.1634 307 5/15/2024
2024.5.14.829 218 5/14/2024
2024.5.13.1637 110 5/13/2024
2024.5.8.1005 253 5/8/2024
2024.4.4.2102 312 4/4/2024
2024.3.26.1111 214 3/26/2024
2024.3.19.2310 198 3/19/2024
2024.3.12.1022 216 3/12/2024
2024.3.7.836 237 3/7/2024
2024.3.6.1645 120 3/6/2024
2024.3.3.842 158 3/3/2024
2024.3.3.750 119 3/3/2024
2024.3.1.1143 136 3/1/2024
2024.2.27.1029 114 2/27/2024
2024.2.6.1959 144 2/6/2024
2023.10.12.1926 4,035 10/12/2023
2023.9.14.812 1,701 9/14/2023
2023.8.29.1040 9,330 8/29/2023
2023.8.17.903 1,822 8/17/2023
2023.8.9.1314 1,900 8/9/2023
2023.8.2.750 1,999 8/2/2023
2023.7.12.830 1,969 7/12/2023
2023.7.5.1419 2,089 7/6/2023
2023.6.14.1628 3,789 6/14/2023
2023.5.30.1640 2,486 5/30/2023
2023.5.4.1552 2,531 5/4/2023
2023.4.12.1236 6,884 4/12/2023
2023.3.14.1356 5,469 3/14/2023
2023.3.1.810 3,207 3/1/2023
2023.2.25.1185 887 2/25/2023
2023.2.22.27 5,612 2/22/2023
2023.2.15.1413 3,381 2/15/2023
2023.2.11.1628 3,387 2/11/2023
2023.1.11.534 3,663 1/11/2023
2022.12.14.648 12,791 12/14/2022
2022.11.27.1059 4,010 11/27/2022
2022.11.21.338 4,128 11/21/2022
2022.11.14.1819 4,305 11/14/2022
2022.11.14.1533 589 11/14/2022
2022.11.13.917 4,976 11/13/2022
2022.10.31.740 8,024 11/1/2022
2022.10.15.652 8,297 10/15/2022
2022.10.1.810 10,271 10/1/2022
2022.9.26.1444 10,907 9/26/2022
2022.9.14.809 9,577 9/14/2022
2022.9.8.1009 18,273 9/8/2022
2022.8.20.1007 9,745 8/20/2022
2022.8.1.1 10,008 7/31/2022
2022.7.15.841 18,898 7/15/2022
2022.7.1.1300 10,187 7/1/2022
2022.6.21.647 10,032 6/21/2022
2022.5.4.1010 36,512 5/4/2022
2022.4.10.828 29,340 4/10/2022
2022.3.26.1117 29,135 3/26/2022
2022.2.11.931 50,724 2/17/2022
2022.1.15.1312 20,955 1/17/2022
2022.1.10.537 20,037 1/10/2022
2022.1.7.1357 9,564 1/8/2022
2021.12.28.1452 10,977 12/28/2021
2021.12.15.911 10,285 12/16/2021 2021.12.15.911 is deprecated because it has critical bugs.
2021.11.19.850 37,956 11/19/2021
2021.11.11.1334 30,527 11/16/2021
2021.11.8.2109 8,946 11/9/2021
2021.11.8.1612 9,480 11/8/2021
2021.10.23.1310 51,970 10/25/2021
2021.10.13.1459 9,988 10/18/2021
2021.10.9.1116 77 10/9/2024
2021.10.9.821 453 10/10/2021
2021.9.26.1913 65,910 9/26/2021
2021.9.17.1702 15,285 9/18/2021
2021.8.30.1319 96,524 8/30/2021
2021.8.14.1600 53,525 8/16/2021
2021.8.14.829 5,664 8/14/2021
2021.8.8.1612 18,617 8/8/2021
2021.8.8.1138 422 8/8/2021
2021.7.22.1044 63,722 7/23/2021
2021.7.15.1547 10,029 7/15/2021
2021.7.12.734 9,823 7/13/2021
2021.6.26.1753 37,314 6/27/2021
2021.6.23.734 19,428 6/24/2021
2021.6.19.803 10,466 6/20/2021
2021.6.11.1600 37,515 6/13/2021
2021.6.9.1120 10,208 6/9/2021
2021.6.7.1407 2,558 6/7/2021
2021.5.28.1533 18,968 5/31/2021
2021.5.28.1451 10,167 5/31/2021
2021.5.25.1732 8,998 5/25/2021
2021.5.12.929 32,412 5/12/2021
2021.5.12.914 404 5/12/2021
2021.5.12.637 5,581 5/12/2021
2021.5.5.1901 33,307 5/6/2021
2021.5.2.1617 9,769 5/4/2021
2021.5.1.1505 10,067 5/1/2021
2021.4.28.1505 9,853 4/28/2021
2021.4.5.1653 63,963 4/5/2021
2021.4.1.913 9,957 4/1/2021
2021.3.31.1630 9,848 4/1/2021
2021.3.18.1608 10,297 3/18/2021
2021.3.3.1295 480 3/3/2021
2021.3.3.835 500 3/3/2021
2021.3.1.1205 24,763 3/2/2021
2021.3.1.1 17,154 2/27/2021
2021.2.21.1 16,602 2/21/2021
2021.2.19.3 8,966 2/20/2021
2021.2.19.2 8,699 2/19/2021
2021.2.18.2 7,736 2/19/2021
2021.2.18.1 445 2/19/2021
2021.2.16.1 17,023 2/16/2021
2021.2.10.1 38,548 2/10/2021
2021.2.9.1 7,616 2/9/2021
2021.2.8.1 472 2/9/2021
2021.2.7.1 14,459 2/6/2021
2020.12.27.1 13,863 12/27/2020
2020.12.26.3 20,202 12/27/2020
2020.12.26.2 502 12/27/2020
2020.12.24.2 526 12/26/2020
2020.12.24.1 475 12/24/2020
2020.12.18.1 7,761 12/19/2020
2020.12.15.1 13,954 12/15/2020
2020.12.14.5 13,116 12/14/2020
2020.12.14.4 7,129 12/14/2020
2020.12.14.3 6,917 12/14/2020
2020.11.27.1 68,568 11/27/2020
2020.11.25.1 13,272 11/25/2020
2020.11.23.1 498 11/25/2020
2020.11.22.2 8,821 11/23/2020
2020.11.20.1 8,083 11/21/2020
2020.11.19.3 8,133 11/19/2020
2020.11.11.1 65,297 11/11/2020
2020.10.9.5 142,072 10/9/2020
2020.10.5.1 71,907 10/5/2020
2020.10.4.1 542 10/4/2020
2020.10.1.1 19,126 10/1/2020
2020.9.24.2 24,226 9/24/2020
2020.9.12.1 50,899 9/12/2020
2020.9.8 17,710 9/8/2020
2020.9.6.5 5,365 9/6/2020
2020.9.6.4 528 9/6/2020
2020.9.6.2 1,776 9/6/2020
2020.9.3.1 14,564 9/3/2020

2 April 2024
- Update to 8.0.3

7 March 2024
- Update to allow trimming and A0T compilation under .net 8

16 November 2023
- Update to add support for .net 8

14 September 2023
- SDK Service pack .net 6 and 7

9 August 2023
- Update to sevice packs of .net 6 and 7

2 Augusted  2023
- Update binaries