ExternalSignature
نمای کلی
ExternalSignature یک کلاس در Aspose.PDF FOSS برای .NET است. ارث‌برده از: Signature.
یک پیکربندی امضای PKCS#7 جدا شده که دور یک گواهی‌نامه پلتفرم از پیش بارگذاری شده ساخته شده است — به طور معمول از مخزن گواهی‌نامه‌های OS، یک کارت هوشمند یا HSM — به جای یک فایل PFX.
این کلاس ۱۱ متد برای کار با اشیاء ExternalSignature در برنامه‌های .NET فراهم می‌کند. متدهای موجود شامل: ExternalSignature, GetSignatureAlgorithmInfo, Signature, Verify هستند. تمام اعضای عمومی پس از نصب بسته Aspose.PDF FOSS برای .NET برای هر برنامهٔ .NET قابل دسترسی هستند. ویژگی‌ها: Authority, AvoidEstimatingSignatureLength, ByteRange, Certificate, ContactInfo, CustomAppearance، و ۹ مورد دیگر.
خواص
| نام | نوع | دسترسی | توضیح |
|---|---|---|---|
Certificate | System.Security.Cryptography.X509Certificates.X509Certificate2 | خواندن | گواهی‌نامه‌ای که این نمونه با آن ساخته شده است. |
Authority | string | خواندن/نوشتن | مجوز را می‌گیرد یا تنظیم می‌کند. |
ContactInfo | string | خواندن/نوشتن | دریافت یا تنظیم اطلاعات تماس. |
Location | string | خواندن/نوشتن | موقعیت را دریافت یا تنظیم می‌کند. |
Reason | string | خواندن/نوشتن | دریافت یا تنظیم دلیل. |
Date | DateTime | خواندن/نوشتن | تاریخ را دریافت یا تنظیم می‌کند. |
ByteRange | int[] | خواندن | ورودی /ByteRange امضا. |
TimestampSettings | Aspose.Pdf.TimestampSettings | خواندن/نوشتن | تنظیمات TSA RFC 3161؛ در صورت تنظیم، توسط امضاکننده رعایت می‌شود. |
OcspSettings | Aspose.Pdf.OcspSettings | خواندن/نوشتن | تنظیمات OCSP / بررسی لغو؛ توسط امضاکننده هنگام تنظیم شدن رعایت می‌شود. |
CustomAppearance | SignatureCustomAppearance? | خواندن/نوشتن | دستگیره‌های ظاهر بصری که توسط SignWithAppearance هنگام امضا شدن از طریق بارگذاری مستطیل قابل مشاهده رعایت می‌شوند. |
CustomSignHash | SignHash? | خواندن/نوشتن | بازگشت‌صدا (callback) امضاکننده خارجی اختیاری. |
UseLtv | bool | خواندن/نوشتن | دریافت یا تنظیم مقدار use ltv. |
AvoidEstimatingSignatureLength | bool | خواندن/نوشتن | وقتی مقدار true باشد، امضاکننده مرحله تخمین بازه بایت را نادیده می‌گیرد و مستقیماً از DefaultSignatureLength هنگام رزرو کردن فضا برای رشته هگز PKCS#7 /Contents استفاده می‌کند. |
DefaultSignatureLength | int | خواندن/نوشتن | تعداد بایت‌های رزرو شده برای رشتهٔ هگزادسیمال /Contents در PKCS#7. |
ShowProperties | bool | خواندن/نوشتن | اگر true باشد، ظاهر قابل مشاهدهٔ امضا شامل Reason/Location/ContactInfo امضاکننده به‌عنوان متن می‌شود. |
روش ها
| امضا | توضیح |
|---|---|
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2) | در این نمونه ExternalSignature، ExternalSignature(certificate) را فراخوانی می‌کند. |
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, detached: bool) | detached انتخاب‌کنندهٔ پردازشگر است، دقیقاً همان‌طور که جفت PKCS7 / PKCS7Detached عمل می‌کند: true یک پاکت adbe.pkcs7.detached بر روی یک SHA-256 digest تولید می‌کند، false پردازشگر adbe.pkcs7.sha1 را بر روی یک SHA-1 digest اعمال می‌کند. |
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, digestHashAlgorithm: DigestHashAlgorithm) | در این نمونه ExternalSignature، ExternalSignature(certificate, digestHashAlgorithm) را فراخوانی می‌کند. |
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 (هنگامی که از یک امضای موجود بارگذاری می‌شود) برای گزارش الگوریتم امضا / الگوریتم خلاصه‌سازی / استاندارد رمزنگاری سه‌تایی. |
