XMLSignatureValidator  - AS3

O status de validade da assinatura criptográfica computado no elemento SignedInfo da assinatura.

O status é:

• válido — Se a assinatura tiver criptografia válida.
• inválida — Se a compilação tiver sido alterada após a assinatura.
• desconhecido — Se o método verify() não tiver sido chamado.

Observação: Se digestStatus for inválido, identityStatus e referencesStatus não são verificados e informados como unknown.

A validade do status do certificado de assinatura.

O status pode ser:

• válido — O certificado não venceu, não falhou na verificação de revogação e está vinculado a um certificado raiz confiável.
• desconhecido — O certificado não venceu e a verificação de revogação não falhou, mas não está vinculado a um certificado raiz confiável. Um status desconhecido também será reportado quando o status não tiver sido verificado, seja porque o método verify() não foi chamado ou porque a assinatura criptográfica do elemento SignedInfo (digestStatus) é inválida.
• inválido — O certificado expirou ou a verificação de revogação falhou.

Os certificados adicionados usando o método addCertificate() e as definições das propriedades revocationCheckSetting e useSystemTrustStore podem ser alteradas se um certificado for considerado válido.

Observação: Se identityStatus for inválido, referencesStatus não será verificado e será informado como unknown. Além disso, as referências não são verificadas quando identityStatus é desconhecido, a menos que referencesValidationSetting seja validOrUnknownIdentity

Elementos da API relacionados

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

A propriedade isSupported será definida como true se a classe XMLSignatureValidator for suportada na plataforma atual; de outra maneira, ela será definida como false.

O status de validade dos dados nas referências no elemento SignedInfo da assinatura.

O status pode ser:

• válido — Se todas as referências forem válidas.
• inválido — Se qualquer referência for inválida.
• desconhecido — Se não houver verificação. As referências podem permanecer sem verificação nas seguintes circunstâncias:
  • o método verify() não foi chamado
  • a assinatura criptográfica do elemento SignedInfo (digestStatus) é inválida.
  • o certificado de assinatura (identityStatus) é inválido
  • referencesValidationSetting é validIdentity (a configuração padrão) e identityStatus do certificado de assinatura é desconhecido.
  • referencesValidationSetting é never.

Importante: Os recursos externos não são validados a menos que sejam referenciados diretamente em um elemento SignedInfo dentro do documento de assinatura. Os recursos externos referenciados por uma referência secundária não são validados. Por exemplo, caso uma assinatura XML assine um elemento manifest, apenas a integridade do elemento manifest é verificada. Os arquivos listados no manifest não são verificados.

Elementos da API relacionados

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

Especifica as condições em que as referências são verificadas.

Use as constantes definidas na classe ReferencesValidationSetting para definir esta propriedade. As configurações incluem:

• ReferencesValidationSetting.VALID_IDENTITY — Só verifique referências caso o certificado de assinatura seja válido e esteja encadeado na raiz confiável. Esta é a configuração padrão.
• ReferencesValidationSetting.VALID_OR_UNKNOWN_IDENTITY — Verifique referências caso o certificado de assinatura seja válido, mesmo que ele não esteja encadeado na raiz confiável.
• ReferencesValidationSetting.NEVER — Jamais verifique referências.

Use o padrão, validIdentity, a configuração com assinaturas assinada com um certificado comercial ou quando você fornece um certificado próprio como ancoragem confiável com o método addCertificate(). Essa configuração evita a sobrecarga de verificar a validade de referência quando o documento assinado será rejeitado.

Use a configuração validOrUnknownIdentity com assinaturas assinadas com certificados assinados automaticamente. Essa configuração permite validar que os dados assinados não foram alterados, mas não fornece nenhuma garantia sobre a identidade do signatário.

Use a configuração never para evitar a sobrecarga de validação das referências quando essa validação não é importante no contexto do aplicativo.

Elementos da API relacionados

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

Especifica como a revogação de um certificado é verificada.

Use as constantes definidas na classe RevocationSettings para definir esta propriedade. As configurações incluem:

• RevocationCheckSettings.NEVER — Não verificar a revogação do certificado.
• RevocationCheckSettings.BEST_EFFORT — Verificar a revogação do certificado, se as informações de revogação estiverem disponíveis e o status de revogação puder ser obtido. Se o status de revogação não puder ser determinado positivamente, o certificado não será rejeitado.
• RevocationCheckSettings.REQUIRED_IF_AVAILABLE — Se o certificado incluir informações de revogação, o status de revogação deve ser positivamente determinado para validar o certificado.
• RevocationCheckSettings.ALWAYS_REQUIRED — Sempre verificar a revogação do certificado. Certificados sem informações de revogação são rejeitados.

Elementos da API relacionados

O campo Nome comum do certificado de assinatura.

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

O campo Nome distinto do certificado de assinatura.

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

Uma matriz contendo as OIDs de Uso de Chave Estendida listadas no certificado de assinatura.

Cada uso de chave estendida é reportada num formulário OID numérico.

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

Uma matriz contendo as configurações confiáveis do certificado de assinatura.

As configurações confiáveis são derivadas do sistema e o uso da chave OIDs está incorporado no certificado. As constantes para as strings representam as configurações confiáveis reconhecidas definidas na classe SignerTrustSettings.

A matriz signerTrustSettings de um certificado desconhecido ou inválido está vazia.

A modificação da matriz não altera as configurações confiáveis do certificado.

Elementos da API relacionados

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

A implementação IURIDereferencer.

Uma implementação de IURIDereferencer deve ser fornecida antes de tentar verificar a assinatura.

Elementos da API relacionados

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

Especifica que os certificados na armazenagem confiável do sistema são usados na criação do conjunto.

Se for true, as âncoras confiáveis na armazenagem confiável do sistema serão usadas como raízes confiáveis. A armazenagem confiável do sistema não é usada por padrão.

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

A validade do status de uma assinatura XML verificada.

A assinatura XML é verificada por meio da validação da assinatura criptográfica do elemento SignedInfo, do certificado de assinatura e dos dados relacionados às referências no elemento SignedInfo. A validade de cada um desses elementos é reportada individualmente pelas propriedades digestStatus, identityStatus() e referencesStatus, respectivamente.

A validade de uma assinatura XML pode ser válida, inválida ou desconhecida. O status geral depende do status de verificação dos componentes individuais do arquivo de assinatura:

• digestStatus — A validade da assinatura criptográfica computada sobre o elemento SignedInfo.
• identityStatus — A validade do certificado de autenticação.
• referencesStatus — A validade da compilação das referências no elemento SignedInfo da assinatura.

A validade da assinatura reportada pela propriedade validityStatus pode ser:

• válido — Se referencesStatus, digestStatus e identityStatus forem todos válidos.
• inválido — Se qualquer status individual for inválido.
• desconhecido — Se qualquer status individual for desconhecido.

Elementos da API relacionados

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

Cria um objeto XMLSignatureValidator.

Você deve definir a propriedade uriDereferencer antes de chamar o método verify() do novo objeto.

Elementos da API relacionados

 
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);

Adiciona um certificado x509 pela criação do conjunto de chaves.

O certificado adicionado deve ser um certificado x509 DER-codificado.

Se o parâmetro trusted for true, o certificado será considerado uma âncora confiável.

Observação: Uma assinatura XML pode incluir certificados para a elaboração de um conjunto de assinaturas de certificados. A classe XMLSignatureValidator usa esses certificados para criação de conjuntos, mas não como raízes confiáveis (por padrão).

Parâmetros

 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);

Verifique a assinatura especificada.

A verificação é assíncrona. O objeto XMLSignatureValidator despacha um evento completo quando a verificação é concluída com êxito ou error ainda que a verificação não pôde ser concluída por causa dos erros.

O processo de verificação não pode ser cancelado. Enquanto um processo de verificação estiver em andamento, as chamadas subsequentes para o método verify() falham. Depois que a verificação atual estiver completa, será possível chamar novamente o método verify().

Observação: Como XMLSignatureValidator implementa somente um subconjunto de recomendações W3C para a sintaxe da assinatura XML e o processamento, nem todas as assinaturas XML válidas podem ser verificadas.

Parâmetros

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 );

Despachado quando a verificação for concluída.

Um evento complete não implica numa assinatura válida. Verifique a propriedade validityStatus do objeto XMLSignatureValidator para determinar o resultado da verificação de assinatura.

Esse evento tem as seguintes propriedades:

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);    
}

Elementos da API relacionados

Despachado se a verificação não puder ser concluída por causa de erros.

Esse evento tem as seguintes propriedades:

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