iaik.x509.extensions.netscape
Class NetscapeRevocationUrl

java.lang.Object
  |
  +--iaik.x509.V3Extension
        |
        +--iaik.x509.extensions.netscape.NetscapeRevocationUrl

public class NetscapeRevocationUrl

extends V3Extension

This class implements the NetscapeRevocationUrl Extension.

Each Netscape certificate extension is associated with a specific certificateExtension object identifier, derived from:

 netscape OBJECT IDENTIFIER ::= { 2 16 840 1 113730 }
 netscape-cert-extension OBJECT IDENTIFIER :: = { netscape 1 }
 

The object identifier for the NetscapeRevocationUrl extension is defined as:

netscape-revocation-url OBJECT IDENTIFIER ::= { netscape-cert-extension 3 }

which corresponds to the OID string "2.16.840.1.113730.1.3".

The Netscape Certificate Specification specifies the NetscapeRevocationUrl extension as IA5String that represents a relative or absolute URL that can be used to check the revocation status of a certificate. The revocation check will be performed as an HTTP GET method using a url that is the concatenation of revocation-url and certificate-serial-number, where the certificate-serial-number is encoded as a string consisting of an even number of ascii hexadecimal digits. If the number of significant digits is odd, the string will have a single leading zero to ensure an even number of digits is generated. For example, if the netscape-base-url is https://www.certs-r-us.com/, the netscape-revocation-url is cgi-bin/check-rev.cgi?, and the certificate serial number is 173420, the resulting URL would be:

https://www.certs-r-us.com/cgi-bin/check-rev.cgi?02a56c

The server should return a document with a Content-Type of application/x-netscape-revocation. The document should contain a single ascii digit, '1' if the certificate is not curently valid, and '0' if it is curently valid.

You may specify a particular (relative or absolute) URL directly when creating a NetscapeRevocationUrl extension, or you may use the default constructor and supply the URL by using the setRevocationUrl method, e.g.:

 NetscapeRevocationUrl netscapeRevocationUrl = new NetscapeRevocationUrl();
 netscapeRevocationUrl.setRevocationUrl("cgi-bin/check-rev.cgi?");
 

Version:

File Revision 14

See Also:

V3Extension, X509Extensions, NetscapeBaseUrl

Field Summary

static ObjectID

oid The object ID of the X.509 extension NetscapeRevocationUrl.

Fields inherited from class iaik.x509.V3Extension

critical

Constructor Summary

NetscapeRevocationUrl()
Default constructor.

NetscapeRevocationUrl(String url)
Constructs a NetscapeRevocationUrl extension with a specified URL.

Method Summary

ObjectID	getObjectID() Returns the object ID of this NetscapeRevocationUrl extension
String	getRevocationUrl() Returns the revocation url.
int	hashCode() Returns a hashcode for this identity.
void	init(ASN1Object obj) Inits this NetscapeRevocationUrl implementation with an ASN1object representing the value of this extension.
void	setRevocationUrl(String url) Sets the revocation url.
ASN1Object	toASN1Object() Returns an ASN1Object representing the value of this NetscapeRevocationUrl extension object.
String	toString() Returns a string that represents the contents of this NetscapeRevocationUrl 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 ObjectID oid

The object ID of the X.509 extension NetscapeRevocationUrl.

Constructor Detail

NetscapeRevocationUrl

public NetscapeRevocationUrl()

Default constructor. Creates an empty NetscapeRevocationUrl object.

Use the setRevocationUrl method for specifying a particular (absolute or relative) URL value, e.g.:

 NetscapeRevocationUrl netscapeRevocationUrl = new NetscapeRevocationUrl();
 netscapeRevocationUrl.setRevocationUrl("cgi-bin/check-rev.cgi?");
 

NetscapeRevocationUrl

public NetscapeRevocationUrl(String url)

Constructs a NetscapeRevocationUrl extension with a specified URL.

The (absolute or relative) URL is given as a String value, for instance:

NetscapeRevocationUrl netscapeRevocationUrl = new NetscapeRevocationUrl("cgi-bin/check-rev.cgi?");

Parameters:

url - the revocation URL, as String

Method Detail

getObjectID

public ObjectID getObjectID()

Returns the object ID of this NetscapeRevocationUrl extension

Overrides:

getObjectID in class V3Extension

Returns:

the object ID

init

public void init(ASN1Object obj)

Inits this NetscapeRevocationUrl implementation with an ASN1object representing the value of this extension.

The given ASN1Object represents the IA5STRING (absolute or relative) URL value.

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 NetscapeRevocationUrl 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.

Overrides:

init in class V3Extension

Parameters:

obj - the NetscapeRevocationUrl as ASN1Object

toASN1Object

public ASN1Object toASN1Object()

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

The returned ASN1Object represents the IA5STRING (absolute or relative) URL value.

Overrides:

toASN1Object in class V3Extension

Returns:

the value of this NetscapeRevocationUrl as ASN1Object

setRevocationUrl

public void setRevocationUrl(String url)

Sets the revocation url.

The (absolute or relative) URL value is given as String, e.g.:

 NetscapeRevocationUrl netscapeRevocationUrl = new NetscapeRevocationUrl();
 netscapeRevocationUrl.setRevocationUrl("cgi-bin/check-rev.cgi?");
 

Parameters:

url - the revocation url, as String

getRevocationUrl

public String getRevocationUrl()

Returns the revocation url.

Returns:

the revocation url value as String

See Also:

setRevocationUrl(java.lang.String)

hashCode

public int hashCode()

Returns a hashcode for this identity.

Overrides:

hashCode in class V3Extension

Returns:

a hash code for this identity

toString

public String toString()

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

Overrides:

toString in class Object

Returns:

the string representation