sun.security.x509

Class AuthorityInfoAccessExtension

java.lang.Object

sun.security.x509.Extension

sun.security.x509.AuthorityInfoAccessExtension

All Implemented Interfaces:

CertAttrSet<java.lang.String>

public class AuthorityInfoAccessExtension
extends Extension
implements CertAttrSet<java.lang.String>

The Authority Information Access Extension (OID = 1.3.6.1.5.5.7.1.1).

The AIA extension identifies how to access CA information and services for the certificate in which it appears. It enables CAs to issue their certificates pre-configured with the URLs appropriate for contacting services relevant to those certificates. For example, a CA may issue a certificate that identifies the specific OCSP Responder to use when performing on-line validation of that certificate.

This extension is defined in Internet X.509 PKI Certificate and Certificate Revocation List (CRL) Profile. The profile permits the extension to be included in end-entity or CA certificates, and it must be marked as non-critical. Its ASN.1 definition is as follows:

   id-pe-authorityInfoAccess OBJECT IDENTIFIER ::= { id-pe 1 }

   AuthorityInfoAccessSyntax  ::=
         SEQUENCE SIZE (1..MAX) OF AccessDescription

   AccessDescription  ::=  SEQUENCE {
         accessMethod          OBJECT IDENTIFIER,
         accessLocation        GeneralName  }
 

See Also:

Extension, CertAttrSet

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DESCRIPTIONS
static java.lang.String	IDENT Identifier for this attribute, to be used with the get, set, delete methods of Certificate, x509 type.
static java.lang.String	NAME Attribute name.

Fields inherited from class sun.security.x509.Extension

critical, extensionId, extensionValue

Constructor Summary

Constructors

Constructor and Description
AuthorityInfoAccessExtension(java.lang.Boolean critical, java.lang.Object value) Create the extension from the passed DER encoded value of the same.
AuthorityInfoAccessExtension(java.util.List<AccessDescription> accessDescriptions) Create an AuthorityInfoAccessExtension from a List of AccessDescription; the criticality is set to false.

Method Summary

Methods

Modifier and Type	Method and Description
void	delete(java.lang.String name) Delete the attribute value.
void	encode(java.io.OutputStream out) Write the extension to the DerOutputStream.
java.lang.Object	get(java.lang.String name) Get the attribute value.
java.util.List<AccessDescription>	getAccessDescriptions() Return the list of AccessDescription objects.
java.util.Enumeration<java.lang.String>	getElements() Return an enumeration of names of attributes existing within this attribute.
java.lang.String	getName() Return the name of this attribute.
void	set(java.lang.String name, java.lang.Object obj) Set the attribute value.
java.lang.String	toString() Return the extension as user readable string.

Methods inherited from class sun.security.x509.Extension

encode, equals, getExtensionId, getExtensionValue, hashCode, isCritical

Methods inherited from class java.lang.Object

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

Field Detail

IDENT

public static final java.lang.String IDENT

Identifier for this attribute, to be used with the get, set, delete methods of Certificate, x509 type.

See Also:

Constant Field Values

NAME

public static final java.lang.String NAME

Attribute name.

See Also:

Constant Field Values

DESCRIPTIONS

public static final java.lang.String DESCRIPTIONS

See Also:

Constant Field Values

Constructor Detail

AuthorityInfoAccessExtension

public AuthorityInfoAccessExtension(java.util.List<AccessDescription> accessDescriptions)
                             throws java.io.IOException

Create an AuthorityInfoAccessExtension from a List of AccessDescription; the criticality is set to false.

Parameters:

accessDescriptions - the List of AccessDescription

Throws:

java.io.IOException - on error

AuthorityInfoAccessExtension

public AuthorityInfoAccessExtension(java.lang.Boolean critical,
                            java.lang.Object value)
                             throws java.io.IOException

Create the extension from the passed DER encoded value of the same.

Parameters:

critical - true if the extension is to be treated as critical.

value - Array of DER encoded bytes of the actual value.

Throws:

java.io.IOException - on error.

Method Detail

getAccessDescriptions

public java.util.List<AccessDescription> getAccessDescriptions()

Return the list of AccessDescription objects.

getName

public java.lang.String getName()

Return the name of this attribute.

Specified by:

getName in interface CertAttrSet<java.lang.String>

Returns:

the name of this CertAttrSet.

encode

public void encode(java.io.OutputStream out)
            throws java.io.IOException

Write the extension to the DerOutputStream.

Specified by:

encode in interface CertAttrSet<java.lang.String>

Parameters:

out - the DerOutputStream to write the extension to.

Throws:

java.io.IOException - on encoding errors.

set

public void set(java.lang.String name,
       java.lang.Object obj)
         throws java.io.IOException

Set the attribute value.

Specified by:

set in interface CertAttrSet<java.lang.String>

Parameters:

name - the name of the attribute (e.g. "x509.info.key")

obj - the attribute object.

Throws:

java.io.IOException - on other errors.

get

public java.lang.Object get(java.lang.String name)
                     throws java.io.IOException

Get the attribute value.

Specified by:

get in interface CertAttrSet<java.lang.String>

Parameters:

name - the name of the attribute to return.

Throws:

java.io.IOException - on other errors.

delete

public void delete(java.lang.String name)
            throws java.io.IOException

Delete the attribute value.

Specified by:

delete in interface CertAttrSet<java.lang.String>

Parameters:

name - the name of the attribute to delete.

Throws:

java.io.IOException - on other errors.

getElements

public java.util.Enumeration<java.lang.String> getElements()

Return an enumeration of names of attributes existing within this attribute.

Specified by:

getElements in interface CertAttrSet<java.lang.String>

Returns:

an enumeration of the attribute names.

toString

public java.lang.String toString()

Return the extension as user readable string.

Specified by:

toString in interface CertAttrSet<java.lang.String>

Overrides:

toString in class Extension

Returns:

value of this certificate attribute in printable form.