Signature — Derinlemesine başvuru

Bir bakışta

Bu, NextPDF Enterprise uzun vadeli üreticisinin derin referansıdır: bir B-LT veya B-LTA imzasının nasıl birleştirildiği, iptal materyalinin nasıl toplanıp zorlandığı, belge zaman damgasının belgeyi nasıl sabitlediği ve Pro sınırının nasıl zorlandığı. Davranış düzeyinde ve sözleşme düzeyindedir. Somut Enterprise uygulama türleri burada bilinçli olarak adlandırılmaz; sayfa yalnızca genel pakete ve Core sözleşme yüzeyine referans verir.

Kullanılabilirlik ve lisanslama

Bu yetenek NextPDF Enterprise (nextpdf/enterprise) ile sevk edilir ve bir Enterprise-katman lisans zarfıyla etkinleşir. Bu yetkiye sahip olmayan bir dağıtım, yeteneğin sınıflarını yüklemez. Sürümleri karşılaştırın ve lisans edinin.

Kanonik düzey→katman matrisi: B-B, Core, Pro ve Enterprise tarafından üretilen temel düzeydir; B-T (zaman damgalı) Core, Pro ve Enterprise tarafından üretilir — Core, RFC 3161 zaman damgası yolunu sevk eder; bu nedenle B-T bir premium paket gerektirmez; B-LT ve B-LTA (DSS, VRI, belge zaman damgası) yalnızca Enterprise tarafından üretilir. Yalnızca Pro’lu bir dağıtımda B-LT veya B-LTA istemek fail-closed olur: Enterprise uzun vadeli üreticisi yokken Core SignatureLevel::isAvailableInEnvironment false döndürür ve Core düzenleyicisi, düzeyi sessizce düşürmek yerine adlandırılmış bir hata yükseltir.

PAdES düzeyi	Eklenenler	Üretici sürümü
B-B	İmzalı özniteliklere sahip CMS imzası	Core, Pro, Enterprise
B-T	İmza değeri üzerine güvenilir RFC 3161 zaman damgası	Core, Pro, Enterprise
B-LT	Doğrulama materyaliyle Document Security Store	yalnızca Enterprise
B-LTA	DSS üzerine belge zaman damgası (arşiv döngüsü)	yalnızca Enterprise

Kavramsal model

Bir B-LT imzası, bir B-T imzası artı bir Document Security Store’dur. DSS; imzalama sertifikasının süresi dolduktan sonra bir doğrulayıcının ihtiyaç duyduğu sertifika, OCSP-yanıtı ve CRL akışlarını tutan Catalog düzeyinde bir sözlüktür — ISO 32000-2 §12.8.4.3. Uzun vadeli doğrulama iki sözlük türü kullanır — bir DSS ve bir belge zaman damgası sözlüğü — ISO 32000-2 §12.8. CMS imzasının kendisi /Contents içinde DER ile kodlanmış olarak saklanır — ISO 32000-2 §12.8.1.

Bir B-LTA imzası, DSS dahil tüm belge durumu üzerine, belge zaman damgası sözlüğü aracılığıyla yazılan bir belge zaman damgası ekler — ISO 32000-2 §12.8.5. ETSI EN 319 142-2 aynı uzun vadeli bileşimi — §5.5 — ve işleyici desteğini — §6.3.3.3 — açıklar.

Üretici iş akışı

1. Zinciri oluşturun. İmzalayıcı sertifikası artı çağıranın sağladığı herhangi bir ara sertifika, imzalayıcı önce gelmek üzere, güven çıpasına doğru zinciri oluşturur — RFC 5280 §6.1.
2. İptal materyalini toplayın. Kök olmayan her sertifika için üretici önce OCSP’ye sorar. Bir OCSP yanıtı good, revoked veya unknown bildirir — RFC 6960 §2.2 — ve thisUpdate/nextUpdate ile zaman sınırlıdır — RFC 6960 §4.2. OCSP kullanılamıyorsa delta-CRL desteğiyle bir CRL’ye geri döner; bir temel CRL ve isteğe bağlı bir delta, ayrı DSS girişleri olarak eklenir.
3. DSS’yi yazın. Sertifikalar, OCSP yanıtları ve CRL’ler, ayrı PDF akış nesneleri olarak yazılır; yinelenenler içerik karmasına göre kaldırılır. DSS sözlüğü, bunlara /Certs, /OCSPs, /CRLs aracılığıyla referans verir.
4. İmza başına VRI (isteğe bağlı katılım). İmzanın /Contents değerinin büyük harfli karmasıyla anahtarlanan bir VRI girişi, o imza için belirli sertifikaları/OCSP/CRL’leri, isteğe bağlı bir doğrulama-zamanı girişiyle dizinler. VRI varsayılan olarak kapalıdır: ETSI EN 319 142-1 V1.2.1 §5.4, yeni belgelerde DSS içinde VRI kullanmamayı önerir; bazı doğrulayıcılar uzun vadeli durumu yine de onunla daha iyi gösterir; bu nedenle çağıranca etkinleştirilebilir.
5. Belge zaman damgası (B-LTA). DSS yazıldıktan sonra, ByteRange ve /Contents yer tutucularıyla /SubFilter /ETSI.RFC3161 içeren bir /DocTimeStamp sözlüğü eklenir. Tam dosya birleştirildikten sonra üretici, ByteRange üzerinde SHA-256 özetini hesaplar, bir RFC 3161 belirteci ister — §2.4.1 — ve DER belirtecini gömer; genTime, UTC belirteç-oluşturma anıdır — §2.4.2.

İptal zorlaması

Üretici, şu önceliğe göre bir zorlama modu çözümler: açık, yapılandırılmış bir zorlama modu kazanır; aksi durumda açık (kullanımdan kaldırılmış) bir boole, katı veya izin veren moda eşlenir; aksi durumda varsayılan katı (fail-closed) olur.

Katı zorlama altında, kök olmayan herhangi bir sertifika için eksik bir OCSP yanıtı ve eksik bir CRL, yalnızca bir uyarı yaymak yerine bir hata yükseltir. Fail-closed varsayılanı, “B-LT” bir PDF’nin uzun vadeli düzeyi yine de ilan ederken DSS içinde hiçbir iptal materyali olmadan üretilememesi için vardır. İzin veren (yalnızca uyarı) iş akışına açıkça katılınmalıdır. Katı çevrimdışı bir ağ politikası altında hiçbir OCSP/CRL getirme işlemi olmaz; yalnızca DSS’ye gömülü materyal kullanılır ve eksik-materyal koşulu aynı zorlama kuralıyla ele alınır.

Arşiv döngüsü

B-LTA belge zaman damgası, kendisi süresi dolan bir TSA sertifikası tarafından sabitlenir. O süre dolmadan önce çalıştırılan arşiv döngüsü, TSA sertifika zinciri için taze iptal materyali toplar, DSS’yi yeniden yazar, isteğe bağlı olarak TSA sertifika karmasıyla anahtarlanan bir VRI girişi ekler ve güncellenen durum üzerine yeni bir belge zaman damgası ekler. Her yeni zaman damgası, öncekileri kapsar. Döngüyü zamanında çalıştırmak operasyonel bir yükümlülüktür; üretici, döngü yapılandırılmış bir TSA olmadan ya da katı çevrimdışı politika altında istenirse bir hata yükseltir. Tam arşiv yüzeyi Arşiv derin referansında belgelenmiştir.

API yüzeyi (yalnızca genel sözleşme)

Tür	Çeşit	Rol	Kararlılık	Beri
SignerInterface	arayüz (NextPDF\Contracts)	Core imzalama sözleşmesi	kararlı	1.0.0
LtvManagerInterface	arayüz (NextPDF\Contracts)	Çalışma zamanında çözümlenen uzun vadeli üretici + arşiv-döngüsü sözleşmesi	kararlı	1.0.0
TsaClientInterface	arayüz	Üreticinin çağırdığı RFC 3161 TSA istemcisi	kararlı	1.0.0
SignatureLevel	enum (NextPDF\Security\Signature)	B-B, B-T, B-LT, B-LTA seçici ve kullanılabilirlik yoklaması	kararlı	1.0.0

SignatureLevel::requiresDss → B-LT, B-LTA için true. requiresDocumentTimestamp → yalnızca B-LTA için true. requiresTimestamp → B-T, B-LT, B-LTA için true. Üretim kodu bu sözleşmelere bağımlıdır; somut Enterprise uygulama sınıfları dahilîdir ve genel API’nin parçası değildir.

Uygunluk

İddia	Standart	Madde
İmza/zaman damgası /Contents içinde DER ile kodlanmış olarak saklanır.	ISO 32000-2	§12.8.1
LTV bir DSS ve bir belge zaman damgası sözlüğü kullanır.	ISO 32000-2	§12.8
DSS, belge kataloğundaki DSS anahtarının değeri olan sözlüktür; Certs, OCSPs, CRLs tutar.	ISO 32000-2	§12.8.4.3
Belge zaman damgası sözlüğü yapısı.	ISO 32000-2	§12.8.5
Uzun vadeli imzalar için DSS + belge zaman damgaları.	ETSI EN 319 142-2	§5.5
İşleyici DSS + belge zaman damgalarını destekler.	ETSI EN 319 142-2	§6.3.3.3
RFC 3161 isteği TSTInfo döndürür; genTime, UTC oluşturma anıdır.	RFC 3161	§2.4.1, §2.4.2
OCSP good/revoked/unknown, thisUpdate/nextUpdate ile sınırlıdır.	RFC 6960	§2.2, §4.2
Bir güven çıpasına yol doğrulama girdileri.	RFC 5280	§6.1

Tüm maddeler başka sözcüklerle ifade edilmiştir. NextPDF normatif metni yeniden üretmez. NextPDF hiçbir PAdES sertifikasyon iddiasında bulunmaz: üretici, ETSI EN 319 142 içinde tanımlanan B-LT ve B-LTA düzeyleriyle hizalı yapılar yazar; hiçbir uygunluk-test sonucu veya üçüncü taraf doğrulaması iddia edilmez. ETSI EN 319 142-1 temel-düzeyler bölümü, alıntılanan kanıt kümesinin dışındadır; bu nedenle alıntılanan ETSI çıpası EN 319 142-2’dir ve ISO/RFC çıpaları, Core imzalama referansıyla aynı açıklama duruşunda olmak üzere uzun vadeli ve zaman damgası iddialarını taşır. Üretilen bir imzanın doğrulanıp doğrulanmadığı; doğrulayıcının güven çıpalarına ve iptal-tazeliği politikasına göre verdiği bir karardır; üretici materyali gömer ve güvenilir bir sonuç ileri sürmez.

Uç durumlar ve FIPS modu davranışı

Uç durumlar

• DSS, belge zaman damgasından önce yazılmalıdır; DSS’den önce yazılan bir zaman damgası, doğrulama materyalini kapsamaz.
• Katı zorlama (varsayılan), kök olmayan bir sertifika için iptal materyali eksik olduğunda bir hata yükseltir. İzin veren mod isteğe bağlı katılımdır.
• Hiçbir TSA yapılandırılmamış B-LTA, B-LT üretmek yerine bir hata yükseltir.
• Katı çevrimdışı politika: hiçbir OCSP/CRL/TSA ağ erişimi yok; B-LTA katı çevrimdışı durumda erişilebilir değildir.
• Belge-zaman-damgası belirtecinin sınırlı bir ayrılmış alanı vardır; bunu aşan bir belirteç, kesmek yerine bir hata yükseltir.

FIPS modu davranışı

FIPS 140-3 kripto-politika profili, güvenlik modülüyle birlikte belgelenen bir Enterprise yeteneğidir. Uzun vadeli üretici, yalnızca belge zaman damgası ve RFC 3161 alışverişi için kullanılan SHA-256 özetini ekler; imzalama ilkeli Core imzalayıcısına aittir. FIPS profili altında aynı DSS, VRI ve belge-zaman-damgası yapıları üretilir; kısıtlama, DSS yerleşimine değil, imzalama ve özet algoritmalarına uygulanır. PKCS#11 aracılığıyla donanım anahtar muhafazası, güvenlik modülüyle belgelenmiştir ve bu sayfanın kapsamı dışındadır.

Davranış sözleşmesi

• Core, B-B ve B-T üretir (B-T, imza değeri üzerine RFC 3161 zaman damgasını ekler). Pro, aynı Core yığını aracılığıyla B-B ve B-T üretir. B-LT ve B-LTA yalnızca Enterprise tarafından üretilir.
• Üretici, DSS’yi (B-LT) ve DSS üzerine bir belge zaman damgasını (B-LTA) yazar. Doğrulama materyalini gömer; güvenilir bir doğrulama sonucu ileri sürmez.
• Fail-closed iptal-zorlama varsayılanı, çağıran izin veren iş akışına katılmadıkça kök olmayan bir sertifika için iptal materyali eksik olduğunda bir hata yükseltir.
• B-LTA yapılandırılmış bir TSA gerektirir; hiçbiri yoksa B-LTA adımı, B-LT düzeyine düşmek yerine bir hata yükseltir.

Core yedeği

Yalnızca Core’lu bir dağıtımda yazılım imzalayıcısı, SignerInterface aracılığıyla PAdES B-B ve B-T üretir; Core, RFC 3161 zaman damgası yolunu sevk eder, böylece B-T bir premium paket gerektirmez. Core’un hiçbir DSS, VRI veya belge-zaman-damgası üreticisi yoktur; bir B-LT veya B-LTA isteği, SignatureLevel::isAvailableInEnvironment’ın false döndürmesiyle fail-closed olur.

Pro yedeği

Yalnızca Pro’lu bir dağıtımda imzalama yolu, B-B/B-T temeli artı uzak ve bulut-KMS imzalama iş akışlarıdır. Pro hiçbir DSS veya belge zaman damgası üretmez. RemoteSigningConfig, Core SignatureLevel enum’unu taşır, ancak uzun vadeli bir düzey (B-LT/B-LTA), Pro’nun üzerinde işlem yapmadığı ileri-bildirimli bir değerdir; uzun vadeli üretici, çalışma zamanında Core sözleşmesi aracılığıyla çözümlenir ve nextpdf/enterprise içinde sevk edilir.

Enterprise sınır notu

Dahilî mekanizma ayrıntısı, kaynak deposunun dahilî belgelendirmesinde kalır ve bu kılavuzun kapsamı dışındadır.

Dağıtım sınırı

NextPDF Enterprise doğrulama materyalini gömer; çağıranın sağladığı OCSP/CRL yanıtlayıcıları ve bir RFC 3161 TSA ile bütünleşir. Bu yanıtlayıcıları veya TSA’yı işletmez, barındırmaz ya da kullanılabilirliğini garanti etmez. Uzun vadeli geçerlilik; yanıtlayıcılara, TSA’ya, arşiv-döngüsü zamanlamasına ve operatöre bağlıdır — yalnızca NextPDF Enterprise’a değil. Operatör; TSA seçiminden ve erişilebilirliğinden, iptal-yanıtlayıcı erişiminden veya önceden toplanmış materyalden, ağ politikasından ve her zaman damgası sertifikasının süresi dolmadan önce arşiv döngüsünü çalıştırmaktan sorumludur.

Yayımlama sınırı

Bu sayfa yalnızca dışarıdan gözlemlenebilir davranışı ve desteklenen genel API yüzeyini belgeler. Dahilî ad alanı yolları, yardımcı sınıflar, mekanizma tabloları, runbook dosya adları ve bilet önekleri kapsam dışıdır.

Hukuki uygunluk sınırı

ETSI EN 319 142 içinde tanımlanan B-LT ve B-LTA yapılarıyla hizalanma, bir hukuki görüş ve bir sertifikasyon değil, yapısal bir beyandır. NextPDF hiçbir PAdES sertifikasyon iddiasında bulunmaz. Üretilen bir imzanın doğrulanıp doğrulanmadığı; doğrulayıcının güven çıpalarına ve iptal-tazeliği politikasına göre verdiği bir karardır.

Ayrıca bakınız

• Signature (yetenek genel bakışı)
• Arşiv derin referansı — DSS/VRI bakımı, LTV sağlığı, arşiv döngüsü.
• Güvenlik / İmzalama (Core) — CMS, RFC 3161, RFC 5280, OCSP/CRL.
• Pro güvenliği — B-B temeli ve Enterprise sınırı.
• PAdES temel eşlemesi