com.entrust.toolkit.x509.extensions

Class IssuingDistributionPoint

java.lang.Object

iaik.x509.V3Extension

com.entrust.toolkit.x509.extensions.IssuingDistributionPoint

Deprecated.

As of JTK 6.0; Use the class iaik.x509.extenstions.IssuingDistributionPoint

public class IssuingDistributionPoint
extends V3Extension

This class implements the IssuingDistributionPoint Extension.

This CRL extension field identifies the CRL distribution point for this particular CRL, and indicates if the CRL is limited to revocations for end-entity certificates only, for CA-certificates only, or for a limited set of reasons only.

The IssuingDistributionPoint OID is "2.5.29.28".

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

 IssuingDistPointSyntax ::= SEQUENCE {
     distributionPoint          [0] DistributionPointName OPTIONAL,
     onlyContainsUserCerts      [1] BOOLEAN DEFAULT FALSE,
     onlyContainsCACerts            [2] BOOLEAN DEFAULT FALSE,
     onlySomeReasons                [3] ReasonFlags OPTIONAL,
     indirectCRL                            [4] BOOLEAN DEFAULT FALSE }
 

The distributionPoint component contains the name of the distribution point in one or more name forms. If this field is absent, the CRL shall contain entries for all revoked unexpired certificates issued by the CRL issuer.

If onlyContainsUserCerts is true, the CRL only contains revocations for end-entity certificates. If onlyContainsCACerts is true, the CRL only contains revocations for CA-certificates.

If onlySomeReasons is present, the CRL only contains revocations for the identified reason or reasons, otherwise the CRL contains revocations for all reasons.

If indirectCRL is true, then the CRL may contain revocation notifications from CAs other than the issuer of the CRL.

This class provides several methods for setting and getting the component values of a IssuingDistributionPoint extension object.

Copyright 1998 Entrust Technologies Limited.

Version:

1.0

See Also:

V3Extension, X509Certificate, DistributionPointName

Field Summary

Fields

Modifier and Type	Field and Description
static ObjectID	oid Deprecated.

Fields inherited from class iaik.x509.V3Extension

critical

Constructor Summary

Constructors

Constructor and Description
IssuingDistributionPoint() Deprecated. Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
DistributionPointName	getDistributionPoint() Deprecated. Returns the distributionPoint value of this IssuingDistributionPoint extension specifying the name of the distribution point in one or more name forms.
boolean	getIndirectCRL() Deprecated. Returns true if this is an indirect CRL, false otherwise.
ObjectID	getObjectID() Deprecated. Returns the object ID of this IssuingDistributionPoint extension
boolean	getOnlyContainsCACerts() Deprecated. Returns true if the CRL contains only CA certificates, false otherwise.
boolean	getOnlyContainsUserCerts() Deprecated. Returns true if the CRL contains only end-entity certificates, false otherwise.
int	getReasons() Deprecated. Returns the onlySomeReasons value of this IssuingDistributionPoint extension specifying the revocation reasons supported by this CRL.
int	hashCode() Deprecated. Returns a hashcode for this identity.
void	init(ASN1Object point) Deprecated. Inits this IssuingDistributionPoint implementation with an ASN1Object representing the value of this extension.
void	setDistributionPoint(DistributionPointName dpn) Deprecated. Stores the distributionPoint value in this IssuingDistributionPoint extension.
void	setOnlyContainsCACerts(boolean onlyContainsCACerts) Deprecated. Sets the flag indicating that this CRL contains only CA certificates.
void	setOnlyContainsUserCerts(boolean onlyContainsUserCerts) Deprecated. Sets the flag indicating that this CRL contains only end-entity certificates.
void	setReasons(int onlySomeReasons) Deprecated. Sets the onlySomeReasons value of this IssuingDistributionPoint extension specifying the revocation reasons supported by this CRL.
ASN1Object	toASN1Object() Deprecated. Returns the value of this IssuingDistributionPoint extension as an ASN1Object.
java.lang.String	toString() Deprecated. Returns a string that represents the contents of this IssuingDistributionPoint extension.

Methods inherited from class iaik.x509.V3Extension

getName, isCritical, setCritical

Methods inherited from class java.lang.Object

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

Field Detail

oid

public static final ObjectID oid

Deprecated.

Constructor Detail

IssuingDistributionPoint

public IssuingDistributionPoint()

Deprecated.

Default constructor.

Generating a new IssuingDistributionPoint extension is not supported. This class is provided for compatibility with existing CRLs only.

Method Detail

getObjectID

public ObjectID getObjectID()

Deprecated.

Returns the object ID of this IssuingDistributionPoint extension

Specified by:

getObjectID in class V3Extension

Returns:

the object ID

init

public void init(ASN1Object point)
          throws X509ExtensionException

Deprecated.

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

The ASN1Object is the extensionValue from ASN.1 type "Extension" representing the (optional) distributionPoint, onlyContainsUserCerts, onlyContainsCACerts, (optional) onlySomeReasons, and indirectCRL values of this extension.

Specified by:

init in class V3Extension

Parameters:

point - the extensionValue as an ASN1Object

Throws:

X509ExtensionException - if the extension could not be parsed

toASN1Object

public ASN1Object toASN1Object()
                        throws X509ExtensionException

Deprecated.

Returns the value of this IssuingDistributionPoint extension as an ASN1Object.

Specified by:

toASN1Object in class V3Extension

Returns:

the value of the extension as ASN1Object

Throws:

X509ExtensionException - if there was an error while creating the ASN1Object

See Also:

init(iaik.asn1.ASN1Object)

setDistributionPoint

public void setDistributionPoint(DistributionPointName dpn)

Deprecated.

Stores the distributionPoint value in this IssuingDistributionPoint extension.

Parameters:

dpn - the distributionPoint.

getDistributionPoint

public DistributionPointName getDistributionPoint()

Deprecated.

Returns the distributionPoint value of this IssuingDistributionPoint extension specifying the name of the distribution point in one or more name forms. If this field is absent, the CRL shall contain entries for all revoked unexpired certificates issued by the CRL issuer. In this case the method returns null. The value of the distributionPoint is returned as a DistributionPointName object. Please refer to the DistributionPointName documentation for structure details.

Returns:

the distributionPoint value.

setOnlyContainsUserCerts

public void setOnlyContainsUserCerts(boolean onlyContainsUserCerts)

Deprecated.

Sets the flag indicating that this CRL contains only end-entity certificates.

Parameters:

onlyContainsUserCerts - true if the CRL contains only end-entity certificates, false otherwise.

getOnlyContainsUserCerts

public boolean getOnlyContainsUserCerts()

Deprecated.

Returns true if the CRL contains only end-entity certificates, false otherwise.

Returns:

true if the CRL contains only end-entity certificates, false otherwise.

setOnlyContainsCACerts

public void setOnlyContainsCACerts(boolean onlyContainsCACerts)

Deprecated.

Sets the flag indicating that this CRL contains only CA certificates.

Parameters:

onlyContainsCACerts - true if the CRL contains only CA certificates, false otherwise.

getOnlyContainsCACerts

public boolean getOnlyContainsCACerts()

Deprecated.

Returns true if the CRL contains only CA certificates, false otherwise.

Returns:

true if the CRL contains only CA certificates, false otherwise.

setReasons

public void setReasons(int onlySomeReasons)

Deprecated.

Sets the onlySomeReasons value of this IssuingDistributionPoint extension specifying the revocation reasons supported by this CRL. If this field is not present in the extension then the CRL must contain all revocations issued by the CA, regardless of reason.

Parameters:

onlySomeReasons - the reasons bitmask encoded as an int

getReasons

public int getReasons()

Deprecated.

Returns the onlySomeReasons value of this IssuingDistributionPoint extension specifying the revocation reasons supported by this CRL. If this field is not present in the extension then the CRL must contain all revocations issued by the CA, regardless of reason.

The onlySomeReasons is returned as an int. Individual bits must be tested to determine which reasons are supported. A default value of -1 indicates that all reasons are supported.

Returns:

the onlySomeReasons value.

getIndirectCRL

public boolean getIndirectCRL()

Deprecated.

Returns true if this is an indirect CRL, false otherwise.

Returns:

true if this is an indirect CRL, false otherwise.

hashCode

public int hashCode()

Deprecated.

Returns a hashcode for this identity.

Specified by:

hashCode in class V3Extension

Returns:

a hash code for this identity

toString

public java.lang.String toString()

Deprecated.

Returns a string that represents the contents of this IssuingDistributionPoint extension.

Overrides:

toString in class java.lang.Object

Returns:

the string representation