Class JadesVerifier

java.lang.Object

br.ufsc.labsec.signature.AbstractSignatureVerifier<JadesSignature>

br.ufsc.labsec.signature.conformanceVerifier.jades.JadesVerifier

All Implemented Interfaces:

AbstractVerifierInterface<JadesInformation, JadesAttrCommonStruct, JadesSignature>, JadesAbstractVerifierInterface, Verifier

public class JadesVerifier
extends AbstractSignatureVerifier<JadesSignature>
implements JadesAbstractVerifierInterface

Esta classe implementa os métodos para verificação de uma assinatura JAdES. Estende Verifier.

Field Summary

Fields

Modifier and Type	Field	Description
protected CertPath	certPath	Caminho de certificação do assinante
protected Date	timeReference	Tempo que será levado em conta para validar a assinatura

Fields inherited from class AbstractSignatureVerifier

component, report, selectedSignature, signatureChanged, signatureContainer

Fields inherited from interface AbstractVerifierInterface

docICP1503TimePoint

Constructor Summary

Constructors

Constructor	Description
JadesVerifier(JadesSignatureComponent component)	Construtor

Method Summary

Modifier and Type	Method	Description
protected void	addCertificatesToValidation(SignatureReport sigReport, Certificate cert)	Realiza a verificação dos certificados e CRLs do caminho de certificação da assinatura e adiciona os resultados ao relatório da assinatura
void	addProcessedCriticalHeader(String attr)	Adiciona um atributo aos atributos processados que são críticos
void	addValidationData(JadesSignature signature)	Captura e adiciona artefatos presentes na assinatura (como certificados e CRLs) ao SignatureIdentityInformation da assinatura conforme a presença dos atributos CertificateValues e RevocationValues
boolean	checkCertPath(X509Certificate certificate)	Verifica se é possível criar o caminho de certificação da assinatura
protected boolean	checkSignaturePolicyPeriod()	Verifica se a assinatura foi feita dentro do período válido para o uso de políticas.
boolean	clear()	Limpa as informações do verificador
SignatureAttribute<JadesAttrCommonStruct>	getAttribute(JadesSignature signature, Class<? extends SignatureAttribute<JadesAttrCommonStruct>> attributeClass)	Retorna um atributo na assinatura, se presente
SignatureAttribute<JadesAttrCommonStruct>	getAttribute(Class<? extends SignatureAttribute<JadesAttrCommonStruct>> attributeClass)	Retorna Retorna um atributo na assinatura, se presente
List<SignatureAttribute<JadesAttrCommonStruct>>	getAttributeInstancesList(List<String> attributeClasses)	Retorna a lista de atributos na assinatura
List<String>	getAvailableAttributes()	Retorna os atributos das assinaturas
CertPath	getCertPath()	Retorna o caminho de certificação
CertPath	getCertPath(Certificate certificate)	Retorna o caminho de certificação do certificado dado
JadesSignatureComponent	getComponent()	Obtém o componente de assinaturas
List<String>	getMandatedAttributes()	Retorna uma lista de atributos obrigatórios
List<TstToken>	getOrderedTimeStamps()	Retorna uma lista de atributos de carimbo do tempo ordenada por identificador, de acordo com o especificado na lista de prioridade.
PaReport	getPaReport()	Retorna o relatório da política de assinatura
AdESType	getPolicyType()	Retorna o tipo da política de assinatura
AttributeList	getProhibitedAttributes(SignatureReport sigReport)	Caso exista na assinatura uma PoE de um tempo anterior a AbstractVerifierInterface.docICP1503TimePoint, captura os atributos proibidos conforme a política da assinatura.
JadesSignature	getSignature()
JadesSignatureContainer	getSignatureContainer()	Retorna o container contendo a assinatura
SignaturePolicyInterface	getSignaturePolicy()	Retorna a Política de Assinatura da assinatura passada na construção desta classe.
Certificate	getSignerCert()
X509Certificate	getSigningCertificate(JadesSignature sig)	Busca o certificado do assinante
X509Certificate	getSigningCertificateSigReport(SignatureReport sigReport)	Busca certificado do assinante de um relatório de assinatura
Date	getTimeReference()	Retorna o tempo em que o carimbo do tempo foi criado pela ACT.
List<String>	getTimeStampPriorityList()	Retorna a lista de prioridades dos carimbos do tempo
Date	getTSTimeReference()	Retorna o tempo em que o carimbo do tempo foi criado pela ACT.
boolean	hasProofOfExistence()	Retorna se há a presença de pelo menos um carimbo de tempo que forneça prova de existência.
boolean	hasSignedData()	Verifica se a assinatura selecionada possui dados assinados.
boolean	isTimeStamp()
boolean	needSignedContent()	Verifica se a assinatura possui conteúdo destacado
void	report(Report report, SignatureContainer<JadesSignature> signatureContainer)	Cria um objeto Report com as informações da verificação
void	report(Report report, SignatureWrapper wrapper)
void	selectSignatures(boolean isComplete)	Carrega as informações das assinaturas presentes no contâiner JAdES
void	selectTarget(byte[] target, byte[] detachedPayload)	Inicializa os bytes do documento JAdES assinado
void	setPolicyType(AdESType policyType)	Atribue o tipo da política de assinatura
void	setTimeReference(Date timeReference)	Atribue uma refêrencia de tempo que será utilizada no algoritmo de validação dos caminhos de certificação
boolean	supports(byte[] signature, byte[] detached)	Verifica se o documento assinado é uma assinatura JAdES
protected boolean	verifyAttributesInMandatedList(List<String> signatureAttributeList, List<String> attributesToExclude, SignatureReport sigReport)	Os atributos da assinatura que tem o seu identificador presente na lista de atributos obrigatórios passados aqui serão verificados.
protected void	verifyConformity(CertPath certPath, boolean advanced, SignatureReport report)	Verifica se a assinatura pertence a ICP-Brasil e adiciona a InitialSignatureReport a legislação ou âncoro de confiança que é respeitada pelo certificado do assinante
protected boolean	verifyOnlyUnmandatedAttributes(List<String> signatureAttributeList, List<String> attributesToExclude, SignatureReport sigReport)	Verifica apenas os atributos que não são obrigatórios segundo a lista passada.

Methods inherited from class AbstractSignatureVerifier

addPolicyToVerificationPackage, getContainerBytes, getCurrentTimeReference, getReceiptRequest, getReport, getSelectedSignature, makeVerificationPackage, setCurrentTimeReference, setup, setupLpaSig, signatureContainerChanged, withReturnArtifacts

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface AbstractVerifierInterface

getCurrentTimeReference

Methods inherited from interface JadesAbstractVerifierInterface

getSelectedSignature

Methods inherited from interface Verifier

checkLastCertificateName, isAnchored, isGovBr, isICPBr

Field Details

timeReference

protected Date timeReference

Tempo que será levado em conta para validar a assinatura

certPath

protected CertPath certPath

Caminho de certificação do assinante

Constructor Details

JadesVerifier

public JadesVerifier(JadesSignatureComponent component)

Construtor

Parameters:

component - Componente de assinatura JAdES

Method Details

selectTarget

public void selectTarget(byte[] target,
 byte[] detachedPayload)
                  throws VerificationException

Inicializa os bytes do documento JAdES assinado

Parameters:

target - Os bytes do documento JAdES assinado

detachedPayload - Os bytes do conteúdo assinado no documento

Throws:

VerificationException - Exceção caso os bytes não sejam uma assinatura válida

selectSignatures

public void selectSignatures(boolean isComplete)

Carrega as informações das assinaturas presentes no contâiner JAdES

Parameters:

isComplete - Se o relatório deve ser completo ou não

getProhibitedAttributes

public AttributeList getProhibitedAttributes(SignatureReport sigReport)

Description copied from interface: AbstractVerifierInterface

Caso exista na assinatura uma PoE de um tempo anterior a AbstractVerifierInterface.docICP1503TimePoint, captura os atributos proibidos conforme a política da assinatura. Caso contrário, retorna um AttributeList vazio.

Specified by:

getProhibitedAttributes in interface AbstractVerifierInterface<JadesInformation, JadesAttrCommonStruct, JadesSignature>

Parameters:

sigReport - relatório de assinatura

Returns:

Lista de atributos proibidos, seguindo normativos antigos caso haja uma PoE de um tempo anterior a AbstractVerifierInterface.docICP1503TimePoint. Caso contrário, um AttributeList vazio.

verifyConformity

protected void verifyConformity(CertPath certPath,
 boolean advanced,
 SignatureReport report)

Verifica se a assinatura pertence a ICP-Brasil e adiciona a InitialSignatureReport a legislação ou âncoro de confiança que é respeitada pelo certificado do assinante

Parameters:

certPath - caminho de certificação

advanced - se a assinatura é avançada

report - O relatório de verificação da assinatura

getOrderedTimeStamps

public List<TstToken> getOrderedTimeStamps()
                                    throws SignatureAttributeException

Retorna uma lista de atributos de carimbo do tempo ordenada por identificador, de acordo com o especificado na lista de prioridade. No caso de a lista conter mais do que um carimbo com o mesmo identificador, eles são ordenado por tempo. Na ordenação por tempo, é considerado que o tempo mais recente (ou seja, maior) tem maior prioridade.

Returns:

A lista de carimbo de tempo ordenada

Throws:

SignatureAttributeException

verifyAttributesInMandatedList

protected boolean verifyAttributesInMandatedList(List<String> signatureAttributeList,
 List<String> attributesToExclude,
 SignatureReport sigReport)

Os atributos da assinatura que tem o seu identificador presente na lista de atributos obrigatórios passados aqui serão verificados.

Na lista errors serão retornados os erros que comprometem a assinatura, já na lista de warnings seram retornados os erros que aconteceram mas não infuenciam na validade da assinatura.

Os atributos que tem seu identificador presente na lista attributesToExclude não serão verificados mesmo que presentes na lista de atributos obrigatórios

Parameters:

signatureAttributeList - lista de atributos presentes na assinatura que devem ser levados em conta

attributesToExclude - lista de atributos que devem ser desconsiderados

sigReport - o relatório de verificação

verifyOnlyUnmandatedAttributes

protected boolean verifyOnlyUnmandatedAttributes(List<String> signatureAttributeList,
 List<String> attributesToExclude,
 SignatureReport sigReport)

Verifica apenas os atributos que não são obrigatórios segundo a lista passada. A lista de atributos que não devem ser verificados mesmo que não sejam obrigatórios será levada em conta.

Parameters:

signatureAttributeList - lista de atributos da assinatura

attributesToExclude - atributos a serem ignorados

sigReport -

getAttributeInstancesList

public List<SignatureAttribute<JadesAttrCommonStruct>> getAttributeInstancesList(List<String> attributeClasses)

Retorna a lista de atributos na assinatura

Specified by:

getAttributeInstancesList in interface JadesAbstractVerifierInterface

Returns:

lista de atributos presente na assinatura

getAttribute

public SignatureAttribute<JadesAttrCommonStruct> getAttribute(Class<? extends SignatureAttribute<JadesAttrCommonStruct>> attributeClass)
                                                       throws SignatureAttributeException

Retorna Retorna um atributo na assinatura, se presente

Returns:

Atributo requisitado presente na assinatura

Throws:

SignatureAttributeException - quando o atributo não está presente na assinatura ou mal codificado

getAttribute

public SignatureAttribute<JadesAttrCommonStruct> getAttribute(JadesSignature signature,
 Class<? extends SignatureAttribute<JadesAttrCommonStruct>> attributeClass)
                                                       throws SignatureAttributeException

Retorna um atributo na assinatura, se presente

Returns:

Atributo requisitado presente na assinatura

Throws:

SignatureAttributeException - quando o atributo não está presente na assinatura ou mal codificado

getComponent

public JadesSignatureComponent getComponent()

Description copied from class: AbstractSignatureVerifier

Obtém o componente de assinaturas

Specified by:

getComponent in interface AbstractVerifierInterface<JadesInformation, JadesAttrCommonStruct, JadesSignature>

Specified by:

getComponent in interface JadesAbstractVerifierInterface

Specified by:

getComponent in interface Verifier

Specified by:

getComponent in class AbstractSignatureVerifier<JadesSignature>

Returns:

Componente de assinatura

getSignatureContainer

public JadesSignatureContainer getSignatureContainer()

Description copied from class: AbstractSignatureVerifier

Retorna o container contendo a assinatura

Specified by:

getSignatureContainer in class AbstractSignatureVerifier<JadesSignature>

Returns:

Container da assinatura

getAvailableAttributes

public List<String> getAvailableAttributes()

Retorna os atributos das assinaturas

Specified by:

getAvailableAttributes in interface Verifier

Returns:

Os atributos das assinaturas

getSigningCertificateSigReport

public X509Certificate getSigningCertificateSigReport(SignatureReport sigReport)

Busca certificado do assinante de um relatório de assinatura

Specified by:

getSigningCertificateSigReport in interface Verifier

Parameters:

sigReport - Relatório da assinatura que deseja descobrir o assinante

Returns:

Certificado do assinate

clear

public boolean clear()

Limpa as informações do verificador

Specified by:

clear in interface Verifier

Returns:

Indica se a limpeza foi bem sucedida

report

public void report(Report report,
 SignatureContainer<JadesSignature> signatureContainer)
            throws VerificationException

Cria um objeto Report com as informações da verificação

Specified by:

report in class AbstractSignatureVerifier<JadesSignature>

Parameters:

report - O relatório a ser preenchido

signatureContainer - Contêiner com as assinaturas

Throws:

VerificationException - Exceção caso haja algum problema na verificação

report

public void report(Report report,
 SignatureWrapper wrapper)
            throws VerificationException

Specified by:

report in interface Verifier

Throws:

VerificationException

needSignedContent

public boolean needSignedContent()

Verifica se a assinatura possui conteúdo destacado

Specified by:

needSignedContent in interface Verifier

Returns:

Indica se a assinatura possui conteúdo destacado

getMandatedAttributes

public List<String> getMandatedAttributes()

Retorna uma lista de atributos obrigatórios

Specified by:

getMandatedAttributes in interface Verifier

Returns:

Uma lista de atributos obrigatórios

addValidationData

public void addValidationData(JadesSignature signature)

Description copied from class: AbstractSignatureVerifier

Captura e adiciona artefatos presentes na assinatura (como certificados e CRLs) ao SignatureIdentityInformation da assinatura conforme a presença dos atributos CertificateValues e RevocationValues

Specified by:

addValidationData in class AbstractSignatureVerifier<JadesSignature>

Parameters:

signature - A assinatura

addCertificatesToValidation

protected void addCertificatesToValidation(SignatureReport sigReport,
 Certificate cert)
                                    throws SignatureNotICPBrException

Realiza a verificação dos certificados e CRLs do caminho de certificação da assinatura e adiciona os resultados ao relatório da assinatura

Parameters:

sigReport - O relatório da verificação da assinatura

cert - O certificado do assinante

Throws:

AIAException - Exceção em caso de erro ao obter o caminho de certificação

SignatureNotICPBrException

supports

public boolean supports(byte[] signature,
 byte[] detached)
                 throws SignatureNotICPBrException

Verifica se o documento assinado é uma assinatura JAdES

Specified by:

supports in interface Verifier

Parameters:

signature - Os bytes do documento assinado

detached - Os bytes do arquivo destacado

Returns:

Indica se o documento assinado é uma assinatura JAdES

Throws:

SignatureNotICPBrException - Exceção caso a assinatura não seja feita com um certificado ICP-Brasil

getCertPath

public CertPath getCertPath(Certificate certificate)

Retorna o caminho de certificação do certificado dado

Specified by:

getCertPath in interface Verifier

Parameters:

certificate - O certificado usado para gerar o caminho de certificação

Returns:

O caminho de certificação do certificado dado

getSigningCertificate

public X509Certificate getSigningCertificate(JadesSignature sig)

Busca o certificado do assinante

Specified by:

getSigningCertificate in interface JadesAbstractVerifierInterface

Specified by:

getSigningCertificate in class AbstractSignatureVerifier<JadesSignature>

Parameters:

sig - A assinatura a ser verificada

Returns:

O certificado do assinante

checkCertPath

public boolean checkCertPath(X509Certificate certificate)

Verifica se é possível criar o caminho de certificação da assinatura

Parameters:

certificate - Certificado utilizado na assinatura

Returns:

Indica se o caminho de certificação foi criado com sucesso

setPolicyType

public void setPolicyType(AdESType policyType)

Atribue o tipo da política de assinatura

Parameters:

policyType - O tipo da política

getPolicyType

public AdESType getPolicyType()

Retorna o tipo da política de assinatura

Returns:

O tipo da política

getSignaturePolicy

public SignaturePolicyInterface getSignaturePolicy()

Retorna a Política de Assinatura da assinatura passada na construção desta classe.

Specified by:

getSignaturePolicy in interface AbstractVerifierInterface<JadesInformation, JadesAttrCommonStruct, JadesSignature>

Returns:

A política de assinatura

setTimeReference

public void setTimeReference(Date timeReference)

Atribue uma refêrencia de tempo que será utilizada no algoritmo de validação dos caminhos de certificação

Parameters:

timeReference - tempo que será usado como referência para a validação do caminho de certificação

getTSTimeReference

public Date getTSTimeReference()

Retorna o tempo em que o carimbo do tempo foi criado pela ACT. Caso nenhum carimbo do tempo existir na assinatura, retorna-se nulo.

Specified by:

getTSTimeReference in interface AbstractVerifierInterface<JadesInformation, JadesAttrCommonStruct, JadesSignature>

Returns:

Horário em que o camrimbo do tempo foi criado pela ACT.

getTimeReference

public Date getTimeReference()

Retorna o tempo em que o carimbo do tempo foi criado pela ACT. Caso nenhum carimbo do tempo existir na assinatura, retorna-se o tempo atual.

Returns:

Horário em que o carimbo do tempo foi criado pela ACT ou horário atual.

hasProofOfExistence

public boolean hasProofOfExistence()

Retorna se há a presença de pelo menos um carimbo de tempo que forneça prova de existência.

Returns:

Retorna se há a presença de pelo menos um carimbo de tempo que forneça prova de existência.

getTimeStampPriorityList

public List<String> getTimeStampPriorityList()

Retorna a lista de prioridades dos carimbos do tempo

Returns:

a lista de prioridades dos carimbos do tempo

getSignature

public JadesSignature getSignature()

Specified by:

getSignature in interface AbstractVerifierInterface<JadesInformation, JadesAttrCommonStruct, JadesSignature>

isTimeStamp

public boolean isTimeStamp()

Specified by:

isTimeStamp in interface AbstractVerifierInterface<JadesInformation, JadesAttrCommonStruct, JadesSignature>

getCertPath

public CertPath getCertPath()

Retorna o caminho de certificação

Specified by:

getCertPath in interface AbstractVerifierInterface<JadesInformation, JadesAttrCommonStruct, JadesSignature>

Returns:

O caminho de certificação

getSignerCert

public Certificate getSignerCert()

Specified by:

getSignerCert in interface AbstractVerifierInterface<JadesInformation, JadesAttrCommonStruct, JadesSignature>

getPaReport

public PaReport getPaReport()

Retorna o relatório da política de assinatura

Returns:

O relatório da política de assinatura

checkSignaturePolicyPeriod

protected boolean checkSignaturePolicyPeriod()

Verifica se a assinatura foi feita dentro do período válido para o uso de políticas.

Returns:

Indica se a assinatura está dentro do período válido para o uso de políticas

addProcessedCriticalHeader

public void addProcessedCriticalHeader(String attr)

Adiciona um atributo aos atributos processados que são críticos

Specified by:

addProcessedCriticalHeader in interface JadesAbstractVerifierInterface

Parameters:

attr - Os atributos processados

hasSignedData

public boolean hasSignedData()

Verifica se a assinatura selecionada possui dados assinados. Retorna true se a assinatura não for do tipo detached, ou se for do tipo detached e houver dados assinados (signedData) disponíveis. Caso a assinatura seja detached e não haja dados assinados, retorna false.

Specified by:

hasSignedData in interface Verifier

Returns:

true se há dados assinados ou se a assinatura não for detached, caso contrário false.