Πρόσθετο Υπογραφής
Υπογράψτε έγγραφα PDF και Word με ορατή υπογραφή και ψηφιακό σφραγίδα
Το πρόσθετο Signer τοποθετεί μια ορατή υπογραφή σε ένα έγγραφο και, εξ ορισμού, το σφραγίζει με ψηφιακή υπογραφή που μπορεί να επαληθεύσει ένας αναγνώστης PDF. Υπογράφει αρχεία PDF και Word (.docx). Η ορατή υπογραφή είναι πάντα μια εικόνα PNG: σχεδιασμένη, πληκτρολογημένη ή ανεβασμένη από τον υπογράφοντα.
| Επίφάνεια | Χρησιμοποιήστε το όταν |
|---|---|
DocumentSigner (C#) | Υπογράφετε στον διακομιστή, χωρίς να εμπλέκεται πρόγραμμα περιήγησης |
Drop-in widget (doconutSigner.js) | Θέλετε μια έτοιμη οθόνη ανεβάσματος, υπογραφής και λήψης στη σελίδα σας |
HTTP endpoints (?sign=open|run|download) | Δημιουργείτε το δικό σας UI υπογραφής ενάντια σε τεκμηριωμένη σύμβαση διακομιστή |
Κάθε υπογραφή τοποθετείται μία φορά, σε μία σελίδα. Το όνομα του υπογράφοντα, ο λόγος και η τοποθεσία μπορούν να μεταβιβαστούν μαζί της.
Εγκατάσταση του πακέτου
Εγκαταστήστε το πιο πρόσφατο σταθερό πρόσθετο Signer:
dotnet add package Doconut.NET6.SignerΓια να κλειδώσετε το πρόσθετο στην έκδοση που περιγράφει αυτή η τεκμηρίωση, περάστε την έκδοση ξεχωριστά:
dotnet add package Doconut.NET6.Signer --version 26.10.0Διατηρήστε το πακέτο Signer στην ίδια έκδοση με το Doconut.NET6. Το αναγνωριστικό πακέτου είναι Doconut.NET6.Signer· το .<version> εμφανίζεται μόνο στο ληφθέν όνομα αρχείου .nupkg.
Το αρχείο άδειας του πρόσθετου, Doconut.Viewer.Signer.lic, τοποθετείται στον ίδιο φάκελο με το Doconut.Viewer.lic· διαβάζεται μαζί με την άδεια του προβολέα.
Πλατφόρμες. Το πρόσθετο λειτουργεί όπου τρέχει το Doconut.NET6: Windows και Linux βασισμένο σε glibc σε x64 (όχι Alpine ή άλλες διανομές βασισμένες σε musl). Σε Linux, εγκαταστήστε τη βιβλιοθήκη διαμόρφωσης γραμματοσειρών πριν ανοίξει το πρώτο έγγραφο:
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():
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
});Αυτό είναι ό,τι χρειάζεται η διεπαφή C#. Το widget και τα HTTP endpoints του είναι μια ξεχωριστή επιλογή, AddSignerWidget() (δείτε το Ενσωματωμένο widget).
Το πρόσθετο χρειάζεται άδεια που παρέχει τη δυνατότητα Signer. Χωρίς αυτή, το AddDoconut() αποτυγχάνει κατά την εκκίνηση, πριν η εφαρμογή εξυπηρετήσει ένα αίτημα:
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. | Καθαρή |
| Πληρωμένη άδεια, πιστοποιητικό ληγμένο ή ακόμη μη έγκυρο | Ξεκινά (με το widget ενεργό, καταγράφεται Προειδοποίηση) | Απορρίπτεται: The signing certificate expired on yyyy-MM-dd. | Καθαρή |
| Προσωρινή άδεια Demo/NFR, ενεργή ή ληγμένη | Ξεκινά | Σφραγισμένη με το ενσωματωμένο demo πιστοποιητικό, υδατογραφημένη (watermarked: true) | Υδατογραφημένη |
Χωρίς άδεια, αρχείο legacy 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>().
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"), το αίτημα και το πιστοποιητικό για αυτήν την κλήση. Η πρόσοψη δεν διαβάζει SignerWidgetOptions.SigningCertificate· αυτή η ρύθμιση είναι για το widget. Περνάτε null υπό άδεια δοκιμής, ή σε Visual λειτουργία.
SignResult διατηρεί το υπογεγραμμένο έγγραφο ως ροή με δυνατότητα αναζήτησης, συν το Extension του (".pdf" ή ".docx") ώστε να μπορείτε να ονομάσετε το αρχείο. Είστε υπεύθυνοι για τη ροή: απελευθερώστε την όταν τελειώσετε.
Μια Visual υπογραφή σφραγίζει μόνο την εικόνα και δεν χρειάζεται πιστοποιητικό:
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:
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; // ".docx"SignAsync ρίχνει εξαίρεση αντί να επιστρέφει όταν η κλήση δεν μπορεί να ολοκληρωθεί:
| Εξαίρεση | Μήνυμα | Πότε |
|---|---|---|
InvalidOperationException | No signing certificate configured. | Κατάσταση Certified, πληρωμένη άδεια, και δεν περάστηκε πιστοποιητικό |
InvalidOperationException | The signing certificate expired on yyyy-MM-dd. / The signing certificate is not valid before yyyy-MM-dd. | Κατάσταση Certified με πιστοποιητικό εκτός του χρονικού του παραθύρου εγκυρότητας |
ArgumentException | The 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, ή μια τοποθέτηση που δεν είναι έγκυρη |
NotSupportedException | The signer supports PDF and Word (.docx) documents; got '{extension}'. | Οποιοσδήποτε άλλος τύπος πηγής |
Λειτουργίες υπογραφής, έξοδος Word και πιστοποιητικά
Λειτουργίες υπογραφής
SignRequest.Mode επιλέγει αν η υπογραφή είναι σφραγισμένη.
| Λειτουργία | Τι παράγει | Πιστοποιητικό | Επαληθεύσιμο |
|---|---|---|---|
SignatureMode.Certified (default) | Η ορατή υπογραφή συν ψηφιακή σφραγίδα | Απαιτείται υπό πληρωμένη άδεια | Ναι |
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 είτε μια διαδρομή, συν το κωδικό πρόσβασης:
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"],
};
});
});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 σηματοδοτούν την υπογραφή.
- Οι υλικοί διακριτικοί κώδικες, οι έξυπνες κάρτες, τα HSM και το αποθετήριο πιστοποιητικών των Windows δεν υποστηρίζονται. Εξάγετε το πιστοποιητικό, με το ιδιωτικό κλειδί και την αλυσίδα, σε ένα PFX.
Δημιουργήστε ένα PFX από ένα πιστοποιητικό και το ιδιωτικό του κλειδί με OpenSSL:
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 με το ιδιωτικό κλειδί |
Διαφορετικά, ο κεντρικός υπολογιστής γράφει μία γραμμή στο αρχείο καταγραφής όταν ξεκινά. Πληροφορίες όταν το πιστοποιητικό είναι έτοιμο:
Doconut Signer: using certificate '{subject}' (valid until yyyy-MM-dd). Signatures are digitally sealed.Μια Προειδοποίηση όταν είναι ληγμένο, ακόμη μη έγκυρο, ή δεν έχει εκδοθεί για υπογραφή εγγράφων:
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.Και Πληροφορίες όταν δεν έχει ρυθμιστεί πιστοποιητικό:
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 διαβάζεται όταν υπογράφετε, έτσι ένα λανθασμένο μονοπάτι ή κωδικός πρόσβασης αποτυγχάνει την κλήση.
Widget ενσωμάτωσης
Ενεργοποίηση των τελικών σημείων
Τα ?sign=open|run|download τελικά σημεία του widget είναι απενεργοποιημένα από προεπιλογή. Ενεργοποιήστε τα δίπλα στην καταχώριση του plugin:
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() προκαλεί εξαίρεση:
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. Το σενάριο εξακολουθεί να σερβίρεται, έτσι το widget φορτώνει και σχεδιάζει τη ζώνη του, μετά αναφέρει Signing is not enabled on this server. στην πρώτη του αίτηση.
Ενσωμάτωση
UseDoconutResources() σερβίρει το σενάριο στο {ResourcesPath}/js/doconutSigner.js (προεπιλογή /doconut-res/js/doconutSigner.js). Είναι ένα ενιαίο, αυτόνομο αρχείο χωρίς εξαρτήσεις:
<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 ή ένα στοιχείο, προκαλεί εξαίρεση αν δεν βρεθεί η τοποθέτηση, και επιστρέφει ένα χειριστή.
Ο υπογράφων ανεβάζει ένα αρχείο PDF ή .docx, δημιουργεί μια υπογραφή (Σχεδίαση σε καμβά, Πληκτρολόγηση ονόματος με γραμματοσειρά υπογραφής, ή Εικόνα από PNG, JPG ή GIF), το σύρει και το μεγεθύνει στη σελίδα, και υπογράφει και κατεβάζει το αποτέλεσμα. Το widget στέλνει πάντα την υπογραφή ως PNG· μια ανεβασμένη εικόνα μετατρέπεται στον περιηγητή σε PNG που ταιριάζει στο 520×160.
Επιλογές
| Επιλογή | Τύπος | Προεπιλογή | Σημειώσεις |
|---|---|---|---|
basePath | string | '/doconut' | Πού σερβίρονται τα τελικά σημεία ?sign= και οι εικόνες προεπισκόπησης |
resPath | string | '/doconut-res' | Κρατημένο· το widget περιλαμβάνει το δικό του CSS |
maxUploadMb | number | 25 | Έλεγχος μόνο στην πλευρά του πελάτη, έτσι ένα υπερμεγέθες αρχείο αποτυγχάνει άμεσα. Το όριο του διακομιστή είναι MaxUploadMb σε AddSignerWidget |
maxSignatureKb | number | 512 | Όριο στην πλευρά του πελάτη για τη λειτουργία Image. Κρατήστε το ίσο με το MaxSignatureImageKb του διακομιστή |
previewWidth | number | 560 | Πλάτος εικονοστοιχείου (pixel) της προεπισκόπησης σελίδας |
licenseUrl | string | null | null | Μετατρέπει την ειδοποίηση demo-watermark σε σύνδεσμο προς αυτό το URL |
signatureMode | string | 'certified' | Αρχικός τύπος υπογραφής: 'certified' ή 'visual'. Οποιαδήποτε άλλη τιμή γίνεται 'certified' |
showSignatureModeToggle | boolean | true | Εμφανίζει την επιλογή Ψηφιακή υπογραφή / Μόνο οπτική. Με false, το widget υπογράφει με signatureMode |
wordOutput | string | 'pdf' | Αρχική έξοδος για πηγές .docx: 'pdf' ή 'docx'. Οποιαδήποτε άλλη τιμή γίνεται 'pdf' |
showOutputFormatToggle | boolean | true | Εμφανίζει την επιλογή PDF / Word, μόνο για πηγές .docx. Με false, το widget χρησιμοποιεί wordOutput |
labels | object | {} | Αντικαθιστά οποιοδήποτε υποσύνολο των αγγλικών κειμένων |
Η απόκρυψη ενός εναλλαστή δεν απενεργοποιεί τη λειτουργία· καθορίζει την τιμή. Δύο κοινές ρυθμίσεις:
// Και οι δύο διακόπτες εμφανίζονται, ψηφιακή υπογραφή ως προεπιλογή: ένας πλήρης αυτό‑εξυπηρετούμενος υπογράφων.
Doconut.signer('#host', { basePath: '/doconut', licenseUrl: '/pricing' });// Μόνο οπτικό, χωρίς διακόπτη: μια απλή σφραγίδα χωρίς προσφορά ψηφιακής υπογραφής.
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 πολύ μεγάλο | { message } |
Μια κλήση που προκαλεί εξαίρεση πιάστηκε και καταγράφηκε· δεν διακόπτει ποτέ τη ροή του widget.
Απαιτητικός χειρισμός
| Μέθοδος | Συμπεριφορά |
|---|---|
reset() | Επιστρέφει στην οθόνη απόρριψης και καθαρίζει τη τρέχουσα ροή. Δεν ενεργοποιεί ξανά το onReady. Δεν κάνει τίποτα μετά το destroy() |
loadFile(file) | Ξεκινά τη ροή με ένα File. Δεν κάνει τίποτα εκτός εάν το widget βρίσκεται στην οθόνη απόρριψης· καλέστε το reset() πρώτα αν χρειάζεται |
destroy() | Αφαιρεί τους ακροατές, αδειάζει το mount και παγώνει την παρουσία |
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'.
| Κλειδί | Προεπιλογή Αγγλικών |
|---|---|
dropPrompt | Drag & drop a PDF or Word file here |
dropHint | PDF or Word (.docx) |
chooseFile | Choose file |
signatureHeading | Your signature |
modeDraw / modeType / modeImage | Draw / Type / Image |
metaSummary | Signature details (optional) |
metaSignerName / metaReason / metaLocation | Signer name / Reason / Location |
signatureType | Signature type |
modeCertified / modeVisual | Digital signature / Visual only |
modeVisualNote | No certificate — a visible mark only, not cryptographically verifiable. |
outputFormat | Output format |
outputPdf / outputWord | PDF / Word (.docx) |
signAction | Sign document |
download | Download |
demoNotice | Demo — signed with the Doconut demo certificate; output is watermarked. |
signingNotEnabled | Signing is not enabled on this server. |
page / pages | 1 page / {n} pages |
Περαιτέρω κλειδιά καλύπτουν το βήμα τοποθέτησης, την οθόνη σφάλματος, τη συνδεδεμένη μορφή της ειδοποίησης επίδειξης (demoNoticePrefix, demoNoticeLink, demoNoticeSuffix) και τις ανακοινώσεις aria-live.
Όταν το open ή το run απαντά το 404 χωρίς σφάλμα JSON, το widget εμφανίζει το signingNotEnabled. Ένα σφάλμα JSON από τον διακομιστή έχει πάντα προτεραιότητα, έτσι μηνύματα όπως μια ληγμένη μεταφόρτωση παραμένουν ορατά.
Θεματοποίηση
Το widget προσθέτει την κλάση dsw στο στοιχείο mount του και διαβάζει τα χρώματα, την ακτίνα και τις γραμματοσειρές του από προσαρμοσμένες ιδιότητες 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, 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"). Η προεπισκόπηση σελίδας χρησιμοποιεί τη στάνταρ διαδρομή εικόνας του viewer, {basePath}?token={token}&page={n}&thumb=1&width={px}· η εμφανιζόμενη σελίδα γίνεται placement.page.
Το σώμα run:
{
"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.kind | Drawn, 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 χαρακτήρες |
wordOutput | pdf (προεπιλογή) ή docx· αγνοείται για πηγές PDF. Οτιδήποτε άλλο γίνεται pdf |
mode | certified (προεπιλογή) ή visual. Οτιδήποτε άλλο γίνεται certified |
downloadName ακολουθεί την έξοδο: <source>-signed.pdf ή <source>-signed.docx, και το download στέλνει το αντίστοιχο Content-Type.
Το ανεβασμένο αρχείο προέλευσης και το υπογεγραμμένο αποτέλεσμα διατηρούνται για 30 λεπτά. Μετά από αυτό, τα run και download απαντούν 404 και το αρχείο πρέπει να ανοίξει ξανά. Όλα τα tokens είναι GUID.
| Διαδρομή | Κατάσταση | Όταν | Σώμα |
|---|---|---|---|
| any | 404 | Το widget δεν είναι ενεργοποιημένο | μόνο κατάσταση |
| any | 405 | Λάθος ρήμα (open και run χρειάζονται POST, download χρειάζεται GET) | μόνο κατάσταση |
open | 400 | Δεν είναι multipart ανέβασμα | Expected a multipart file upload. |
open | 400 | Δεν υπάρχει αρχείο ή είναι κενό | No file uploaded. |
open | 400 | Οτιδήποτε άλλο εκτός από .pdf ή .docx | Signing supports PDF and Word (.docx) files only. |
open | 413 | Το ανέβασμα υπερβαίνει το MaxUploadMb | File is too large. |
run | 400 | Το σώμα δεν είναι έγκυρο JSON ή είναι κενό | Malformed request. / Empty request. |
run | 400 | Το token λείπει ή δεν είναι GUID | Invalid token. |
run | 404 | Το ανέβασμα έληξε ή δεν ανοίχθηκε ποτέ | Upload expired — please re-open the file. |
run | 400 | Δεν υπάρχει υπογραφή ή δεν υπάρχει τοποθέτηση | No signature supplied. / No placement supplied. |
run | 400 | Το payload δεν είναι base64, είναι κενό, πολύ μεγάλο ή δεν είναι PNG | Signature image is not valid base64. / Signature image is empty. / Signature image is too large. / The signature image must be a PNG. |
run | 400 | Η τοποθέτηση είναι εκτός της σελίδας | The signature or its placement is invalid. |
run | 400 | Λειτουργία πιστοποιημένη, πληρωμένη άδεια και χωρίς πιστοποιητικό | No signing certificate configured. |
run | 400 | Λειτουργία πιστοποιημένη με πιστοποιητικό εκτός του χρονικού πλαισίου εγκυρότητας | The signing certificate expired on yyyy-MM-dd. / The signing certificate is not valid before yyyy-MM-dd. |
open, run | 500 | Η επεξεργασία απέτυχε | Ένα αποκαθαρισμένο μήνυμα |
download | 400 | Το token λείπει ή δεν είναι GUID | μόνο κατάσταση |
download | 404 | Άγνωστο ή ληγμένο token | μόνο κατάσταση |
Μια πλήρης διαδρομή με fetch:
// file: το File για υπογραφή; pngBase64: η υπογραφή ως ακατέργαστο base64 PNG, χωρίς πρόθεμα data: prefix,
// για παράδειγμα 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 σας.
Σε παραγωγή
-
Εγκαταστήστε το plugin δίπλα στο βασικό πακέτο, στην ίδια έκδοση:
dotnet add package Doconut.NET6.Signer. -
Προσθέστε το αρχείο άδειας. Τοποθετήστε το
Doconut.Viewer.Signer.licστον ίδιο φάκελο με τοDoconut.Viewer.lic. -
Αποκτήστε το πιστοποιητικό σας ως PFX με το ιδιωτικό κλειδί και την αλυσίδα εκδότη, από μια αρχή πιστοποιητικών ή το δικό σας PKI οργανισμού. Για να δοκιμάσετε πρώτα, χρησιμοποιήστε μια demo άδεια (το ενσωματωμένο demo πιστοποιητικό, με υδατογράφημα) ή ένα αυτό-υπογεγραμμένο PFX.
-
Διαβάστε το πιστοποιητικό από τη διαμόρφωση, ώστε η αλλαγή του να μην απαιτεί ποτέ αλλαγή κώδικα:
json"DoconutSigner": { "PfxPath": "certs/your-certificate.pfx" }csharpvar 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) ή μια θυρίδα στην παραγωγή. -
Ελέγξτε το αρχικό log. Θα πρέπει να εμφανίζει
using certificate '{subject}' (valid until …). Signatures are digitally sealed.. Ένα Warning αντί αυτού σημαίνει ότι το πιστοποιητικό έχει λήξει, δεν είναι ακόμη έγκυρο, ή δεν έχει εκδοθεί για υπογραφή εγγράφων.
Εμπιστοσύνη σε αναγνώστες PDF. Ένας αναγνώστης εμφανίζει την υπογραφή ως έγκυρη όταν εμπιστεύεται τη ρίζα του πιστοποιητικού. Με το PKI του οργανισμού σας, αυτό ισχύει σε κάθε μηχάνημα που εμπιστεύεται τη ρίζα σας, που συνήθως είναι κάθε μηχάνημα εντός του οργανισμού. Τα πιστοποιητικά που εμπιστεύεται η Adobe σε οποιοδήποτε μηχάνημα (η Adobe Approved Trust List) είναι, όσο γνωρίζουμε, εκδοθέντα με το ιδιωτικό κλειδί σε ένα hardware token ή HSM, το οποίο αυτό το plugin δεν μπορεί να χρησιμοποιήσει: υπογράφει μόνο από ένα PFX. Επιβεβαιώστε με τον πάροχο του πιστοποιητικού σας πριν βασιστείτε σε αυτό το είδος εμπιστοσύνης.
Φάρμες ιστού
Το widget διατηρεί κάθε μεταφόρτωση και το αποτέλεσμα της στη μνήμη στον κόμβο που εξυπηρέτησε το open. Πίσω από έναν φορτωτή ισορροπίας χωρίς sticky sessions, ένα μεταγενέστερο run, download ή αίτημα προεπισκόπησης μπορεί να φτάσει σε άλλο κόμβο και να μην βρει τη μεταφόρτωση. Καταχωρίστε το κοινόχρηστο, κρυπτογραφημένο κατάστημα widget μία φορά, μετά το AddDoconut():
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); // πόσο διαρκεί η αποθήκευση ενός ανεβασμένου αρχείου (η προεπιλογή)
});- Ένας μόνος διακομιστής δεν χρειάζεται τίποτα: χωρίς αυτήν την κλήση χρησιμοποιείται η αποθήκη στη μνήμη.
- Οι μεταφορτώσεις και τα αποτελέσματα κρυπτογραφούνται κατά την αποθήκευση στο κοινόχρηστο (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
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
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
public sealed record VisibleSignature(SignatureKind Kind, byte[] PngBytes)
{
public bool IsValid { get; } // PngBytes δεν είναι κενό
}
public enum SignatureKind { Drawn, Typed, Image }Το PngBytes είναι PNG για κάθε τύπο. Μια σχεδιασμένη ή πληκτρολογημένη υπογραφή είναι διαφανής· μια ανεβασμένη εικόνα διατηρεί τη διαφάνειά της, έτσι ένα αδιαφανές JPG παραμένει αδιαφανές. Το Kind είναι μόνο υπόδειξη.
SignaturePlacement
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
public enum SignatureMode { Certified, Visual } // Certified είναι η προεπιλογή
public enum WordOutput { Pdf, Docx } // Pdf είναι η προεπιλογή; αγνοείται για πηγές PDFSignResult
public sealed record SignResult(Stream Stream, string Extension);Το υπογεγραμμένο έγγραφο ως ροή με δυνατότητα αναζήτησης, και η επέκτασή του με την τελεία (".pdf" ή ".docx").
SigningCertificate
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
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 πιστοποιητικό με προσωρινή άδεια, και οι οπτικές υπογραφές μόνο με πληρωμένη άδεια.
Επίλυση προβλημάτων
| Σύμπτωμα | Αιτία | Διόρθωση |
|---|---|---|
AddDoconut() throws The Signer plugin is registered via AddPlugin but no active license grants Signer. | Καμία άδεια, αρχείο TRIAL, άδεια χωρίς Signer, ή πληρωμένη άδεια εκτός του χρονικού παραθύρου έκδοσής της | Εγκαταστήστε άδεια που παρέχει Signer, ή αφαιρέστε το AddPlugin<SignerPlugin>() |
AddDoconut() throws AddSignerWidget() was called but the Signer plugin is not registered. | Το widget είναι ενεργοποιημένο χωρίς το plugin του | Προσθέστε options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>() |
AddDoconut() throws Doconut Signer: the certificate file was not found at '{path}'. | PfxPath δείχνει σε ένα αρχείο που λείπει | Διορθώστε τη διαδρομή· αναπτύξτε το αρχείο όπου ο λογαριασμός της εφαρμογής μπορεί να το διαβάσει |
AddDoconut() throws 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() throws 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. | Πληρωμένη άδεια, Πιστοποιημένη λειτουργία, και χωρίς πιστοποιητικό | Ρυθμίστε το SigningCertificate, ή υπογράψτε σε Οπτική λειτουργία |
run απαντά 400 The signing certificate expired on yyyy-MM-dd. | Το πιστοποιητικό είναι παλιό | Αντικαταστήστε το· οι οπτικές υπογραφές συνεχίζουν να λειτουργούν εν τω μεταξύ |
| Το log αναφέρει ότι η έξοδος «χρησιμοποιεί το ενσωματωμένο demo πιστοποιητικό», όμως μια πληρωμένη άδεια απορρίπτει τις Πιστοποιημένες υπογραφές | Αυτή η γραμμή γράφεται όποτε δεν έχει ρυθμιστεί πιστοποιητικό, ανεξαρτήτως άδειας | Ρυθμίστε το 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 |
Ήταν αυτή η σελίδα χρήσιμη;