ร่องรอยการตรวจสอบ AST

โดยสรุป

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

ความพร้อมใช้งานและการให้สิทธิ์ใช้งาน

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

การติดตั้ง

composer require nextpdf/enterprise:^3

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

AstAuditTrailInterface คือสัญญาการบันทึก record($documentSourceHash, $log) แปลงแต่ละรายการจาก MutationLog ของ Pro AST ให้เป็น AstAuditEntry แล้วต่อท้าย การเรียกซ้ำด้วยแฮชเอกสารเดียวกันจะสะสมรายการ การนำไปใช้เป็นแบบต่อท้ายเท่านั้นตามสัญญา กล่าวคือเมื่อบันทึกแล้วจะไม่สามารถแก้ไขหรือลบรายการได้ findByDocument($hash) คืนค่ารายการของเอกสารหนึ่งตามลำดับการแทรก count() คืนค่ายอดรวมข้ามทุกเอกสาร InMemoryAstAuditTrail คือการนำไปใช้อ้างอิง

AstAuditEntry คือบันทึกที่ไม่เปลี่ยนรูปของการกลายพันธุ์หนึ่งครั้ง ได้แก่ แฮชต้นทางของเอกสาร รหัสโหนดแบบบัญญัติ ชนิดของการกลายพันธุ์ (updated / inserted / deleted) ดัชนีหน้าแบบเริ่มจาก 0 ภาพรวมแอตทริบิวต์ก่อน/หลัง และเวลาแบบ UTC ที่บันทึกรายการ การเรียกค้นมีขอบเขตต่อแฮชเอกสาร ประวัติการตรวจสอบจึงแยกออกจากกันต่อเอกสาร

AstAwareChunker เดินใน AST แบบเชิงลึกก่อนและปล่อยอินสแตนซ์ AstChunk ที่เคารพโครงสร้างเอกสาร กล่าวคือ หัวเรื่องเริ่มชังก์ใหม่ ข้อความปลายสะสมจนถึงขนาดที่กำหนดค่าไว้ และหน้าต่างซ้อนทับรักษาความต่อเนื่องข้ามขอบเขตการแบ่ง แต่ละชังก์พกพารหัสโหนด ดัชนีหน้า กล่องขอบเขต และชนิดของโหนดของโหนดที่มีส่วนร่วมโหนดแรก ระบบปลายทางจึงสามารถอ้างอิงตำแหน่งต้นทางที่แม่นยำได้

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

โมดูลนี้ บันทึกประวัติการกลายพันธุ์และผลิตชังก์ที่มีโครงสร้าง ไม่ได้รับรองความสมบูรณ์หรือให้การยืนยันทางกฎหมาย

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

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

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

• NextPDF Core / Pro AST มอบโมเดล AST และบันทึกการกลายพันธุ์
• NextPDF Enterprise AST (หน้านี้) เพิ่มร่องรอยการตรวจสอบต่อเอกสารแบบต่อท้ายเท่านั้นทับการกลายพันธุ์เหล่านั้นและตัวแบ่งชังก์ที่ยึดกับการอ้างอิงตำแหน่ง โดยใช้บันทึกการกลายพันธุ์ของ Pro ไม่ได้แทนที่โมเดล AST

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

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

พื้นเพเชิงการออกแบบ: การปฏิบัติตามข้อกำหนดที่คุณส่งมอบให้ผู้ตรวจสอบได้

พื้นผิว API

คลาส / อินเทอร์เฟซ	ความรับผิดชอบ
AstAuditTrailInterface	สัญญาการบันทึกแบบต่อท้ายเท่านั้นและการเรียกค้นต่อเอกสาร
AstAuditEntry	บันทึกที่ไม่เปลี่ยนรูปของการกลายพันธุ์หนึ่งครั้งพร้อมภาพรวมก่อน/หลัง
InMemoryAstAuditTrail	การนำไปใช้ร่องรอยแบบต่อท้ายเท่านั้นสำหรับอ้างอิง
AstAwareChunker	ตัวแบ่งชังก์ AST ที่เคารพโครงสร้างและยึดกับการอ้างอิงตำแหน่ง
AstChunk	หนึ่งชังก์พร้อมรหัสโหนด ดัชนีหน้า bbox และชนิดของโหนด

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

$trail->record($documentSourceHash, $mutationLog);
$entries = $trail->findByDocument($documentSourceHash);

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

$trail->record($documentSourceHash, $mutationLog);

foreach ($trail->findByDocument($documentSourceHash) as $entry) {
    $logger->info('ast.audit', [
        'node'     => $entry->nodeId,
        'type'     => $entry->mutationType,
        'page'     => $entry->pageIndex,
        'recorded' => $entry->occurredAt->format(DATE_RFC3339),
    ]);
}
// Persist the trail in a WORM-backed store for tamper-evidence (see Evidence).

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

• การบันทึก MutationLog เดียวกันสองครั้งจะสะสมรายการ ให้กำจัดข้อมูลซ้ำที่ต้นทางหากต้องการความเป็นอุดมคติเชิงดำเนินการซ้ำ
• ร่องรอยแบบในหน่วยความจำไม่ทนทาน การปรับใช้ในการใช้งานจริงต้องจัดหา AstAuditTrailInterface แบบคงสภาพ
• แบบต่อท้ายเท่านั้นเป็นสัญญาของที่เก็บ ไม่ใช่คุณสมบัติเชิงการเข้ารหัสลับ ให้จับคู่กับการแพ็กเกจ Evidence เพื่อให้มีหลักฐานการถูกแก้ไข

ประสิทธิภาพ

การบันทึกเป็นเชิงเส้นตามจำนวนรายการการกลายพันธุ์ การแบ่งชังก์เป็นการเดินใน AST แบบเชิงลึกก่อนเพียงครั้งเดียว ต้นทุนเพิ่มขึ้นตามจำนวนโหนดและขนาดชังก์ที่กำหนดค่าไว้

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

ภาพรวมก่อน/หลังอาจมีข้อความเอกสาร ให้ถือว่าร่องรอยเป็นข้อมูลอ่อนไหวขณะพักอยู่ สัญญาแบบต่อท้ายเท่านั้นป้องกันการแก้ไขในที่ผ่าน API นี้ แต่ความทนทานและหลักฐานการถูกแก้ไขขึ้นอยู่กับที่เก็บเบื้องหลัง

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

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

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

รหัสโหนด ชนิดของการกลายพันธุ์ ดัชนีหน้า และการประทับเวลาปลอดภัยที่จะบันทึกในล็อก ภาพรวมก่อน/หลังอาจมีเนื้อหาเอกสาร ให้ปกปิดก่อนส่งต่อไปยังปลายทางที่ใช้ร่วมกัน

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

พฤติกรรม	การอ้างอิง	สถานะ
บริบทการอัปเดตแบบเพิ่ม / ความสมบูรณ์	ISO 32000-2:2020 §12.8	อ้างอิง (บริบทสำหรับหลักฐานการถูกแก้ไข)

ตารางนี้บันทึกบริบทของข้อกำหนดที่โมดูลนี้ทำงานอยู่ภายใน ร่องรอยการตรวจสอบเป็นตัวช่วยในการเก็บบันทึก ไม่ใช่การรับรองหรือการให้การยืนยันทางกฎหมาย

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

โมดูลนี้ไม่ดำเนินการเชิงการเข้ารหัสลับใด ๆ การแฮช การลงนาม และการประทับเวลาสำหรับหลักฐานการถูกแก้ไขจัดการโดยโมดูล Evidence, Security และ Signature

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

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

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

• ร่องรอยการตรวจสอบเป็นแบบต่อท้ายเท่านั้นตามสัญญาภายในที่เก็บที่กำหนดค่าไว้ เมื่อบันทึกแล้วจะไม่สามารถแก้ไขหรือลบรายการผ่าน API นี้ได้
• แต่ละรายการเป็นบันทึกที่ไม่เปลี่ยนรูปของการกลายพันธุ์หนึ่งครั้ง (แฮชต้นทางของเอกสาร รหัสโหนดแบบบัญญัติ ชนิดของการกลายพันธุ์ ดัชนีหน้า ภาพรวมก่อน/หลัง เวลา UTC ที่บันทึก) การเรียกค้นมีขอบเขตต่อแฮชเอกสาร
• การบันทึกบันทึกการกลายพันธุ์เดียวกันสองครั้งจะสะสมรายการ ให้กำจัดข้อมูลซ้ำที่ต้นทางหากต้องการความเป็นอุดมคติเชิงดำเนินการซ้ำ
• ตัวแบ่งชังก์เดินใน AST แบบเชิงลึกก่อนและปล่อยชังก์ที่เคารพโครงสร้างซึ่งพกพารหัสโหนด ดัชนีหน้า กล่องขอบเขต และชนิดของโหนดเพื่อการอ้างอิงตำแหน่งต้นทางที่แม่นยำ
• การบันทึกการกลายพันธุ์เป็นการบันทึกว่ามันเกิดขึ้น ไม่ได้ตรวจสอบหรืออนุญาตการเปลี่ยนแปลง และการอ้างอิงตำแหน่งของชังก์เป็นตัวช่วยนำทาง ไม่ใช่ข้อกล่าวอ้างเรื่องการเป็นไปตามมาตรฐาน

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

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

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

NextPDF Core / Pro AST มอบโมเดล AST และบันทึกการกลายพันธุ์ ร่องรอยการตรวจสอบต่อเอกสารแบบต่อท้ายเท่านั้นและตัวแบ่งชังก์ที่ยึดกับการอ้างอิงตำแหน่งไม่มีสิ่งเทียบเท่าในระดับชั้น Core พื้นผิว Enterprise ใช้บันทึกการกลายพันธุ์ ไม่ได้แทนที่โมเดล AST

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

NextPDF Pro AST มอบโมเดล AST และบันทึกการกลายพันธุ์ แต่ไม่มีร่องรอยการตรวจสอบต่อเอกสารแบบต่อท้ายเท่านั้นและไม่มีตัวแบ่งชังก์ที่ยึดกับการอ้างอิงตำแหน่ง สิ่งเหล่านั้นมาในแพ็กเกจ nextpdf/enterprise เท่านั้น พื้นผิว Enterprise ใช้บันทึกการกลายพันธุ์ของ Pro

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

สัญญาการบันทึก การเรียกค้นต่อเอกสาร และตัวแบ่งชังก์ได้รับการอธิบายในระดับพฤติกรรม ร่องรอยแบบในหน่วยความจำสำหรับอ้างอิงได้รับการบันทึกไว้ การคงสภาพแบบทนทานจัดหาโดยโฮสต์ และรายละเอียดภายในของที่เก็บใด ๆ อยู่นอกขอบเขตของพื้นผิวสาธารณะ

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

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

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

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

ดูเพิ่มเติม

• Evidence — ผนึกและประทับเวลาร่องรอย
• Validation — การตรวจสอบนโยบายเชิงโครงสร้าง
• Core AST — โมเดล AST
• ร่องรอยการตรวจสอบ AST — Deep Reference — รายละเอียดภายในของที่เก็บแบบทนทานและพื้นผิว API สาธารณะทั้งหมด