デジタル署名を操作する方法

適用対象: InfoPath 2010 | InfoPath Forms Services | Office 2010 | SharePoint Server 2010 | Visual Studio | Visual Studio Tools for Microsoft Office

この記事の内容
デジタル署名の機能
デジタル署名のオブジェクト モデルの概要
プログラムでデジタル署名を操作する

Microsoft.Office.InfoPath 名前空間のオブジェクト モデルには、デジタル署名をプログラムによって操作するための機能が用意されています。

デジタル署名の機能

InfoPath のデジタル署名機能を使用すると、以下の操作を行うことができます。

• フォーム全体に署名する、またはフォーム内の署名可能な特定のデータ セットに個別に署名する。

• 署名対象にできる各データ セットについて、単一の署名または複数の署名が可能かどうかを指定し、その署名間の関係を指定する。たとえば、それらの署名を同等の連署にするのか、それとも新しい各署名を以前のすべての署名の副署にするのかを指定できます。

• ユーザーがフォームに署名したときにフォームに表示されるメッセージを指定する。

• 文書に署名を挿入し、それを確認する。

• セキュリティ向上のために各署名に追加された検証可能な非否認情報を確認する。この追加情報には、各署名者に表示されたフォームのビューが含まれています。この追加情報は署名の一部になっていて、署名を無効にすることなく削除することはできません。このデータは、フォーム内の署名をクリックして [デジタル署名の確認] ダイアログ ボックスを表示することにより、いつでも再表示できます。

• デジタル署名の操作にオブジェクト モデルを活用する。デジタル署名のオブジェクト モデルを通じて、署名ブロックにカスタム情報を完全に信頼できる形で追加できます。

デジタル署名のオブジェクト モデルの概要

Sign イベント

デジタル署名のオブジェクト モデルには、次のイベントがあります。

SignEventArgs オブジェクト

Sign イベントのイベント ハンドラーは、SignEventArgs イベント オブジェクトで動作します。このイベント オブジェクトには、次のプロパティがあります。

コレクションおよびオブジェクト

デジタル署名のオブジェクト モデルには、次のコレクションがあります。

デジタル署名のオブジェクト モデルには、次のオブジェクトがあります。

プログラムでデジタル署名を操作する

Microsoft.Office.InfoPath 名前空間のオブジェクト モデルには、デジタル署名をプログラムによって操作するためのメンバーが用意されています。特に、完全に信頼されたフォームでは、次のようなタイムラインに従って、署名ブロックをコミットする前に署名ブロックにカスタム情報を追加することができます。

1. ユーザーがフォームにデジタル署名を追加する操作を開始します。

2. [デジタル署名] ダイアログ ボックスが表示され、ユーザーは [追加] をクリックし、署名するデータを選択します。

3. SignedDataBlock オブジェクトによって表されている選択されたデータの Sign イベントが発生し、SignedDataBlock オブジェクトの Sign() メソッドおよび SignatureCollection コレクションの CreateSignature メソッドが実行されます。

4. 任意のオプション カスタム操作が実行されます。

5. Signature オブジェクトの Sign() メソッドが実行されます。

6. 名前の入力 (または署名画像の選択)、署名に使用する証明書の選択、およびコメントの入力を行うための [署名] ダイアログ ボックスが表示されます。

7. [署名] ボタンがクリックされると、そのフォーム用の署名のコレクションに署名が追加され、非否認情報がキャプチャされて署名と共に保存されます (非否認情報は、後で [デジタル署名] ダイアログ ボックスの [署名済みフォームの表示] をクリックし、[収集された追加署名情報の表示] をクリックすることで確認できます)。

次の例では、ユーザーが、選択されたデータの署名と、信頼できるタイムスタンプ サービスから取得したタイムスタンプ値で副署の署名を行うとき、Sign() メソッドを呼び出します。

public void FormEvents_Sign(object sender, SignEventArgs e)
{
   // Add a new Signature object to the SignedDataBlockCollection.
   Signature thisSignature = 
      e.SignedDataBlock.Signatures.CreateSignature();

   // Write the XML digital signature block and compute hash
   // for signed data.
   thisSignature.Sign();

   // Countersign the signature with a trusted timestamp.

   // Get the XML node storing the signature block.
   XPathNavigator oNodeSig = thisSignature.SignatureBlockXmlNode;
   XPathNavigator oNodeSigValue = 
      oNodeSig.SelectSingleNode(
      ".//*[local-name(.)='signatureValue']");

   // Get timestamp from a trusted timestamp service (fictitious).
   MyTrustedTimeStampService s = new MyTrustedTimeStampService();
   string strVerifiedTimeStamp = s.AddTimeStamp(oNodeSigValue.Value);

   // Add the value returned from the timestamp service to the 
   // unsigned part of the signature block.
   XPathNavigator oNodeObj = 
      oNodeSig.SelectSingleNode(".//*[local-name(.)='Object']");
   XPathNavigator oNode = oNodeObj.Clone();
   oNode.SetValue(strVerifiedTimeStamp);
   oNodeObj.MoveToParent();
   oNodeObj.AppendChild(oNode);

   e.SignatureWizard = false;
}

Public Sub FormEvents_Sign(ByVal sender As Object, _
   ByVal e As SignEventArgs)
   ' Add a new Signature object to the SignedDataBlockCollection.
   Dim thisSignature As Signature = 
      e.SignedDataBlock.Signatures.CreateSignature

   ' Write the XML digital signature block and compute hash
   ' for signed data.
   thisSignature.Sign()

   ' Countersign the signature with a trusted timestamp.

   ' Get the XML node storing the signature block
   Dim oNodeSig As XPathNavigator  = _
      thisSignature.SignatureBlockXmlNode
   Dim oNodeSigValue As XPathNavigator  = _
      oNodeSig.SelectSingleNode(_
      ".//*[local-name(.)='signatureValue']")

   ' Get timestamp from a trusted timestamp service (fictitious).
   Dim s As MyTrustedTimeStampService = New MyTrustedTimeStampService()
   Dim strVerifiedTimeStamp As String  = _
      s.AddTimeStamp(oNodeSigValue.Value)

   ' Add the value returned from the timestamp service to the 
   ' unsigned part of the signature block.
   Dim oNodeObj As XPathNavigator  = 
      oNodeSig.SelectSingleNode(".//*[local-name(.)='Object']")
   Dim oNode As XPathNavigator  = oNodeObj.Clone()
   oNode.SetValue(strVerifiedTimeStamp)
   oNodeObj.MoveToParent()
   oNodeObj.AppendChild(oNode)

   e.SignatureWizard = False