ExternalSignature
نظرة عامة
ExternalSignature هي فئة في Aspose.PDF FOSS لـ .NET. ترث من: Signature.
تكوين توقيع PKCS#7 منفصل مبني حول شهادة منصة مُحمَّلة مسبقًا — عادةً من مخزن شهادات نظام التشغيل، أو بطاقة ذكية أو HSM — بدلاً من ملف PFX.
توفر هذه الفئة 11 طريقة للعمل مع كائنات ExternalSignature في برامج .NET. تشمل الطرق المتاحة: ExternalSignature, GetSignatureAlgorithmInfo, Signature, Verify. جميع الأعضاء العامة متاحة لأي تطبيق .NET بعد تثبيت حزمة Aspose.PDF FOSS لـ .NET. الخصائص: Authority, AvoidEstimatingSignatureLength, ByteRange, Certificate, ContactInfo, CustomAppearance, و9 أخرى.
خصائص
| اسم | النوع | الوصول | وصف |
|---|---|---|---|
Certificate | System.Security.Cryptography.X509Certificates.X509Certificate2 | قراءة | الشهادة التي تم إنشاء هذا المثيل بها. |
Authority | string | قراءة/كتابة | يحصل أو يعيّن السلطة. |
ContactInfo | string | قراءة/كتابة | يحصل أو يحدد معلومات الاتصال. |
Location | string | قراءة/كتابة | يحصل أو يضبط الموقع. |
Reason | string | قراءة/كتابة | يسترجع أو يعيّن السبب. |
Date | DateTime | قراءة/كتابة | يحصل أو يضبط التاريخ. |
ByteRange | int[] | قراءة | الإدخال /ByteRange للتوقيع. |
TimestampSettings | Aspose.Pdf.TimestampSettings | قراءة/كتابة | إعدادات RFC 3161 TSA؛ تُحترم من قبل المُوقّع عندما تُضبط. |
OcspSettings | Aspose.Pdf.OcspSettings | قراءة/كتابة | إعدادات OCSP / فحص الإبطال؛ تُحترم من قبل المُوقّع عندما تُضبط. |
CustomAppearance | SignatureCustomAppearance? | قراءة/كتابة | مقابض المظهر البصري التي يُحترمها SignWithAppearance عندما يتم توقيع التوقيع عبر visible-rect overload. |
CustomSignHash | SignHash? | قراءة/كتابة | استدعاء اختياري للموقّع الخارجي. |
UseLtv | bool | قراءة/كتابة | يحصل أو يعيّن قيمة use ltv. |
AvoidEstimatingSignatureLength | bool | قراءة/كتابة | عند التفعيل، يتخطى الموقّع مرحلة تقدير نطاق البايتات ويستخدم DefaultSignatureLength مباشرةً عند حجز مساحة لسلسلة HEX الخاصة بـ PKCS#7 /Contents. |
DefaultSignatureLength | int | قراءة/كتابة | عدد البايتات المحجوزة لسلسلة HEX الخاصة بـ /Contents في PKCS#7. |
ShowProperties | bool | قراءة/كتابة | عند true، يتضمن مظهر التوقيع المرئي السبب/الموقع/ContactInfo للمتوقّع كنص. |
الطرق
| التوقيع | وصف |
|---|---|
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2) | ينادي ExternalSignature(certificate) على هذا الكائن من ExternalSignature. |
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, detached: bool) | detached يختار المعالج، تمامًا كما يفعل زوج PKCS7 / PKCS7Detached: true يُصدر ظرف adbe.pkcs7.detached فوق تجزئة SHA-256، false المعالج adbe.pkcs7.sha1 فوق تجزئة SHA-1. |
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, digestHashAlgorithm: DigestHashAlgorithm) | يستدعي ExternalSignature(certificate, digestHashAlgorithm) على هذا الكائن ExternalSignature. |
ExternalSignature(base64Certificate: string, detached: bool) | يُنشأ من شهادة عامة مُشفَّرة بـ base64 (بدون مفتاح خاص) للتوقيع المؤجل/الخارجي عبر CustomSignHash. |
Signature() | يستدعي Signature على هذا الكائن ExternalSignature. |
Signature(pfx: string, password: string) | يقوم باستدعاء Signature(pfx, password) على هذا المثيل ExternalSignature. |
Signature(pfx: Stream, password: string) | يستدعي Signature(pfx, password) على هذا الكائن ExternalSignature. |
Verify() | تحقق من توقيع PKCS#7 المحمَّل مقابل بايتات PDF الأصلية — يرجع true عندما يتم فك ترميز التوقيع وتأكيد صلاحيته. |
Verify(options: Security.ValidationOptions, validationResult: Security.ValidationResult) | تحقق باستخدام خيارات صريحة + كائن نتيجة DTO. |
Verify(publicKeyCertificate: System.Security.Cryptography.X509Certificates.X509Certificate2, options: Security.ValidationOptions, validationResult: Security.ValidationResult) | تحقق مع تثبيت المفتاح العام. |
GetSignatureAlgorithmInfo() | تحليل ظرف PKCS#7 (عند تحميله من توقيع موجود) للإبلاغ عن ثلاثية خوارزمية التوقيع / خوارزمية التجزئة / المعيار التشفيري. |
