ปลั๊กอิน Signer

ลงนามไฟล์ PDF และ Word ด้วยลายเซ็นที่มองเห็นได้และตราดิจิทัล

ปลั๊กอิน Signer จะวางลายเซ็นที่มองเห็นได้บนเอกสารและโดยค่าเริ่มต้นจะปิดผนึกด้วยลายเซ็นดิจิทัลที่โปรแกรมอ่าน PDF สามารถตรวจสอบได้ มันลงนามไฟล์ PDF และ Word (.docx) ลายเซ็นที่มองเห็นได้จะเป็นภาพ PNG เสมอ: วาด, พิมพ์, หรืออัปโหลดโดยผู้ลงนาม.

วิธีการใช้เมื่อ
DocumentSigner (C#)คุณลงนามบนเซิร์ฟเวอร์โดยไม่มีเบราว์เซอร์เข้ามาเกี่ยวข้อง
Drop-in widget (doconutSigner.js)คุณต้องการหน้าจออัปโหลด, ลงนามและดาวน์โหลดที่เตรียมไว้แล้วในหน้าของคุณ
HTTP endpoints (?sign=open|run|download)คุณสร้าง UI การลงนามของคุณเองตามสัญญาเซิร์ฟเวอร์ที่มีเอกสารอธิบาย

ลายเซ็นแต่ละอันจะถูกวางเพียงครั้งเดียวบนหน้าเดียว ชื่อผู้ลงนาม เหตุผล และตำแหน่งสามารถเดินทางไปพร้อมกับมันได้.

ติดตั้งแพคเกจ

ติดตั้งปลั๊กอิน Signer รุ่นเสถียรล่าสุด:

bash
dotnet add package Doconut.NETStandard.Signer

เพื่อระบุเวอร์ชันของปลั๊กอินให้ตรงกับรุ่นที่เอกสารนี้อธิบาย ให้ส่งเวอร์ชันแยกต่างหาก:

bash
dotnet add package Doconut.NETStandard.Signer --version 26.10.0

รักษาแพคเกจ Signer ให้เป็นเวอร์ชันเดียวกับ Doconut.NETStandard. ID ของแพคเกจคือ Doconut.NETStandard.Signer; .<version> จะปรากฏเฉพาะในชื่อไฟล์ .nupkg ที่ดาวน์โหลด.

ไฟล์ใบอนุญาตของปลั๊กอิน, Doconut.Viewer.Signer.lic, จะอยู่ในโฟลเดอร์เดียวกับ Doconut.Viewer.lic; มันจะถูกอ่านพร้อมกับใบอนุญาตของ viewer.

ลงทะเบียนปลั๊กอิน

เช่นเดียวกับปลั๊กอิน Doconut ทุกตัว, Signer จะลงทะเบียนกับ AddPlugin<TPlugin>() ภายใน AddDoconut():

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
    options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
});

นั่นคือทั้งหมดที่ชั้น C# ต้องการ วิดเจ็ตและ HTTP endpoint ของมันเป็นการเลือกใช้แยกต่างหาก, AddSignerWidget() (ดู วิดเจ็ตแบบฝัง).

ปลั๊กอินต้องการใบอนุญาตที่ให้ความสามารถ Signer. หากไม่มี, AddDoconut() จะโยนข้อผิดพลาดเมื่อเริ่มต้น, ก่อนที่แอปจะให้บริการคำขอ:

text
The Signer plugin is registered via AddPlugin but no active license grants Signer. Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Signer.

มันจะโยนข้อผิดพลาดเมื่อไม่มีใบอนุญาต, ไฟล์ legacy TRIAL, ใบอนุญาตที่ไม่มี Signer, และใบอนุญาตแบบชำระเงินที่ใช้เกินช่วงเวอร์ชัน ใบอนุญาต Demo/NFR ชั่วคราวจะได้รับการยอมรับ ดู การตั้งค่าใบอนุญาต เพื่อดูวิธีโหลดใบอนุญาต.

การให้ใบอนุญาตและลายน้ำ

สถานะใบอนุญาตการเริ่มต้นลายเซ็นที่รับรองลายเซ็นภาพ
ใบอนุญาตแบบชำระเงินที่ให้สิทธิ Signer, มีการกำหนดค่าใบรับรองเริ่มปิดผนึกด้วยใบรับรองของคุณ, สะอาด (watermarked: false)สะอาด
ใบอนุญาตแบบชำระเงินที่ให้สิทธิ Signer, ไม่มีใบรับรองเริ่มปฏิเสธ: No signing certificate configured.สะอาด
ใบอนุญาตแบบชำระเงิน, ใบรับรองหมดอายุหรือยังไม่ใช้งานเริ่ม (พร้อมวิดเจ็ตเปิดใช้งาน, มีการบันทึกคำเตือน)ปฏิเสธ: The signing certificate expired on yyyy-MM-dd.สะอาด
ใบอนุญาต Demo/NFR ชั่วคราว, ใช้งานหรือหมดอายุเริ่มปิดผนึกด้วยใบรับรอง demo ที่สร้างมาในตัว, มีลายน้ำ (watermarked: true)มีลายน้ำ
ไม่มีใบอนุญาต, ไฟล์ legacy TRIAL, ใบอนุญาตที่ไม่มี Signer, หรือใบอนุญาตแบบชำระเงินที่อยู่นอกช่วงเวอร์ชันAddDoconut() จะโยนข้อผิดพลาด——

กฎนี้เหมือนกันสำหรับชั้น C# และวิดเจ็ต: ผลลัพธ์จะมีลายน้ำเมื่อใบอนุญาตไม่ใช่ใบอนุญาต viewer แบบชำระเงินหรือเป็นแบบชั่วคราว ภายใต้ใบอนุญาตชั่วคราวปลั๊กอินจะลงนามด้วยใบรับรอง demo ที่สร้างมาในตัวเสมอ และใบรับรองใด ๆ ที่คุณกำหนดจะไม่ถูกใช้.

ใบรับรอง demo สร้างตราที่แท้จริง, แต่โปรแกรมอ่าน PDF ไม่เชื่อถือมัน การบูรณาการสามารถสร้างและทดสอบแบบครบวงจรด้วยใบอนุญาตประเมินผล; เพื่อให้ได้ผลลัพธ์ที่สะอาดและเชื่อถือได้ คุณต้องมีทั้งใบอนุญาตแบบชำระเงินและ ใบรับรองการลงนาม ของคุณเอง.

การใช้จาก C#

DocumentSigner ถูกลงทะเบียนโดย AddDoconut() และดึงจากการฉีดพึ่งพา. ตัวสร้างของมันเป็น internal, ดังนั้นห้าม new มัน. การดึงโดยไม่มี AddPlugin<SignerPlugin>() จะทำให้เกิด No IDocumentSigner is registered. Add the signing plugin: options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>().

csharp
using Doconut;
using Doconut.Core.Models.Signing;

public sealed class ContractSigning
{
    private readonly DocumentSigner _signer;

    public ContractSigning(DocumentSigner signer) => _signer = signer;

    public async Task<byte[]> SignAsync(Stream pdf, byte[] signaturePng, SigningCertificate certificate, CancellationToken ct)
    {
        var request = new SignRequest(
            new VisibleSignature(SignatureKind.Drawn, signaturePng),
            new SignaturePlacement(Page: 1, X: 0.58, Y: 0.80, W: 0.32, H: 0.12),
            SignerName: "Ada Lovelace",
            Reason: "I approve this document",
            Location: "London, UK");
        // Mode defaults to Certified (ลายเซ็นที่มองเห็นได้ + ซีลดิจิทัล); WordOutput defaults to Pdf.

        SignResult result = await _signer.SignAsync(pdf, ".pdf", request, certificate, ct);
        using (result.Stream)
        using (var output = new MemoryStream())
        {
            await result.Stream.CopyToAsync(output, ct);
            return output.ToArray();
        }
    }
}

SignAsync รับสตรีมต้นทาง, ส่วนขยายของมัน (".pdf" หรือ ".docx"), คำขอ, และใบรับรอง สำหรับการเรียกนี้. ตัว façade ไม่ได้อ่าน SignerWidgetOptions.SigningCertificate; การตั้งค่านั้นเป็นสำหรับวิดเจ็ต. ส่ง null ภายใต้ใบอนุญาตทดลอง, หรือในโหมด Visual.

SignResult เก็บเอกสารที่ลงนามเป็นสตรีมที่สามารถเลื่อนได้, พร้อมกับ Extension ของมัน (".pdf" หรือ ".docx") เพื่อให้คุณสามารถตั้งชื่อไฟล์ได้. คุณเป็นเจ้าของสตรีม: dispose มันเมื่อคุณทำเสร็จ.

ลายเซ็น Visual จะทำการประทับภาพเท่านั้นและไม่ต้องการใบรับรอง:

csharp
var signer = app.Services.GetRequiredService<DocumentSigner>();
byte[] signaturePng = File.ReadAllBytes("signature.png");

var request = new SignRequest(
    new VisibleSignature(SignatureKind.Image, signaturePng),
    new SignaturePlacement(Page: 1, X: 0.58, Y: 0.80, W: 0.32, H: 0.12),
    Mode: SignatureMode.Visual);

SignResult result = await signer.SignAsync(stream, ".pdf", request, ct: ct);

แหล่งข้อมูล Word จะถูกลงนามเป็น PDF เว้นแต่คุณขอผลลัพธ์เป็น Word. ตั้งชื่อผลลัพธ์จาก result.Extension:

csharp
var signer = app.Services.GetRequiredService<DocumentSigner>();
byte[] signaturePng = File.ReadAllBytes("signature.png");

var request = new SignRequest(
    new VisibleSignature(SignatureKind.Drawn, signaturePng),
    new SignaturePlacement(Page: 1, X: 0.58, Y: 0.80, W: 0.32, H: 0.12),
    WordOutput: WordOutput.Docx);

SignResult result = await signer.SignAsync(stream, ".docx", request, ct: ct);
string downloadName = "contract-signed" + result.Extension;   // \u0022.docx\u0022

SignAsync จะโยนข้อยกเว้นแทนการคืนค่าเมื่อการเรียกไม่สำเร็จ:

ข้อยกเว้นข้อความเมื่อ
InvalidOperationExceptionNo signing certificate configured.โหมด Certified, ใบอนุญาตแบบชำระเงิน, และไม่ได้ส่งใบรับรอง
InvalidOperationExceptionThe signing certificate expired on yyyy-MM-dd. / The signing certificate is not valid before yyyy-MM-dd.โหมด Certified พร้อมใบรับรองที่อยู่นอกช่วงเวลาที่ใช้งานได้
ArgumentExceptionThe sign request is invalid: the visible signature needs PNG bytes and the placement must be a normalized rectangle on a 1-based page.ไบต์ PNG ว่างเปล่า หรือการวางตำแหน่งที่ไม่ถูกต้อง
NotSupportedExceptionThe signer supports PDF and Word (.docx) documents; got '{extension}'.ประเภทแหล่งข้อมูลอื่น ๆ

โหมดการลงนาม, ผลลัพธ์ Word และใบรับรอง

โหมดการลงนาม

SignRequest.Mode เลือกว่าลายเซ็นจะถูกปิดผนึกหรือไม่.

โหมดสิ่งที่สร้างใบรับรองตรวจสอบได้
SignatureMode.Certified (ค่าเริ่มต้น)ลายเซ็นที่มองเห็นได้พร้อมกับตราดิจิทัลจำเป็นภายใต้ใบอนุญาตแบบชำระเงินใช่
SignatureMode.Visualลายเซ็นที่มองเห็นได้เท่านั้นไม่เคยต้องการไม่: เป็นเพียงภาพ

ใช้ Certified เมื่อจำเป็นต้องพิสูจน์ลายเซ็น: การอนุมัติ, สัญญา, หรือสิ่งใดที่ผู้ตรวจสอบต้องตรวจสอบเพื่อยืนยันตัวตนและความสมบูรณ์. ใช้ Visual เมื่อคุณต้องการเพียงรูปลักษณ์ของลายเซ็นหรือไม่มีใบรับรอง. ใบอนุญาตชั่วคราวจะใส่น้ำลายน้ำให้ทั้งสองแบบ.

ตรา PDF คือลายเซ็นแยกส่วน PKCS#7 (adbe.pkcs7.detached) ด้วย SHA-256 สำหรับคีย์ RSA หรือ ECDSA. พวกมันบรรจุใบรับรองผู้ออกที่พบในไฟล์ PFX ของคุณ, ดังนั้นผู้อ่านที่เชื่อถือรากของคุณสามารถสร้างห่วงโซ่ได้. ตราที่เป็นของ Word เป็นลายเซ็นแพ็กเกจ OOXML และบรรจุเฉพาะใบรับรองผู้ลงนามเท่านั้น.

เอกสาร Word

สำหรับแหล่งข้อมูล .docx, SignRequest.WordOutput จะเลือกผลลัพธ์. จะถูกละเลยสำหรับแหล่งข้อมูล PDF ซึ่งจะสร้าง PDF เสมอ.

ผลลัพธ์สิ่งที่เกิดขึ้นการสนับสนุนตัวตรวจสอบ
WordOutput.Pdf (ค่าเริ่มต้น)เอกสารถูกแปลงเป็น PDF แล้วลงลายเซ็นและปิดผนึกกว้าง: PDF ที่ลงลายเซ็นจะตรวจสอบได้ทุกที่
WordOutput.Docxเอกสารยังคงเป็น Word: รูปภาพลายเซ็นจะถูกใส่ลงในเอกสาร พร้อมลายเซ็นแพ็กเกจ OOXMLจำกัด: ตัวดูทุกตัวไม่แสดงลายเซ็นแพ็กเกจ OOXML

เก็บเป็น PDF เว้นแต่ผู้รับต้องการไฟล์ Word ที่แก้ไขได้และยอมรับการสนับสนุนตัวตรวจสอบที่จำกัด.

การตั้งค่าใบรับรอง

เพื่อปิดผนึกด้วยอัตลักษณ์ของคุณเอง ให้ปลั๊กอินไฟล์ PFX (PKCS#12) ที่รวมคีย์ส่วนตัวไว้. สำหรับวิดเจ็ต ตั้งค่า SignerWidgetOptions.SigningCertificate; สำหรับฟาซาด C# ส่งใบรับรองไปยัง SignAsync. ให้ข้อมูลเป็นไบต์หรือเส้นทางพร้อมรหัสผ่าน:

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
    options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
    options.AddSignerWidget(widget =>
    {
        widget.SigningCertificate = new SigningCertificate
        {
            PfxBytes = File.ReadAllBytes("/secure/signing.pfx"),
            Password = builder.Configuration["Signing:PfxPassword"],
        };
    });
});
csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
    options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
    options.AddSignerWidget(widget =>
    {
        widget.SigningCertificate = new SigningCertificate
        {
            PfxPath = "/secure/signing.pfx",
            Password = builder.Configuration["Signing:PfxPassword"],
        };
    });
});

ใบรับรองจะถูกเก็บไว้ในหน่วยความจำเท่านั้น. มันจะไม่ถูกบันทึก, ส่งกลับไปยังไคลเอนต์, หรือบันทึกถาวร, และรหัสผ่านจะไม่ปรากฏในบรรทัดบันทึกหรือข้อความแสดงข้อผิดพลาด.

ข้อกำหนด:

  • PFX / PKCS#12 ชุด ที่มีคีย์ส่วนตัว. ไฟล์ที่มีเฉพาะคีย์สาธารณะเท่านั้น (.cer, .crt) ไม่สามารถลงลายเซ็นได้. ส่งออกสายการออกใบรับรองพร้อมกับมัน เพื่อให้การปิดผนึก PDF สามารถบรรจุได้.
  • รหัสผ่านที่ถูกต้อง.
  • อยู่ภายใน ช่วงเวลาที่มีผล ของมัน. ใบรับรองที่หมดอายุหรือยังไม่ถึงวันเริ่มใช้งานจะไม่ทำให้แอปหยุดทำงาน: จะบันทึกเป็นคำเตือน (Warning) ตอนเริ่มต้น, และลายเซ็น Certified จะถูกปฏิเสธจนกว่าจะเปลี่ยนใหม่. ลายเซ็น Visual จะไม่ได้รับผลกระทบ.
  • ออกเพื่อการลงลายเซ็นเอกสาร: การใช้คีย์ที่มี digital signature หรือ non-repudiation, และการใช้คีย์ขยาย (extended key usage) หากมี ซึ่งอนุญาตให้ลงลายเซ็นเอกสาร, ปกป้องอีเมล หรือการยืนยันตัวลูกค้า. ใบรับรองที่ออกเพื่อวัตถุประสงค์อื่น เช่น ใบรับรองเซิร์ฟเวอร์ TLS, ยังสามารถลงลายเซ็นได้, แต่จะบันทึกเป็นคำเตือนและโปรแกรมอ่าน PDF จะทำเครื่องหมายลายเซ็น.
  • โทเค็นฮาร์ดแวร์, สมาร์ทการ์ด, HSMs และที่เก็บใบรับรองของ Windows ไม่ได้รับการสนับสนุน. ส่งออกใบรับรองพร้อมคีย์ส่วนตัวและสายการออกเป็น PFX.

สร้าง PFX จากใบรับรองและคีย์ส่วนตัว ด้วย OpenSSL:

bash
openssl pkcs12 -export -out signing.pfx -inkey private.key -in certificate.crt
# รหัสผ่านการส่งออกที่คุณได้รับการแจ้งให้ป้อนคือ SigningCertificate.Password.

ส่งออกหนึ่งจากที่เก็บใบรับรองของ Windows: เปิด certmgr.msc และค้นหาใบรับรอง (ไอคอนของมันจะแสดงกุญแจเมื่อมีคีย์ส่วนตัว). คลิกขวาที่มัน, เลือก All Tasks → Export…, เลือก Yes, export the private key, เลือก Personal Information Exchange – PKCS #12 (.PFX), แล้วตั้งรหัสผ่าน.

การตรวจสอบตอนเริ่มต้น

เมื่อวิดเจ็ตเปิดใช้งาน, ใบรับรองใน SignerWidgetOptions.SigningCertificate จะถูกตรวจสอบหนึ่งครั้ง, ภายใน AddDoconut(), ดังนั้น PFX ที่ตั้งค่าไม่ถูกต้องจะล้มเหลวตอนเริ่มต้นแทนที่จะเกิดขึ้นที่ลายเซ็นแรก. ปัญหา 3 ประการจะทำให้เกิด InvalidOperationException:

ข้อความวิธีแก้
Doconut Signer: the certificate file was not found at '{path}'.แก้ไข PfxPath; ตรวจสอบให้ไฟล์ถูกปรับใช้และอ่านได้โดยบัญชีของแอป
Doconut Signer: the signing certificate could not be opened — the password is incorrect or the file is not a valid .pfx.ตรวจสอบรหัสผ่าน; ตรวจสอบให้ไฟล์เป็น .pfx จริง, ไม่ใช่ .cer หรือ .pem
Doconut Signer: the signing certificate has no private key. Re-export the .pfx INCLUDING the private key.ส่งออก PFX อีกครั้งพร้อมคีย์ส่วนตัว

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

text
Doconut Signer: using certificate '{subject}' (valid until yyyy-MM-dd). Signatures are digitally sealed.

คำเตือน (Warning) เมื่อมันหมดอายุ, ยังไม่ถึงวันเริ่มใช้งาน, หรือไม่ได้ออกเพื่อการลงลายเซ็นเอกสาร:

text
Doconut Signer: the signing certificate '{subject}' expired on yyyy-MM-dd. Certified signatures will be refused until it is replaced.
Doconut Signer: the signing certificate '{subject}' is not valid before yyyy-MM-dd. Certified signatures will be refused until then.
Doconut Signer: the signing certificate '{subject}' is not issued for document signing (its key usage excludes it). PDF readers will flag these signatures.

และข้อมูล (Information) เมื่อไม่มีการกำหนดค่าใบรับรอง:

text
Doconut Signer: no signing certificate configured — output uses the built-in demo certificate and is watermarked. Set SignerWidgetOptions.SigningCertificate to sign with your own certificate.

บรรทัดสุดท้ายนั้นเหมือนกันในทุกไลเซนส์. ภายใต้ไลเซนส์ที่ชำระเงิน ใบรับรองสาธิตจะไม่ถูกใช้: หากไม่มีใบรับรอง, จะทำงานเฉพาะลายเซ็น Visual เท่านั้น.

ฟาซาด C# จะไม่ถูกตรวจสอบตอนเริ่มต้น. ใบรับรองที่คุณส่งไปยัง SignAsync จะถูกอ่านเมื่อคุณลงลายเซ็น, ดังนั้นเส้นทางหรือรหัสผ่านที่ผิดจะทำให้การเรียกนั้นล้มเหลว.

วิดเจ็ตแบบ Drop-in

เปิดใช้งานจุดเชื่อมต่อ

จุดเชื่อมต่อ ?sign=open|run|download ของวิดเจ็ต ปิดโดยค่าเริ่มต้น. เปิดใช้งานพวกมันข้างการลงทะเบียนปลั๊กอิน:

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
    options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
    options.AddSignerWidget(widget =>
    {
        widget.MaxUploadMb = 25;           // ค่าเริ่มต้น
        widget.MaxSignatureImageKb = 512;  // ค่าเริ่มต้น
        // widget.SigningCertificate: ดูการตั้งค่า Certificate; ปล่อยให้เป็น null สำหรับการลงนาม demo (ที่มีลายน้ำ)
    });
});

AddSignerWidget() โดยไม่มีอาร์กิวเมนต์จะเปิดใช้งานวิดเจ็ตด้วยค่าเริ่มต้น. มันไม่ได้ให้สิทธิ์การลงนามโดยตัวเอง: จำเป็นต้องมี AddPlugin<SignerPlugin>(), หรือ AddDoconut() จะโยนข้อผิดพลาด:

text
AddSignerWidget() was called but the Signer plugin is not registered. Add options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>() (the widget needs it), or remove the AddSignerWidget() call.

หากไม่มี AddSignerWidget(), ทุกคำขอ ?sign= จะตอบกลับด้วย 404. สคริปต์เองยังคงให้บริการ, ดังนั้นวิดเจ็ตจะโหลดและวาดโซนวางของมัน, จากนั้นรายงาน Signing is not enabled on this server. ในคำขอแรกของมัน.

ฝังวิดเจ็ต

UseDoconutResources() ให้บริการสคริปต์ที่ {ResourcesPath}/js/doconutSigner.js (ค่าเริ่มต้น /doconut-res/js/doconutSigner.js). มันเป็นไฟล์เดียวที่รวมทุกอย่างโดยไม่มีการพึ่งพา:

html
<div id="host"></div>
<script src="/doconut-res/js/doconutSigner.js"></script>
<script>
  const handle = Doconut.signer('#host', { basePath: '/doconut' });
</script>

Doconut.signer(selectorOrElement, options) รับตัวเลือก CSS หรืออิลิเมนต์, จะโยนข้อผิดพลาดหากไม่พบ mount, และคืนค่า handle.

ผู้ลงนามอัปโหลดไฟล์ PDF หรือไฟล์ .docx, สร้างลายเซ็น (Draw บนแคนวาส, Type ชื่อในฟอนต์ลายเซ็น, หรือ Image จาก PNG, JPG หรือ GIF), ลากและปรับขนาดบนหน้า, แล้วลงนามและดาวน์โหลดผลลัพธ์. วิดเจ็ตจะส่งลายเซ็นเป็น PNG เสมอ; ภาพที่อัปโหลดจะถูกแปลงในเบราว์เซอร์เป็น PNG ที่มีขนาด 520×160.

ตัวเลือก

ตัวเลือกประเภทค่าเริ่มต้นหมายเหตุ
basePathstring'/doconut'ที่ที่จุดเชื่อมต่อ ?sign= และภาพตัวอย่างถูกให้บริการ
resPathstring'/doconut-res'สงวนไว้; วิดเจ็ตรวม CSS ของตัวเอง
maxUploadMbnumber25ตรวจสอบเฉพาะด้านไคลเอนต์, ดังนั้นไฟล์ที่ใหญ่เกินจะล้มเหลวอย่างรวดเร็ว. ขีดจำกัดของเซิร์ฟเวอร์คือ MaxUploadMb ใน AddSignerWidget
maxSignatureKbnumber512ขีดจำกัดด้านไคลเอนต์สำหรับโหมด Image. ให้เท่ากับ MaxSignatureImageKb ของเซิร์ฟเวอร์
previewWidthnumber560ความกว้างพิกเซลของการแสดงตัวอย่างหน้า
licenseUrlstring | nullnullเปลี่ยนการแจ้งเตือนลายน้ำเดโมให้เป็นลิงก์ไปยัง URL นี้
signatureModestring'certified'ประเภทลายเซ็นเริ่มต้น: 'certified' หรือ 'visual'. ค่าที่อื่นจะกลายเป็น 'certified'
showSignatureModeTogglebooleantrueแสดงตัวเลือก ลายเซ็นดิจิทัล / เฉพาะภาพ. หากใช้ false, วิดเจ็ตจะลงนามด้วย signatureMode
wordOutputstring'pdf'ผลลัพธ์เริ่มต้นสำหรับแหล่งข้อมูล .docx: 'pdf' หรือ 'docx'. ค่าที่อื่นจะกลายเป็น 'pdf'
showOutputFormatTogglebooleantrueแสดงตัวเลือก PDF / Word, เฉพาะแหล่งข้อมูล .docx. หากใช้ false, วิดเจ็ตจะใช้ wordOutput
labelsobject{}เขียนทับส่วนใดส่วนหนึ่งของสตริงภาษาอังกฤษ

การซ่อนสวิตช์ไม่ได้ปิดการทำงานของฟีเจอร์; มันกำหนดค่าคงที่. การกำหนดค่าที่พบบ่อยสองแบบ:

javascript
// แสดงสวิตช์ทั้งสอง, ลายเซ็นดิจิทัลเป็นค่าเริ่มต้น: ผู้ลงนามแบบบริการตนเองเต็มรูปแบบ.
Doconut.signer('#host', { basePath: '/doconut', licenseUrl: '/pricing' });
javascript
// แสดงผลอย่างเดียว, ไม่มีสวิตช์: ตราแบบง่ายที่ไม่มีลายเซ็นดิจิทัลให้
Doconut.signer('#host', {
  basePath: '/doconut',
  signatureMode: 'visual',
  showSignatureModeToggle: false
});

คอลแบ็ค

คอลแบ็คทำงานเมื่อข้อมูลที่ส่ง
onReadyหนึ่งครั้งเมื่อเมานท์ (ไม่ทำซ้ำบน reset())—
onSourceLoadedไฟล์ถูกเปิดและแสดงตัวอย่าง{ file: { token, name, pages, ext } }
onSignedการลงนามสำเร็จ{ downloadToken, downloadName, watermarked }
onDownloadเมื่อคลิกดาวน์โหลดแต่ละครั้ง{ downloadName, downloadToken }
onErrorขั้นตอนการเปิด, ลงนาม หรือดาวน์โหลดล้มเหลว, หรือไฟล์แบบ Image-mode มีขนาดใหญ่เกินไป{ message }

คอลแบ็คที่ทำให้เกิดข้อผิดพลาดจะถูกจับและบันทึก; มันจะไม่ทำให้การทำงานของวิดเจ็ตหยุดชะงัก.

การจัดการเชิงบังคับ

เมธอดพฤติกรรม
reset()คืนสู่หน้าจอวางและเคลียร์การทำงานปัจจุบัน ไม่เรียก onReady อีกครั้ง ไม่ทำอะไรหลังจาก destroy()
loadFile(file)เริ่มการทำงานด้วย File. ไม่ทำอะไรหากวิดเจ็ตไม่ได้อยู่ที่หน้าจอวาง; เรียก reset() ก่อนหากจำเป็น
destroy()ลบผู้ฟัง, ทำให้เมานท์ว่างเปล่า, และทำให้อินสแตนซ์ค้าง
javascript
const signerWidget = Doconut.signer('#host', {
  basePath: '/doconut',
  onSigned: (result) => console.log('signed', result.downloadName, result.watermarked),
  onError: (error) => console.warn(error.message)
});
document.getElementById('start-over').addEventListener('click', () => signerWidget.reset());

ป้ายกำกับ

แต่ละสตริงมีค่าเริ่มต้นเป็นภาษาอังกฤษ; labels จะเขียนทับส่วนใดส่วนหนึ่งและส่วนที่เหลือยังคงเป็นภาษาอังกฤษ ชิ้นส่วนที่เปลี่ยนแปลงในเวลารันใช้ {placeholders}, เช่น uploading: 'Uploading {name}…' และ pages: '{n} pages'.

คีย์ค่าเริ่มต้นภาษาอังกฤษ
dropPromptDrag & drop a PDF or Word file here
dropHintPDF or Word (.docx)
chooseFileChoose file
signatureHeadingYour signature
modeDraw / modeType / modeImageDraw / Type / Image
metaSummarySignature details (optional)
metaSignerName / metaReason / metaLocationSigner name / Reason / Location
signatureTypeSignature type
modeCertified / modeVisualDigital signature / Visual only
modeVisualNoteNo certificate — a visible mark only, not cryptographically verifiable.
outputFormatOutput format
outputPdf / outputWordPDF / Word (.docx)
signActionSign document
downloadDownload
demoNoticeDemo — signed with the Doconut demo certificate; output is watermarked.
signingNotEnabledSigning is not enabled on this server.
page / pages1 page / {n} pages

คีย์เพิ่มเติมครอบคลุมขั้นตอนการวาง, หน้าจอข้อผิดพลาด, ฟอร์มที่เชื่อมโยงของประกาศสาธิต (demoNoticePrefix, demoNoticeLink, demoNoticeSuffix) และประกาศ aria-live.

เมื่อ open หรือ run ตอบ 404 โดยไม่มีข้อผิดพลาด JSON, วิดเจ็ตจะแสดง signingNotEnabled. ข้อผิดพลาด JSON จากเซิร์ฟเวอร์จะมีลำดับความสำคัญสูงสุด, ดังนั้นข้อความเช่นการอัปโหลดที่หมดอายุจะยังคงแสดงอยู่.

ธีม

วิดเจ็ตเพิ่มคลาส dsw ให้กับองค์ประกอบเมานท์ของมันและอ่านสี, รัศมีและฟอนต์จากคุณสมบัติ CSS แบบกำหนดเอง, ดังนั้นคุณสามารถตั้งธีมได้โดยไม่ต้องแก้ไขภายในของมัน:

css
#host.dsw {
  --dsw-accent: #b0522b;       /* ลิงก์, โฟกัส, โหมดทำงาน */
  --dsw-bg: #fffaf3;
  --dsw-fg: #3b2a1a;
  --dsw-muted: #8a7a68;
  --dsw-border: #e0cbb0;
  --dsw-radius: 14px;
  --dsw-font: Georgia, "Times New Roman", serif;
  --dsw-signature-font: "Segoe Script", "Brush Script MT", cursive;   /* โหมด Type */
}

ค่าเริ่มต้น: --dsw-accent: #2b6cb0, --dsw-bg: #ffffff, --dsw-fg: #1a202c, --dsw-muted: #718096, --dsw-border: #cbd5e0, --dsw-radius: 8px, ฟอนต์ UI ของระบบ, และฟอนต์ลายเซ็นแบบอักษรเชิงโค้ง.

สร้างส่วนหน้าเอง

วิดเจ็ตเป็นไคลเอนต์สำหรับสัญญา HTTP นี้ ทั้งสามเส้นทางอยู่ภายใต้พาธที่ UseDoconut() ถูกเมานท์ (โดยปกติ /doconut), และพวกมันตอบ 404 จนกว่า AddSignerWidget() จะถูกเรียก. ข้อผิดพลาดจะมีเนื้อหา JSON, { "error": "..." }, ยกเว้นในกรณีที่ตารางระบุว่า "status only". ค่าที่ไม่รู้จักของ ?sign= จะตอบ 400.

เส้นทางวัตถุประสงค์การตอบสนองสำเร็จ
POST ?sign=open (multipart, one file)อัปโหลด PDF หรือ .docx และเปิดเพื่อดูตัวอย่าง200 — { token, name, pages, ext }
POST ?sign=run (JSON body)ลงนามไฟล์ที่อัปโหลด200 — { downloadToken, downloadName, watermarked }
GET ?sign=download&token=<downloadToken>สตรีมไฟล์ที่ลงนาม200 — ไฟล์, Content-Disposition: attachment, Cache-Control: no-store

ext ในการตอบสนอง open รวมจุดนำหน้า (".docx"). การแสดงตัวอย่างหน้าใช้เส้นทางรูปภาพของผู้ชมมาตรฐาน, {basePath}?token={token}&page={n}&thumb=1&width={px}; หน้าที่แสดงจะเป็น placement.page.

เนื้อหา run:

json
{
  "token": "GUID-from-open",
  "signature": { "kind": "Drawn", "payload": "<base64 PNG, no data: prefix>" },
  "placement": { "page": 1, "x": 0.58, "y": 0.80, "w": 0.32, "h": 0.12 },
  "meta": { "signerName": "Ada Lovelace", "reason": "I approve", "location": "London, UK" },
  "wordOutput": "pdf",
  "mode": "certified"
}
ฟิลด์หมายเหตุ
tokenโทเคนจาก open
signature.kindDrawn, Typed หรือ Image, ไม่สนใจตัวพิมพ์ใหญ่/เล็ก; อย่างอื่นจะกลายเป็น Drawn. เพียงคำแนะนำ: payload จะเป็น PNG เสมอ
signature.payloadPNG base64 อย่างเดียว, ไม่มีคำนำหน้า data:. ต้องเป็น PNG จริงและไม่ใหญ่กว่า MaxSignatureImageKb หลังจากถอดรหัส
placement.pageเริ่มจาก 1
placement.x / y / w / hNormalized 0..1 จากมุมซ้ายบน, พร้อมกับ x + w ≤ 1 และ y + h ≤ 1
meta.signerName / reason / locationไม่บังคับ. แต่ละรายการจะถูกตัดขอบ, ค่าที่ว่างจะถูกละทิ้ง, และแต่ละรายการจะถูกตัดที่ 256 ตัวอักษร
wordOutputpdf (ค่าเริ่มต้น) หรือ docx; ไม่สนใจสำหรับแหล่ง PDF. อย่างอื่นจะกลายเป็น pdf
modecertified (ค่าเริ่มต้น) หรือ visual. อย่างอื่นจะกลายเป็น certified

downloadName ตามผลลัพธ์: <source>-signed.pdf หรือ <source>-signed.docx, และ download ส่ง Content-Type ที่ตรงกัน.

ไฟล์ต้นฉบับที่อัปโหลดและผลลัพธ์ที่ลงนามจะถูกเก็บไว้แต่ละ 30 นาที. หลังจากนั้น, run และ download จะตอบ 404 และไฟล์ต้องเปิดใหม่อีกครั้ง. โทเคนทั้งหมดเป็น GUID.

เส้นทางสถานะเมื่อเนื้อหา
any404วิดเจ็ตไม่ได้เปิดใช้งานstatus only
any405คำกริยาผิด (open และ run ต้องการ POST, download ต้องการ GET)status only
open400ไม่ใช่อัปโหลดแบบ multipartExpected a multipart file upload.
open400ไม่มีไฟล์ หรือไฟล์ว่างNo file uploaded.
open400อย่างอื่นที่ไม่ใช่ .pdf หรือ .docxSigning supports PDF and Word (.docx) files only.
open413การอัปโหลดเกิน MaxUploadMbFile is too large.
run400เนื้อหาไม่เป็น JSON ที่ถูกต้อง, หรือว่างเปล่าMalformed request. / Empty request.
run400โทเคนหายไปหรือไม่ใช่ GUIDInvalid token.
run404การอัปโหลดหมดอายุหรือไม่เคยเปิดUpload expired — please re-open the file.
run400ไม่มีลายเซ็น, หรือไม่มีการวางNo signature supplied. / No placement supplied.
run400payload ไม่ใช่ base64, ว่างเปล่า, ขนาดใหญ่เกินไป, หรือไม่ใช่ PNGSignature image is not valid base64. / Signature image is empty. / Signature image is too large. / The signature image must be a PNG.
run400การวางอยู่นอกหน้าThe signature or its placement is invalid.
run400โหมด Certified, ไลเซนส์ที่ชำระเงินและไม่มีใบรับรองNo signing certificate configured.
run400โหมด Certified ที่มีใบรับรองอยู่นอกช่วงเวลาที่ใช้ได้The signing certificate expired on yyyy-MM-dd. / The signing certificate is not valid before yyyy-MM-dd.
open, run500การประมวลผลล้มเหลวA sanitized message
download400โทเคนหายไปหรือไม่ใช่ GUIDstatus only
download404โทเคนไม่รู้จักหรือหมดอายุstatus only

รอบการทำงานที่สมบูรณ์ด้วย fetch:

javascript
// file: ไฟล์ที่ต้องเซ็น; pngBase64: ลายเซ็นในรูปแบบ base64 PNG แบบเปล่า, โดยไม่มี data: คำนำ,
// เช่น canvas.toDataURL(\u0027image/png\u0027).split(\u0027,\u0027)[1].
async function signFile(file, pngBase64) {
  const base = '/doconut';

  // 1. open: อัปโหลดไฟล์
  const form = new FormData();
  form.append('file', file, file.name);
  const opened = await (await fetch(base + '?sign=open', { method: 'POST', body: form })).json();

  // 2. run: เซ็นมัน
  const signed = await (await fetch(base + '?sign=run', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      token: opened.token,
      signature: { kind: 'Drawn', payload: pngBase64 },
      placement: { page: 1, x: 0.58, y: 0.80, w: 0.32, h: 0.12 },
      meta: { signerName: 'Ada Lovelace', reason: 'I approve', location: 'London, UK' },
      wordOutput: 'pdf',
      mode: 'certified'
    })
  })).json();

  // 3. download: ดึงไฟล์ที่เซ็นแล้ว
  const blob = await (await fetch(base + '?sign=download&token=' + encodeURIComponent(signed.downloadToken))).blob();
  const link = document.createElement('a');
  link.href = URL.createObjectURL(blob);
  link.download = signed.downloadName;
  link.click();
  URL.revokeObjectURL(link.href);
}

จุดเชื่อมต่อเป็น same-origin: เวอร์ชันนี้ไม่มีการสนับสนุน CORS. ให้บริการ UI ของคุณและสคริปต์วิดเจ็ตจากต้นทางเดียวกันกับ Doconut, หรือทำ reverse‑proxy ทั้งสองเส้นทาง /doconut (เส้นทางมิดเดิลแวร์และเส้นทางทรัพยากร) ภายใต้ต้นทางของ UI ของคุณ.

ในการผลิต

  1. ติดตั้งปลั๊กอิน ข้างแพ็คเกจหลัก, ที่เวอร์ชันเดียวกัน: dotnet add package Doconut.NETStandard.Signer.

  2. เพิ่มไฟล์ใบอนุญาต. วาง Doconut.Viewer.Signer.lic ในโฟลเดอร์เดียวกันกับ Doconut.Viewer.lic.

  3. รับใบรับรองของคุณเป็น PFX พร้อมคีย์ส่วนตัวและสายการออกใบรับรอง, จากหน่วยงานออกใบรับรองหรือ PKI ขององค์กรของคุณ. เพื่อทดลองก่อน, ใช้ใบอนุญาตเดโม (ใบรับรองเดโมในตัว, มีลายน้ำ) หรือ PFX ที่เซ็นด้วยตนเอง.

  4. อ่านใบรับรองจากการกำหนดค่า, เพื่อให้การเปลี่ยนแปลงไม่ต้องแก้ไขโค้ด:

    json
    "DoconutSigner": { "PfxPath": "certs/your-certificate.pfx" }
    csharp
    var signerSettings = builder.Configuration.GetSection("DoconutSigner");
    
    builder.Services.AddDoconut(options =>
    {
        options.LicensePath = "Doconut.Viewer.lic";
        options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
        options.AddSignerWidget(widget => widget.SigningCertificate = new SigningCertificate
        {
            PfxPath = Path.Combine(builder.Environment.ContentRootPath, signerSettings["PfxPath"]),
            Password = signerSettings["Password"] ?? "",
        });
    });

    เก็บ .pfx ไว้นอก wwwroot, และเก็บรหัสผ่านให้อยู่นอก appsettings.json: ความลับผู้ใช้ในระหว่างการพัฒนา (dotnet user-secrets set "DoconutSigner:Password" "<password>"), ตัวแปรสภาพแวดล้อม (DoconutSigner__Password) หรือ vault ในการผลิต.

  5. ตรวจสอบบันทึกการเริ่มต้น. ควรอ่านว่า using certificate '{subject}' (valid until …). Signatures are digitally sealed. คำเตือนหมายความว่าใบรับรองหมดอายุ, ยังไม่เป็นที่ใช้ได้, หรือไม่ได้ออกสำหรับการลงนามเอกสาร.

เชื่อถือในโปรแกรมอ่าน PDF. โปรแกรมอ่านจะแสดงลายเซ็นเป็นที่ถูกต้องเมื่อมันเชื่อถือรากของใบรับรอง. ด้วย PKI ขององค์กรของคุณ, สิ่งนี้จะทำงานบนเครื่องทุกเครื่องที่เชื่อถือรากของคุณ, ซึ่งโดยปกติจะเป็นทุกเครื่องภายในองค์กร. ใบรับรองที่ Adobe เชื่อถือบนเครื่องใดเครื่องหนึ่ง (Adobe Approved Trust List) นั้น, ตามที่เราทราบ, ถูกออกด้วยคีย์ส่วนตัวบนโทเคนฮาร์ดแวร์หรือ HSM, ซึ่งปลั๊กอินนี้ไม่สามารถใช้ได้: มันลงนามจาก PFX เท่านั้น. ยืนยันกับผู้ให้บริการใบรับรองของคุณก่อนพึ่งพาการเชื่อมั่นแบบนั้น.

ฟาร์มเว็บ

วิดเจ็ตเก็บการอัปโหลดแต่ละรายการและผลลัพธ์ไว้ในหน่วยความจำบนโหนดที่ให้บริการ open. ภายหลังโหลดบาลานเซอร์ที่ไม่มี sticky sessions, คำขอ run, download หรือการแสดงตัวอย่างในภายหลังอาจไปยังโหนดอื่นและไม่พบการอัปโหลด. ลงทะเบียนที่เก็บวิดเจ็ตที่แชร์และเข้ารหัสเพียงครั้งเดียว, หลังจาก AddDoconut():

csharp
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);

builder.Services.AddDoconutDistributedWidgets(store =>
{
    store.RootPath = @"\\fileshare\doconut";   // โฟลเดอร์ที่ทุกโหนดสามารถอ่านและเขียนได้
    store.FarmKey = farmKey;                   // อย่างน้อย 32 ไบต์, เหมือนกันบนทุกโหนด
    // store.Ttl = TimeSpan.FromMinutes(30);   // ระยะเวลาที่อัปโหลดจะถูกเก็บ (ค่าเริ่มต้น)
});
  • เซิร์ฟเวอร์เดียวไม่ต้องการอะไร: หากไม่มีการเรียกนี้ ที่เก็บในหน่วยความจำจะถูกใช้.
  • การอัปโหลดและผลลัพธ์ถูกเข้ารหัสขณะพักบนแชร์ (AES-256, encrypt-then-MAC), และแต่ละไฟล์ถูกผูกกับโทเคนของมัน, ดังนั้นโทเคนหนึ่งจะไม่สามารถอ่านไฟล์ของโทเคนอื่นได้.
  • FarmKey ต้องมีขนาดอย่างน้อย 32 ไบต์และต้องเหมือนกันบนทุกโหนด. โหลดจากที่เก็บความลับ; อย่า hard‑code. การลงทะเบียนจะโยน ArgumentException เมื่อ RootPath หายไปหรือ FarmKey สั้นกว่า 32 ไบต์.
  • ชี้ RootPath ไปยังตำแหน่งที่แชร์เดียวกันที่ ตัวชมแบบกระจาย ใช้, และให้ทุกโหนดใช้ใบรับรองการลงนามเดียวกัน.

อ้างอิง API

ฟาซาเดและตัวเลือกวิดเจ็ตอยู่ใน namespace Doconut; ประเภทคำขอและผลลัพธ์อยู่ใน Doconut.Core.Models.Signing. SignerPlugin อยู่ใน Doconut.Plugins.Signer.

DocumentSigner (ตัวลงนามเอกสาร)

csharp
public sealed class DocumentSigner
{
    public Task<SignResult> SignAsync(
        Stream source, string sourceExtension, SignRequest request,
        SigningCertificate? cert = null, CancellationToken ct = default);
}

ได้รับจากการฉีดพึ่งพา; ตัวสร้างเป็น internal. sourceExtension คือ ".pdf" หรือ ".docx". ภายใต้ลิขสิทธิ์แบบชำระเงิน cert จะถูกใช้และผลลัพธ์จะสะอาด; ภายใต้ลิขสิทธิ์ชั่วคราวจะใช้ใบรับรองสาธิตในตัว, cert จะถูกละเลย, และผลลัพธ์จะมีลายน้ำ.

SignRequest (คำขอการลงนาม)

csharp
public sealed record SignRequest(
    VisibleSignature   Signature,
    SignaturePlacement Placement,
    string?            SignerName = null,
    string?            Reason     = null,
    string?            Location   = null,
    WordOutput         WordOutput = WordOutput.Pdf,
    SignatureMode      Mode       = SignatureMode.Certified)
{
    public bool IsValid { get; }   // Signature.IsValid && Placement.IsValid
}

ลายเซ็นที่มองเห็นได้หนึ่งครั้งที่วางไว้หนึ่งตำแหน่ง, พร้อมเมตาดาต้าผู้ลงนามที่เป็นตัวเลือก.

VisibleSignature and SignatureKind (ลายเซ็นที่มองเห็นได้และประเภทลายเซ็น)

csharp
public sealed record VisibleSignature(SignatureKind Kind, byte[] PngBytes)
{
    public bool IsValid { get; }   // PngBytes ไม่ว่างเปล่า
}

public enum SignatureKind { Drawn, Typed, Image }

PngBytes เป็น PNG สำหรับทุกประเภท. ลายเซ็นที่วาดหรือพิมพ์เป็นแบบโปร่งแสง; ภาพที่อัปโหลดจะคงความโปร่งแสงที่มีอยู่, ดังนั้น JPG ที่ทึบจะยังคงทึบ. Kind เป็นเพียงคำแนะนำ.

SignaturePlacement (ตำแหน่งลายเซ็น)

csharp
public readonly record struct SignaturePlacement(int Page, double X, double Y, double W, double H)
{
    public bool IsValid { get; }   // Page >= 1; X, Y >= 0; W, H > 0; X + W <= 1; Y + H <= 1
}

Page เริ่มจาก 1; X, Y, W และ H ถูกทำให้เป็นค่า 0..1 ปกติจากมุมบนซ้าย.

SignatureMode and WordOutput (โหมดลายเซ็นและผลลัพธ์ Word)

csharp
public enum SignatureMode { Certified, Visual }   // Certified เป็นค่าเริ่มต้น
public enum WordOutput { Pdf, Docx }              // Pdf เป็นค่าเริ่มต้น; ถูกละเว้นสำหรับแหล่งที่มาของ PDF

SignResult (ผลลัพธ์การลงนาม)

csharp
public sealed record SignResult(Stream Stream, string Extension);

เอกสารที่ลงนามเป็นสตรีมที่สามารถเลื่อนตำแหน่งได้, และส่วนขยายของมันพร้อมจุด (".pdf" หรือ ".docx").

SigningCertificate (ใบรับรองการลงนาม)

csharp
public sealed class SigningCertificate
{
    public byte[]? PfxBytes { get; init; }
    public string? PfxPath  { get; init; }
    public string  Password { get; init; } = "";
    public bool    HasMaterial { get; }   // PfxBytes ไม่ว่างเปล่า, หรือ PfxPath ไม่ว่าง
}

ตั้งค่าให้เป็น PfxBytes หรือ PfxPath, พร้อมกับ Password.

SignerWidgetOptions (ตัวเลือกวิดเจ็ตผู้ลงนาม)

csharp
public sealed class SignerWidgetOptions
{
    public int MaxUploadMb { get; set; } = 25;
    public int MaxSignatureImageKb { get; set; } = 512;
    public SigningCertificate? SigningCertificate { get; set; }
}

ตั้งค่าผ่าน DoconutOptions.AddSignerWidget(Action<SignerWidgetOptions>? configure = null), ซึ่งคืนค่า DoconutOptions เพื่อให้สามารถเรียกต่อกันได้. ค่า null SigningCertificate หมายถึงใบรับรองสาธิตภายใต้ลิขสิทธิ์ชั่วคราว, และลายเซ็น Visual จะใช้ได้เฉพาะลิขสิทธิ์แบบชำระเงิน.

การแก้ไขปัญหา

อาการสาเหตุวิธีแก้
AddDoconut() ทำให้เกิด The Signer plugin is registered via AddPlugin but no active license grants Signer.ไม่มีลิขสิทธิ์, ไฟล์ TRIAL, ลิขสิทธิ์ที่ไม่มี Signer, หรือลิขสิทธิ์แบบชำระเงินที่อยู่นอกช่วงเวอร์ชันของมันติดตั้งลิขสิทธิ์ที่ให้สิทธิ Signer, หรือเอา AddPlugin<SignerPlugin>() ออก
AddDoconut() ทำให้เกิด AddSignerWidget() was called but the Signer plugin is not registered.วิดเจ็ตถูกเปิดใช้งานโดยไม่มีปลั๊กอินของมันเพิ่ม options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>()
AddDoconut() ทำให้เกิด Doconut Signer: the certificate file was not found at '{path}'.PfxPath ชี้ไปที่ไฟล์ที่หายไปแก้ไขเส้นทาง; ปรับใช้ไฟล์ในตำแหน่งที่บัญชีแอปสามารถอ่านได้
AddDoconut() ทำให้เกิด Doconut Signer: the signing certificate could not be opened — the password is incorrect or the file is not a valid .pfx.รหัสผ่านผิด, หรือไม่ใช่ไฟล์ PKCS#12ตรวจสอบรหัสผ่าน; ใช้ .pfx ที่แท้จริง
AddDoconut() ทำให้เกิด Doconut Signer: the signing certificate has no private key. Re-export the .pfx INCLUDING the private key.PFX ถูกส่งออกโดยไม่มีคีย์ส่วนตัวส่งออกใหม่พร้อมคีย์ส่วนตัว
การแก้ไข DocumentSigner ทำให้เกิด No IDocumentSigner is registered.SignerPlugin ยังไม่ได้ลงทะเบียนเพิ่ม AddPlugin<SignerPlugin>() ภายใน AddDoconut()
ผลลัพธ์มีลายน้ำลิขสิทธิ์เป็นแบบชั่วคราว (Demo/NFR)ใช้ลิขสิทธิ์แบบชำระเงินที่ให้สิทธิ Signer
run ตอบ 400 No signing certificate configured.ลิขสิทธิ์แบบชำระเงิน, โหมด Certified, และไม่มีใบรับรองกำหนดค่า SigningCertificate, หรือเซ็นในโหมด Visual
run ตอบ 400 The signing certificate expired on yyyy-MM-dd.ใบรับรองหมดอายุเปลี่ยนใหม่; ลายเซ็น Visual ยังคงทำงานในระหว่างนี้
บันทึกบอกว่าผลลัพธ์ "ใช้ใบรับรองสาธิตในตัว", แต่ลิขสิทธิ์แบบชำระเงินปฏิเสธลายเซ็น Certifiedบรรทัดนั้นจะเขียนทุกครั้งเมื่อไม่มีการกำหนดค่าใบรับรอง, ไม่ว่า ลิขสิทธิ์ จะเป็นแบบใดกำหนดค่า SigningCertificate
วิดเจ็ตโหลดแล้วแต่บอกว่า Signing is not enabled on this server.AddSignerWidget() ไม่ได้ถูกเรียก, หรือ basePath ไม่ตรงกับตำแหน่งที่ UseDoconut() ถูกเมานท์เรียก AddSignerWidget(); แก้ไข basePath
run ตอบ 400 The signature image must be a PNG., Signature image is not valid base64. หรือ Signature image is too large.UI ที่กำหนดเองส่ง URL data:, JPG, หรือมากกว่า MaxSignatureImageKbส่ง PNG base64 แบบไม่มีส่วนหัวภายในขีดจำกัด
open ตอบ 413 File is too large.การอัปโหลดเกิน MaxUploadMbยก MaxUploadMb ใน AddSignerWidget; maxUploadMb ของวิดเจ็ตเป็นการตรวจสอบฝั่งไคลเอนต์เท่านั้น
run หรือ download ตอบ 404 Upload expired — please re-open the file.ช่วงเวลา 30 นาทีหมดแล้ว, หรือโหนดเว็บฟาร์มไม่มีไฟล์อัปโหลดเปิดไฟล์อีกครั้ง; ในฟาร์ม, ลงทะเบียน AddDoconutDistributedWidgets
ไฟล์ .docx ที่ลงนามแสดงไม่มีลายเซ็นในบางโปรแกรมดูผลลัพธ์ Word มีลายเซ็นแพ็กเกจ OOXML, ซึ่งโปรแกรมดูหลายตัวไม่แสดงลงนามเป็น PDF, ค่าเริ่มต้น
โปรแกรมอ่าน PDF บอกว่าตัวตนของผู้ลงนามไม่ทราบโปรแกรมอ่านไม่เชื่อถือรากของใบรับรอง (ใบรับรองสาธิตไม่เคยได้รับความเชื่อถือ)ใช้ใบรับรองจากรากที่โปรแกรมอ่านของคุณเชื่อถือ
วิดเจ็ตล้มเหลวเมื่อ UI อยู่บนต้นทางอื่นจุดเชื่อมต่อไม่มีการสนับสนุน CORSให้บริการ UI จากต้นทางเดียวกัน, หรือ reverse-proxy เส้นทาง Doconut
ธีมไม่ทำงานตัวเลือกกำหนดเป้าหมายที่องค์ประกอบภายใน mountกำหนดเป้าหมายที่ mount เอง: #host.dsw หรือ #host

หน้านี้เป็นประโยชน์หรือไม่?