４．XML文書に署名する (Java)

　XML署名に含まれる各要素の構成を説明します。
　それぞれの要素の意味やXMLスキーマなどはW3Cのサイトで確認してください。

　Referenceインスタンスは、XMLSignatureFactoryクラスのnewReferenceメソッドをコールすることで生成されます。<Reference>は、これによって構成されます。
　以下に、メソッドの詳細を記します。

public abstract Reference newReference(
			String uri,
			DigestMethod dm,
			List transforms,
			String type,
			String id)

• uri
<Reference>のURI属性の値を指定します。ここでは、""を指定します。
• dm
ダイジェストメソッドを指定します。SHA1、SHA256、SHA512、RIPEMD160 などを指定できます。
• transforms
変換アルゴリズムのリスト。変更不能なリストとしてコピーされます。4.5.2<Transform>を構成する を参照してください。
• type
参照形URIを指定しますが、ここでは指定しませんので、 null とします。
• id
参照形IDを指定しますが、ここでは null とします。

　Transformインスタンスは、XMLSignatureFactoryクラスのnewTransformメソッドをコールすることで生成されます。<Reference>には、これのリストを指定します。
　以下に、メソッドの詳細を記します。

public abstract Transform newTransform(
			String algorithm,
			TransformParameterSpec params)

• algorithm
変換アルゴリズムを識別するURIを指定します。ここでは、Transform.ENVELOPED（"http://www.w3.org/2000/09/xmldsig#enveloped-signature"）を指定します。
• params
変換アルゴリズム固有のパラメータをしていますが、ここでは null を指定します。

　SignedInfoインスタンスは、XMLSignatureFactoryクラスのnewSignedInfoメソッドをコールすることで生成されます。<Reference>には、これのリストを指定します。
　以下に、メソッドの詳細を記します。

public abstract SignedInfo newSignedInfo(
			CanonicalizationMethod cm,
			SignatureMethod sm,
			List references)

• cm
正規化のメソッドを指定します。ここでは、C14N W/Commentsを生成して指定します。4.5.4<CanonicalizationMethod>を構成する を参照してください。
• sm
署名のメソッドを指定します。ここでは、DSA-SHA1を生成して指定します。4.5.5<SignatureMethod>を構成する を参照してください。
• reference
4.5.1<Reference>を構成する で作成したReferenceをリストで指定します。

CanonicalizationMethodインスタンスは、XMLSignatureFactoryクラスのnewCanonicalizationMethodメソッドをコールすることで生成されます。<SignedInfo>には、これを指定します。
　以下に、メソッドの詳細を記します。

public abstract CanonicalizationMethod newCanonicalizationMethod(
			String algorithm,
			C14NMethodParameterSpec params)

• algorithm
正規化のアルゴリズムを識別するURIを指定します。ここでは、INCLUSIVE_WITH_COMMENTS（"http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"）を指定しています。
• params
アルゴリズム固有の正規化パラメータを指定しますが、ここでは null を指定します。

SignatureMethodインスタンスは、XMLSignatureFactoryクラスのnewSignatureMethodメソッドをコールすることで生成されます。<SignedInfo>には、これを指定します。
　以下に、メソッドの詳細を記します。

public abstract SignatureMethod newSignatureMethod(
			String algorithm,
			SignatureMethodParameterSpec params)

• algorithm
署名のアルゴリズムを識別するURIを指定します。ここでは、DSA_SHA1（"http://www.w3.org/2000/09/xmldsig#dsa-sha1"）を指定しています。
• params
アルゴリズム固有の署名パラメータを指定しますが、ここでは null を指定します。

　KeyValueインスタンスを生成するには、まず、XMLSignatureFactoryクラスのgetKeyInfoFactoryメソッドをコールすることでKeyInfoFactoryを得ます。次に、このKeyInfoFactoryクラスのnewKeyValueをコールすることで生成します。<KeyValue>は、これによって構成されます。
　以下に、getKeyInfoFactoryメソッドの詳細を記します。

public final KeyInfoFactory getKeyInfoFactory()

　このメソッドから返された KeyInfoFactory は、この XMLSignatureFactory と同じ機構型およびプロバイダを持ちます。

次に、newKeyValueメソッドの詳細を記します。

public abstract KeyValue newKeyValue(PublicKey key)

• key
公開鍵を指定します。公開鍵は、4.5.7鍵ペアを生成する を参照してください。

　鍵ペアは、まず、KeyPairGeneratorクラスのgetInstanceをコールして生成します。次に、そのインスタンスのgenerateKeyPair()をコールすることで鍵ペアが生成されます。
　以下に、getInstanceメソッドの詳細を記します。

public static KeyPairGenerator getInstance(String algorithm)

• algorithm
アルゴリズムの標準名の文字列を指定します。アルゴリズムの標準名は、以下のとおりです。
DSA: FIPS PUB 186 で定義されているデジタル署名アルゴリズム
RSA: PKCS #1 で定義されている RSA 暗号化アルゴリズム

次に、鍵ペアを生成するgenerateKeyPairメソッドの詳細を記します。

public KeyPair generateKeyPair()

これによって、指定された鍵ペアが戻ります。

　KeyInfoインスタンスは、KeyInfoFactoryクラスのnewKeyInfoメソッドをコールすることで生成します。
　以下に、メソッドの詳細を記します。

public abstract KeyInfo newKeyInfo(List content)

• content
鍵情報の型を表現する XMLStructure のリスト。このリストは、変更不能としてコピーされます。

続きます。

お問い合わせは、こちらからお願いします。

(記載の会社名および製品名は、各社の登録商標および商標です。)