BouncyCastle C#（開發者使用方法）

了解充氣城堡的用途

Bouncy Castle 是一家安全服務供應商，提供種類繁多的加密演算法。 它的多功能性使其能夠滿足各種安全需求，從基本加密到複雜的數位簽章。 對於初學者來說，了解充氣城堡的範圍是將其有效應用於專案中的關鍵。

設定

下載庫：要開始使用，請從官方充氣城堡網站下載最新版本的充氣城堡軟體包。 請務必選擇符合專案需求的正確版本。

整合到您的專案中：下載後，將 Bouncy Castle 整合到您的 C# 專案中。 這通常需要在項目設定中添加該庫作為引用。

您也可以使用 NuGet 套件管理員下載並安裝它，只需在 NuGet 套件管理員的搜尋列中搜尋"Bouncycastle"即可。

BouncyCastle C#（開發者使用方法）：圖 1 - 使用 NuGet 套件管理員下載並安裝 BouncyCastle，只需在 NuGet 套件管理員的搜尋列中搜尋"Bouncycastle"即可。

基本加密範例

在這個例子中，我將示範一個使用 C# 中的 Bouncy Castle 和 AES（高級加密標準）的簡單加密場景。

using Org.BouncyCastle.Crypto;
using Org.BouncyCastle.Crypto.Engines;
using Org.BouncyCastle.Crypto.Generators;
using Org.BouncyCastle.Crypto.Modes;
using Org.BouncyCastle.Crypto.Parameters;
using Org.BouncyCastle.Security;
using System.Text;

public class SimpleEncryption
{
    /// <summary>
    /// Encrypts data using AES encryption with a given password.
    /// </summary>
    /// <param name="message">The message to encrypt.</param>
    /// <param name="password">The password for key derivation.</param>
    /// <returns>The encrypted message as a byte array.</returns>
    public static byte[] EncryptData(string message, string password)
    {
        // Generate a random salt
        var salt = new byte[8];
        new SecureRandom().NextBytes(salt);

        // Derive key and IV from the password and salt
        Pkcs5S2ParametersGenerator generator = new Pkcs5S2ParametersGenerator();
        generator.Init(PbeParametersGenerator.Pkcs5PasswordToBytes(password.ToCharArray()), salt, 1000);
        ParametersWithIV keyParam = (ParametersWithIV)generator.GenerateDerivedMacParameters(256 + 128);

        // Create AES cipher in CBC mode with PKCS7 padding
        var cipher = new PaddedBufferedBlockCipher(new CbcBlockCipher(new AesEngine()));
        cipher.Init(true, keyParam);

        // Convert message to byte array and encrypt
        byte[] inputBytes = Encoding.UTF8.GetBytes(message);
        byte[] outputBytes = new byte[cipher.GetOutputSize(inputBytes.Length)];
        int length = cipher.ProcessBytes(inputBytes, 0, inputBytes.Length, outputBytes, 0);
        cipher.DoFinal(outputBytes, length);

        return outputBytes;
    }
}

using Org.BouncyCastle.Crypto;
using Org.BouncyCastle.Crypto.Engines;
using Org.BouncyCastle.Crypto.Generators;
using Org.BouncyCastle.Crypto.Modes;
using Org.BouncyCastle.Crypto.Parameters;
using Org.BouncyCastle.Security;
using System.Text;

public class SimpleEncryption
{
    /// <summary>
    /// Encrypts data using AES encryption with a given password.
    /// </summary>
    /// <param name="message">The message to encrypt.</param>
    /// <param name="password">The password for key derivation.</param>
    /// <returns>The encrypted message as a byte array.</returns>
    public static byte[] EncryptData(string message, string password)
    {
        // Generate a random salt
        var salt = new byte[8];
        new SecureRandom().NextBytes(salt);

        // Derive key and IV from the password and salt
        Pkcs5S2ParametersGenerator generator = new Pkcs5S2ParametersGenerator();
        generator.Init(PbeParametersGenerator.Pkcs5PasswordToBytes(password.ToCharArray()), salt, 1000);
        ParametersWithIV keyParam = (ParametersWithIV)generator.GenerateDerivedMacParameters(256 + 128);

        // Create AES cipher in CBC mode with PKCS7 padding
        var cipher = new PaddedBufferedBlockCipher(new CbcBlockCipher(new AesEngine()));
        cipher.Init(true, keyParam);

        // Convert message to byte array and encrypt
        byte[] inputBytes = Encoding.UTF8.GetBytes(message);
        byte[] outputBytes = new byte[cipher.GetOutputSize(inputBytes.Length)];
        int length = cipher.ProcessBytes(inputBytes, 0, inputBytes.Length, outputBytes, 0);
        cipher.DoFinal(outputBytes, length);

        return outputBytes;
    }
}

此程式碼片段示範如何使用 Bouncy Castle 的加密庫在 C# 中建立基本加密方法。 若要使用此方法，您需要呼叫EncryptData函數，傳入您要加密的訊息和密碼。 例如：

string message = "Hello, this is a test message!";
string password = "StrongPassword123";
byte[] encryptedMessage = SimpleEncryption.EncryptData(message, password);
Console.WriteLine("Original Message: " + message);
Console.WriteLine("Encrypted Message: " + BitConverter.ToString(encryptedMessage));

string message = "Hello, this is a test message!";
string password = "StrongPassword123";
byte[] encryptedMessage = SimpleEncryption.EncryptData(message, password);
Console.WriteLine("Original Message: " + message);
Console.WriteLine("Encrypted Message: " + BitConverter.ToString(encryptedMessage));

這個例子非常基礎，僅用作入門介紹。 在實際應用中，您應該考慮更穩健的做法，例如將鹽值和初始化向量與加密資料一起存儲，並處理加密過程中可能拋出的異常。

! BouncyCastle C#（開發者使用方法）：圖 2 - 控制台輸出

NTRU Prime 和其他高級演算法

Bouncy Castle 支援多種演算法，包括高級NTRU Prime 演算法。 這使得開發人員能夠靈活地選擇最適合其特定需求的演算法。

異常處理和安全最佳實踐

在密碼學應用中，正確的異常處理至關重要。 Bouncy Castle 的方法可能會拋出異常，正確處理這些異常可以確保應用程式的健全性和安全性。

開始使用 IronPDF

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

使用 NuGet 套件管理器安裝

若要使用 NuGet 套件管理器將 IronPDF 整合到您的 Bouncy Castle C# 專案中，請依照下列步驟操作：

1. 開啟 Visual Studio，在解決方案資源管理器中，以滑鼠右鍵按一下您的專案。
2. 從上下文選單中選擇"管理 NuGet 套件…"。
3. 前往瀏覽標籤並蒐尋 IronPDF。
4. 從搜尋結果中選擇 IronPDF 庫，然後按一下安裝按鈕。
5. 接受任何許可協議提示。

如果要透過套件管理器控制台將 IronPDF 新增至專案中，請在套件管理器控制台中執行下列命令：

Install-Package IronPdf

它會將 IronPDF 取得並安裝到您的專案中。

使用 NuGet 網站安裝

如需詳細了解 IronPDF，包括其功能、相容性和其他下載選項，請造訪 NuGet 網站上的 IronPDF 頁面。https://www.nuget.org/packages/IronPdf 。

透過 DLL 安裝

或者，您也可以使用 IronPDF 的 DLL 檔案將其直接整合到您的專案中。請從IronPDF 直接下載頁面下載包含 DLL 的 ZIP 檔案。 解壓縮文件，並將 DLL 文件包含在您的專案中。

使用 IronPDF 產生 PDF

首先，讓我們使用 IronPDF 建立一個簡單的 PDF 文件：

using IronPdf;

public class PdfGenerator
{
    /// <summary>
    /// Creates a simple PDF from HTML content.
    /// </summary>
    /// <param name="filePath">The file path to save the PDF.</param>
    /// <param name="content">The HTML content to render as PDF.</param>
    public static void CreateSimplePdf(string filePath, string content)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(content);
        pdf.SaveAs(filePath);
    }
}

using IronPdf;

public class PdfGenerator
{
    /// <summary>
    /// Creates a simple PDF from HTML content.
    /// </summary>
    /// <param name="filePath">The file path to save the PDF.</param>
    /// <param name="content">The HTML content to render as PDF.</param>
    public static void CreateSimplePdf(string filePath, string content)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(content);
        pdf.SaveAs(filePath);
    }
}

在這段程式碼中，我們使用 IronPDF 的ChromePdfRenderer類別將 HTML 內容渲染為 PDF 並將其儲存到檔案中。

使用充氣城堡加密 PDF

產生 PDF 檔案後，我們可以使用 Bouncy Castle 加密。 這裡，我們將修改EncryptData方法以處理 PDF 檔案：

using System.IO;
using System.Text;

// ... [Previous Bouncy Castle using statements]

public class PdfEncryption
{
    /// <summary>
    /// Encrypts a PDF file using AES encryption.
    /// </summary>
    /// <param name="inputFilePath">The path to the input PDF file.</param>
    /// <param name="outputFilePath">The path to save the encrypted PDF file.</param>
    /// <param name="password">The password used for encryption.</param>
    public static void EncryptPdfFile(string inputFilePath, string outputFilePath, string password)
    {
        // Read the PDF file
        byte[] pdfBytes = File.ReadAllBytes(inputFilePath);

        // Encrypt the PDF bytes
        byte[] encryptedBytes = SimpleEncryption.EncryptData(Encoding.UTF8.GetString(pdfBytes), password);

        // Write the encrypted bytes to a new file
        File.WriteAllBytes(outputFilePath, encryptedBytes);
    }
}

using System.IO;
using System.Text;

// ... [Previous Bouncy Castle using statements]

public class PdfEncryption
{
    /// <summary>
    /// Encrypts a PDF file using AES encryption.
    /// </summary>
    /// <param name="inputFilePath">The path to the input PDF file.</param>
    /// <param name="outputFilePath">The path to save the encrypted PDF file.</param>
    /// <param name="password">The password used for encryption.</param>
    public static void EncryptPdfFile(string inputFilePath, string outputFilePath, string password)
    {
        // Read the PDF file
        byte[] pdfBytes = File.ReadAllBytes(inputFilePath);

        // Encrypt the PDF bytes
        byte[] encryptedBytes = SimpleEncryption.EncryptData(Encoding.UTF8.GetString(pdfBytes), password);

        // Write the encrypted bytes to a new file
        File.WriteAllBytes(outputFilePath, encryptedBytes);
    }
}

在這個方法中，我們將 PDF 檔案讀取為位元組，使用我們先前定義的SimpleEncryption類別對這些位元組進行加密，然後將加密後的位元組寫入新檔案。