Digitales Signieren von PDF-Dokumenten
Durch die Schnittstelle zu webPDF, ermöglicht n2pdf Ihnen die digitale Signierung (elektronische Unterschrift) von PDF-Dokumenten, durch Anbringung einer Signatur mittels eines digitalen Zertifikats. Die Echtheit (Identifikation des Unterzeichners) von PDF-Dokumenten kann somit bestätigt werden, und die PDF-Dokumente sind vor Veränderungen und Manipulationen geschützt.
Im Rahmen der Erstellung Ihrer PDF-Dokumente können Sie nun diese abschließend, mittels eines digitalen Zertifikates signieren. webPDF bringt dazu ein entsprechendes Zertifikat im Dokument an. Sie können dabei verschiedene Einstellungen, wie z. B. die Sichtbarkeit oder die Position des Zertifikats, bestimmen.
Natürlich unterstützt webPDF auch die Anbringung von Zeitstempeln ("timestamps") in den digitalen Zertifikaten. Somit können Sie auch den Zeitpunkt der Signierung digital bestimmen und absichern.
Durch Verwendung einer entsprechenden Klassifizierung (z. B. "qualifizierte elektronische Signatur" oder "fortgeschrittene elektronische Signatur"), können Sie die Dokumente entsprechend den gültigen Gesetzesrahmen signieren. Sie können diesen Webservice also z. B. im Rahmen von E-Invoice (elektronische Rechnung) oder Archivierungssystemen (revisionssichere Archivierung) einsetzen.
webPDF ermöglicht den Einsatz von Zertifikaten einer Zertifizierungsstelle (Certificate Authority - kurz CA) oder "Self-signed"-Zertifikaten. Es werden Zertifikate im X.509-Standard verwendet.
Über die nachfolgenden Einstellungen können Sie die Nutzung des Signatur-Services von n2pdf aus beeinflussen. Alle Optionen werden über die Funktion N2PDFSetOption gesetzt. Es stehen Ihnen dabei die folgenden Parameter der Funktion zur Verfügung:
|
Eine Beispielnutzung des Signatur-Dienstes finden Sie in unserer Beispieldatenbank "n2pdf_Mail Archive". |
N2PDFOPTION_SIGNATURE_ENABLED
Aktiviert den Signaturdienst. Alle folgenden Optionen werden erst nach Aktivierung dieser Option gültig.
N2PDFVALUE_TRUE |
Signatur-service aktivieren |
N2PDFVALUE_FALSE |
Signatur-service deaktivieren |
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_ENABLED, N2PDFVALUE_True, "" )
N2PDFOPTION_SIGNATURE_KEYSTORE_NAME
Definiert den Namen des Schlüssels (Alias), der bei der Unterzeichnung des Dokuments verwendet werden soll. Diese Einstellung überschreibt die Konfigurationseinstellung des Servers.
|
Weitere Information finden Sie in der Dokumentation von webPDF im Kapitel "Keystore". |
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_KEYSTORE_NAME, "default", "" )
N2PDFOPTION_SIGNATURE_KEYSTORE_PASSWORD
Definiert das Passwort, das für den Zugriff auf den privaten Schlüssel, der mit der Option N2PDFOPTION_SIGNATURE_KEYSTORE_NAME gesetzt wurde, benötigt wird. Diese Einstellung überschreibt die Konfigurationseinstellung des Servers.
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_KEYSTORE_PASSWORD, "n2pdf", "" )
|
Weitere Informationen finden Sie in der Dokumentation von webPDF im Kapitel "Keystore". |
N2PDFOPTION_SIGNATURE_REASON
Gibt den Grund für die Unterzeichnung des Dokuments an.
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_REASON, doc.Reason(0), "" )
N2PDFOPTION_SIGNATURE_LOCATION
Gibt den Ort der Unterzeichnung an.
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_LOCATION, doc.Location(0), "" )
N2PDFOPTION_SIGNATURE_CONTACT
Gibt den Namen des Unterzeichners an.
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_CONTACT, doc.Contact(0), "" )
N2PDFOPTION_SIGNATURE_CERT_LEVEL (Default: 1)
Über diesen Parameter wird die Stufe der Unterschrift bestimmt.
0 |
Unterschreiben des Dokuments, aber nicht zertifizieren, d. h. weitere Unterschriften bzw. Änderungen sind möglich |
1 |
Dokument zertifizieren, und keine weiteren Änderungen mehr zulassen |
2 |
Dokument zertifizieren, aber das Ausfüllen von Feldern erlauben |
3 |
Dokument zertifizieren, aber das Ausfüllen von Feldern und das Anbringen von Anmerkungen erlauben |
Beispiel: Das signierte Dokument wurde zertifiziert, ein Ausfüllen von Feldern ist möglich.
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_CERT_LEVEL, "2", "" )
N2PDFOPTION_SIGNATURE_PAGE (Default: 1)
Legt fest, auf welcher Seite die Unterschrift angezeigt wird.
Beispiel: Die Signatur befindet sich auf der ersten Seite.
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_PAGE, "1", "" )
N2PDFOPTION_SIGNATURE_VISIBLE (Default: N2PDFVALUE_FALSE)
Über diese Option können Sie entscheiden ob die Unterschrift visuell sichtbar im Dokument angezeigt oder unsichtbar im Dokument abgelegt werden soll.
N2PDFVALUE_TRUE |
Unterschrift ist sichtbar (siehe Option N2PDFOPTION_SIGNATURE_PAGE) |
N2PDFVALUE_FALSE |
Unterschrift wird nicht sichtbar im Dokument abgelegt |
Beispiel: Die Unterschrift wird sichtbar im Dokument angezeigt.
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_VISIBLE, N2PDFVALUE_True, "" )
N2PDFOPTION_SIGNATURE_FIELD
Definiert den Namen des Feldes im Dokument, in dem die Unterschrift gespeichert wird. Wird hier ein bereits vorhandener Feldname angegeben, dann wird automatisch ein eindeutiger Name berechnet.
|
Mit dem Namen des Feldes ist nicht ein Notes-Feldname gemeint, sondern ein eindeutiger Name im PDF Dokument, in dem die Signatur gespeichert wird |
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_FIELD, "security", "" )
N2PDFOPTION_SIGNATURE_IDENTIFIER
Definiert die Anwendung, die die Unterzeichnung durchgeführt hat. Diese Information wird angezeigt, wenn die Unterschrift sichtbar im Dokument angezeigt wird. In diesem Fall wird der Wert im visuellen Element angezeigt.
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_IDENTIFIER, "Lotus Notes", "" )
N2PDFOPTION_SIGNATURE_APPEND
Mit dieser Option können Sie festlegen, ob die neue Unterschrift angehangen werden soll, wenn bereits eine Unterschrift im Dokument vorhanden ist.
N2PDFVALUE_TRUE |
Unterschrift an die bestehende anhängen |
N2PDFVALUE_FALSE |
Unterschrift nicht an die bestehende anhängen |
|
Wenn die Unterschrift nicht an eine bestehende Unterschrift angehängt werden soll, wird n2pdf eine Fehlermeldung ausgeben. |
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_APPEND, N2PDFVALUE_True, "" )
N2PDFOPTION_SIGNATURE_POSITION_X (Default: 10 Millimeter vom linken Rand)
Mit dieser Option können Sie die X-Position des Feldes festlegen
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_POSITION_X, "15", "" )
N2PDFOPTION_SIGNATURE_POSITION_Y (Default: 10 Millimeter vom unteren Rand)
Mit dieser Option können Sie die Y-Position des Feldes festlegen
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_POSITION_Y, "15", "" )
N2PDFOPTION_SIGNATURE_POSITION_WIDTH (Default: 80 - in Millimeter)
Mit dieser Option können Sie die Breite des Signaturfeldes festlegen
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_POSITION_WIDTH, "150", "" )
N2PDFOPTION_SIGNATURE_POSITION_HEIGHT (Default: 40 - in Millimeter)
Mit dieser Option können Sie die Höhe des Signaturfeldes festlegen.
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_POSITION_HEIGHT, "100", "" )
N2PDFOPTION_SIGNATURE_POSITION_UNIT(Default:"mm")
Maßeinheit für die Angaben der X/Y-Position und der Höhe und Breite des Signatur-Feldes.
N2PDFVALUE_SIGNATURE_POSITION_UNIT_MM |
Millimeter |
N2PDFVALUE_SIGNATURE_POSITION_UNIT_PX |
Pixel |
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_POSITION_UNIT, N2PDFVALUE_SIGNATURE_POSITION_UNIT_PX , "" )
Für das Erscheinungsbild können folgende Werte gesetzt werden
N2PDFOPTION_SIGNATURE_IMAGE_FILENAME
Mit dieser Option legen Sie den Dateinamen fest, der in der Signatur als Bild im Signaturfeld angezeigt werden soll.
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_IMAGE_FILENAME, "c:\temp\signature.jpg"100", "" )
N2PDFOPTION_SIGNATURE_IMAGE_OPACITY(Default: 50)
Deckkraft der Grafik als prozentualer Wert zwischen 0 und 100.
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_IMAGE_OPACITY, "100", "" )
N2PDFOPTION_SIGNATURE_IMAGE_POSITION(Default: "center")
Position der Grafik innerhalb des Signatur-Feldes:
center |
Grafik zentriert |
left |
Grafik links ausgerichtet. |
right |
Grafik rechts ausgerichtet. |
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_IMAGE_POSITION, "left", "" )
Mit den nachfolgenden Optionen können die Namensbestandteile des Zertifikats anzeigt oder versteckt werden. Setzen sie den entsprechenden Wert auf "true" zur Anzeige oder auf "false" zur Ausblendung.
Der voreingestellte Wert für die folgenden Optionen ist "N2PDFVALUE_TRUE"
N2PDFOPTION_SIGNATURE_ID_SIGNED_BY
N2PDFOPTION_SIGNATURE_ID_NAME
N2PDFOPTION_SIGNATURE_ID_COMMON_NAME
N2PDFOPTION_SIGNATURE_ID_ORG_UNIT
N2PDFOPTION_SIGNATURE_ID_ORG_NAME
N2PDFOPTION_SIGNATURE_ID_LOCAL
N2PDFOPTION_SIGNATURE_ID_STATE
N2PDFOPTION_SIGNATURE_ID_COUNTRY
N2PDFOPTION_SIGNATURE_ID_MAIL
N2PDFOPTION_SIGNATURE_ID_DATE
N2PDFVALUE_TRUE |
Element wird angezeigt |
N2PDFVALUE_FALSE |
Element wird nicht angezeigt |
Beispiel:
Call N2PDFSetOption ( JobID, N2PDFOPTION_SIGNATURE_ID_SIGNED_BY, N2PDFVALUE_FALSE, "" )