iaik.x509.attr

Class V1Form

java.lang.Object

iaik.x509.attr.V1Form

All Implemented Interfaces:

AttCertIssuer

public class V1Form
extends java.lang.Object
implements AttCertIssuer

This class implements the AC type V1Form.

The Internet Attribute Certificate Profile for Authorization specifies the V1Form type as TO BE USED option for identifying the issuer of an attribute certificate (entity who signs the attribute certificate):

 AttCertIssuer ::= CHOICE {
    v1Form   GeneralNames,  -- v1 or v2
    v2Form   [0] V2Form     -- v2 only
 }
 

Attribute certifcates conforming to the Internet Attribute Certificate Profile for Authorization presented in draft-ietf-pkix-ac509prof-06.txt are not allowed to use the V2Form choice for representing the issuer. They must use the v1Form choice, which must contain one and only one GeneralName, which must contain a non- empty distinguished name in the directoryName field. This means that all AC issuers must have non-empty distinguished names.
Part of the reason for the use of the v1Form field is that it means that the AC issuer does not have to know which PKC the AC verifier will use for it (the AC issuer). Using the baseCertificateID field to reference the AC issuer would mean that the AC verifier would have to trust the PKC that the AC issuer chose (for itself) at AC creation time.

See Also:

AttributeCertificate, IssuerSerial, ObjectDigestInfo, AlgorithmID, V2Form

Field Summary

Fields inherited from interface iaik.x509.attr.AttCertIssuer

V1_FORM, V2_FORM

Constructor Summary

Constructors

Constructor and Description
V1Form(ASN1Object obj) Creates a V1Form from its ASN.1 representation.
V1Form(GeneralNames generalNames) Creates a V1Form from the given GeneralNames.
V1Form(Name issuerName) Creates a V1Form for the given issuer name.

Method Summary

Modifier and Type	Method and Description
void	decode(ASN1Object obj) Decodes a V1Form from its ASN.1 representation.
boolean	equals(java.lang.Object obj) Compares this V1Form to the specified object.
GeneralNames	getGeneralNames() Gets the GeneralNames of this V1Form.
int	getVForm() Returns 1 (v1Form -- the version this AttcertIssuer represents).
int	hashCode() Returns a hashcode for this V1Form.
boolean	isV1FormFor(Name issuerName) Checks if this V1Form represents the given issuerName.
ASN1Object	toASN1Object() Returns this V1Form as ASN1Object.
java.lang.String	toString() Returns a string giving some information about this V1Form object.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

V1Form

public V1Form(GeneralNames generalNames)

Creates a V1Form from the given GeneralNames.

Parameters:

generalNames - the GeneralNames identifying the AC issuer

V1Form

public V1Form(Name issuerName)

Creates a V1Form for the given issuer name.

A GeneralName for the given directoryName is internally created according to the requirements of draft-ietf-pkix-ac509prof-06.txt: "Conforming ACs must contain one and only one GeneralName, which must contain a non-empty distinguished name in the directoryName field. This means that all AC issuers must have non-empty distinguished names".

Parameters:

issuerName - the name of the AC issuer

V1Form

public V1Form(ASN1Object obj)
       throws CodingException

Creates a V1Form from its ASN.1 representation.

Parameters:

obj - the V1Form as ASN1Object

Throws:

CodingException - if an decoding/parsing error occurs

Method Detail

getGeneralNames

public GeneralNames getGeneralNames()

Gets the GeneralNames of this V1Form.

Returns:

the GeneralNames identifying the AC issuer

toASN1Object

public ASN1Object toASN1Object()

Returns this V1Form as ASN1Object.

Specified by:

toASN1Object in interface AttCertIssuer

Returns:

this V1Form as ASN1Object

decode

public void decode(ASN1Object obj)
            throws CodingException

Decodes a V1Form from its ASN.1 representation.

Specified by:

decode in interface AttCertIssuer

Parameters:

obj - the V1Form as ASN1Object

Throws:

CodingException - if an decoding/parsing error occurs

equals

public boolean equals(java.lang.Object obj)

Compares this V1Form to the specified object.

Specified by:

equals in interface AttCertIssuer

Overrides:

equals in class java.lang.Object

Parameters:

obj - the object to compare this V1Form against.

Returns:

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

isV1FormFor

public boolean isV1FormFor(Name issuerName)

Checks if this V1Form represents the given issuerName.

Returns:

true if this is a V1Form for the given issuer name, false if not

hashCode

public int hashCode()

Returns a hashcode for this V1Form.

Specified by:

hashCode in interface AttCertIssuer

Overrides:

hashCode in class java.lang.Object

Returns:

a hashcode for this V1Form

getVForm

public int getVForm()

Returns 1 (v1Form -- the version this AttcertIssuer represents).

Specified by:

getVForm in interface AttCertIssuer

toString

public java.lang.String toString()

Returns a string giving some information about this V1Form object.

Specified by:

toString in interface AttCertIssuer

Overrides:

toString in class java.lang.Object

Returns:

the string representation