ExternalSignature

סקירה כללית

ExternalSignature היא מחלקה ב-Aspose.PDF FOSS עבור .NET. יורשת מ: Signature.

תצורת חתימה מנותקת מסוג PKCS#7 שנבנית סביב תעודת פלטפורמה שכבר נטענה — בדרך כלל ממאגר תעודות ה-OS, מכרטיס חכם או 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`	קריאה/כתיבה	הגדרות TSA לפי RFC 3161; מתקבלות על ידי החותם כאשר מוגדרות.
`OcspSettings`	`Aspose.Pdf.OcspSettings`	קריאה/כתיבה	הגדרות בדיקת OCSP / שלילה; מתקבלות על ידי החותם כאשר מוגדרות.
`CustomAppearance`	`SignatureCustomAppearance?`	קריאה/כתיבה	הגדרות המראה החזותי מכובדות על ידי SignWithAppearance כאשר החתימה נחתמת דרך עומס של visible-rect.
`CustomSignHash`	`SignHash?`	קריאה/כתיבה	Callback חיצוני של חותם – אופציונלי.
`UseLtv`	`bool`	קריאה/כתיבה	מקבל או מגדיר את השימוש ב-ltv.
`AvoidEstimatingSignatureLength`	`bool`	קריאה/כתיבה	כאשר אמת, החותם מדלג על שלב האומדן של טווח הבייטים ומשתמש ב DefaultSignatureLength ישירות בעת שמירת מקום למחרוזת הקס של PKCS#7 /Contents.
`DefaultSignatureLength`	`int`	קריאה/כתיבה	מספר הבייטים המיועדים למחרוזת ההקס של PKCS#7 /Contents.
`ShowProperties`	`bool`	קריאה/כתיבה	כאשר אמת, המראה הנראית של החתימה כוללת את Reason/Location/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 (כאשר נטענת מחתימה קיימת) כדי לדווח על שלושת ה-signing-algorithm / digest-algorithm / cryptographic-standard.