สัญญา

โดยสรุป

NextPDF Enterprise เปิดเผยชุดอินเทอร์เฟซสาธารณะขนาดเล็กที่ส่วนประกอบ Enterprise ผูกเข้าด้วยเพื่อการกลับด้านการพึ่งพาและความสามารถในการทดสอบ อินเทอร์เฟซแรกคือสัญญาไคลเอนต์ TSA สำหรับการร้องขอโทเค็นการประทับเวลา RFC 3161 เหล่านี้คือรอยต่อของการผสานการทำงาน ตัวมันเองไม่ดำเนินการเชิงการเข้ารหัสลับหรือกล่าวอ้างการเป็นไปตามมาตรฐานใด ๆ

ความพร้อมใช้งานและการอนุญาต

ความสามารถนี้มาพร้อมกับ NextPDF Enterprise (nextpdf/enterprise) และเปิดใช้งานด้วยซองสิทธิ์ใช้งานระดับชั้น Enterprise การปรับใช้ที่ไม่มีสิทธิ์นั้นจะไม่โหลดคลาสของความสามารถนี้ เปรียบเทียบรุ่นและขอรับสิทธิ์ใช้งาน

การติดตั้ง

composer require nextpdf/enterprise:^3

ภาพรวมเชิงแนวคิด

TsaClientInterface ประกาศการดำเนินการหนึ่งอย่าง คือ getDocumentTimestamp($documentHash) คืนค่า RFC 3161 TimeStampToken ที่เข้ารหัสแบบ DER สำหรับแฮชเอกสาร ส่วนประกอบ Enterprise รับอินเทอร์เฟซนี้แทนไคลเอนต์รูปธรรม เพื่อให้สามารถฉีดและแทนที่พฤติกรรมการประทับเวลาในการทดสอบได้

TsaClientAdapter คือตัวห่อหุ้มบาง ๆ ที่ปรับไคลเอนต์การประทับเวลาของ Core ให้เข้ากับอินเทอร์เฟซนี้ ไคลเอนต์ของ Core เป็นคลาส final และไม่สามารถนำอินเทอร์เฟซ Enterprise ไปใช้โดยตรงได้ อแดปเตอร์จึงบริดจ์ทั้งสองโดยไม่เปลี่ยนพฤติกรรม ให้ฉีด TsaClientInterface ทุกที่ และเดินสาย TsaClientAdapter (หรือการนำไปใช้ของคุณเอง) ที่ composition root

โมดูลนี้ยืนยันอะไร

โมดูลนี้ กำหนดสัญญาการผสานการทำงาน ไม่ได้ทำงานใด ๆ ด้วยตัวเอง

• TsaClientInterface อธิบายวิธีรับโทเค็นการประทับเวลา ไม่ได้ตรวจสอบความถูกต้องของโทเค็น รับรอง TSA หรือยืนยันว่าโทเค็นให้ผลทางกฎหมาย
• TsaClientAdapter ส่งต่อการเรียกโดยไม่เปลี่ยนแปลง ไม่เพิ่มพฤติกรรมและไม่เพิ่มการรับประกัน

การรับโทเค็นการประทับเวลารองรับเวิร์กโฟลว์การตรวจสอบและการตรวจสอบความถูกต้องระยะยาว ไม่ใช่การให้การยืนยันทางกฎหมายหรือการรับรอง

ขอบเขตของระดับชั้น

Contracts เป็นพื้นผิวการผสานการทำงานเฉพาะ Enterprise ไคลเอนต์ TSA รูปธรรมอยู่ใน Core (NextPDF\Security\Timestamp) โมดูลนี้มอบเพียงอินเทอร์เฟซที่หันหน้าไปทาง Enterprise และอแดปเตอร์ เพื่อให้ส่วนประกอบ Enterprise คงความแยกขาดและทดสอบได้

เหตุใดจึงทำงานเช่นนี้

Core TsaClient เป็นคลาส final จึงไม่สามารถนำอินเทอร์เฟซ Enterprise ไปใช้โดยตรงได้ Enterprise ยังคงต้องการรอยต่อการประทับเวลาที่ฉีดเข้าได้และจำลองได้ เพื่อการกลับด้านการพึ่งพาและส่วนประกอบที่ทดสอบได้ NextPDF แก้ปัญหานี้โดยการเป็นเจ้าของอินเทอร์เฟซที่ระดับชั้น Enterprise และบริดจ์ไคลเอนต์ Core รูปธรรมผ่านอแดปเตอร์บาง ๆ การเดินทางไป-กลับยังคงอยู่ใน Core Enterprise ได้สัญญาที่เสถียรโดยไม่ต้องทำซ้ำไคลเอนต์หรือผ่อนคลายการรับประกัน final การแทนที่ด้วยการนำไปใช้ปลอมในการทดสอบจึงไม่ต้องเปลี่ยนโค้ดของ Core

ภูมิหลังการออกแบบ การประทับเวลาและเวลาที่เชื่อถือได้

พื้นผิว API

คลาส / อินเทอร์เฟซ	ความรับผิดชอบ
TsaClientInterface	สัญญา คือ การร้องขอโทเค็นการประทับเวลา RFC 3161 ที่เข้ารหัสแบบ DER
TsaClientAdapter	ปรับไคลเอนต์การประทับเวลาของ Core ให้เข้ากับ TsaClientInterface

ตัวอย่างโค้ด — เริ่มต้นอย่างรวดเร็ว

use NextPDF\Enterprise\Contracts\TsaClientInterface;

final class MySigner
{
    public function __construct(private TsaClientInterface $tsa) {}
}

ตัวอย่างโค้ด — การใช้งานจริง

use NextPDF\Enterprise\Contracts\TsaClientAdapter;

// Composition root: bridge the Core client into the Enterprise contract.
$tsa = new TsaClientAdapter($coreTsaClient);
$container->set(TsaClientInterface::class, $tsa);
// Components depend on the interface; the adapter is wired once here.

กรณีขอบเขตและข้อควรระวัง

• อแดปเตอร์ส่งต่อข้อยกเว้นจากไคลเอนต์เบื้องล่างโดยไม่เปลี่ยนแปลง ให้จัดการความล้มเหลวของ TSA ที่จุดเรียก
• โทเค็นที่คืนค่ามาเป็นไบต์ ไม่ใช่คำตัดสิน ให้ตรวจสอบความถูกต้องและตรวจสอบยืนยันมันในจุดที่ต้องการ (ดู Evidence / Signature)

ประสิทธิภาพ

อินเทอร์เฟซและอแดปเตอร์ไม่เพิ่มค่าใช้จ่ายที่วัดได้ ต้นทุนเป็นการเดินทางไป-กลับของ TSA เบื้องล่างทั้งหมด

หมายเหตุด้านความปลอดภัย

ให้ถือว่าจุดปลาย TSA เบื้องหลังไคลเอนต์รูปธรรมเป็นขอบเขตความเชื่อถือ สัญญานี้ไม่ตรวจสอบความถูกต้องของโทเค็นหรือสายโซ่ใบรับรองของ TSA การตรวจสอบยืนยันเป็นของพื้นผิวการลงนามและหลักฐาน

ถิ่นที่อยู่ของข้อมูลและการลดความเสี่ยงด้าน PII

มีเพียงแฮชเอกสารที่ข้ามสัญญานี้ — ไม่มีเนื้อหาเอกสาร ข้อพิจารณาด้านถิ่นที่อยู่มีผลกับการนำไคลเอนต์ TSA รูปธรรมไปใช้ ไม่ใช่กับอินเทอร์เฟซนี้

การรายงานข้อมูลที่ปลอดภัยและการขัดล้างบันทึก

แฮชเอกสารปลอดภัยที่จะบันทึกในล็อก อย่าบันทึกไบต์โทเค็นดิบไปยังปลายทางที่ใช้ร่วมกัน ให้ถือว่าเป็นอาร์ทิแฟกต์ที่อ่อนไหวต่อความสมบูรณ์

การเป็นไปตามข้อกำหนด

พฤติกรรม	การอ้างอิง	สถานะ
การร้องขอและการผูกโทเค็นการประทับเวลา	IETF RFC 3161 §2	รูปทรงของสัญญาเท่านั้น (งานทำโดยไคลเอนต์รูปธรรม)

ตารางนี้บันทึกข้อกำหนดที่สัญญาถูกจัดรูปขึ้นรอบ ๆ อินเทอร์เฟซกำหนดรอยต่อ ไม่ได้กล่าวอ้างการเป็นไปตามมาตรฐานหรือการให้การยืนยันใด ๆ

พฤติกรรมในโหมด FIPS

โมดูลนี้ไม่ดำเนินการเชิงการเข้ารหัสลับใด ๆ ไคลเอนต์ TSA รูปธรรมและโมดูล Security กำกับการเลือกอัลกอริทึมและพฤติกรรมในโหมด FIPS

แบบจำลองภัยคุกคาม

พื้นผิวของสัญญาน้อยที่สุด คือ แฮชเข้า ไบต์โทเค็นออก มาตรการลดความเสี่ยง คือ ไม่มีเนื้อหาข้ามขอบเขต และความรับผิดชอบในการตรวจสอบยืนยันถูกมอบหมายอย่างชัดแจ้งไปยังโมดูล Evidence และ Signature

สัญญาพฤติกรรม

• อินเทอร์เฟซไคลเอนต์ TSA ประกาศการดำเนินการหนึ่งอย่าง คือ คืนค่า RFC 3161 TimeStampToken ที่เข้ารหัสแบบ DER สำหรับแฮชเอกสาร ส่วนประกอบ Enterprise พึ่งพาอินเทอร์เฟซ ไม่ใช่ไคลเอนต์รูปธรรม
• อแดปเตอร์คือตัวห่อหุ้มบาง ๆ ที่บริดจ์ไคลเอนต์การประทับเวลาของ Core ให้เข้ากับอินเทอร์เฟซนี้โดยไม่เปลี่ยนพฤติกรรม และส่งต่อข้อยกเว้นจากไคลเอนต์เบื้องล่างโดยไม่เปลี่ยนแปลง
• อินเทอร์เฟซอธิบายวิธีรับโทเค็น ไม่ได้ตรวจสอบความถูกต้องของโทเค็น รับรอง TSA หรือยืนยันผลทางกฎหมาย
• โทเค็นที่คืนค่ามาเป็นไบต์ ไม่ใช่คำตัดสิน — การตรวจสอบความถูกต้องและการตรวจสอบยืนยันเป็นของพื้นผิว Evidence และ Signature

ขอบเขตการเผยแพร่

หน้านี้จัดทำเอกสารเฉพาะพฤติกรรมที่สังเกตได้จากภายนอกและพื้นผิว API สาธารณะที่รองรับเท่านั้น พาธเนมสเปซภายใน คลาสตัวช่วย ตารางกลไก ชื่อไฟล์ runbook และคำนำหน้าหมายเลขทิกเก็ตอยู่นอกขอบเขต

ทางเลือกสำรองของ Core

ไคลเอนต์ TSA รูปธรรมอยู่ใน Core โมดูลนี้มอบเพียงอินเทอร์เฟซที่หันหน้าไปทาง Enterprise และอแดปเตอร์ เพื่อให้ส่วนประกอบ Enterprise คงความแยกขาดและทดสอบได้ รอยต่อที่หันหน้าไปทาง Enterprise เองไม่มีสิ่งเทียบเท่าในระดับชั้น Core — Core เปิดเผยไคลเอนต์รูปธรรม ไม่ใช่อินเทอร์เฟซนี้

ทางเลือกสำรองของ Pro

ทางเลือกสำรองของ Pro — ไม่มี ความสามารถนี้ไม่มีสิ่งเทียบเท่าในระดับชั้น Pro อินเทอร์เฟซไคลเอนต์ TSA ที่หันหน้าไปทาง Enterprise และอแดปเตอร์มาในแพ็กเกจ nextpdf/enterprise เท่านั้น

หมายเหตุขอบเขตของ Enterprise

อินเทอร์เฟซและอแดปเตอร์ได้รับการอธิบายในระดับพฤติกรรม อแดปเตอร์ส่งต่อการเรียกโดยไม่เปลี่ยนแปลงและไม่เพิ่มพฤติกรรม ไคลเอนต์ TSA รูปธรรมและรายละเอียดภายในของมันเป็นเรื่องของ Core และอยู่นอกขอบเขตของพื้นผิวการผสานการทำงาน Enterprise นี้

ขอบเขตการปรับใช้

มีเพียงแฮชเอกสารที่ข้ามสัญญานี้ — ไม่มีเนื้อหาเอกสาร ผู้ปฏิบัติงานเดินสายอแดปเตอร์หรือการนำไปใช้แบบกำหนดเองที่ composition root และเป็นเจ้าของไคลเอนต์ TSA รูปธรรมเบื้องหลังมัน ถิ่นที่อยู่ ขอบเขตความเชื่อถือของจุดปลาย TSA และการตรวจสอบยืนยันสายโซ่ใบรับรองมีผลกับไคลเอนต์รูปธรรมนั้น ไม่ใช่กับอินเทอร์เฟซนี้

ขอบเขตการปฏิบัติตามข้อกำหนดทางกฎหมาย

ไม่มีข้อจำกัดด้านการควบคุมการส่งออกที่มีผลกับพื้นผิวของสัญญานี้ การรับโทเค็นการประทับเวลารองรับเวิร์กโฟลว์การตรวจสอบและการตรวจสอบความถูกต้องระยะยาว ไม่ใช่การให้การยืนยันทางกฎหมายหรือการรับรอง เอกสารนี้ไม่ใช่ความเห็นทางกฎหมาย ให้ปรึกษาที่ปรึกษาด้านการปฏิบัติตามข้อกำหนดและกฎหมายของคุณเอง

ดูเพิ่มเติม

• Contracts — Deep Reference — พื้นผิวคลาสและเมทอดฉบับเต็ม
• Evidence — ฝังโทเค็น RFC 3161 ในแพ็กเกจ
• Validation — การตรวจสอบเชิงโครงสร้างของ LTV
• Specifications: PAdES — บริบทการประทับเวลา