iaik.pdf.asn1objects

Class SignaturePolicyIdentifier

java.lang.Object

iaik.asn1.structures.AttributeValue

iaik.pdf.asn1objects.SignaturePolicyIdentifier

All Implemented Interfaces:

iaik.asn1.ASN1Type

public class SignaturePolicyIdentifier
extends iaik.asn1.structures.AttributeValue

This class represents the signature-policy-identifier attribute, that shall be included in a CAdES-EPES signature as a signed attribute. This attribute is used to add a reference to a signature policy, in order to define rules for creation and validation of an electronic signature. The ASN.1 structure is as following: SignaturePolicyIdentifier ::= CHOICE{ signaturePolicyId SignaturePolicyId, signaturePolicyImplied SignaturePolicyImplied -- not used in this version} SignaturePolicyId ::= SEQUENCE { sigPolicyId SigPolicyId, sigPolicyHash SigPolicyHash, sigPolicyQualifiers SEQUENCE SIZE (1..MAX) OF SigPolicyQualifierInfo OPTIONAL} SignaturePolicyImplied ::= NULL SigPolicyId ::= OBJECT IDENTIFIER SigPolicyHash ::= OtherHashAlgAndValue OtherHashAlgAndValue ::= SEQUENCE { hashAlgorithm AlgorithmIdentifier, hashValue OtherHashValue } OtherHashValue ::= OCTET STRING The ASN.1 structure SigPolicyQualifierInfo is represented by the class SignaturePolicyQualifierInfo.

Field Summary

Fields

Modifier and Type	Field and Description
static iaik.asn1.ObjectID	oid The attributeType object identifier of the SignaturePolicyIdentifier attribute.

Constructor Summary

Constructors

Constructor and Description
SignaturePolicyIdentifier() Empty default constructor.
SignaturePolicyIdentifier(iaik.asn1.ASN1Object obj) Creates an SignaturePolicyIdentifier from its ASN.1 representation.
SignaturePolicyIdentifier(iaik.asn1.ObjectID policyID) Constructor for setting the applicable signature policy's ID.
SignaturePolicyIdentifier(iaik.asn1.ObjectID policyID, iaik.asn1.structures.AlgorithmID hashAlgorithm, byte[] policyHashValue) Constructor for setting the signature policy's ID, hash and hash algorithm.

Method Summary

Modifier and Type	Method and Description
void	addSignaturePolicyQualifier(SignaturePolicyQualifierInfo policyQualifier) Add a signature policy qualifier, to add further properties to the policy.
void	decode(iaik.asn1.ASN1Object obj) Decodes the given ASN.1 SignaturePolicyIdentifier object
boolean	equals(java.lang.Object obj) Compares this SignaturePolicyIdentifier to the specified object.
iaik.asn1.ObjectID	getAttributeType()
iaik.asn1.structures.AlgorithmID	getHashAlgorithm() Returns the hash algorithm used to calculate the hash value of this signature policy
iaik.asn1.ObjectID	getPolicyID() Returns this signature policy's ID
byte[]	getSigPolicyHash() The hash value of this signature policy.
java.util.ArrayList<SignaturePolicyQualifierInfo>	getSigPolicyQualifiers() Returns the signature policy qualifiers that had been set for this signature policy
iaik.asn1.ASN1Object	toASN1Object() Returns this SignaturePolicyIdentifier as ASN1Object.
java.lang.String	toString()

Methods inherited from class iaik.asn1.structures.AttributeValue

getName, multipleAllowed

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

oid

public static final iaik.asn1.ObjectID oid

The attributeType object identifier of the SignaturePolicyIdentifier attribute. The corresponding OID string is "1.2.840.113549.1.9.16.2.15".

Constructor Detail

SignaturePolicyIdentifier

public SignaturePolicyIdentifier()

Empty default constructor. Required for dynamic object creation. Shall NOT be used by an application.

SignaturePolicyIdentifier

public SignaturePolicyIdentifier(iaik.asn1.ObjectID policyID)

Constructor for setting the applicable signature policy's ID.

Parameters:

policyID - the ID of the signature policy

SignaturePolicyIdentifier

public SignaturePolicyIdentifier(iaik.asn1.ObjectID policyID,
                                 iaik.asn1.structures.AlgorithmID hashAlgorithm,
                                 byte[] policyHashValue)

Constructor for setting the signature policy's ID, hash and hash algorithm.

Parameters:

policyID - the ID of the signature policy

hashAlgorithm - the algorithm, that has been used to create the hash value

policyHashValue - hash value of the signature policy

SignaturePolicyIdentifier

public SignaturePolicyIdentifier(iaik.asn1.ASN1Object obj)
                          throws iaik.asn1.CodingException

Creates an SignaturePolicyIdentifier from its ASN.1 representation.

Parameters:

obj - the SignaturePolicyIdentifier as ASN1Object

Throws:

iaik.asn1.CodingException

Method Detail

addSignaturePolicyQualifier

public void addSignaturePolicyQualifier(SignaturePolicyQualifierInfo policyQualifier)

Add a signature policy qualifier, to add further properties to the policy.

Parameters:

policyQualifier - the signature policy qualifier to be added

decode

public void decode(iaik.asn1.ASN1Object obj)
            throws iaik.asn1.CodingException

Decodes the given ASN.1 SignaturePolicyIdentifier object

Parameters:

obj - the SignaturePolicyIdentifier as ASN1Object

Throws:

iaik.asn1.CodingException

toASN1Object

public iaik.asn1.ASN1Object toASN1Object()
                                  throws iaik.asn1.CodingException

Returns this SignaturePolicyIdentifier as ASN1Object.

Returns:

this SignaturePolicyIdentifier as ASN1Object

Throws:

iaik.asn1.CodingException

getAttributeType

public iaik.asn1.ObjectID getAttributeType()

Specified by:

getAttributeType in class iaik.asn1.structures.AttributeValue

getPolicyID

public iaik.asn1.ObjectID getPolicyID()

Returns this signature policy's ID

Returns:

the signature policy ID

getHashAlgorithm

public iaik.asn1.structures.AlgorithmID getHashAlgorithm()

Returns the hash algorithm used to calculate the hash value of this signature policy

Returns:

the hash algorithm used to calculate the signature policy hash or null, if no hash value is set

getSigPolicyHash

public byte[] getSigPolicyHash()

The hash value of this signature policy. The hash value 0 indicates that no hash value has been set and that it should not be checked.

Returns:

the signature policy's hash value

getSigPolicyQualifiers

public java.util.ArrayList<SignaturePolicyQualifierInfo> getSigPolicyQualifiers()

Returns the signature policy qualifiers that had been set for this signature policy

Returns:

the signature policy qualifiers

toString

public java.lang.String toString()

Specified by:

toString in class iaik.asn1.structures.AttributeValue

equals

public boolean equals(java.lang.Object obj)

Compares this SignaturePolicyIdentifier to the specified object.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the object to compare this SignaturePolicyIdentifier against.

Returns:

true, if the given object is equal to this SignaturePolicyIdentifier, false otherwise