XMLSignatureValidator  - AS3

署名 SignedInfo エレメントに対して計算された暗号署名の有効性を返します。

ステータスを以下に示します。

• valid — 署名が暗号として有効である場合。
• invalid — 署名後ダイジェストが変更された場合。
• unknown -- verify() メソッドが呼び出されていない場合。

注意：digestStatus が invalid の場合、identityStatus と referencesStatus はチェックされず、unknown として報告されます。

署名証明書の有効性ステータス。

ステータスは次のいずれかです。

• valid -- 証明書の有効期限は切れておらず、失効のチェックに失敗せず、信頼されたルート証明書へのチェーンがあります。
• unknown -- 証明書の有効期限は切れておらず、失効のチェックに失敗しなかったが、信頼されたルート証明書へのチェーンがありません。unknown のステータスは、verify() メソッドが呼び出されていないか、SignedInfo エレメント（digestStatus）の暗号署名が無効であるために、ステータスが検証されていない場合にも報告されます。
• invalid -- 証明書の有効期限が切れているか、失効のチェックに失敗しました。

addCertificate() メソッド、revocationCheckSetting プロパティおよび useSystemTrustStore プロパティの設定を使用して追加された証明書は、証明書が有効と見なされるかどうかを変更できます。

注意：identityStatus が invalid の場合、referencesStatus はチェックされず、unknown として報告されます。さらに、identityStatus は、referencesValidationSetting が validOrUnknownIdentity でない限り、unknown になります。

関連する API エレメント

 import flash.security.XMLSignatureValidator;
 
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var identityResult:String = verifier.identityStatus;

現在のプラットフォームで XMLSignatureValidator クラスがサポートされている場合、isSupported プロパティは true に設定されます。サポートされていない場合は、false に設定されます。

署名 SignedInfo エレメントの参照内にあるデータの有効性のステータス。

ステータスは次のいずれかです。

• valid -- すべての参照が有効な場合。
• invalid -- いずれかの参照が無効な場合。
• unknown — 無効な場合。参照は、次の状況の場合に未検証のままになる可能性があります。
  • verify() メソッドが呼び出されなかった場合。
  • SignedInfo エレメントの暗号署名（digestStatus）が無効な場合。
  • 署名証明書（identityStatus）が無効な場合。
  • referencesValidationSetting が validIdentity（デフォルトの設定）であり、署名証明書の identityStatus が unknown である場合。
  • referencesValidationSetting が never の場合。

重要：外部リソースは、署名ドキュメントの SignedInfo エレメント内で直接参照されていない限り、検証されません。二次参照によって参照される外部リソースは検証されません。例えば、XML 署名がマニフェストエレメントに署名している場合は、マニフェストエレメント自体の整合性だけが検証されます。マニフェストにリストされているファイルはチェックされません。

関連する API エレメント

 import flash.security.XMLSignatureValidator;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var dataResult:String = verifier.referencesStatus;

参照がチェックされる条件を指定します。

このプロパティを設定するには、ReferencesValidationSetting クラスに定義されている定数を使用します。この設定には次のようなものがあります。

• ReferencesValidationSetting.VALID_IDENTITY — 署名証明書が有効であり、信頼されたルートにチェーンされている場合のみ、参照をチェックします。これはデフォルトの設定です。
• ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY — 署名証明書が有効な場合に、参照をチェックします。信頼できるルートにチェーンされていない場合でも実行します。
• ReferencesValidationSetting.NEVER — 参照をチェックしません。

デフォルトの設定である validIdentity を使用するのは、商用証明書を使用して署名された署名を使用する場合、または addCertificate() メソッドを使用して独自の証明書を信頼アンカーとして供給する場合です。この設定により、署名されたドキュメントが拒否される場合の参照の有効性をチェックするオーバーヘッドが回避されます。

自己署名証明書を使用して署名された署名では、validOrUnknownIdentity 設定を使用します。この設定では、署名されたデータが変更されていないことを検証できますが、署名者のアイデンティティについては何の保証も与えられません。

アプリケーションのコンテキストの中でこのような検証が重要でない場合は、never 設定を使用して、参照を検証するオーバーヘッドを回避します。

関連する API エレメント

 import flash.security.ReferencesValidationSetting;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator(); 
 verifier.referencesValidationSetting = ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY;

証明書の失効のチェック方法を指定します。

このプロパティを設定するために、RevocationSettings クラスで定義されている定数を使用します。この設定には次のようなものがあります。

• RevocationCheckSettings.NEVER -- 証明書の失効をチェックしません。
• RevocationCheckSettings.BEST_EFFORT -- 失効情報があり、失効ステータスを取得できる場合、証明書の失効をチェックします。失効ステータスが明確に判別できない場合、証明書は拒否されません。
• RevocationCheckSettings.REQUIRED_IF_AVAILABLE -- 証明書に失効情報が含まれている場合、証明書を検証するために失効ステータスを明確に判別できる必要があります。
• RevocationCheckSettings.ALWAYS_REQUIRED -- 常に証明書の失効をチェックします。失効情報がない証明書は拒否されます。

関連する API エレメント

署名証明書の共通名フィールド。

 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var commonName:String = verifier.signerCN;

署名証明書の識別名フィールド。

 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var distinguishedName:String = verifier.signerDN;

署名証明書にリストされている拡張キー使用法 OID を含む配列です。

各拡張キー使用法は、数値形式の OID で報告されます。

 import flash.security.XMLSignatureValidator;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var extendedKeyOIDs:Array = verifier.signerExtendedKeyUsages;

署名証明書の信頼設定を含む配列。

信頼設定は、証明書に埋め込まれたシステム OID およびキー使用法 OID から派生します。有効な信頼設定を表すストリングの定数は、SignerTrustSettings クラスで定義されています。

unknown または invalid の証明書の signerTrustSettings 配列は空です。

配列を変更しても、証明書の信頼設定は変更されません。

関連する API エレメント

 import flash.security.XMLSignatureValidator;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate a signature...
  
 var certificateTrustedFor:Array = verifier.signerTrustSettings;

IURIDereferencer 実装。

IURIDereferencer 実装は、署名を検証しようとする前に提供する必要があります。

関連する API エレメント

 import com.example.SignedMessageDereferencer; //A custom class implementing IURIDereferencer
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator(); 
 verifier.uriDereferencer = new SignedMessageDereferencer();

システムの信頼ストアの証明書をチェーンの構築に使用するように指定します。

true の場合、システムの信頼ストアの信頼アンカーは信頼されたルートとして使用されます。デフォルトでは、システムの信頼ストアは使用されません。

 var verifier:XMLSignatureValidator = new XMLSignatureValidator(); 
 verifier.useSystemTrustStore = true;

検証された XML 署名の有効性ステータス。

XML 署名は、SignedInfo エレメントの暗号署名、署名証明書、および SignedInfo エレメントの参照によって指定されるデータを検証することによって検証されます。これらの各エレメントの有効性は、digestStatus、identityStatus() および referencesStatus プロパティによってそれぞれ個別に報告されます。

XML 署名の有効性は valid、invalid、または unknown です。全体のステータスは、署名ファイルの個々のコンポーネントの検証ステータスによって決まります。

• digestStatus -- SignedInfo エレメントに対して計算された暗号署名の有効性。
• identityStatus -- 署名証明書の有効性。
• referencesStatus -- 署名の SignedInfo エレメントにおける参照のダイジェストの有効性。

validityStatus プロパティによって報告される署名の有効性には、次のようなものがあります。

• valid -- referencesStatus、digestStatus および identityStatus がすべて valid の場合。
• invalid -- 個々のステータスのいずれかが invalid の場合。
• unknown -- 個々のステータスのいずれかが unknown の場合。

関連する API エレメント

 import flash.security.XMLSignatureValidator;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 //validate the signature...
  
 var validationResult:String = verifier.validityStatus;

XMLSignatureValidator オブジェクトを作成します。

uriDereferencer プロパティの設定は、新しいオブジェクトの verify() メソッドを呼び出す前に行う必要があります。

関連する API エレメント

 
import com.example.EnvelopedDereferencer; //Your custom IURIDereferencer implementation

//Create the object
var verifier:XMLSignatureValidator = new XMLSignatureValidator();

//Provide the IURIDerferencer
verifier.uriDereferencer = new EnvelopedDereferencer(xmlDoc);

//Set validation options
verifier.referencesValidationSetting = ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY;
verifier.revocationCheckSetting = RevocationCheckSettings.NEVER;
verifier.useSystemTrustStore = true;

//Add listeners to handle results
verifier.addEventListener(Event.COMPLETE, verificationComplete);
verifier.addEventListener(ErrorEvent.ERROR, verificationError);

チェーン構築用の x509 証明書を追加します。

追加される証明書は、DER エンコードされた x509 証明書でなければなりません。

trusted パラメーターが true の場合、証明書は信頼アンカーと見なされます。

注意：XML 署名に、署名者の証明書チェーンを構築するための証明書が含まれていることがあります。XMLSignatureValidator クラスは、チェーンを構築するためにこれらの証明書を使用しますが、信頼されたルートとしては構築されません（デフォルト）。

パラメーター

 import flash.utils.ByteArray;
 
 var verifier:XMLSignatureValidator = new XMLSignatureValidator();
 var certificate:ByteArray = new ByteArray();
 
 var certFile:File = new File("certificate.cer");
 var certFileStream:FileStream = new FileStream();
 certFileStream.open(certFile, FileMode.READ);
 certFileStream.readBytes(certificate, 0, certFileStream.bytesAvailable);

 verifier.addCertificate(certificate, true);

指定された署名を検証します。

検証は非同期です。XMLSignatureValidator オブジェクトは、検証が正常に完了すると complete イベントを送出し、エラーが原因で検証が完了できないと error イベントを送出します。

検証処理はキャンセルできません。検証処理の実行中は、後続の verify() メソッドの呼び出しは失敗します。現在の検証が完了すると、もう一度 verify() メソッドを呼び出すことができます。

注意： XMLSignatureValidator は、W3C recommendation for XML Signature Syntax and Processing のサブセットのみを実装するため、有効な XML 署名のすべてを検証できるわけではありません。

パラメーター

import flash.filesystem.File;
import flash.filesystem.FileStream;
import com.example.SignedMessageDereferencer; //Your IURIDereferencer implementation
 
const xmlSignatureNS:Namespace = new Namespace( "http://www.w3.org/2000/09/xmldsig#" );

var verifier:XMLSignatureValidator = new XMLSignatureValidator();
verifier.uriDereferencer = new SignedMessageDereferencer();

var signatureFile:File = new File( "path/to/XMLSignatureDocument.xml" );
var sigFileStream:FileStream = new FileStream();
sigFileStream.open( signatureFile, FileMode.READ );

var xmlDoc:XML = XML( sigFileStream.readUTFBytes(sigFileStream.bytesAvailable) );
var xmlSig:XML = XML( xmlDoc..xmlSignatureNS::Signature );

verifier.verify( xmlSig );

検証が完了したときに送出されます。

complete イベントは署名が有効であることを意味するものではありません。XMLSignatureValidator オブジェクトの validityStatus プロパティをチェックして、署名検証の結果を判別します。

このイベントには、次のプロパティがあります。

private function verificationComplete(event:Event):void{
    var validator:XMLSignatureValidator = event.target as XMLSignatureValidator;
    trace("Digest status: " + validator.digestStatus);
    trace("Identity status: " + validator.identityStatus);
    trace("Reference status: " + validator.referencesStatus);
    trace("Signature status: " + validator.validityStatus);    
}

関連する API エレメント

エラーが原因で検証が完了しなかった場合に送出されます。

このイベントには、次のプロパティがあります。

private function verificationError(event:ErrorEvent):void{
    trace("Verification error: " + event.text);                
}