Signer-Plugin

Signieren Sie PDF- und Word-Dokumente mit einer sichtbaren Signatur und einem digitalen Siegel

Das Signer-Plugin platziert eine sichtbare Signatur auf einem Dokument und versiegelt es standardmäßig mit einer digitalen Signatur, die ein PDF‑Reader überprüfen kann. Es signiert PDF und Word (.docx) Dateien. Die sichtbare Signatur ist immer ein PNG‑Bild: gezeichnet, getippt oder vom Unterzeichner hochgeladen.

OberflächeWann verwenden
DocumentSigner (C#)Sie signieren auf dem Server, ohne dass ein Browser beteiligt ist
Drop-in widget (doconutSigner.js)Sie möchten einen fertigen Upload-, Signatur- und Download‑Bildschirm in Ihrer Seite
HTTP endpoints on DocImage.axd (?sign=open|run|download)Sie bauen Ihre eigene Signatur‑UI gegen einen dokumentierten Server‑Vertrag

Jede Signatur wird einmal, auf einer Seite, platziert. Der Name des Unterzeichners, der Grund und der Ort können mit ihr mitgereist werden.

Paket installieren

powershell
Install-Package Doconut.NETFramework.Signer

Um das Plugin an die in dieser Dokumentation beschriebene Version zu binden:

powershell
Install-Package Doconut.NETFramework.Signer -Version 26.10.0

Halten Sie das Signer-Paket in derselben Version wie Doconut.NETFramework.

Die Lizenzdatei des Plugins, Doconut.Viewer.Signer.lic, kommt in denselben Ordner wie Doconut.Viewer.lic; sie wird zusammen mit der Viewer‑Lizenz gelesen.

Plugin registrieren

Wie jedes Doconut-Plugin registriert sich Signer bei AddPlugin<TPlugin>() in DoconutHost.Initialize, aufgerufen von Application_Start:

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
    options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
});

Fügen Sie Doconut.DoconutHost.Shutdown() zu Application_End hinzu, damit Hintergrundarbeiten beim Recyceln des Anwendungspools sauber gestoppt werden.

Das ist alles, was die C#‑Fassade benötigt. Das Widget und seine HTTP‑Endpunkte sind ein separates Opt‑In, AddSignerWidget() (siehe Drop-in widget).

Das Plugin benötigt eine Lizenz, die die Signer‑Funktionalität gewährt. Ohne diese wirft DoconutHost.Initialize von Application_Start:

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.

In System.Web bedeutet das, dass jede Anfrage ein leeres 500 zurückgibt, und der Grund nur im Windows‑Ereignisprotokoll (Quelle ASP.NET) zu finden ist. Es wirft bei fehlender Lizenz, einer veralteten TRIAL‑Datei, einer Lizenz ohne Signer und einer kostenpflichtigen Lizenz, die außerhalb ihres Versionsfensters verwendet wird. Temporäre Demo/NFR‑Lizenzen werden akzeptiert. Siehe Lizenzsetup.

Lizenzierung & Wasserzeichen

LizenzstatusStartZertifizierte SignaturVisuelle Signatur
Kostenpflichtige Lizenz, die Signer gewährt, Zertifikat konfiguriertStartetVersiegelt mit Ihrem Zertifikat, sauber (watermarked: false)Sauber
Kostenpflichtige Lizenz, die Signer gewährt, kein ZertifikatStartetAbgelehnt: No signing certificate configured.Sauber
Kostenpflichtige Lizenz, Zertifikat abgelaufen oder noch nicht gültigStartetAbgelehnt: The signing certificate expired on yyyy-MM-dd.Sauber
Temporäre Demo/NFR‑Lizenz, aktiv oder abgelaufenStartetVersiegelt mit dem integrierten Demo‑Zertifikat, mit Wasserzeichen (watermarked: true)Mit Wasserzeichen
Keine Lizenz, eine veraltete TRIAL‑Datei, eine Lizenz ohne Signer, oder eine kostenpflichtige Lizenz außerhalb ihres VersionsfenstersApplication_Start wirft; jede Anfrage gibt ein leeres 500 zurück——

Die Regel ist für die C#‑Fassade und das Widget identisch: Die Ausgabe wird mit einem Wasserzeichen versehen, wenn die Lizenz keine kostenpflichtige Viewer‑Lizenz ist oder temporär ist. Unter einer temporären Lizenz signiert das Plugin stets mit dem integrierten Demo‑Zertifikat, und jedes von Ihnen konfigurierte Zertifikat wird nicht verwendet.

Das Demo‑Zertifikat erzeugt ein echtes Siegel, aber PDF‑Reader vertrauen ihm nicht. Eine Integration kann end‑to‑end auf einer Evaluations‑Lizenz aufgebaut und getestet werden; um eine saubere, vertrauenswürdige Ausgabe zu erhalten, benötigen Sie sowohl eine kostenpflichtige Lizenz als auch Ihr eigenes Signaturzertifikat.

Verwendung aus C#

DocumentSigner wird von DoconutHost.Initialize registriert; löse es von DoconutHost.Services auf. Sein Konstruktor ist intern, also nie new es. Das Auflösen ohne AddPlugin<SignerPlugin>() wirft 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");
        // Modus ist standardmäßig Certified (sichtbare Signatur + digitales Siegel); WordOutput ist standardmäßig Pdf.

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

SignAsync nimmt den Quellstream, seine Erweiterung (".pdf" oder ".docx"), die Anfrage und das Zertifikat für diesen Aufruf. Die Fassade liest SignerWidgetOptions.SigningCertificate nicht; diese Einstellung ist für das Widget. Übergebe null unter einer Demo‑Lizenz oder im Visual‑Modus.

SignResult hält das signierte Dokument als seekbaren Stream, plus sein Extension (".pdf" oder ".docx"), sodass Sie die Datei benennen können. Sie besitzen den Stream: Entsorgen Sie ihn, wenn Sie fertig sind.

In einem MVC 5-Controller

Machen Sie die Aktion asynchron und await die Signatur. Diese versieht eine Visual‑Signatur, die kein Zertifikat benötigt:

csharp
[HttpPost]
public async Task<ActionResult> Sign(HttpPostedFileBase file)
{
    var signer = Doconut.DoconutHost.Services.GetRequiredService<DocumentSigner>();
    byte[] signaturePng = System.IO.File.ReadAllBytes(Server.MapPath("~/App_Data/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(
        file.InputStream, Path.GetExtension(file.FileName), request, ct: Response.ClientDisconnectedToken);
    string contentType = result.Extension == ".pdf"
        ? "application/pdf"
        : "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
    return File(result.Stream, contentType, Path.GetFileNameWithoutExtension(file.FileName) + "-signed" + result.Extension);
}

Eine Word‑Quelle wird zu PDF signiert, es sei denn, Sie verlangen Word‑Ausgabe. Benennen Sie das Ergebnis von result.Extension:

csharp
var signer = Doconut.DoconutHost.Services.GetRequiredService<DocumentSigner>();
byte[] signaturePng = File.ReadAllBytes(HostingEnvironment.MapPath("~/App_Data/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 wirft eine Ausnahme, anstatt zurückzugeben, wenn der Aufruf nicht erfolgreich sein kann:

AusnahmeNachrichtWann
InvalidOperationExceptionNo signing certificate configured.Zertifizierter Modus, eine kostenpflichtige Lizenz und kein Zertifikat übergeben
InvalidOperationExceptionThe signing certificate expired on yyyy-MM-dd. / The signing certificate is not valid before yyyy-MM-dd.Zertifizierter Modus mit einem Zertifikat außerhalb seines Gültigkeitszeitraums
ArgumentExceptionThe sign request is invalid: the visible signature needs PNG bytes and the placement must be a normalized rectangle on a 1-based page.Leere PNG‑Bytes oder eine Platzierung, die nicht gültig ist
NotSupportedExceptionThe signer supports PDF and Word (.docx) documents; got '{extension}'.Beliebiger anderer Quelltyp

Signiermodi, Word‑Ausgabe und Zertifikate

Signiermodi

SignRequest.Mode wählt, ob die Signatur versiegelt wird.

ModusWas es erzeugtZertifikatVerifizierbar
SignatureMode.Certified (default)Die sichtbare Signatur plus ein digitales SiegelErforderlich bei einer kostenpflichtigen LizenzJa
SignatureMode.VisualNur die sichtbare SignaturNiemals benötigtNein: es ist ein Bild

Verwenden Sie Certified, wenn die Signatur nachweisbar sein muss: Genehmigungen, Verträge, alles, was ein Prüfer zur Überprüfung von Identität und Integrität benötigt. Verwenden Sie Visual, wenn Sie nur das Aussehen einer Signatur benötigen oder kein Zertifikat haben. Eine temporäre Lizenz versieht beide mit einem Wasserzeichen.

PDF‑Siegel sind PKCS#7 abgetrennte Signaturen (adbe.pkcs7.detached) mit SHA-256, für RSA‑ oder ECDSA‑Schlüssel. Sie enthalten die Ausstellerzertifikate aus Ihrem PFX, sodass ein Leser, der Ihrer Stammzertifizierungsstelle vertraut, die Kette aufbauen kann. Word‑native Siegel sind OOXML‑Paket‑Signaturen und enthalten nur das Signaturzertifikat des Unterzeichners.

Word‑Dokumente

Für eine .docx‑Quelle wählt SignRequest.WordOutput die Ausgabe. Sie wird für PDF‑Quellen ignoriert, die immer ein PDF erzeugen.

AusgabeWas passiertUnterstützung durch Prüfer
WordOutput.Pdf (default)Das Dokument wird in PDF konvertiert, dann signiert und versiegeltBreit: ein signiertes PDF wird überall verifiziert
WordOutput.DocxDas Dokument bleibt Word: das Signaturbild wird darin platziert, plus eine OOXML‑Paket‑SignaturBegrenzt: nicht jeder Betrachter zeigt OOXML‑Paket‑Signaturen

Behalten Sie PDF, es sei denn, der Empfänger benötigt eine editierbare Word‑Datei und akzeptiert die eingeschränkte Prüferunterstützung.

Zertifikatseinrichtung

Um mit Ihrer eigenen Identität zu versiegeln, geben Sie dem Plugin eine PFX (PKCS#12)‑Datei, die den privaten Schlüssel enthält. Für das Widget setzen Sie SignerWidgetOptions.SigningCertificate; für die C#‑Fassade übergeben Sie das Zertifikat an SignAsync. Geben Sie entweder die Bytes oder einen Pfad an, plus das Passwort. App_Data ist ein guter Ort für die Datei, weil IIS sie nie ausliefert:

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
    options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
    options.AddSignerWidget(widget =>
    {
        widget.SigningCertificate = new SigningCertificate
        {
            PfxBytes = File.ReadAllBytes(HostingEnvironment.MapPath("~/App_Data/signing.pfx")),
            Password = System.Configuration.ConfigurationManager.AppSettings["DoconutSigner:Password"] ?? "",
        };
    });
});
csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
    options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
    options.AddSignerWidget(widget =>
    {
        widget.SigningCertificate = new SigningCertificate
        {
            PfxPath = HostingEnvironment.MapPath("~/App_Data/signing.pfx"),
            Password = System.Configuration.ConfigurationManager.AppSettings["DoconutSigner:Password"] ?? "",
        };
    });
});

Die Eigenschaften von SigningCertificate sind nur initialisierbar, was C# 7.3 (der Standard für .NET‑Framework‑Projekte) nicht setzen kann. Setzen Sie <LangVersion> auf 9.0 oder höher in der Projektdatei.

Das Zertifikat wird nur im Speicher gehalten. Es wird niemals protokolliert, an einen Client zurückgegeben oder gespeichert, und das Passwort erscheint nie in einer Fehlermeldung.

Anforderungen:

  • Ein PFX / PKCS#12‑Bundle mit seinem privaten Schlüssel. Eine Nur‑Public‑Key‑Datei (.cer, .crt) kann nicht signieren. Exportieren Sie die Ausstellerkette damit, sodass PDF‑Siegel sie tragen können.
  • Das korrekte Passwort.
  • Innerhalb seines Gültigkeitszeitraums. Ein abgelaufenes oder noch nicht gültiges Zertifikat stoppt die Anwendung nicht, aber Certified‑Signaturen werden abgelehnt, bis es ersetzt wird. Visual‑Signaturen sind davon nicht betroffen.
  • Für Dokumentensignatur ausgestellt: eine Schlüsselverwendung mit digital signature oder non-repudiation und, falls vorhanden, einer erweiterten Schlüsselverwendung, die Dokumentensignatur, E‑Mail‑Schutz oder Client‑Authentifizierung erlaubt. Ein Zertifikat, das für etwas anderes ausgestellt wurde, z. B. ein TLS‑Serverzertifikat, signiert weiterhin, aber PDF‑Reader kennzeichnen die Signatur.
  • Hardware‑Token, Smartcards, HSMs und der Windows‑Zertifikatspeicher werden nicht unterstützt. Exportieren Sie das Zertifikat mit seinem privaten Schlüssel und der Kette in ein PFX.

Erstellen Sie ein PFX aus einem Zertifikat und seinem privaten Schlüssel mit OpenSSL:

bash
openssl pkcs12 -export -out signing.pfx -inkey private.key -in certificate.crt
# Das Export-Passwort, nach dem Sie gefragt werden, ist SigningCertificate.Password.

Exportieren Sie eines aus dem Windows‑Zertifikatspeicher: Öffnen Sie certmgr.msc und suchen Sie das Zertifikat (sein Symbol zeigt einen Schlüssel, wenn der private Schlüssel vorhanden ist). Rechtsklicken Sie darauf, wählen Sie Alle Aufgaben → Exportieren…, wählen Sie Ja, privaten Schlüssel exportieren, wählen Sie Personal Information Exchange – PKCS #12 (.PFX) und setzen Sie ein Passwort.

Startprüfungen

Wenn das Widget aktiviert ist, wird das Zertifikat in SignerWidgetOptions.SigningCertificate einmal geprüft, innerhalb von DoconutHost.Initialize, sodass ein falsch konfiguriertes PFX bereits beim Start fehlschlägt und nicht erst bei der ersten Signatur. Drei Probleme werfen ein InvalidOperationException von Application_Start, und jede Anfrage beantwortet dann ein leeres 500; die Meldung befindet sich im Windows‑Ereignisprotokoll:

NachrichtLösung
Doconut Signer: the certificate file was not found at '{path}'.Korrigieren Sie PfxPath; stellen Sie sicher, dass die Datei bereitgestellt und vom Konto des Anwendungspools lesbar ist
Doconut Signer: the signing certificate could not be opened — the password is incorrect or the file is not a valid .pfx.Überprüfen Sie das Passwort; stellen Sie sicher, dass die Datei ein echtes .pfx ist, nicht ein .cer oder .pem
Doconut Signer: the signing certificate has no private key. Re-export the .pfx INCLUDING the private key.Exportieren Sie das PFX erneut mit dem privaten Schlüssel

Unter ASP.NET Core protokolliert der Host beim Start ebenfalls eine Zeile, in der das Zertifikat benannt wird, oder eine Warnung, dass es abgelaufen ist oder nicht zum Signieren ausgestellt wurde. DoconutHost schreibt diese Zeile nicht, daher prüfen Sie unter .NET Framework ein neues Zertifikat, indem Sie ein Testdokument im zertifizierten Modus signieren.

Die C#‑Fassade wird beim Start nicht geprüft. Das Zertifikat, das Sie an SignAsync übergeben, wird beim Signieren gelesen, sodass ein falscher Pfad oder ein falsches Passwort diesen Aufruf fehlschlagen lässt.

Drop-in-Widget

Endpunkte aktivieren

Die ?sign=open|run|download-Endpunkte des Widgets werden von DocImage.axd bereitgestellt und sind standardmäßig deaktiviert. Aktivieren Sie sie neben der Plugin‑Registrierung:

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
    options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
    options.AddSignerWidget(widget =>
    {
        widget.MaxUploadMb = 25;           // der Standard
        widget.MaxSignatureImageKb = 512;  // der Standard
        // widget.SigningCertificate: siehe Zertifikatsetup; lassen Sie es null für Demo (wassergekennzeichnet) Signatur
    });
});
// System.Web liest den gesamten Upload, bevor Doconut ihn sieht: behalten Sie maxRequestLength (KB) und
// maxAllowedContentLength (bytes) in Web.config über dem widget's MaxUploadMb.

AddSignerWidget() ohne Argument aktiviert das Widget mit den Standardwerten. Es gewährt nicht von selbst das Signieren: es benötigt AddPlugin<SignerPlugin>(), oder DoconutHost.Initialize wirft:

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.

Die Endpunkte und das Skript werden vom Handler und dem in Web.config registrierten Modul bereitgestellt:

xml
<system.webServer>
  <handlers>
    <add name="DocImage" verb="GET,HEAD,POST" path="DocImage.axd" type="Doconut.DocImageHandler, Doconut" />
  </handlers>
  <modules>
    <add name="DoconutResources" type="Doconut.DoconutResourceModule, Doconut" />
  </modules>
</system.webServer>

Das Modul liefert das Skript, unabhängig davon, ob das Widget aktiviert ist. Ohne AddSignerWidget() lädt das Widget und zeichnet seine Drop‑Zone, und seine erste Anfrage beantwortet 404: das Widget meldet dann Signing is not enabled on this server.

Upload‑Grenzen

ASP.NET liest den gesamten Anforderungstext, bevor DocImage.axd ausgeführt wird. Ein Upload über MaxUploadMb, aber unter den Host‑Grenzen, erhält das eigene JSON des Widgets 413 (File is too large.). Ein Upload über die Host‑Grenzen wird zuerst von IIS abgelehnt, mit einer Fehlermeldungsseite, die das Widget nicht lesen kann. Halten Sie beide Host‑Grenzen über der Obergrenze des Widgets:

xml
<system.web>
  <httpRuntime maxRequestLength="30720" />           <!-- KILOBYTES: 30 MB -->
</system.web>
<system.webServer>
  <security>
    <requestFiltering>
      <requestLimits maxAllowedContentLength="31457280" />  <!-- BYTES: 30 MB -->
    </requestFiltering>
  </security>
</system.webServer>

Ein Upload, der ohne ein Content-Length (chunked) gesendet wird und die Host‑Grenzen überschreitet, erhält ebenfalls die IIS‑Fehlerseite; dafür gibt es keine Umgehungslösung.

Einbetten

Das Skript wird unter /doconut-res/js/doconutSigner.js bereitgestellt. Es ist eine einzelne, eigenständige Datei ohne Abhängigkeiten. Zeigen Sie basePath auf den Handler:

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

Doconut.signer(selectorOrElement, options) nimmt einen CSS-Selektor oder ein Element, wirft einen Fehler, wenn das Mount nicht gefunden wird, und gibt ein Handle zurück. Der Standard-basePath des Widgets, /doconut, ist der ASP.NET Core-Endpunkt; in diesem Paket muss er '/DocImage.axd' sein.

Der Unterzeichner lädt ein PDF oder eine .docx-Datei hoch, erstellt eine Signatur (Zeichnen auf einer Leinwand, Tippen einen Namen in einer Signatur-Schriftart oder Bild aus einer PNG, JPG oder GIF), zieht sie auf die Seite, ändert die Größe und signiert und lädt das Ergebnis herunter. Das Widget sendet die Signatur immer als PNG; ein hochgeladenes Bild wird im Browser in ein PNG konvertiert, das 520×160 passt.

Optionen

OptionTypStandardHinweise
basePathstring'/doconut'Wo die ?sign=-Endpunkte und Vorschaubilder bereitgestellt werden. Setzen Sie '/DocImage.axd' in diesem Paket
resPathstring'/doconut-res'Reserviert; das Widget enthält sein eigenes CSS
maxUploadMbnumber25Nur clientseitige Prüfung, sodass eine zu große Datei sofort fehlschlägt. Das Server-Limit beträgt MaxUploadMb in AddSignerWidget
maxSignatureKbnumber512Clientseitiges Limit für den Bildmodus. Halten Sie es gleich dem Server-MaxSignatureImageKb
previewWidthnumber560Pixelbreite der Seitenvorschau
licenseUrlstring | nullnullWandelt den Demo-Wasserzeichen-Hinweis in einen Link zu dieser URL um
signatureModestring'certified'Initialer Signaturtyp: 'certified' oder 'visual'. Jeder andere Wert wird zu 'certified'
showSignatureModeTogglebooleantrueZeigt die Auswahl Digitale Signatur / Nur visuell. Mit false signiert das Widget mit signatureMode
wordOutputstring'pdf'Initiale Ausgabe für .docx-Quellen: 'pdf' oder 'docx'. Jeder andere Wert wird zu 'pdf'
showOutputFormatTogglebooleantrueZeigt die Auswahl PDF / Word, nur für .docx-Quellen. Mit false verwendet das Widget wordOutput
labelsobject{}Überschreibt beliebige Teilmenge der englischen Zeichenketten

Das Ausblenden eines Schalters deaktiviert die Funktion nicht; es fixiert den Wert. Zwei gängige Konfigurationen:

javascript
// Beide Umschalter angezeigt, digitale Signatur standardmäßig: ein vollständiger Selbstbedienungsunterzeichner.
Doconut.signer('#host', { basePath: '/DocImage.axd', licenseUrl: '/pricing' });
javascript
// Nur visuell, kein Umschalter: ein einfacher Stempel ohne digitale Signatur angeboten.
Doconut.signer('#host', {
  basePath: '/DocImage.axd',
  signatureMode: 'visual',
  showSignatureModeToggle: false
});

Rückrufe

RückrufWird ausgelöst, wennNutzdaten
onReadyEinmal beim Mount (nicht erneut bei reset())—
onSourceLoadedDie Datei wird geöffnet und ihre Vorschau angezeigt{ file: { token, name, pages, ext } }
onSignedSignatur erfolgreich{ downloadToken, downloadName, watermarked }
onDownloadBei jedem Klick auf Download{ downloadName, downloadToken }
onErrorEin Öffnen-, Signatur- oder Download-Schritt schlägt fehl, oder eine Bildmodus-Datei ist zu groß{ message }

Ein Rückruf, der einen Fehler wirft, wird abgefangen und protokolliert; er unterbricht den Ablauf des Widgets nie.

Imperativer Zugriff

MethodeVerhalten
reset()Kehrt zum Drop-Bildschirm zurück und löscht den aktuellen Ablauf. Löst onReady nicht erneut aus. Keine Aktion nach destroy()
loadFile(file)Startet den Ablauf mit einem File. Keine Aktion, sofern das Widget nicht auf seinem Drop-Bildschirm ist; rufen Sie bei Bedarf zuerst reset() auf
destroy()Entfernt die Listener, leert das Mount und friert die Instanz ein
javascript
const signerWidget = Doconut.signer('#host', {
  basePath: '/DocImage.axd',
  onSigned: (result) => console.log('signed', result.downloadName, result.watermarked),
  onError: (error) => console.warn(error.message)
});
document.getElementById('start-over').addEventListener('click', () => signerWidget.reset());

Bezeichnungen

Jeder String hat einen englischen Standard; labels überschreibt jede Teilmenge und der Rest bleibt Englisch. Fragmente, die zur Laufzeit geändert werden, verwenden {placeholders}, wie zum Beispiel uploading: 'Uploading {name}…' und pages: '{n} pages'.

SchlüsselEnglischer Standard
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

Weitere Schlüssel decken den Platzierungsschritt, den Fehlerschirm, das verknüpfte Formular des Demo‑Hinweises (demoNoticePrefix, demoNoticeLink, demoNoticeSuffix) und die aria-live Ankündigungen ab.

Wenn open oder run 404 ohne JSON‑Fehler beantwortet, zeigt das Widget signingNotEnabled. Ein JSON‑Fehler vom Server hat immer Vorrang, sodass Meldungen wie ein abgelaufener Upload sichtbar bleiben.

Themen

Das Widget fügt dem Montage‑Element die Klasse dsw hinzu und liest seine Farben, Radius und Schriftarten aus CSS‑Custom‑Properties, sodass du es thematisieren kannst, ohne seine Interna zu berühren:

css
#host.dsw {
  --dsw-accent: #b0522b;       /* Links, Fokus, aktiver Modus */
  --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;   /* der Type-Modus */
}

Standardwerte: --dsw-accent: #2b6cb0, --dsw-bg: #ffffff, --dsw-fg: #1a202c, --dsw-muted: #718096, --dsw-border: #cbd5e0, --dsw-radius: 8px, eine System‑UI‑Schrift und eine kursive Signaturschrift.

Erstelle dein eigenes Frontend

Das Widget ist ein Client für diesen HTTP‑Vertrag auf DocImage.axd. Die Routen beantworten 404, bis AddSignerWidget() aufgerufen wird. Fehler enthalten einen JSON‑Body, { "error": "..." }, außer dort, wo die Tabelle „nur Status“ angibt. Ein unbekannter ?sign=‑Wert beantwortet 400.

RouteZweckErfolgsantwort
POST /DocImage.axd?sign=open (multipart, one file)Lade ein PDF oder .docx hoch und öffne es zur Vorschau200 — { token, name, pages, ext }
POST /DocImage.axd?sign=run (JSON body)Signiere die hochgeladene Datei200 — { downloadToken, downloadName, watermarked }
GET /DocImage.axd?sign=download&token=<downloadToken>Streame die signierte Datei200 — die Datei, Content-Disposition: attachment, Cache-Control: no-store

ext in der open‑Antwort enthält den führenden Punkt (".docx"). Die Seitenvorschau verwendet die Standard‑Viewer‑Bild‑Route, /DocImage.axd?token={token}&page={n}&thumb=1&width={px}; die angezeigte Seite wird zu placement.page.

Der run‑Body:

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"
}
FeldHinweise
tokenDas Token von open
signature.kindDrawn, Typed oder Image, case‑insensitive; alles andere wird zu Drawn. Nur ein Hinweis: die Nutzlast ist immer ein PNG
signature.payloadEin reines base64‑PNG, ohne data:‑Präfix. Es muss ein echtes PNG sein und nach dem Dekodieren nicht größer als MaxSignatureImageKb sein.
placement.page1‑basiert
placement.x / y / w / hNormalisiertes 0..1 von der oberen linken Ecke, mit x + w ≤ 1 und y + h ≤ 1
meta.signerName / reason / locationOptional. Jeder Eintrag wird getrimmt, ein leerer Wert wird verworfen und jeder wird auf 256 Zeichen gekürzt.
wordOutputpdf (Standard) oder docx; für PDF‑Quellen ignoriert. Alles andere wird zu pdf.
modecertified (Standard) oder visual. Alles andere wird zu certified.

downloadName folgt der Ausgabe: <source>-signed.pdf oder <source>-signed.docx, und download sendet das passende Content-Type.

Die hochgeladene Quelle und das signierte Ergebnis werden jeweils 30 Minuten aufbewahrt. Danach beantworten run und download 404 und die Datei muss erneut geöffnet werden. Alle Tokens sind GUIDs.

RouteStatusWannBody
any404Das Widget ist nicht aktiviertnur Status
any405Falsches Verb (open und run benötigen POST, download benötigt GET)nur Status
open400Kein Multipart‑UploadExpected a multipart file upload.
open400Keine Datei oder eine leereNo file uploaded.
open400Alles andere als .pdf oder .docxSigning supports PDF and Word (.docx) files only.
open413Der Upload überschreitet MaxUploadMb (aber nicht die IIS‑Grenzen)File is too large.
run400Der Body ist kein gültiges JSON oder ist leerMalformed request. / Empty request.
run400Das Token fehlt oder ist keine GUIDInvalid token.
run404Der Upload ist abgelaufen oder wurde nie geöffnetUpload expired — please re-open the file.
run400Keine Signatur oder keine PlatzierungNo signature supplied. / No placement supplied.
run400Die Nutzlast ist nicht base64, ist leer, zu groß oder kein PNGSignature image is not valid base64. / Signature image is empty. / Signature image is too large. / The signature image must be a PNG.
run400Die Platzierung liegt außerhalb der SeiteThe signature or its placement is invalid.
run400Zertifizierter Modus, eine kostenpflichtige Lizenz und kein ZertifikatNo signing certificate configured.
run400Zertifizierter Modus mit einem Zertifikat außerhalb seines GültigkeitszeitraumsThe signing certificate expired on yyyy-MM-dd. / The signing certificate is not valid before yyyy-MM-dd.
open, run500Verarbeitung fehlgeschlagenEine bereinigte Meldung
download400Das Token fehlt oder ist keine GUIDnur Status
download404Unbekanntes oder abgelaufenes Tokennur Status

Ein vollständiger Rundlauf mit fetch:

javascript
// file: die File zum Signieren; pngBase64: die Signatur als reines base64 PNG, ohne data: prefix,
// zum Beispiel canvas.toDataURL('image/png').split(',')[1].
async function signFile(file, pngBase64) {
  const base = '/DocImage.axd';

  // 1. open: Datei hochladen
  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: signiere es
  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: lade die signierte Datei herunter
  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);
}

Die Endpunkte sind same-origin: Diese Version unterstützt kein CORS. Stellen Sie Ihre UI und das Widget‑Skript vom selben Ursprung wie die Anwendung bereit, oder setzen Sie einen Reverse‑Proxy für DocImage.axd und /doconut-res unter dem Ursprung Ihrer UI ein.

In Produktion

  1. Installieren Sie das Plugin neben dem Kernpaket, in derselben Version: Install-Package Doconut.NETFramework.Signer.

  2. Fügen Sie die Lizenzdatei hinzu. Legen Sie Doconut.Viewer.Signer.lic in denselben Ordner wie Doconut.Viewer.lic.

  3. Holen Sie Ihr Zertifikat als PFX mit seinem privaten Schlüssel und der Ausstellerkette, von einer Zertifizierungsstelle oder der eigenen PKI Ihrer Organisation. Um es zunächst auszuprobieren, verwenden Sie eine Demolizenz (das integrierte Demo‑Zertifikat, mit Wasserzeichen) oder ein selbstsigniertes PFX.

  4. Lesen Sie das Zertifikat aus der Konfiguration, sodass eine Änderung nie einen Code‑Änderung erfordert:

    xml
    <appSettings>
      <add key="DoconutSigner:PfxPath" value="~/App_Data/your-certificate.pfx" />
    </appSettings>
    csharp
    var settings = System.Configuration.ConfigurationManager.AppSettings;
    
    Doconut.DoconutHost.Initialize(options =>
    {
        options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
        options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
        options.AddSignerWidget(widget => widget.SigningCertificate = new SigningCertificate
        {
            PfxPath = HostingEnvironment.MapPath(settings["DoconutSigner:PfxPath"]),
            Password = settings["DoconutSigner:Password"] ?? "",
        });
    });

    Bewahren Sie das .pfx in App_Data auf, das IIS niemals bereitstellt, und halten Sie das Passwort außerhalb eines Klartext-Web.config: Verwenden Sie einen verschlüsselten Konfigurationsabschnitt oder einen Geheimspeicher, den Ihre Bereitstellung liest.

  5. Signieren Sie ein Testdokument im Certified‑Modus. Ein Zertifikat, das abgelaufen oder noch nicht gültig ist, wird mit The signing certificate expired on yyyy-MM-dd. (oder is not valid before) abgelehnt, und ein PDF‑Reader zeigt, ob er der Signatur vertraut.

Vertrauen in PDF‑Reader. Ein Reader zeigt die Signatur als gültig an, wenn er der Stammzertifizierung vertraut. Mit der PKI Ihrer Organisation gilt das auf jedem Rechner, der Ihrer Stammzertifizierung vertraut, was in der Regel jeder Rechner innerhalb der Organisation ist. Zertifikate, die Adobe auf irgendeinem Rechner vertraut (die Adobe Approved Trust List), werden, soweit wir wissen, mit dem privaten Schlüssel auf einem Hardware‑Token oder HSM ausgestellt, was dieses Plugin nicht nutzen kann: Es signiert ausschließlich aus einem PFX. Bestätigen Sie dies bei Ihrem Zertifikatanbieter, bevor Sie sich auf diese Art von Vertrauen verlassen.

Webfarmen

Das Widget speichert jede hochgeladene Datei und ihr Ergebnis im Speicher auf dem Server, der open bereitgestellt hat. Hinter einem Load‑Balancer ohne Sticky‑Sessions kann eine spätere run, download oder Vorschau‑Anfrage einen anderen Server erreichen und die hochgeladene Datei nicht finden. Registrieren Sie den geteilten, verschlüsselten Widget‑Speicher über das zweite Argument von DoconutHost.Initialize:

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

Doconut.DoconutHost.Initialize(
    options =>
    {
        options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
        options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>();
        options.AddSignerWidget();
    },
    services => services.AddDoconutDistributedWidgets(store =>
    {
        store.RootPath = @"\\fileshare\doconut";   // ein Ordner, den jeder Server lesen und schreiben kann
        store.FarmKey = farmKey;                   // mindestens 32 Bytes, auf jedem Server identisch
        // store.Ttl = TimeSpan.FromMinutes(30);   // wie lange ein Upload aufbewahrt wird (der Standard)
    }));
  • Ein einzelner Server benötigt nichts: Ohne diesen Aufruf wird der In‑Memory‑Speicher verwendet.
  • Uploads und Ergebnisse werden im Ruhezustand auf dem Share verschlüsselt (AES‑256, encrypt‑then‑MAC), und jede Datei ist an ihr Token gebunden, sodass ein Token niemals die Datei eines anderen lesen kann.
  • FarmKey muss mindestens 32 Byte groß sein und auf jedem Server identisch sein. Laden Sie es aus einem Geheimspeicher; niemals hartkodieren. Die Registrierung wirft ein ArgumentException, wenn RootPath fehlt oder FarmKey kürzer als 32 Byte ist.
  • Zeigen Sie RootPath auf denselben gemeinsamen Ort, den der verteilte Viewer verwendet, und geben Sie jedem Server dasselbe Signaturzertifikat.

API-Referenz

Die Fassade und die Widget-Optionen befinden sich im Namespace Doconut; die Anforderungs- und Ergebnis-Typen befinden sich in Doconut.Core.Models.Signing. SignerPlugin befindet sich in 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);
}

Gelöst aus DoconutHost.Services; der Konstruktor ist intern. sourceExtension ist ".pdf" oder ".docx". Unter einer bezahlten Lizenz wird cert verwendet und die Ausgabe ist sauber; unter einer temporären Lizenz wird das integrierte Demo-Zertifikat verwendet, cert wird ignoriert, und die Ausgabe ist mit Wasserzeichen versehen.

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
}

Eine sichtbare Signatur, einmal platziert, plus optionale Unterzeichner-Metadaten.

VisibleSignature und SignatureKind

csharp
public sealed record VisibleSignature(SignatureKind Kind, byte[] PngBytes)
{
    public bool IsValid { get; }   // PngBytes ist nicht leer
}

public enum SignatureKind { Drawn, Typed, Image }

PngBytes ist ein PNG für jede Art. Eine gezeichnete oder getippte Signatur ist transparent; ein hochgeladenes Bild behält die vorhandene Transparenz bei, sodass ein undurchsichtiges JPG undurchsichtig bleibt. Kind ist nur ein Hinweis.

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 ist 1-basiert; X, Y, W und H sind normalisierte 0..1 vom oberen linken Eckpunkt aus.

SignatureMode und WordOutput

csharp
public enum SignatureMode { Certified, Visual }   // Certified ist Standard
public enum WordOutput { Pdf, Docx }              // Pdf ist Standard; ignoriert für PDF-Quellen

SignResult

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

Das signierte Dokument als durchsuchbarer Stream und seine Erweiterung mit dem Punkt (".pdf" oder ".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 ist nicht leer, oder PfxPath ist nicht leer
}

Setzen Sie entweder PfxBytes oder PfxPath, plus Password. Die Setter sind nur initierbar: Das Projekt benötigt C# 9.0 oder höher.

SignerWidgetOptions

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

Setzen Sie über DoconutOptions.AddSignerWidget(Action<SignerWidgetOptions>? configure = null), das das DoconutOptions zurückgibt, sodass Aufrufe verkettet werden können. Ein null SigningCertificate bedeutet das Demo-Zertifikat unter einer temporären Lizenz, und visuelle Signaturen nur unter einer bezahlten Lizenz.

Fehlersuche

SymptomUrsacheLösung
Jede Anfrage liefert ein leeres 500 nach dem Hinzufügen des Plugins; das Ereignisprotokoll zeigt The Signer plugin is registered via AddPlugin but no active license grants Signer.Keine Lizenz, eine TRIAL-Datei, eine Lizenz ohne Signer oder eine bezahlte Lizenz außerhalb ihres VersionsfenstersInstallieren Sie eine Lizenz, die Signer gewährt, oder entfernen Sie AddPlugin<SignerPlugin>()
Das Ereignisprotokoll zeigt AddSignerWidget() was called but the Signer plugin is not registered.Das Widget ist aktiviert ohne sein PluginFügen Sie options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>() hinzu
Das Ereignisprotokoll zeigt Doconut Signer: the certificate file was not found at '{path}'.PfxPath verweist auf eine fehlende DateiKorrigieren Sie den Pfad; stellen Sie die Datei dort bereit, wo das Konto des Anwendungspools sie lesen kann
Das Ereignisprotokoll zeigt Doconut Signer: the signing certificate could not be opened — the password is incorrect or the file is not a valid .pfx.Falsches Passwort oder keine PKCS#12-DateiÜberprüfen Sie das Passwort; verwenden Sie ein echtes .pfx
Das Ereignisprotokoll zeigt Doconut Signer: the signing certificate has no private key. Re-export the .pfx INCLUDING the private key.Das PFX wurde ohne privaten Schlüssel exportiertExportieren Sie es erneut mit dem privaten Schlüssel
new SigningCertificate { … } kompiliert nichtDas Projekt verwendet C# 7.3, das keine init-only Eigenschaften setzen kannSetzen Sie <LangVersion> auf 9.0 oder höher
Auflösen von DocumentSigner wirft No IDocumentSigner is registered.SignerPlugin ist nicht registriertFügen Sie AddPlugin<SignerPlugin>() in DoconutHost.Initialize hinzu
Die Ausgabe ist mit Wasserzeichen versehenDie Lizenz ist temporär (Demo/NFR)Verwenden Sie eine bezahlte Lizenz, die Signer gewährt
run antwortet 400 No signing certificate configured.Eine bezahlte Lizenz, zertifizierter Modus und kein ZertifikatKonfigurieren Sie SigningCertificate, oder signieren Sie im Visual-Modus
run antwortet 400 The signing certificate expired on yyyy-MM-dd.Das Zertifikat ist abgelaufenErsetzen Sie es; visuelle Signaturen funktionieren in der Zwischenzeit weiter
Das Widget lädt, sagt aber Signing is not enabled on this server.AddSignerWidget() wurde nicht aufgerufen, oder basePath ist nicht '/DocImage.axd'Rufen Sie AddSignerWidget() auf; setzen Sie basePath: '/DocImage.axd'
Ein großer Upload zeigt eine IIS-Fehlerseite anstelle der Widget-NachrichtmaxRequestLength / maxAllowedContentLength liegen unter MaxUploadMbErhöhen Sie beide Host-Limits über MaxUploadMb
run antwortet 400 The signature image must be a PNG., Signature image is not valid base64. oder Signature image is too large.Eine benutzerdefinierte UI sendete eine data:-URL, ein JPG oder mehr als MaxSignatureImageKbSenden Sie ein reines Base64-PNG innerhalb des Limits
open antwortet 413 File is too large.Der Upload überschreitet MaxUploadMbErhöhen Sie MaxUploadMb in AddSignerWidget; das maxUploadMb des Widgets ist nur eine clientseitige Prüfung
run oder download antwortet 404 Upload expired — please re-open the file.Das 30‑Minuten‑Fenster ist abgelaufen, oder ein anderer Server im Farm hat den Upload nichtÖffnen Sie die Datei erneut; in einer Farm registrieren Sie AddDoconutDistributedWidgets
Ein signiertes .docx zeigt in einigen Betrachtern keine SignaturWord-Ausgabe enthält eine OOXML-Paket-Signatur, die viele Betrachter nicht anzeigenSignieren Sie zu PDF, das Standardformat
PDF‑Reader sagen, die Identität des Unterzeichners ist unbekanntDer Reader vertraut der Zertifikatswurzel nicht (das Demo-Zertifikat wird nie vertraut)Verwenden Sie ein Zertifikat von einer Wurzel, der Ihre Reader vertrauen
Das Widget schlägt fehl, wenn die UI auf einer anderen Herkunft istDie Endpunkte haben keine CORS-UnterstützungBedienen Sie die UI von derselben Herkunft aus, oder setzen Sie einen Reverse‑Proxy für DocImage.axd und /doconut-res ein
Das Theme wird nicht angewendetDer Selektor zielt auf ein Element innerhalb des MountsZielen Sie auf das Mount selbst: #host.dsw oder #host

Framework-Notizen

Im Vergleich zu den ASP.NET Core-Paketen unterscheidet sich dieses Paket nur im Hosting; die API, der Endpunktvertrag, das Widget‑Skript und die Lizenzierungsregeln sind identisch.

  • Registrierung befindet sich in Application_Start, über DoconutHost.Initialize, anstelle von builder.Services.AddDoconut. Dienste wie AddDoconutDistributedWidgets gehen in sein zweites Argument.
  • Endpunkte werden von DocImage.axd bereitgestellt und das Skript von DoconutResourceModule, beide registriert in Web.config, anstelle von UseDoconut() und UseDoconutResources(). Das Widget benötigt basePath: '/DocImage.axd'.
  • Startfehler erscheinen als ein leeres 500 bei jeder Anforderung, wobei der Grund im Windows-Ereignisprotokoll zu finden ist.
  • Uploads werden von ASP.NET vollständig gelesen, bevor Doconut sie sieht, daher müssen die IIS‑Grenzwerte über MaxUploadMb liegen.
  • Keine Start‑Log‑Zeile zum Zertifikat: Die drei Zertifikatsfehler werden weiterhin ausgelöst, aber die Zeile, die das Zertifikat benennt, wird nicht geschrieben.
  • C# 9.0 oder höher wird benötigt, um die Init‑Only‑Eigenschaften von SigningCertificate zu setzen.
  • Nur Windows, wie der Rest des .NET‑Framework‑Pakets.

War diese Seite hilfreich?