iaik.x509.extensions.priv

Class IdentityLinkIssuer

java.lang.Object

iaik.x509.V3Extension

iaik.x509.extensions.priv.IdentityLinkIssuer

public class IdentityLinkIssuer
extends V3Extension

This class implements the IdentityLinkIssuer Extension as used in Austrian E-Government for certificates that are authorized to issue identity links. In this context this extension is called "Eigenschaft zur Ausstellung von Personenbindungen" (see http://reference.e-government.gv.at, Spezifikationen/Konventionen).

The IdentityLinkIssuer extension is a private X509v3 extension, which shall be used in identity link issuer certificates in Austrian E-Government. It shall be marked as being not critical.

The object identifier for the IdentityLinkIssuer extension is derived from the gv-at OID as used for the Austria adminstration:

gv-at ::= OBJECT IDENTIFIER ::= { iso(1) member-body(2) austria(40) (0) (10) } id-identityLinkIssuer OBJECT IDENTIFIER ::= { gv-at organization(1) sourcePINRegisterAuthority (7) 1 }

which corresponds to the OID string "1.2.40.0.10.1.7.1".

The ASN.1 definition of the IdentityLinkIssuer extension is specified as follows:

 IdentityLinkIssuer ::= CHOICE {
   isIdentityLinkIssuer alwaysTrue,
   isNull NULL }

 alwaysTrue BOOLEAN ::= TRUE
 

The alwaysTrue choice is only included for backwards compatibility to former versions of the IdentityLinkIssuer extension. Newly issued certificates must use the isNull option.

Since the IdentityLinkIssuer extension has no specific value (only is presence in a certificate is sufficient to recognize the certificate as authorized to issue identity links) an IdentityLinkIssuer extension can be created by simply calling the default constructor (first you should register the MandateIssuer extension within the X509Extensions framework):

 X509Extensions.register(IdentityLinkIssuer.oid, IdentityLinkIssuer.class);
 ...
 
 X509Certificate certificate = new X509Certificate();
  ...
 IdentityLinkIssuer identityLinkIssuer = new IdentityLinkIssuer();
 certificate.addExtension(identityLinkIssuer);
 
 Use method getExtension for getting
 a IdentityLinkIssuer extension when parsing a certificate:
 
 X509Certificate cert = ...;
 ...
 // look if IdentityLinkIssuer extension is included:
 IdentityLinkIssuer identityLinkIssuer = cert.getExtension(IdentityLinkIssuer.oid);
 if (identityLinkIssuer != null) {
   ...
 }
 
 

See Also:

ObjectID, X509Certificate, X509Extensions, V3Extension

Field Summary

Fields

Modifier and Type	Field and Description
static ObjectID	oid The object identifier of this IdentityLinkIssuer extension.

Fields inherited from class iaik.x509.V3Extension

critical

Constructor Summary

Constructors

Constructor and Description
IdentityLinkIssuer() Creates a new IdentityLinkIssuer extension.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object otherObject) Compares this object with the given one.
ObjectID	getObjectID() Returns the object ID of this IdentityLinkIssuer extension.
int	hashCode() Returns a hashcode for this identity.
void	init(ASN1Object asn1Object) Inits this IdentityLinkIssuer implementation with an ASN1Object representing the value of this extension.
ASN1Object	toASN1Object() Returns an ASN1Object representing the value of this IdentityLinkIssuer extension object.
java.lang.String	toString() Returns a string that represents the contents of this extension.

Methods inherited from class iaik.x509.V3Extension

getName, isCritical, setCritical

Methods inherited from class java.lang.Object

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

Field Detail

oid

public static final ObjectID oid

The object identifier of this IdentityLinkIssuer extension. The corresponding OID string is "1.2.40.0.10.1.7.1".

Constructor Detail

IdentityLinkIssuer

public IdentityLinkIssuer()

Creates a new IdentityLinkIssuer extension.

Method Detail

getObjectID

public ObjectID getObjectID()

Returns the object ID of this IdentityLinkIssuer extension.

Specified by:

getObjectID in class V3Extension

Returns:

The object ID ("1.2.40.0.10.1.7.1") of this extension.

init

public void init(ASN1Object asn1Object)
          throws X509ExtensionException

Inits this IdentityLinkIssuer implementation with an ASN1Object representing the value of this extension.

The given ASN1Object may be the one created by toASN1Object().

This method is used by the X509Extensions class when parsing the ASN.1 representation of a certificate for properly initializing an included IdentityLinkIssuer extension. This method initializes the extension only with its value, but not with its critical specification. For that reason, this method shall not be explicitly called by an application.

Specified by:

init in class V3Extension

Parameters:

asn1Object - The IdentityLinkIssuer extension value as ASN1Object (NULL or BOOLEAN (deprecated)).

Throws:

X509ExtensionException - If the extension value is not an ASN.1 NULL object

toASN1Object

public ASN1Object toASN1Object()

Returns an ASN1Object representing the value of this IdentityLinkIssuer extension object.

The returned ASN1Object is either an ASN.1 NULL object or (for deprecated extensions) an ASN.1 BOOLEAN:

 IdentityLinkIssuer ::= CHOICE {
   isIdentityLinkIssuer alwaysTrue,
   isNull NULL }
 

Specified by:

toASN1Object in class V3Extension

Returns:

The value of this IdentityLinkIssuer as ASN1Object (NULL or BOOLEAN).

hashCode

public int hashCode()

Returns a hashcode for this identity.

Specified by:

hashCode in class V3Extension

Returns:

A hash code for this identity

equals

public boolean equals(java.lang.Object otherObject)

Compares this object with the given one.

Overrides:

equals in class java.lang.Object

Parameters:

otherObject - The other object to compare with.

Returns:

true, if this object is equal to the other object, false otherwise.

toString

public java.lang.String toString()

Returns a string that represents the contents of this extension. Since the IdentityLinkIssuer does not have a value, this method in any case returns an empty String ("").

Overrides:

toString in class java.lang.Object

Returns:

The string representation of this object.