إضافة توقيع رقمي أو توقيع PDF رقمي في C#

Aspose.PDF for .NET يدعم ميزة توقيع ملفات PDF رقميًا باستخدام فئة SignatureField. يمكنك أيضًا اعتماد ملف PDF باستخدام شهادة PKCS12. شيء مشابه لـ إضافة التوقيعات والأمان في Adobe Acrobat.

عند توقيع مستند PDF باستخدام توقيع، فإنك تؤكد أساسًا محتوياته “كما هي”. وبالتالي، فإن أي تغييرات أخرى تطرأ بعد ذلك تلغي التوقيع وبالتالي، ستعرف إذا تم تعديل المستند. بينما، اعتماد مستند أولاً يسمح لك بتحديد التغييرات التي يمكن للمستخدم إجراؤها على المستند دون إلغاء الاعتماد.

بعبارة أخرى، سيظل المستند يعتبر محتفظًا بسلامته ويمكن للمستلم أن يثق في المستند. لمزيد من التفاصيل، يرجى زيارة اعتماد وتوقيع PDF. بشكل عام، يمكن مقارنة اعتماد مستند بتوقيع كود تنفيذ .NET.

تعمل مقتطفات الكود التالية أيضًا مع مكتبة Aspose.PDF.Drawing.

ميزات توقيع Aspose.PDF for .NET

يمكننا استخدام الفئات والأساليب التالية لتوقيع PDF

فئة DocMDPSignature.
تعداد DocMDPAccessPermissions.
خاصية IsCertified في فئة PdfFileSignature.

لإنشاء توقيع رقمي استنادًا إلى شهادات PKCS12 (امتدادات الملفات .p12، pfx)، يجب عليك إنشاء مثيل من فئة PdfFileSignature، مع تمرير كائن المستند إليها. بعد ذلك، يجب عليك تحديد طريقة التوقيع الرقمي المطلوبة عن طريق إنشاء كائن من إحدى الفئات:

PKCS1.
PKCS7.
PKCS7Detached.

يمكنك تعيين خوارزمية التجزئة فقط لـ PKCS7Detached. بالنسبة لـ PKCS1 و PKCS7، يتم دائمًا تعيين خوارزمية التجزئة إلى SHA-1.

بعد ذلك، تحتاج إلى استخدام كائن خوارزمية التوقيع المستلم في طريقة PdfFileSignature.Sign(). سيتم تعيين التوقيع الرقمي للمستند بعد حفظه.

توقيع PDF مع التوقيعات الرقمية

المثال أدناه ينشئ توقيع PKCS7 غير منفصل مع خوارزمية تجزئة SHA-1.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SignDocument()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();
    
    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "DigitallySign.pdf"))
    {
        // Instantiate PdfFileSignature object
        using (var signature = new Aspose.Pdf.Facades.PdfFileSignature(document))
        {
            // Create PKCS#7 object for sign
            var pkcs = new Aspose.Pdf.Forms.PKCS7(dataDir + "rsa_cert.pfx", "12345");
            // Sign PDF file
            signature.Sign(1, true, new System.Drawing.Rectangle(300, 100, 400, 200), pkcs);
            // Save PDF document
            signature.Save(dataDir + "DigitallySign_out.pdf");
        }
    }
}

المثال أدناه ينشئ توقيعًا منفصلًا بتنسيق PKCS7Detached مع خوارزمية تجزئة SHA-256. تعتمد خوارزمية المفتاح على مفتاح الشهادة. يتم دعم DSA و RSA و ECDSA.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SignDocument(string pfxFilePath, string password)
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "DigitallySign.pdf"))
    {
        // Instantiate PdfFileSignature object using the opened document
        using (var signature = new Aspose.Pdf.Facades.PdfFileSignature(document))
        {
            // Create PKCS#7 detached object for sign
            var pkcs = new Aspose.Pdf.Forms.PKCS7Detached(pfxFilePath, password, Aspose.Pdf.DigestHashAlgorithm.Sha256);
            // Sign PDF file
            signature.Sign(1, true, new System.Drawing.Rectangle(300, 100, 400, 200),pkcs);
            // Save PDF document
            signature.Save(dataDir + "DigitallySign_out.pdf");
        }
    }
}

يمكنك التحقق من التوقيعات باستخدام طريقة PdfFileSignature.VerifySignature(). سابقًا، كانت تستخدم طريقة GetSignNames() للحصول على أسماء التوقيع. بدءًا من الإصدار 25.02، يجب استخدام طريقة GetSignatureNames()، التي تعيد قائمة بـ SignatureName. تمنع SignatureName التصادمات عند التحقق من التوقيعات بنفس الأسماء. يجب أيضًا استخدام الطرق التي تقبل نوع SignatureName بدلاً من اسم توقيع نصي.

ملاحظات، طريقة PdfFileSignature.VerifySigned() قديمة.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void Verify()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "signed_rsa.pdf"))
    {
        // Create an instance of PdfFileSignature for working with signatures in the document
        using (var signature = new Aspose.Pdf.Facades.PdfFileSignature(document))
        {         
            // Get a list of signature names in the document
            var sigNames = signature.GetSignatureNames();

            // Loop through all signature names to verify each one
            foreach (var sigName in sigNames)
            {
                // Verify that the signature with the given name is valid
                if (!signature.VerifySignature(sigName))
                {
                    throw new Exception("Not verified");
                }
            }
        }
    }
}

يمكنك استخدام طريقة TryVerifySignature بدلاً من VerifySignature لتجنب حدوث استثناء.

وصف الطريقة

تستخدم طريقة bool TryVerifySignature(SignatureName signName, out VerificationResult verificationResult) للتحقق بأمان من توقيع رقمي في مستند PDF دون طرح استثناءات. تعيد الطريقة true إذا اكتمل عملية التحقق بنجاح (بما في ذلك الحالات التي يكون فيها التوقيع غير صالح)، و false إذا فشلت عملية التحقق بسبب خطأ تقني (على سبيل المثال، هيكل توقيع تالف أو بيانات غير متوقعة) أو تم تغيير التوقيع بشكل ضار.

السلوك

قيمة الإرجاع:
- true — اكتمل التحقق بدون استثناءات (لكن ليس بالضرورة بنجاح؛ انظر خصائص verificationResult)
- false — حدث خطأ حرج أثناء التحقق أو تم تغيير التوقيع بشكل ضار.
VerificationResult يحتوي على الخصائص التالية:
- State: حالة التحقق — Valid، Invalid، أو Undefined
- IsCompromised: true إذا بدا أن هيكل التوقيع قد تم تعديله (على سبيل المثال، محاولة لتجاوز التحقق من التوقيع)
- Message: رسالة تحتوي على معلومات تفصيلية حول نتيجة التحقق. يمكن تعيين الخاصية إذا كانت State تساوي Undefined أو Invalid
- Exception: الاستثناء الداخلي، إذا حدث (على سبيل المثال، SanitizationException). يمكن تعيين الخاصية إذا كانت State تساوي Undefined

تظهر حالة Undefined خطأ تقني أو تغيير ضار في التوقيع. انظر Message للحصول على معلومات تفصيلية.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
public static void TryVerifySignature()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "DigitallySign.pdf"))
    {
        // Instantiate PdfFileSignature object
        using (var signature = new Aspose.Pdf.Facades.PdfFileSignature(document))
        {
            // Get the names of all signatures
            var signatureNames = signature.GetSignatureNames();

            if (signatureNames.Count == 0)
            {
                Console.WriteLine("The document contains no signatures.");
                return;
            }

            // Verify each signature
            foreach (SignatureName signName in signatureNames)
            {
                Console.WriteLine($"\n=== Verifying signature: {signName} ===");

                bool success = signature.TryVerifySignature(signName, out VerificationResult result);

                // Whether the verification completed without exceptions
                if (!success)
                {
                    Console.WriteLine("⚠️ Verification failed due to a technical error (invalid signature structure or another critical error).");
                    Console.WriteLine($"   Message: {result?.Message}");
                    continue;
                }

                // Analyze the verification result
                switch (result.Value)
                {
                    case VerificationState.Valid:
                        Console.WriteLine("✅ The signature is valid.");
                        Console.WriteLine($"   Message: {result.Message}");
                        break;

                    case VerificationState.Invalid:
                        Console.WriteLine("❌ The signature is invalid.");
                        Console.WriteLine($"   Message: {result.Message}");
                        break;

                    case VerificationState.Undefined:
                        Console.WriteLine("❓ The signature state is undefined.");
                        Console.WriteLine($"   Message: {result.Message}");
                         Console.WriteLine($"  Exception: {(result.Exception != null ? result.Exception.GetType().Name : "none")}");
                        Console.WriteLine($"   Structure appears to be compromised: {result.IsCompromised}");
                        break;
                }

                // Additionally, indicate whether the signature structure appears to have been compromised
                if (result.IsCompromised)
                {
                    Console.WriteLine("   ⚠️ The signature may be compromised (its structure appears to have been modified).");
                }
            }
        }
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
public static void TryVerifySignature()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();

    // Open PDF document
    using var document = new Aspose.Pdf.Document(dataDir + "DigitallySign.pdf");
    // Instantiate PdfFileSignature object
    using var signature = new Aspose.Pdf.Facades.PdfFileSignature(document);
    // Get the names of all signatures
    var signatureNames = signature.GetSignatureNames();

    if (signatureNames.Count == 0)
    {
        Console.WriteLine("The document contains no signatures.");
        return;
    }

    // Verify each signature
    foreach (SignatureName signName in signatureNames)
    {
        Console.WriteLine($"\n=== Verifying signature: {signName} ===");

        bool success = signature.TryVerifySignature(signName, out VerificationResult result);

        // Whether the verification completed without exceptions
        if (!success)
        {
            Console.WriteLine("⚠️ Verification failed due to a technical error (invalid signature structure or another critical error).");
            Console.WriteLine($"   Message: {result?.Message}");
            continue;
        }

        // Analyze the verification result
        switch (result.Value)
        {
            case VerificationState.Valid:
                Console.WriteLine("✅ The signature is valid.");
                Console.WriteLine($"   Message: {result.Message}");
                break;

            case VerificationState.Invalid:
                Console.WriteLine("❌ The signature is invalid.");
                Console.WriteLine($"   Message: {result.Message}");                
                break;

            case VerificationState.Undefined:
                Console.WriteLine("❓ The signature state is undefined.");
                Console.WriteLine($"   Message: {result.Message}");
                Console.WriteLine($"   Structure appears to be compromised: {result.IsСompromised}");
                Console.WriteLine($"   Exception: {(result.Exception != null ? result.Exception.GetType().Name : "none")}");
                break;
        }

        // Additionally, indicate whether the signature structure appears to have been compromised
        if (result.IsСompromised)
        {
            Console.WriteLine("   ⚠️ The signature may be compromised (its structure appears to have been modified).");
        }
    }
}

تحقق من التوقيعات الرقمية باستخدام شهادة مفتاح عام خارجية

يمكنك استخدام شهادة خارجية تحتوي على المفتاح العام الذي يتوافق مع المفتاح الخاص المستخدم لتوقيع المستند للتحقق من التوقيع.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static bool VerifyWithPublicKeyCertificate1(X509Certificate2 certificate, string inputPdfFilePath)
{
    // Create an instance of PdfFileSignature for working with signatures in the document
    using (var fileSign = new Aspose.Pdf.Facades.PdfFileSignature(inputPdfFilePath))
    {
        // Get a list of signatures
        IList<Aspose.Pdf.Facades.SignatureName> signatureNames = fileSign.GetSignatureNames();
        
        // Verify the signature with the given name.
        return fileSign.VerifySignature(signatureNames[0], certificate);
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static bool VerifyWithPublicKeyCertificate1(X509Certificate2 certificate, string inputPdfFilePath)
{
    // Create an instance of PdfFileSignature for working with signatures in the document
    using var fileSign = new Aspose.Pdf.Facades.PdfFileSignature(inputPdfFilePath);
    
    // Get a list of signatures
    IList<Aspose.Pdf.Facades.SignatureName> signatureNames = fileSign.GetSignatureNames();
    
    // Verify the signature with the given name.
    return fileSign.VerifySignature(signatureNames[0], certificate);    
}

يمكنك استخراج شهادة من التوقيع واستخدامها للتحقق من التوقيع.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static bool VerifyWithPublicKeyCertificateFromSignature(string inputPdfFilePath)
{
    // Create an instance of PdfFileSignature for working with signatures in the document
    using (var fileSign = new Aspose.Pdf.Facades.PdfFileSignature(inputPdfFilePath))
    {
        // Get a list of signatures
        IList<Aspose.Pdf.Facades.SignatureName> signatureNames = fileSign.GetSignatureNames();
        
        X509Certificate2 certificate;
        // Extract the public key certificate from the signature
        if (fileSign.TryExtractCertificate(signatureNames[0], out certificate))
        {
            // Verify the signature with the given name.
            return fileSign.VerifySignature(signatureNames[0], certificate);
        }
        
        return false;
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static bool VerifyWithPublicKeyCertificateFromSignature(string inputPdfFilePath)
{
    // Create an instance of PdfFileSignature for working with signatures in the document
    using var fileSign = new Aspose.Pdf.Facades.PdfFileSignature(inputPdfFilePath);
    
    // Get a list of signatures
    IList<Aspose.Pdf.Facades.SignatureName> signatureNames = fileSign.GetSignatureNames();
    
    // Extract the public key certificate from the signature
    if (fileSign.TryExtractCertificate(signatureNames[0], out X509Certificate2 certificate))
    {
        //Verify the signature with the given name.
        return fileSign.VerifySignature(signatureNames[0], certificate);
    }
    
    return false;    
}

تحقق من التوقيعات الرقمية باستخدام فحص الشهادة

عند التحقق من توقيع رقمي، يمكنك التحقق من شهادة التوقيع للإلغاء.

لسوء الحظ، لا يمكن لـ Aspose.PDF التحقق من صحة الشهادات الجذرية أو الوسيطة في سلسلة الشهادات.
لذلك، يتم التحقق فقط من حالة إلغاء شهادة التوقيع باستخدام CRL و OCSP.

لتكوين التحقق من الشهادة، يمكنك استخدام معلمة ValidationOptions.

تقدم خيار ValidationMode ثلاثة أوضاع تحقق:

None – لا يتم التحقق من الشهادة.
Strict – يؤثر إلغاء الشهادة على نتيجة طريقة Verify.
OnlyCheck – يسمح بالتحقق من الشهادة دون التأثير على نتيجة التحقق من التوقيع.

يحدد ValidationMethod الطريقة المستخدمة للتحقق من الشهادة:

Auto – اختيار طريقة تلقائية. يفضل OCSP. يتم تحديد حالة الإلغاء بواسطة الطريقة التي تنجح في إجراء التحقق.
Ocsp – يتم التحقق من الإلغاء باستخدام OCSP.
Crl – يتم التحقق من الإلغاء باستخدام CRL.
All – يتم استخدام كلا الطريقتين للتحقق من الشهادة. لكي تنجح عملية التحقق، يجب أن تؤكد كلا الطريقتين أن الشهادة غير ملغاة.

يتيح خيار CheckCertificateChain التحقق من وجود سلسلة شهادات في التوقيع.
إذا لم يتم العثور على سلسلة الشهادات، ستكون نتيجة التحقق من الشهادة Undefined.

يمكن الحصول على نتيجة التحقق من خلال معلمة إخراج من نوع ValidationResult.
الحالات الممكنة هي: Valid، Invalid، و Undefined.
عادةً ما تعني Undefined أنه لم يكن من الممكن التحقق من الشهادة أو أن سلسلة الشهادات مفقودة.

تعيين كل من CheckCertificateChain و ValidationMode = ValidationMode.Strict يتوافق مع سلوك Adobe Acrobat.
إذا لم تتمكن Adobe Acrobat من العثور على سلسلة الشهادات، فإنها لا تتحقق من حالة الإلغاء، ويعتبر التوقيع غير صالح.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void VerifySignatureWithCertificateCheck(string filePath)
{
    // Open PDF document
    using (var document = new Aspose.Pdf.Document(filePath))
    {
        // Create an instance of PdfFileSignature for working with signatures in the document
        using (var pdfSign = new Aspose.Pdf.Facades.PdfFileSignature(document))
        {
            // Find all signatures
            foreach (var signName in pdfSign.GetSignatureNames())
            {
                // Create a certificate validation option
                var options = new Aspose.Pdf.Security.ValidationOptions();
                options.ValidationMode = ValidationMode.Strict;
                options.ValidationMethod = ValidationMethod.Auto;
                options.CheckCertificateChain = true;
                options.RequestTimeout = 20000;

                Aspose.Pdf.Security.ValidationResult validationResult;
                // Verify a digital signature
                bool verified = pdfSign.VerifySignature(signName, options, out validationResult);
                Console.WriteLine("Certificate validation resul: " + validationResult.Status);
                Console.WriteLine("Is verified: " + verified);
            } 
        }
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void VerifySignatureWithCertificateCheck(string filePath)
{
    // Open PDF document
    using var document = new Aspose.Pdf.Document(filePath);
    
    // Create an instance of PdfFileSignature for working with signatures in the document
    using var pdfSign = new Aspose.Pdf.Facades.PdfFileSignature(document);
    
    // Find all signatures
    foreach (var signName in pdfSign.GetSignatureNames())
    {
        // Create a certificate validation option
        var options = new Aspose.Pdf.Security.ValidationOptions();
        options.ValidationMode = ValidationMode.Strict;
        options.ValidationMethod = ValidationMethod.Auto;
        options.CheckCertificateChain = true;
        options.RequestTimeout = 20000;

        Aspose.Pdf.Security.ValidationResult validationResult;
        // Verify a digital signature
        bool verified = pdfSign.VerifySignature(signName, options, out validationResult);
        Console.WriteLine($"Certificate validation resul: {validationResult.Status}");
        Console.WriteLine($"Is verified: {verified}" );
    }             
}

إضافة توقيت إلى التوقيع الرقمي

كيفية توقيع PDF رقميًا مع توقيت

Aspose.PDF for .NET يدعم توقيع PDF رقميًا مع خادم توقيت أو خدمة ويب.

لتحقيق هذا المتطلب، تمت إضافة فئة TimestampSettings إلى مساحة أسماء Aspose.PDF. يرجى إلقاء نظرة على مقتطف الكود التالي الذي يحصل على التوقيت ويضيفه إلى مستند PDF:

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SignWithTimeStampServer(string pfxFilePath, string password)
{    
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "SimpleResume.pdf"))
    {
        // Create an instance of PdfFileSignature for working with signatures in the document
        using (var signature = new Aspose.Pdf.Facades.PdfFileSignature(document))
        {
            var pkcs = new Aspose.Pdf.Forms.PKCS7(pfxFilePath, password);
            // Create TimestampSettings settings
            var timestampSettings = new Aspose.Pdf.TimestampSettings("https://freetsa.org/tsr", string.Empty); // User/Password can be omitted
            pkcs.TimestampSettings = timestampSettings;
            System.Drawing.Rectangle rect = new System.Drawing.Rectangle(100, 100, 200, 100);
            // Create any of the three signature types
            signature.Sign(1, "Signature Reason", "Contact", "Location", true, rect, pkcs);
            // Save PDF document
            signature.Save(dataDir + "DigitallySignWithTimeStamp_out.pdf");
        }
    }
}

توقيع PDF باستخدام X509Certificate2 بتنسيق base64

يقوم هذا الكود بتوقيع PDF باستخدام شهادة خارجية، ربما تتفاعل مع خادم لاسترداد التجزئة الموقعة وإدراج التوقيع في مستند PDF.

خطوات توقيع PDF:

إنشاء مثيل من PdfFileSignature.
تحديد تجزئة التوقيع المخصصة.
تحميل الشهادة.
توقيع البيانات.
الربط وتوقيع PDF.
حفظ PDF الموقع.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SignWithBase64Certificate(string pfxFilePath, string password)
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();

    var base64Str = "Certificate in base64 format";
    using (var pdfSign = new Aspose.Pdf.Facades.PdfFileSignature())
    {
        var sign = new Aspose.Pdf.Forms.ExternalSignature(base64Str, false);// without Private Key
        sign.ShowProperties = false;
        // Create a delegate to external sign
        Aspose.Pdf.Forms.SignHash customSignHash = delegate (byte[] signableHash, Aspose.Pdf.DigestHashAlgorithm digestHashAlgorithm)
        {
            // Simulated Server Part (This will probably just be sending data and receiving a response)
            var signerCert = new X509Certificate2(pfxFilePath, password, X509KeyStorageFlags.Exportable);// must have Private Key
            var rsaCSP = new RSACryptoServiceProvider();
            var xmlString = signerCert.PrivateKey.ToXmlString(true);
            rsaCSP.FromXmlString(xmlString);
            byte[] signedData = rsaCSP.SignData(signableHash, CryptoConfig.MapNameToOID("SHA1"));
            return signedData;
        };
        sign.CustomSignHash = customSignHash;
        // Bind PDF document
        pdfSign.BindPdf(dataDir + "input.pdf");
        // Sign the file
        pdfSign.Sign(1, "second approval", "second_user@example.com", "Australia", false,
            new System.Drawing.Rectangle(200, 200, 200, 100),
            sign);
        // Save PDF document
        pdfSign.Save(dataDir + "SignWithBase64Certificate_out.pdf");
    }
}

توقيع PDF باستخدام وظيفة توقيع HASH

باستخدام وظيفة توقيع تجزئة مخصصة، يمكن لسلطة التوقيع تنفيذ معايير تشفير محددة أو سياسات أمان داخلية تتجاوز طرق التوقيع القياسية، مما يضمن سلامة المستند. تساعد هذه الطريقة في التحقق من أن المستند لم يتم تعديله منذ تطبيق التوقيع وتوفر توقيعًا رقميًا ملزمًا قانونيًا مع دليل قابل للتحقق على هوية الموقع باستخدام شهادة PFX.

توضح مقتطفات الكود التالية كيفية توقيع مستند PDF رقميًا باستخدام شهادة PFX (PKCS#12) مع وظيفة توقيع تجزئة مخصصة في C#.

لنلقِ نظرة أقرب على عملية توقيع DPF:

تحديد مسارات الملفات ومعلومات الشهادة:

inputPdf: المسار إلى مستند PDF المدخل الذي يحتاج إلى التوقيع.
inputP12: المسار إلى ملف الشهادة .p12 (PFX) المستخدم للتوقيع.
inputPfxPassword: كلمة المرور لشهادة PFX.
outputPdf: المسار الذي سيتم حفظ PDF الموقع فيه.

عملية التوقيع:

يتم إنشاء كائن PdfFileSignature ويرتبط بـ PDF المدخل.
يتم تهيئة كائن PKCS7 باستخدام شهادة PFX وكلمتها السرية. يتم تعيين طريقة ‘CustomSignHash’ كوظيفة توقيع التجزئة المخصصة.
يتم استدعاء طريقة Sign، مع تحديد رقم الصفحة (1 في هذه الحالة)، تفاصيل التوقيع (السبب، المحتوى، الموقع)، والموقع (مستطيل بإحداثيات (0، 0، 500، 500)) للتوقيع.
يتم حفظ PDF الموقع بعد ذلك إلى المسار المحدد.

توقيع التجزئة المخصص:

تقبل طريقة CustomSignHash مصفوفة بايت signableHash (التجزئة التي سيتم توقيعها).
يتم تحميل نفس شهادة PFX واسترداد مفتاحها الخاص.
يتم استخدام المفتاح الخاص لتوقيع التجزئة باستخدام RSACryptoServiceProvider وخوارزمية SHA-1.
يتم إرجاع البيانات الموقعة (مصفوفة بايت) لتطبيقها على توقيع PDF.

يمكن تحديد خوارزمية التجزئة في مُنشئ PKCS7Detached. يمكن استدعاء خدمة طرف ثالث في مُفوض CustomSignHash. يجب أن تتطابق خوارزمية التوقيع المستخدمة في CustomSignHash مع خوارزمية المفتاح في الشهادة المرسلة إلى PKCS7/PKCS7Detached.

المثال أدناه ينشئ توقيعًا غير منفصل باستخدام خوارزمية RSA وخوارزمية تجزئة SHA-1. إذا كنت تستخدم PKCS7Detached بدلاً من PKCS7، يمكنك استخدام ECDCA وتعيين خوارزمية التجزئة المطلوبة.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SignWithCertificate(string pfxFilePath, string password)
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();

    using (var sign = new Aspose.Pdf.Facades.PdfFileSignature())
    {   
        // Bind PDF document
        sign.BindPdf(dataDir + "input.pdf");
        // Create PKCS#7 object to sign
        var pkcs7 = new Aspose.Pdf.Forms.PKCS7(pfxFilePath, password);// You can use PKCS7Detached with digest algorithm argument
        // Set the delegate to external sign
        pkcs7.CustomSignHash = CustomSignHash;
        // Sign the file
        sign.Sign(1, "reason", "cont", "loc", false, new System.Drawing.Rectangle(0, 0, 500, 500), pkcs7);
        // Save PDF document
        sign.Save(dataDir + "SignWithCertificate_out.pdf");
    }

    // Custom hash signing function to generate a digital signature
    byte[] CustomSignHash(byte[] signableHash, Aspose.Pdf.DigestHashAlgorithm digestHashAlgorithm)
    {
        var inputP12 = "111.p12";
        var inputPfxPassword = "123456";
        X509Certificate2 signerCert = new X509Certificate2(inputP12, inputPfxPassword, X509KeyStorageFlags.Exportable);
        RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider();
        var xmlString = signerCert.PrivateKey.ToXmlString(true);
        rsaCSP.FromXmlString(xmlString);
        byte[] signedData = rsaCSP.SignData(signableHash, CryptoConfig.MapNameToOID("SHA1"));
        return signedData;
    }
}

لإنشاء توقيع، يلزم تقدير أولي لطول التوقيع الرقمي المستقبلي. إذا كنت تستخدم SignHash لإنشاء توقيع رقمي، قد تجد أن المفوض يتم استدعاؤه مرتين أثناء عملية حفظ المستند. إذا لم تتمكن من تحمل استدعاءين لسبب ما، على سبيل المثال، إذا حدث طلب رمز PIN أثناء الاستدعاء، يمكنك استخدام خيار AvoidEstimatingSignatureLength لفئات PKCS1 و PKCS7 و PKCS7Detached و ExternalSignature. تعيين هذا الخيار يتجنب خطوة تقدير طول التوقيع عن طريق تعيين قيمة ثابتة كطول متوقع - DefaultSignatureLength. القيمة الافتراضية لخاصية DefaultSignatureLength هي 3000 بايت. يعمل خيار AvoidEstimatingSignatureLength فقط إذا تم تعيين مفوض SignHash في خاصية CustomSignHash. إذا تجاوز طول التوقيع الناتج الطول المتوقع المحدد بواسطة خاصية DefaultSignatureLength، ستتلقى استثناء SignatureLengthMismatchException يشير إلى الطول الفعلي. يمكنك ضبط قيمة معلمة DefaultSignatureLength حسب تقديرك.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SignWithCertificate(string pfxFilePath, string password)
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();

    using (var sign = new Aspose.Pdf.Facades.PdfFileSignature())
    {   
        // Bind PDF document
        sign.BindPdf(dataDir + "input.pdf");
        // Create PKCS#7 object to sign
        var pkcs7 = new Aspose.Pdf.Forms.PKCS7(pfxFilePath, password);// You can use PKCS7Detached with digest algorithm argument
        // Set the delegate to external sign
        pkcs7.CustomSignHash = CustomSignHash;
        // Set an option to avoiding twice SignHash calling.
        pkcs7.AvoidEstimatingSignatureLength = true;
        // Sign the file
        sign.Sign(1, "reason", "cont", "loc", false, new System.Drawing.Rectangle(0, 0, 500, 500), pkcs7);
        // Save PDF document
        sign.Save(dataDir + "SignWithCertificate_out.pdf");
    }

    // Custom hash signing function to generate a digital signature
    byte[] CustomSignHash(byte[] signableHash, Aspose.Pdf.DigestHashAlgorithm digestHashAlgorithm)
    {
        var inputP12 = "111.p12";
        var inputPfxPassword = "123456";
        X509Certificate2 signerCert = new X509Certificate2(inputP12, inputPfxPassword, X509KeyStorageFlags.Exportable);
        RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider();
        var xmlString = signerCert.PrivateKey.ToXmlString(true);
        rsaCSP.FromXmlString(xmlString);
        byte[] signedData = rsaCSP.SignData(signableHash, CryptoConfig.MapNameToOID("SHA1"));
        return signedData;
    }
}

توقيع مستندات PDF باستخدام ECDSA

تتضمن عملية توقيع مستندات PDF باستخدام ECDSA (خوارزمية التوقيع الرقمي باستخدام المنحنيات البيانية) استخدام تشفير المنحنيات البيانية لإنشاء توقيعات رقمية. يوفر هذا أمانًا عاليًا وكفاءة، خاصةً في البيئات المحمولة والمحدودة الموارد. تضمن هذه الطريقة أن مستندات PDF الخاصة بك موقعة رقميًا مع مزايا الأمان لتشفير المنحنيات البيانية.

يدعم Aspose.PDF إنشاء وتحقق التوقيعات الرقمية المعتمدة على ECDSA. تدعم المنحنيات البيانية التالية لإنشاء وتحقق التوقيعات الرقمية:

P-192(secp192r1).
P-256(secp256r1).
P-384(secp384r1).
P-521(secp521r1).
brainpoolP192r1.
brainpoolP256r1.
brainpoolP384r1.
brainpoolP512r1.

الخوارزمية الافتراضية للتجزئة هي SHA2 مع طول يعتمد على حجم مفتاح ECDSA. يمكنك تحديد خوارزمية التجزئة في مُنشئ PKCS7Detached.

يمكن توقيع التوقيعات الرقمية ECDSA مع خوارزميات التجزئة التالية: SHA-256، SHA-384، SHA3–512، SHA3–256، SHA3–384، SHA3–512. يمكن التحقق من التوقيعات الرقمية ECDSA مع خوارزميات التجزئة التالية: SHA-256، SHA-384، SHA3–512، SHA3–256، SHA3–384، SHA3–512.

يمكنك التحقق من التوقيع والتحقق من خلال إنشاء شهادة PFX(output.pfx) في OpenSSL.

openssl ecparam -genkey -name brainpoolP512r1 -out private.key
openssl ec -in private.key -pubout -out public.pem
openssl req -new -x509 -days 365 -key private.key -out certificate.crt -subj "/C=PL/ST=Silesia/L=Katowice/O=My2 Organization/CN=example2.com"
openssl pkcs12 -export -out output.pfx -inkey private.key -in certificate.crt

أسماء المنحنيات المتاحة للتوقيع والتحقق في Aspose.PDF (يمكن الحصول على قائمة المنحنيات في OpenSSL باستخدام الأمر ‘openssl ecparam -list_curves’): prime256v1، secp384r1، secp521r1، brainpoolP256r1، brainpoolP384r1، brainpoolP512r1.

لتوقيع مستند PDF باستخدام ECDSA، ستكون الخطوات العامة في C# كما يلي:

ستحتاج إلى شهادة ECDSA بتنسيق PFX أو P12. تحتوي هذه الشهادات على كل من المفاتيح العامة والخاصة اللازمة للتوقيع.
باستخدام مكتبة Aspose.PDF، تقوم بربط المستند بمعالج التوقيع.
استخدم المفتاح الخاص ECDSA لتوقيع تجزئة محتوى المستند.
ضع التوقيع الناتج داخل ملف PDF مع بيانات التعريف مثل سبب التوقيع، الموقع، وتفاصيل الاتصال.

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void VerifyEcda()
{
   // The path to the documents directory
   var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures();

   // Open PDF document
   using (var document = new Aspose.Pdf.Document(dataDir + "signed_ecdsa.pdf"))
    {
        // Create an instance of PdfFileSignature for working with signatures in the document
        using (var signature = new Aspose.Pdf.Facades.PdfFileSignature(document))
        {
            // Check if the document contains any digital signatures
            if (!signature.ContainsSignature())
            {
                throw new Exception("Not contains signature");
            }

            // Get a list of signature names in the document
            var sigNames = signature.GetSignatureNames();

            // Loop through all signature names to verify each one
            foreach (var sigName in sigNames)
            {
                // Verify that the signature with the given name is valid
                if (!signature.VerifySignature(sigName))
                {
                    throw new Exception("Not verified");
                }
            }
        }
    }
}

private static void SignEcdsa(string pfxFilePath, string password)
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_SecuritySignatures(); 

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "input.pdf"))
    {
        // Create an instance of PdfFileSignature to sign the document
        using (var signature = new Aspose.Pdf.Facades.PdfFileSignature(document))
        {
            // Create a PKCS7Detached object using the provided certificate and password
            var pkcs = new Aspose.Pdf.Forms.PKCS7Detached(cert, "12345", Aspose.Pdf.DigestHashAlgorithm.Sha256);

            // Sign the first page of the document, setting the signature's appearance at the specified location
            signature.Sign(1, true, new System.Drawing.Rectangle(300, 100, 400, 200), pkcs);

            // Save PDF document
            signature.Save(dataDir + "SignEcdsa_out.pdf");
        }
    }
}

استخراج الصورة ومعلومات التوقيع