Vorgehensweise: Arbeiten mit digitalen Signaturen mithilfe des InfoPath 2003-Objektmodells
Das InfoPath 2003-kompatible Objektmodell bietet Features zum programmgesteuerten Verwenden von digitalen Signaturen.
Features für digitale Signaturen
Mithilfe der Features für digitale Signaturen in InfoPath können Sie Folgendes ausführen:
Ermöglichen von Signaturen für das gesamte Formular oder für bestimmte Gruppen von Daten im Formular, die getrennt signiert werden können.
Angeben bei jeder signierbaren Datengruppe, ob einzelne oder mehrere Signaturen zulässig sind und in welcher Beziehung diese zueinander stehen sollen. So können Sie beispielsweise angeben, ob es sich um parallele gemeinsame Signaturen handelt oder ob alle früheren Signaturen durch jede neue Signatur gegengezeichnet werden.
Angeben einer Meldung, die angezeigt werden soll, wenn Benutzer das Formular signieren.
Einfügen und Anzeigen einer Signatur im Dokument.
Anzeigen überprüfbarer Nichtabstreitbarkeitsinformationen, die jeder Signatur zur Steigerung der Sicherheit hinzugefügt wurden. Diese zusätzlichen Informationen, die eine Ansicht des Formulars einschließen, wie es jeder signierenden Person vorgelegt wurde, sind ein Bestandteil der Signatur und können nicht entfernt werden, ohne die Signatur ungültig zu machen. Sie können diese Daten jederzeit erneut aufrufen, indem Sie auf die Signatur im Formular klicken, um das Dialogfeld Digitale Signatur überprüfen anzuzeigen.
Profitieren von einem umfangreicheren Objektmodell zum Arbeiten mit digitalen Signaturen. Fügen Sie dem Signaturblock in vollständig vertrauenswürdigen Formularen benutzerdefinierte Informationen über das Objektmodell für digitale Signaturen hinzu.
Übersicht über das Objektmodell für digitale Signaturen
Ereignisse
Das Objektmodell für digitale Signaturen stellt das folgende Ereignis bereit.
Name | Beschreibung |
---|---|
Tritt ein, nachdem eine signierbare Datengruppe zum Signieren ausgewählt wurde. Mithilfe dieses Ereignisses können Sie die in der digitalen Signatur gespeicherten Daten bearbeiten. So können Sie beispielsweise Daten eines vertrauenswürdigen Zeitstempelservers oder eine serverseitige Gegensignatur der Transaktion hinzufügen. Sie können mit diesem Ereignis auch Signaturen blockieren, wenn der aktuelle Benutzer kein Mitglied einer bestimmten Gruppe ist. |
Das OnSign-Ereignis gibt einen Verweis auf das SignEventObject-Objekt zurück, das die folgenden Eigenschaften bereitstellt.
Name | Beschreibung |
---|---|
Ruft einen Wert vom Typ Boolean ab, der den Rückgabestatus des OnSign-Ereignisses angibt, oder legt diesen Wert fest. |
|
Ruft den signierten Datenblock ab, durch den das OnSign-Ereignis ausgelöst wurde. |
|
Ruft einen Verweis auf das XDocument-Objekt ab, das dem OnSign-Ereignis zugeordnet ist. |
Auflistungen und Objekte
Das Objektmodell für digitale Signaturen stellt die folgenden Auflistungen bereit.
Name | Beschreibung |
---|---|
Die Auflistung der SignedDataBlockObject-Objekte in der Formularvorlage gemäß Definition in der Formulardefinitionsdatei (XSF). Die SignedDataBlocksCollection-Auflistung implementiert Eigenschaften, die den Zugriff auf die einem Formular zugeordneten SignedDataBlockObjects-Objekte ermöglichen. Der Zugriff auf die SignedDataBlocks-Auflistung erfolgt über die SignedDataBlocks-Eigenschaft des XDocument-Objekts. |
|
Enthält eine Auflistung von SignatureObject-Objekten für jedes SignedDataBlockObject-Objekt im Formular. Die SignaturesCollection-Auflistung implementiert Eigenschaften und eine Methode, um auf die zugeordneten SignatureObject-Objekte eines Formulars zuzugreifen und eine Signatur zu erstellen. Der Zugriff darauf ist über das SignedDataBlockObject-Objekt möglich. Beachten Sie bei Verwendung der Create-Methode der SignaturesCollection-Auflistung, dass die Signatur erst dann geschrieben wird, wenn die Sign-Methode für das SignatureObject-Objekt aufgerufen wird. Diese Methoden können nur vom OnSign-Ereignishandler einer vollständig vertrauenswürdigen Formularvorlage aus aufgerufen werden. |
Das Objektmodell für digitale Signaturen stellt die folgenden Objekte bereit.
Name | Beschreibung |
---|---|
SignedDataBlockObject |
Stellt eine signierbare Datengruppe in einem Formular dar. Das SignedDataBlock-Objekt stellt eine Reihe von Eigenschaften und eine Methode für die programmgesteuerte Interaktion mit einer signierbaren Datengruppe bereit. |
SignatureObject |
Stellt eine digitale Signatur dar, die einem Formular oder einer signierbaren Datengruppe in einem Formular hinzugefügt wurde. Die SignatureObject-Auflistung implementiert Eigenschaften, die zum Abrufen von Informationen zur digitalen Signatur verwendet werden können, sowie die Sign-Methode zum Schreiben des XML-Blocks mit digitalen Signaturen und zum Berechnen von dessen kryptografischem Hashwert. |
Stellt das digitale X.509-Zertifikat dar, das zum Erstellen der Signatur verwendet wurde. |
Programmgesteuertes Arbeiten mit digitalen Signaturen
Das InfoPath 2003-kompatible Objektmodell stellt Member für die programmgesteuerte Interaktion mit digitalen Signaturen bereit. So können insbesondere in vollständig vertrauenswürdigen Formularen benutzerdefinierte Informationen dem Signaturblock hinzugefügt werden, bevor ein Commit für ihn ausgeführt wird. Dies geschieht entsprechend dem folgenden Zeitplan:
Der Benutzer entscheidet, dass einem Formular eine digitale Signatur hinzugefügt werden soll.
Das erste Fenster des****Assistenten für digitale Signaturen wird angezeigt.
Das OnSign-Ereignis für die ausgewählten Daten, die durch das SignedDataBlockObject-Objekt dargestellt werden, wird ausgelöst. Die Sign-Methode des SignedDataBlockObject-Objekts und die Create-Methode der SignaturesCollection-Auflistung werden ausgeführt.
Alle optionalen benutzerdefinierten Aktionen werden ausgeführt.
Die Sign-Methode des SignatureObject-Objekts wird ausgeführt.
Das zweite und dritte Fenster des Assistenten werden angezeigt, in denen ein Zertifikat zum Signieren ausgewählt und Kommentare eingegeben werden können.
Die Nichtabstreitbarkeitsinformationen werden angezeigt (und können später im Dialogfeld Digitale Signatur überprüfen angezeigt werden).
Beim Klicken auf die Schaltfläche Signieren wird die Signatur der Auflistung von Signaturen für das Formular hinzugefügt.
Im folgenden Beispiel wird das Dialogfeld Signieren aufgerufen und verwendet, um eine Signatur mit einem Zeitstempelwert gegenzuzeichnen, der von einem vertrauenswürdigen Zeitstempeldienst abgerufen wurde.
[InfoPathEventHandler(EventType=InfoPathEventType.OnSign)]
public void OnSign(SignEvent e)
{
Signature signature = e.SignedDataBlock.Signatures.Create();
// Invoke the Sign dialog box to sign the data block.
signature.Sign();
// Countersign the signature with a trusted timestamp
// Get the XML node storing the signature block
IXMLDOMNode oNodeSig = signature.SignatureBlockXmlNode;
IXMLDOMNode oNodeSigValue = oNodeSig.selectSingleNode(".//*[local-name(.)='signatureValue']");
// Get timestamp from a trusted timestamp service (fictitious).
MyTrustedTimeStampService s = new MyTrustedTimeStampService();
string strVerifiedTimeStamp = s.AddTimeStamp(oNodeSigValue.text);
//Add the value returned from the timestamp service to the
//unsigned part of the signature block
IXMLDOMNode oNodeObj = oNodeSig.selectSingleNode(".//*[local-name(.)='Object']");
IXMLDOMNode oNode = oNodeObj.cloneNode(false);
oNode.text = strVerifiedTimeStamp;
oNodeObj.parentNode.appendChild(oNode);
e.ReturnStatus = true;
}