Πρόσθετο Υπογραφής

Υπογράψτε έγγραφα 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.NET8.Signer

Για να «καρφώσετε» το πρόσθετο στην έκδοση που περιγράφει αυτή η τεκμηρίωση, περάστε την έκδοση ξεχωριστά:

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

Διατηρήστε το πακέτο Signer στην ίδια έκδοση με το Doconut.NET8. Το αναγνωριστικό του πακέτου είναι Doconut.NET8.Signer· το .<version> εμφανίζεται μόνο στο ληφθέν όνομα αρχείου .nupkg.

Το αρχείο άδειας του πρόσθετου, Doconut.Viewer.Signer.lic, τοποθετείται στον ίδιο φάκελο με το Doconut.Viewer.lic· διαβάζεται μαζί με την άδεια του προβολέα.

Πλατφόρμες. Το πρόσθετο λειτουργεί όπου και το Doconut.NET8 λειτουργεί: Windows και Linux βασισμένο σε glibc σε x64 (όχι Alpine ή άλλες διανομές βασισμένες σε musl). Σε Linux, εγκαταστήστε τη βιβλιοθήκη ρύθμισης γραμματοσειράς πριν ανοίξει το πρώτο έγγραφο:

bash
apt-get update && apt-get install -y libfontconfig1

Σε RHEL, Fedora και παρόμοιες διανομές το πακέτο είναι fontconfig. Χωρίς αυτό, το άνοιγμα ενός εγγράφου αποτυγχάνει με The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation..

Καταχώρηση του πρόσθετου

Όπως κάθε πρόσθετο Doconut, το Signer καταχωρείται με AddPlugin<TPlugin>() μέσα στο AddDoconut():

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

Αυτό είναι ό,τι χρειάζεται η προσέγγιση C#. Το widget και τα HTTP endpoints του είναι μια ξεχωριστή επιλογή, AddSignerWidget() (δείτε Ενσωματωμένο widget).

Το πρόσθετο χρειάζεται άδεια που παρέχει τη δυνατότητα 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.

Αποτυγχάνει όταν δεν υπάρχει άδεια, όταν υπάρχει παλαιό αρχείο TRIAL, όταν η άδεια δεν περιέχει Signer, ή όταν μια πληρωμένη άδεια χρησιμοποιείται εκτός του χρονικού πλαισίου της. Δέχονται προσωρινές άδειες Demo/NFR. Δείτε Ρύθμιση Άδειας για το πώς φορτώνονται οι άδειες.

Άδεια & υδατογράφημα

Κατάσταση άδειαςΈναρξηΠιστοποιημένη υπογραφήΟπτική υπογραφή
Πληρωμένη άδεια που παρέχει Signer, ρυθμισμένο πιστοποιητικόΞεκινάΣφραγισμένο με το δικό σας πιστοποιητικό, καθαρό (watermarked: false)Καθαρό
Πληρωμένη άδεια που παρέχει Signer, χωρίς πιστοποιητικόΞεκινάΑπορρίπτεται: No signing certificate configured.Καθαρό
Πληρωμένη άδεια, πιστοποιητικό ληγμένο ή ακόμη μη έγκυροΞεκινά (με ενεργό το widget, καταγράφεται Προειδοποίηση)Απορρίπτεται: The signing certificate expired on yyyy-MM-dd.Καθαρό
Προσωρινή άδεια Demo/NFR, ενεργή ή ληγμένηΞεκινάΣφραγισμένο με το ενσωματωμένο demo πιστοποιητικό, με υδατογράφημα (watermarked: true)Με υδατογράφημα
Χωρίς άδεια, παλαιό αρχείο TRIAL, άδεια χωρίς Signer, ή πληρωμένη άδεια εκτός του χρονικού πλαισίου τηςAddDoconut() αποτυγχάνει——

Ο κανόνας είναι ο ίδιος για την προσέγγιση C# και το widget: η έξοδος υδατογραφείται όταν η άδεια δεν είναι πληρωμένη άδεια προβολέα ή είναι προσωρινή. Υπό προσωρινή άδεια το πρόσθετο πάντα υπογράφει με το ενσωματωμένο demo πιστοποιητικό, και οποιοδήποτε πιστοποιητικό ρυθμίσετε δεν χρησιμοποιείται.

Το demo πιστοποιητικό παράγει μια γνήσια σφραγίδα, αλλά οι αναγνώστες PDF δεν την εμπιστεύονται. Μια ενσωμάτωση μπορεί να δημιουργηθεί και να δοκιμαστεί από άκρη σε άκρη με μια άδεια αξιολόγησης· για να έχετε καθαρή, αξιόπιστη έξοδο χρειάζεστε τόσο μια πληρωμένη άδεια όσο και το δικό σας πιστοποιητικό υπογραφής.

Χρήση από C#

DocumentSigner καταχωρείται από AddDoconut() και επιλύεται από την ενσωμάτωση εξαρτήσεων. Ο κατασκευαστής του είναι εσωτερικός, οπότε ποτέ μην 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 προεπιλέγεται σε Certified (ορατή υπογραφή + ψηφιακή σφραγίδα); WordOutput προεπιλέγεται σε 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"), το αίτημα και το πιστοποιητικό για αυτήν την κλήση. Η πρόσοψη δεν διαβάζει SignerWidgetOptions.SigningCertificate· αυτή η ρύθμιση είναι για το widget. Περνάτε null υπό άδεια δοκιμής, ή σε λειτουργία Visual.

SignResult διατηρεί το υπογεγραμμένο έγγραφο ως ρεύμα με δυνατότητα αναζήτησης, συν το Extension του (".pdf" ή ".docx") ώστε να μπορείτε να ονομάσετε το αρχείο. Εσείς κατέχετε το ρεύμα: απελευθερώστε το όταν τελειώσετε.

Μια υπογραφή 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.Κενά bytes 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) που περιλαμβάνει το ιδιωτικό κλειδί. Για το widget, ορίστε SignerWidgetOptions.SigningCertificate· για τη διεπαφή C#, περάστε το πιστοποιητικό στο SignAsync. Παρέχετε είτε τα bytes είτε μια διαδρομή, συν το κωδικό πρόσβασης:

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 να την μεταφέρουν.
  • Ο σωστός κωδικός πρόσβασης.
  • Μέσα στο χρονικό παράθυρο ισχύος του. Ένα ληγμένο ή ακόμη μη έγκυρο πιστοποιητικό δεν σταματά την εφαρμογή: καταγράφεται ως Προειδοποίηση κατά την εκκίνηση, και οι Πιστοποιημένες υπογραφές απορρίπτονται μέχρι να αντικατασταθεί. Οι οπτικές υπογραφές δεν επηρεάζονται.
  • Εκδομένο για υπογραφή εγγράφων: χρήση κλειδιού με ψηφιακή υπογραφή ή μη αποδοχή άρνησης, και εκτεταμένη χρήση κλειδιού, εάν υπάρχει, που επιτρέπει την υπογραφή εγγράφων, την προστασία email ή την πιστοποίηση πελάτη. Ένα πιστοποιητικό εκδοθέν για κάτι άλλο, όπως πιστοποιητικό διακομιστή TLS, εξακολουθεί να υπογράφει, αλλά καταγράφεται ως Προειδοποίηση και οι αναγνώστες PDF σηματοδοτούν την υπογραφή.
  • Δεν υποστηρίζονται hardware tokens, έξυπνες κάρτες, HSM και το αποθετήριο πιστοποιητικών των 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) και ορίστε έναν κωδικό πρόσβασης.

Έλεγχοι εκκίνησης

Όταν το widget είναι ενεργοποιημένο, το πιστοποιητικό στο SignerWidgetOptions.SigningCertificate ελέγχεται μία φορά, μέσα στο AddDoconut(), ώστε ένα λανθασμένα ρυθμισμένο PFX να αποτύχει κατά την εκκίνηση αντί για την πρώτη υπογραφή. Τρία προβλήματα προκαλούν ένα 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.

Μια Προειδοποίηση όταν είναι ληγμένο, ακόμη μη έγκυρο, ή δεν έχει εκδοθεί για υπογραφή εγγράφων:

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.

Και Πληροφορίες όταν δεν έχει ρυθμιστεί κανένα πιστοποιητικό:

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.

Η τελευταία γραμμή είναι η ίδια για κάθε άδεια. Σε μια επί πληρωμή άδεια το πιστοποιητικό επίδειξης δεν χρησιμοποιείται ποτέ: χωρίς πιστοποιητικό, λειτουργούν μόνο οι Οπτικές υπογραφές.

Η διεπαφή C# δεν ελέγχεται κατά την εκκίνηση. Το πιστοποιητικό που περνάτε στο SignAsync διαβάζεται όταν υπογράφετε, έτσι ένα λανθασμένο μονοπάτι ή κωδικός πρόσβασης αποτυγχάνει αυτή την κλήση.

Drop‑in widget

Enable the endpoints

The widget's ?sign=open|run|download endpoints are απενεργοποιημένα από προεπιλογή. Enable them next to the plugin registration:

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: δείτε τη ρύθμιση Πιστοποιητικού; αφήστε το null για υπογραφή επίδειξης (με υδατογράφημα)
    });
});

AddSignerWidget() χωρίς όρισμα ενεργοποιεί το widget με τις προεπιλογές. Δεν παρέχει υπογραφή από μόνο του: χρειάζεται 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. Το ίδιο το script εξακολουθεί να σερβίρεται, έτσι το widget φορτώνει και σχεδιάζει τη ζώνη του, μετά αναφέρει Signing is not enabled on this server. στην πρώτη του αίτηση.

Embed it

UseDoconutResources() σερβίρει το script στο {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 selector ή ένα στοιχείο, ρίχνει σφάλμα αν δεν βρεθεί το mount, και επιστρέφει ένα handle.

Ο υπογράφων ανεβάζει ένα PDF ή αρχείο .docx, δημιουργεί μια υπογραφή (Σχεδίαση σε καμβά, Πληκτρολόγηση ένα όνομα με γραμματοσειρά υπογραφής, ή Εικόνα από PNG, JPG ή GIF), το σύρει και αλλάζει το μέγεθός του στη σελίδα, και υπογράφει και κατεβάζει το αποτέλεσμα. Το widget στέλνει πάντα την υπογραφή ως PNG· μια ανεβασμένη εικόνα μετατρέπεται στον περιηγητή σε PNG που ταιριάζει στο 520×160.

Options

ΕπιλογήΤύποςΠροεπιλογήΣημειώσεις
basePathstring'/doconut'Πού σερβίρονται τα endpoints ?sign= και οι εικόνες προεπισκόπησης
resPathstring'/doconut-res'Κρατημένο· το widget περιλαμβάνει το δικό του CSS
maxUploadMbnumber25Έλεγχος μόνο στην πλευρά του πελάτη, έτσι ένα υπερμεγέθες αρχείο αποτυγχάνει γρήγορα. Το όριο του διακομιστή είναι MaxUploadMb σε AddSignerWidget
maxSignatureKbnumber512Όριο στην πλευρά του πελάτη για τη λειτουργία Image. Κρατήστε το ίσο με το MaxSignatureImageKb του διακομιστή
previewWidthnumber560Πλάτος σε pixel της προεπισκόπησης σελίδας
licenseUrlstring | nullnullΜετατρέπει την ειδοποίηση demo-watermark σε σύνδεσμο σε αυτό το URL
signatureModestring'certified'Αρχικός τύπος υπογραφής: 'certified' ή 'visual'. Οποιαδήποτε άλλη τιμή γίνεται 'certified'
showSignatureModeTogglebooleantrueΕμφανίζει την επιλογή Ψηφιακή υπογραφή / Μόνο οπτική. Με false, το widget υπογράφει με signatureMode
wordOutputstring'pdf'Αρχική έξοδος για πηγές .docx: 'pdf' ή 'docx'. Οποιαδήποτε άλλη τιμή γίνεται 'pdf'
showOutputFormatTogglebooleantrueΕμφανίζει την επιλογή PDF / Word, μόνο για πηγές .docx. Με false, το widget χρησιμοποιεί wordOutput
labelsobject{}Αντικαθιστά οποιοδήποτε υποσύνολο των αγγλικών κειμένων

Η απόκρυψη ενός toggle δεν απενεργοποιεί τη λειτουργία· καθορίζει την τιμή. Δύο κοινές ρυθμίσεις:

javascript
// Εμφανίζονται και οι δύο διακόπτες, η ψηφιακή υπογραφή είναι προεπιλεγμένη: ένας πλήρης αυτό-εξυπηρετούμενος υπογράφων.
Doconut.signer('#host', { basePath: '/doconut', licenseUrl: '/pricing' });
javascript
// Μόνο οπτικό, χωρίς διακόπτη: ένα απλό στίγμα χωρίς ψηφιακή υπογραφή.
Doconut.signer('#host', {
  basePath: '/doconut',
  signatureMode: 'visual',
  showSignatureModeToggle: false
});

Callbacks

ΑνακλήσηΕνεργοποιείται ότανΔεδομένα
onReadyΜία φορά, κατά το mount (όχι ξανά στο reset())—
onSourceLoadedΤο αρχείο ανοίγει και εμφανίζεται η προεπισκόπηση{ file: { token, name, pages, ext } }
onSignedΗ υπογραφή επιτυγχάνει{ downloadToken, downloadName, watermarked }
onDownloadΣε κάθε κλικ στο Download{ downloadName, downloadToken }
onErrorΑποτυγχάνει ένα βήμα ανοίγματος, υπογραφής ή λήψης, ή ένα αρχείο σε λειτουργία Image είναι πολύ μεγάλο{ message }

Μια ανακλήση που ρίχνει εξαίρεση πιάστηκε και καταγράφηκε· δεν διακόπτει ποτέ τη ροή του widget.

Απρακτική διαχείριση

ΜέθοδοςΣυμπεριφορά
reset()Επιστρέφει στην οθόνη απόρριψης και καθαρίζει τη τρέχουσα ροή. Δεν ενεργοποιεί ξανά το onReady. Δεν κάνει καμία ενέργεια μετά το destroy()
loadFile(file)Ξεκινά τη ροή με ένα File. Δεν κάνει καμία ενέργεια εκτός εάν το widget βρίσκεται στην οθόνη απόρριψης· καλέστε το reset() πρώτα εάν χρειάζεται
destroy()Αφαιρεί τους ακροατές, αδειάζει το mount και παγώνει το instance
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

Περαιτέρω κλειδιά καλύπτουν το βήμα τοποθέτησης, την οθόνη σφάλματος, τη συνδεδεμένη φόρμα της ειδοποίησης demo (demoNoticePrefix, demoNoticeLink, demoNoticeSuffix) και τις ανακοινώσεις aria-live.

Όταν το open ή το run απαντούν το 404 χωρίς σφάλμα JSON, το widget εμφανίζει το signingNotEnabled. Ένα σφάλμα JSON από τον διακομιστή πάντα υπερισχύει, έτσι μηνύματα όπως μια λήξη μεταφόρτωσης παραμένουν ορατά.

Διαμόρφωση

Το widget προσθέτει την κλάση dsw στο στοιχείο mount του και διαβάζει τα χρώματα, την ακτίνα και τις γραμματοσειρές του από τις προσαρμοσμένες ιδιότητες 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, και μια πλάγια γραμματοσειρά υπογραφής.

Δημιουργήστε το δικό σας frontend

Το widget είναι πελάτης για αυτή τη σύμβαση HTTP. Όλες οι τρεις διαδρομές βρίσκονται κάτω από τη διαδρομή όπου το UseDoconut() είναι προσαρτημένο (συνήθως /doconut), και απαντούν το 404 μέχρι να κληθεί το AddSignerWidget(). Τα σφάλματα περιλαμβάνουν σώμα JSON, { "error": "..." }, εκτός όπου ο πίνακας λέει «μόνο κατάσταση». Μια άγνωστη τιμή ?sign= απαντά το 400.

ΔιαδρομήΣκοπόςΑπάντηση επιτυχίας
POST ?sign=open (multipart, ένα αρχείο)Ανεβάστε ένα PDF ή .docx και ανοίξτε το για προεπισκόπηση200 — { token, name, pages, ext }
POST ?sign=run (σώμα JSON)Υπογράψτε το ανεβασμένο αρχείο200 — { downloadToken, downloadName, watermarked }
GET ?sign=download&token=<downloadToken>Μετάδοση του υπογεγραμμένου αρχείου200 — το αρχείο, Content-Disposition: attachment, Cache-Control: no-store

Το ext στην απάντηση open περιλαμβάνει την αρχική τελεία (".docx"). Η προεπισκόπηση σελίδας χρησιμοποιεί τη στάνταρ διαδρομή εικόνας του viewer, {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Το token από το open
signature.kindDrawn, Typed ή Image, χωρίς διάκριση πεζών‑κεφαλαίων· οτιδήποτε άλλο γίνεται Drawn. Μόνο υπόδειξη: το payload είναι πάντα PNG
signature.payloadΈνα ακατέργαστο base64 PNG, χωρίς πρόθεμα data:. Πρέπει να είναι πραγματικό PNG και να μην είναι μεγαλύτερο από MaxSignatureImageKb μετά την αποκωδικοποίηση
placement.pageΒασισμένο στο 1
placement.x / y / w / hΚανονικοποιημένο 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 και το αρχείο πρέπει να ανοιχτεί ξανά. Όλα τα tokens είναι GUIDs.

ΔιαδρομήΚατάστασηΠότεΣώμα
οποιαδήποτε404Το widget δεν είναι ενεργοποιημένομόνο κατάσταση
οποιαδήποτε405Λάθος μέθοδος (open και run χρειάζονται POST, download χρειάζεται GET)μόνο κατάσταση
open400Δεν είναι multipart ανέβασμαExpected 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Το token λείπει ή δεν είναι GUIDInvalid token.
run404Το ανέβασμα έληξε ή δεν ανοίχθηκε ποτέUpload expired — please re-open the file.
run400Δεν υπάρχει υπογραφή ή τοποθέτησηNo signature supplied. / No placement supplied.
run400Το payload δεν είναι 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Λειτουργία πιστοποιημένη, πληρωμένη άδεια και χωρίς πιστοποιητικόNo signing certificate configured.
run400Λειτουργία πιστοποιημένη με πιστοποιητικό εκτός του χρονικού πλαισίου ισχύοςThe signing certificate expired on yyyy-MM-dd. / The signing certificate is not valid before yyyy-MM-dd.
open, run500Η επεξεργασία απέτυχεΈνα αποκατεστημένο μήνυμα
download400Το token λείπει ή δεν είναι GUIDμόνο κατάσταση
download404Άγνωστο ή ληγμένο tokenμόνο κατάσταση

Μια πλήρης διαδρομή με fetch:

javascript
// file: το File για υπογραφή; pngBase64: η υπογραφή ως ακατέργαστο base64 PNG, χωρίς πρόθεμα data:,
// για παράδειγμα canvas.toDataURL('image/png').split(',')[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 σας και το script του widget από την ίδια προέλευση με το Doconut, ή κάντε reverse-proxy και στις δύο /doconut διαδρομές (τη διαδρομή του middleware και τη διαδρομή των πόρων) κάτω από την προέλευση του UI σας.

Σε παραγωγή

  1. Εγκαταστήστε το plugin δίπλα στο βασικό πακέτο, στην ίδια έκδοση: dotnet add package Doconut.NET8.Signer.

  2. Προσθέστε το αρχείο άδειας. Τοποθετήστε Doconut.Viewer.Signer.lic στον ίδιο φάκελο με το Doconut.Viewer.lic.

  3. Αποκτήστε το πιστοποιητικό σας ως PFX με το ιδιωτικό κλειδί και την αλυσίδα εκδότη, από μια αρχή πιστοποίησης ή το δικό σας PKI του οργανισμού. Για να δοκιμάσετε πρώτα, χρησιμοποιήστε μια demo άδεια (το ενσωματωμένο demo πιστοποιητικό, με υδατογράφημα) ή ένα αυτο-υπογεγραμμένο 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. Ελέγξτε το αρχικό log. Θα πρέπει να εμφανίζει using certificate '{subject}' (valid until …). Signatures are digitally sealed.. Ένα Warning σημαίνει ότι το πιστοποιητικό έχει λήξει, δεν είναι ακόμη έγκυρο, ή δεν εκδόθηκε για υπογραφή εγγράφων.

Εμπιστοσύνη σε αναγνώστες PDF. Ένας αναγνώστης εμφανίζει την υπογραφή ως έγκυρη όταν εμπιστεύεται τη ρίζα του πιστοποιητικού. Με το PKI του οργανισμού σας, αυτό ισχύει σε κάθε μηχάνημα που εμπιστεύεται τη ρίζα σας, η οποία συνήθως είναι κάθε μηχάνημα εντός του οργανισμού. Τα πιστοποιητικά που εμπιστεύεται η Adobe σε οποιοδήποτε μηχάνημα (η Adobe Approved Trust List) είναι, όσο γνωρίζουμε, εκδομένα με το ιδιωτικό κλειδί σε ένα hardware token ή HSM, το οποίο αυτό το plugin δεν μπορεί να χρησιμοποιήσει: υπογράφει μόνο από ένα PFX. Επιβεβαιώστε με τον πάροχο του πιστοποιητικού σας πριν βασιστείτε σε αυτό το είδος εμπιστοσύνης.

Συμπλέγματα Web

Το widget διατηρεί κάθε μεταφόρτωση και το αποτέλεσμα της στη μνήμη του κόμβου που εξυπηρέτησε το open. Πίσω από έναν φορτωτή ισορροπίας χωρίς sticky sessions, ένα μεταγενέστερο run, download ή αίτημα προεπισκόπησης μπορεί να φτάσει σε άλλο κόμβο και να μην βρει τη μεταφόρτωση. Καταχωρίστε το κοινόχρηστο, κρυπτογραφημένο αποθηκευτικό χώρο του widget μία φορά, μετά το AddDoconut():

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

builder.Services.AddDoconutDistributedWidgets(store =>
{
    store.RootPath = @"\\fileshare\doconut";   // ένας φάκελος που κάθε κόμβος μπορεί να διαβάσει και να γράψει
    store.FarmKey = farmKey;                   // τουλάχιστον 32 bytes, ταυτόσιος σε κάθε κόμβο
    // store.Ttl = TimeSpan.FromMinutes(30);   // πόσο διαρκεί η διατήρηση ενός upload (η προεπιλογή)
});
  • Ένας μόνος διακομιστής δεν χρειάζεται τίποτα: χωρίς αυτήν την κλήση χρησιμοποιείται η αποθήκη στη μνήμη.
  • Οι μεταφορτώσεις και τα αποτελέσματα κρυπτογραφούνται κατά την αποθήκευση στο κοινόχρηστο (AES-256, encrypt-then-MAC), και κάθε αρχείο συνδέεται με το token του, ώστε ένα token να μην μπορεί ποτέ να διαβάσει το αρχείο κάποιου άλλου.
  • Το FarmKey πρέπει να είναι τουλάχιστον 32 byte και το ίδιο σε κάθε κόμβο. Φορτώστε το από ένα μυστικό αποθηκευτικό χώρο· μην το κωδικοποιείτε σκληρά. Η καταχώριση ρίχνει ένα ArgumentException όταν το RootPath λείπει ή το FarmKey είναι μικρότερο από 32 byte.
  • Κατευθύνετε το RootPath στην ίδια κοινόχρηστη τοποθεσία που χρησιμοποιεί ο διανεμημένος viewer, και δώστε σε κάθε κόμβο το ίδιο πιστοποιητικό υπογραφής.

Αναφορά API

Η πρόσοψη και οι επιλογές του widget βρίσκονται στον χώρο ονομάτων 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);
}

Λαμβάνεται μέσω ένεσης εξαρτήσεων· ο κατασκευαστής είναι εσωτερικός. Το sourceExtension είναι ".pdf" ή ".docx". Με πληρωμένη άδεια το cert χρησιμοποιείται και η έξοδος είναι καθαρή· με προσωρινή άδεια το ενσωματωμένο demo πιστοποιητικό χρησιμοποιείται, το 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

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 σημαίνει το demo πιστοποιητικό με προσωρινή άδεια, και οι 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.Το widget είναι ενεργοποιημένο χωρίς το plugin τουΠροσθέστε 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 υπογραφές συνεχίζουν να λειτουργούν εν τω μεταξύ
Το log αναφέρει ότι η έξοδος "χρησιμοποιεί το ενσωματωμένο demo πιστοποιητικό", ωστόσο μια πληρωμένη άδεια απορρίπτει τις Certified υπογραφέςΑυτή η γραμμή γράφεται όποτε δεν έχει ρυθμιστεί πιστοποιητικό, ανεξάρτητα από την άδειαΡυθμίστε το SigningCertificate
Το widget φορτώνει αλλά εμφανίζει 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Στείλτε ένα ακατέργαστο base64 PNG εντός του ορίου
open απαντά 413 File is too large.Η μεταφόρτωση υπερβαίνει το MaxUploadMbΑναβάλετε το MaxUploadMb στο AddSignerWidget· το maxUploadMb του widget είναι μόνο έλεγχος στην πλευρά του πελάτη
run ή download απαντά 404 Upload expired — please re-open the file.Το παράθυρο των 30 λεπτών έληξε, ή ένας κόμβος web-farm δεν έχει τη μεταφόρτωσηΑνοίξτε ξανά το αρχείο· σε farm, καταχωρήστε το AddDoconutDistributedWidgets
Ένα υπογεγραμμένο .docx δεν εμφανίζει υπογραφή σε ορισμένους προβολείςΗ έξοδος Word περιέχει μια υπογραφή πακέτου OOXML, που πολλοί προβολείς δεν εμφανίζουνΥπογράψτε σε PDF, το προεπιλεγμένο
Οι αναγνώστες PDF λένε ότι η ταυτότητα του υπογράφοντα είναι άγνωστηΟ αναγνώστης δεν εμπιστεύεται τη ρίζα του πιστοποιητικού (το demo πιστοποιητικό δεν εμπιστεύεται ποτέ)Χρησιμοποιήστε ένα πιστοποιητικό από ρίζα που εμπιστεύονται οι αναγνώστες σας
Το widget αποτυγχάνει όταν το UI βρίσκεται σε διαφορετική προέλευσηΤα endpoints δεν έχουν υποστήριξη CORSΣερβίρετε το UI από την ίδια προέλευση, ή κάντε reverse-proxy τις διαδρομές Doconut
Το θέμα δεν εφαρμόζεταιΟ selector στοχεύει σε στοιχείο μέσα στο mountΣτοχεύστε το ίδιο το mount: #host.dsw ή #host

Ήταν αυτή η σελίδα χρήσιμη;