原生 Linux 簽章選項

原生 callback ABI 把文件簽章約束綁定到實際的 CMS 輸出與產生的外觀

摘要與 Unicode 中繼資料

sign 操作接受 digestMethod 為 SHA256、SHA384 或 SHA512;預設 SHA256,所選值決定實際的 CMS 簽章者摘要

reason、location、contactInfo、signerName 與 legalAttestation 接受不含內嵌 NUL 字元的 Unicode 字串

中繼資料遵循來源文件的字串加密原則,包括已驗證的 AES-256 輸入

legalAttestation 適用於認證簽章,並成為 Catalog 的 Legal.Attestation 值

必填的 seed 值約束實際的摘要、原因、憑證屬性、認證權限、法律聲明、外觀設定檔、撤銷資訊與時間戳記行為

trustedCAPEM、timestampTrustedCAPEM 與 timestampTrustedCRLPEM 接受 JSON 字串中的 PEM 位元組

對應的舊式路徑輸入為 trustedCAFile、timestampTrustedCAFile 與 timestampTrustedCRLFile;每個信任來源請提供位元組或路徑其中一種

PEM 輸入會以 0600 權限存放在專屬私有檔案中供操作使用,之後移除;回應不會暴露這些產生的路徑

簽章者憑證信任只在明確設定時評估;CMS 完整性驗證仍會檢查實際簽章與簽章憑證的綁定

提供 revocationInfo 物件,包含 enabled、certificatesBase64、ocspResponsesBase64、crlsBase64,以及 trustedCAPEM 或 trustedCAFile

enabled 預設 true;停用的資訊不能包含證據陣列

這些陣列存放完整 DER 憑證、成功的 OCSPResponse 物件與 CertificateList 物件的標準 Base64 字串

clockSkewSeconds 預設 300,必須介於 0 與 86400 之間;maxOCSPAgeSeconds 預設 86400,必須為正;requireTimestamp 預設 false

驗證會以明確信任檢查簽章者與內含時間戳記憑證鏈、完整的非根涵蓋、簽發者與序號相符、CRL 與 OCSP 簽章、responder 授權、有效期間與撤銷狀態

格式錯誤、過期、不完整、不受信任或已撤銷的證據會在 PDF 發布前失敗

通過驗證的證據會成為已簽署的 CMS 屬性 1.2.840.113583.1.1.8,結果回報 revocationInfoEvaluated 與 revocationInfoValid

signatures.verify 接受同一個 revocationInfo 物件來驗證實際內嵌的已簽署屬性;呼叫端的 CRL 與 OCSP 回應在驗證期間不能取代該屬性

證據物件與總位元組共用操作限制,密碼學檢查使用操作取消權杖

提供 appearance 物件,包含 caption、選填的 fontFamily 與選填的 profileName

profileName	實際產生的樣式
HotPDF.StandardApproval	置中藍色文字 11 點、矩形框線、白色背景與單行文字
HotPDF.StandardCertification	靠左黑色文字 10 點、矩形框線、白色背景與多行換行
HotPDF.Compact	靠右黑色文字 8 點、無繪製背景或框線,單行文字

預設集決定其樣式與字型大小;未知的設定檔會直接失敗,而不是為任意外觀貼標籤

必填的 AppearanceFilter 會比對目前操作實際產生的設定檔;先前載入的外觀必須重新產生

沒有 profileName 時,fontSize 預設 12;舊式的頂層 caption、fontFamily 與 fontSize 仍受支援

頂層 caption 不可與 appearance 物件同時使用

credentialSourceURL 描述提供身分的應用程式所聲明的憑證來源,timestampServerURL 描述其時間戳記 callback 所聲明的端點來源

這些值會與對應的必填 seed 約束比較;它們不會取得憑證、存取遠端伺服器,也不會獨立驗證 HTTPS 端點身分

身分取得與傳輸驗證由應用程式自行掌控

timestampServerURL 在 hpdf_signing_operation_v1 中需要實際的 callback,回傳的 RFC 3161 回應必須通過簽章印記、nonce、TSA 憑證用途、明確信任與請求的撤銷檢查