org.bouncycastle.asn1.x509

Class CertDiscoveryMethod

java.lang.Object

org.bouncycastle.asn1.ASN1Object

org.bouncycastle.asn1.x509.CertDiscoveryMethod

All Implemented Interfaces:

ASN1Choice, ASN1Encodable, Encodable

public class CertDiscoveryMethod
extends ASN1Object
implements ASN1Choice

The method used to retrieve a related certificate, as defined by draft-ietf-lamps-certdiscovery-04 (A Mechanism for X.509 Certificate Discovery).

     CertDiscoveryMethod ::= CHOICE {
         byUri          IA5String,
         byInclusion    Certificate,
         byLocalPolicy  NULL,
         byOther        [0] INSTANCE OF OTHER-DISCOVERY-METHOD
     }

     OTHER-DISCOVERY-METHOD ::= TYPE-IDENTIFIER
 

The module is defined with EXPLICIT TAGS, so byOther is an explicitly tagged SEQUENCE { type-id OBJECT IDENTIFIER, value [0] EXPLICIT ANY DEFINED BY type-id }, the same shape as an X.509 OtherName.

byUri carries the URI from which the Referenced Certificate may be retrieved, byInclusion embeds the Referenced Certificate directly, byLocalPolicy signals that the relying party is expected to resolve it through local configuration, and byOther carries a method defined outside the draft, identified by its type-id.

Field Summary

Fields

Modifier and Type	Field and Description
static int	byInclusion Alternative index for byInclusion.
static int	byLocalPolicy Alternative index for byLocalPolicy.
static int	byOther Alternative index for byOther (carried on the wire under context tag [0]).
static int	byUri Alternative index for byUri.

Method Summary

Modifier and Type	Method and Description
static CertDiscoveryMethod	byInclusion(Certificate certificate) Create a byInclusion discovery method embedding the supplied certificate directly.
static CertDiscoveryMethod	byLocalPolicy() Create a byLocalPolicy discovery method (the wire form is ASN.1 NULL; the relying party resolves the certificate through local configuration).
static CertDiscoveryMethod	byOther(ASN1ObjectIdentifier methodType, ASN1Encodable methodValue) Create a byOther discovery method, an instance of the OTHER-DISCOVERY-METHOD information object class.
static CertDiscoveryMethod	byUri(java.lang.String uri) Create a byUri discovery method carrying the supplied URI.
Certificate	getCertificate() Return the certificate carried by a byInclusion method, or null for the other alternatives.
static CertDiscoveryMethod	getInstance(java.lang.Object obj)
ASN1ObjectIdentifier	getOtherMethodType() Return the type-id of a byOther method, or null for the other alternatives.
ASN1Encodable	getOtherMethodValue() Return the value of a byOther method, or null for the other alternatives.
int	getType() Return one of byUri, byInclusion, byLocalPolicy, byOther.
java.lang.String	getUri() Return the URI carried by a byUri method, or null for the other alternatives.
ASN1Primitive	toASN1Primitive() Method providing a primitive representation of this object suitable for encoding.

Methods inherited from class org.bouncycastle.asn1.ASN1Object

encodeTo, encodeTo, equals, getEncoded, getEncoded, hasEncodedTagValue, hashCode

Methods inherited from class java.lang.Object

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

Field Detail

byUri

public static final int byUri

Alternative index for byUri.

See Also:

Constant Field Values

byInclusion

public static final int byInclusion

Alternative index for byInclusion.

See Also:

Constant Field Values

byLocalPolicy

public static final int byLocalPolicy

Alternative index for byLocalPolicy.

See Also:

Constant Field Values

byOther

public static final int byOther

Alternative index for byOther (carried on the wire under context tag [0]).

See Also:

Constant Field Values

Method Detail

byUri

public static CertDiscoveryMethod byUri(java.lang.String uri)

Create a byUri discovery method carrying the supplied URI.

byInclusion

public static CertDiscoveryMethod byInclusion(Certificate certificate)

Create a byInclusion discovery method embedding the supplied certificate directly.

byLocalPolicy

public static CertDiscoveryMethod byLocalPolicy()

Create a byLocalPolicy discovery method (the wire form is ASN.1 NULL; the relying party resolves the certificate through local configuration).

byOther

public static CertDiscoveryMethod byOther(ASN1ObjectIdentifier methodType,
                                          ASN1Encodable methodValue)

Create a byOther discovery method, an instance of the OTHER-DISCOVERY-METHOD information object class.

Parameters:

methodType - the type-id identifying the method.

methodValue - the value associated with that type-id.

getInstance

public static CertDiscoveryMethod getInstance(java.lang.Object obj)

getType

public int getType()

Return one of byUri, byInclusion, byLocalPolicy, byOther.

getUri

public java.lang.String getUri()

Return the URI carried by a byUri method, or null for the other alternatives.

getCertificate

public Certificate getCertificate()

Return the certificate carried by a byInclusion method, or null for the other alternatives.

getOtherMethodType

public ASN1ObjectIdentifier getOtherMethodType()

Return the type-id of a byOther method, or null for the other alternatives.

getOtherMethodValue

public ASN1Encodable getOtherMethodValue()

Return the value of a byOther method, or null for the other alternatives.

toASN1Primitive

public ASN1Primitive toASN1Primitive()

Description copied from class: ASN1Object

Method providing a primitive representation of this object suitable for encoding.

Specified by:

toASN1Primitive in interface ASN1Encodable

Specified by:

toASN1Primitive in class ASN1Object

Returns:

a primitive representation of this object.