Pistitium.Payloader 1.0.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package Pistitium.Payloader --version 1.0.1                
NuGet\Install-Package Pistitium.Payloader -Version 1.0.1                
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="Pistitium.Payloader" Version="1.0.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Pistitium.Payloader --version 1.0.1                
#r "nuget: Pistitium.Payloader, 1.0.1"                
#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 Pistitium.Payloader as a Cake Addin
#addin nuget:?package=Pistitium.Payloader&version=1.0.1

// Install Pistitium.Payloader as a Cake Tool
#tool nuget:?package=Pistitium.Payloader&version=1.0.1                

Pistitium.Payloader

Pistitium.Payloader Provides a framework to:

  • Create Payloads via different Operation chains.
  • Derive your own operation chain from BaseOperationChain
    • Create your own operations by Implementing IPayloadOperation
  • Use already define operation chains:
    • HandshakeOnlyChain
      • UrlSafeBase64EncodingOperation
      • HandshakeOperation
    • HandshakeEncryptionChain
      • EncryptionOperation
      • UrlSafeBase64EncodingOperation
      • HandshakeOperation
      • MachineIdentityOperation
    • PasswordHashEncryptionChain
      • EncryptionOperation
      • UrlSafeBase64EncodingOperation
      • PasswordHashOperation
  • Use already defined Handler
    • FilePayloadHandler
      • Constructor takes in a BaseOperationChain derive class, this could be your own or one the defined above.
  • Create your own Payload Handlers
  • Use class Cryptomizer class to Encrypt that Decrypt (uses System.Security.Criptography)
  • Use class RandomIdGenerator to generate different variations of random IDs
  • Use class Token
    • Handshake: Generates Handshake Token
    • Registration: Generates Registration Token

Installation

Install vial Visual Studio Manage Nuget Packages... or download:

https://www.nuget.org/packages/Pistitium.Payloader

.NET CLI
> dotnet add package Pistitium.Payloader --version 1.0.X

Usage

using Pistitium.Payloader;

///////////////////////////////////////////////////////////
// Loading Payload from file using class FilePayloadHandler
///////////////////////////////////////////////////////////
if (!string.IsNullOrEmpty(storedPassword))
{
    FilePayloadHandler payloadFileHandler = new FilePayloadHandler(new PasswordHashEncryptionChain());

    if (payloadFileHandler.LoadFile(acctFilePath, storedPassword))
    {
        SettingsHandler.Instance.SetDocumentPassword(storedPassword);
        docHashedPassword = payloadFileHandler.Result.Token;

        XmlDocument doc = new XmlDocument();
        doc.LoadXml(payloadFileHandler.Result.Data);
        XmlNode node = doc.DocumentElement.SelectSingleNode("account");

        while (null != node)
        {
            Account acct = new Account(node);

            Accounts.Add(acct);

            node = node.NextSibling;
        }
    }
}

////////////////////////////////////////////////////////
// Saving Payload to file using class FilePayloadHandler
////////////////////////////////////////////////////////
if (!string.IsNullOrEmpty(storedPassword))
{
    XmlDocument doc = new XmlDocument();
    XmlElement docElement = doc.CreateElement("accounts");
    doc.AppendChild(docElement);

    foreach (Account acct in Accounts)
    {
        acct.Save(doc);
    }

    string docPlain = doc.DocumentElement.OuterXml;

    string acctFilePath = DataPocket.Instance.GetParameter(SettingsHandler.KeyDocPath);

    if (string.IsNullOrEmpty(acctFilePath))
    {
        acctFilePath = SettingsHandler.Instance.SelectDocument();
    }

    if (!string.IsNullOrEmpty(acctFilePath))
    {
        FilePayloadHandler payloadFileHandler = new FilePayloadHandler(new PasswordHashEncryptionChain());
        success = payloadFileHandler.SaveData(acctFilePath, doc.DocumentElement.OuterXml, storedPassword);

        if (success)
        {
            docHashedPassword = payloadFileHandler.Result.Token;
        }
    }
}

///////////////////////////
// Using Cryptomizer Class
///////////////////////////
string plaintext = "Have you ever dance with the devil by the moon light!";

CryptoKey cryptoKey = new CryptoKey("TheFarOffM00n");

// Encrypt the string to an array of bytes.
string encryptedBase64 = Cryptomizer.EncryptToBase64String(plaintext, cryptoKey);

string encryptedUrlSafeBase64 = Cryptomizer.EncryptToUrlSafeBase64String(plaintext, cryptoKey);

// Decrypt to Base64 string.
string decryptedBase64 = Cryptomizer.DecryptFromBase64String(encryptedBase64, cryptoKey);

// Decrypt Url Safe Base64 string.
string decryptedUrlSafeBase64 = Cryptomizer.DecryptFromUrlSafeBase64String(encryptedUrlSafeBase64, cryptoKey);

//Display the original data and the decrypted data.
Console.WriteLine("Plain Text:   {0}", plaintext);
Console.WriteLine("Encrypted base64 Encoded: {0}", encryptedBase64);
Console.WriteLine("Encrypted Url Safe Base64 Encoded: {0}", encryptedUrlSafeBase64);
Console.WriteLine("Decrypted from Base64: {0}", decryptedBase64);
Console.WriteLine("Decrypted from Url Safe Base64: {0}", decryptedUrlSafeBase64);

License

MIT

Product Compatible and additional computed target framework versions.
.NET net6.0-windows7.0 is compatible.  net7.0-windows was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net6.0-windows7.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.4 308 2/23/2023
1.0.3 327 1/28/2023
1.0.2 317 1/24/2023
1.0.1 333 1/6/2023
1.0.0 333 1/4/2023

Update icon and readme file.
Simplify Cryptomizer class for easier usage [see readme file]