iaik.x509.extensions.priv

Class Officials

java.lang.Object

iaik.x509.V3Extension

iaik.x509.extensions.priv.Officials

public class Officials
extends V3Extension

This class implements the Officials extension as used for characterizing public authorities in Austrian E-Government. In this context this extension is called "Organwaltereigenschaft" (see http://reference.e-government.gv.at, Spezifikationen/Konventionen).

The Officials extension is a private X509v3 extension which may authorize the Austrian citizen card certificate owner to file a petition on behalf of someone other. This extension shall be marked as being not critical.

The object identifier for the Officials 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-Officials OBJECT IDENTIFIER ::= { gv-at partyRepresentation(3) 4 }

which corresponds to the OID string "1.2.40.0.10.3.4".

The Officials extension must contain the administration indicator (VKZ) of the authority or organization to which the officials ("Organwalter") belongs to:

 AdministrationIndicator ::= UTF8String
 

When creating a Officials extension, specify the administration indicator as String object (first you should register the Officials extension within the X509Extensions framework):

 X509Extensions.register(Officials.oid, Officials.class);
 ...
 X509Certificate certificate = new X509Certificate();
  ...
 String administrationIndicator = ...
 Officials officials = new Officials(administrationIndicator);
 certificate.addExtension(officials);
 

See Also:

ObjectID, X509Certificate, X509Extensions

Field Summary

Fields

Modifier and Type	Field and Description
protected UTF8String	administrationIndicator_ The code that identifies the public authority.
static ObjectID	oid The object identifier of this Officials extension.

Fields inherited from class iaik.x509.V3Extension

critical

Constructor Summary

Constructors

Constructor and Description
Officials() Creates an empty Officials extension.
Officials(java.lang.String administrationIndicator) Creates a new Officials extension for the given administration indicator.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object otherObject) Compares this object with the given one.
java.lang.String	getAdministrationIndicator() Gets the administration indicator value of this Officials extension.
ObjectID	getObjectID() Returns the object ID of this Officials extension.
int	hashCode() Returns a hashcode for this identity.
void	init(ASN1Object asn1Object) Inits this Officials implementation with an ASN1Object representing the value of this extension.
ASN1Object	toASN1Object() Returns an ASN1Object representing the value of this Officials 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 Officials extension. The corresponding OID string is "1.2.40.0.10.3.4".

administrationIndicator_

protected UTF8String administrationIndicator_

The code that identifies the public authority.

Constructor Detail

Officials

public Officials()

Creates an empty Officials extension.

This constructor is only used for dynamic object creation. Applications shall NOT use this constructor, they shall use the Officials(String administrationIndicator_) constructor to create an Officials extension with an administration indicator.

Officials

public Officials(java.lang.String administrationIndicator)

Creates a new Officials extension for the given administration indicator.

The administration indicator value will be encoded as UTF8String.

Parameters:

administrationIndicator - the administration indicator string of the authority

Method Detail

getObjectID

public ObjectID getObjectID()

Returns the object ID of this Officials extension.

Specified by:

getObjectID in class V3Extension

Returns:

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

init

public void init(ASN1Object asn1Object)
          throws X509ExtensionException

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

The given ASN1Object is 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 Officials 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 Officials extension value as ASN1Object.

Throws:

X509ExtensionException - If the extension could not be parsed

toASN1Object

public ASN1Object toASN1Object()

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

Specified by:

toASN1Object in class V3Extension

Returns:

The value of this Officials as ASN1Object.

getAdministrationIndicator

public java.lang.String getAdministrationIndicator()

Gets the administration indicator value of this Officials extension.

Returns:

The administration indicator string of this extension

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.

Overrides:

toString in class java.lang.Object

Returns:

The string representation of this object.