be.cardon.asn1.x509
Class GeneralName

java.lang.Object
  org.bouncycastle.asn1.ASN1Encodable
      be.cardon.asn1.x509.GeneralName

All Implemented Interfaces:

org.bouncycastle.asn1.ASN1Choice, org.bouncycastle.asn1.DEREncodable

public class GeneralName
extends org.bouncycastle.asn1.ASN1Encodable
implements org.bouncycastle.asn1.ASN1Choice

The GeneralName object.

Implements the GeneralNameASN.1 definition from RFC 3280. This class is an enhancement of org.bouncycastle.asn1.x509.GeneralName. Provides the new function getNameAsString() for some tags.

 GeneralName ::= CHOICE {
      otherName                       [0]     OtherName,
      rfc822Name                      [1]     IA5String,
      dNSName                         [2]     IA5String,
      x400Address                     [3]     ORAddress,
      directoryName                   [4]     Name,
      ediPartyName                    [5]     EDIPartyName,
      uniformResourceIdentifier       [6]     IA5String,
      iPAddress                       [7]     OCTET STRING,
      registeredID                    [8]     OBJECT IDENTIFIER}

 OtherName ::= SEQUENCE {
      type-id    OBJECT IDENTIFIER,
      value      [0] EXPLICIT ANY DEFINED BY type-id }

 EDIPartyName ::= SEQUENCE {
      nameAssigner            [0]     DirectoryString OPTIONAL,
      partyName               [1]     DirectoryString }

 Name ::= CHOICE { RDNSequence }

Documentation from RFC 3280 about subjectAltName

 When the subjectAltName extension contains an Internet mail address,
 the address MUST be included as an rfc822Name. The format of an
 rfc822Name is an "addr-spec" as defined in RFC 822 [RFC 822].

 When the subjectAltName extension contains a domain name service
 label, the domain name MUST be stored in the dNSName (an IA5String).
 The name MUST be in the "preferred name syntax," as specified by RFC
 1034 [RFC 1034].

 When the subjectAltName extension contains a URI, the name MUST be
 stored in the uniformResourceIdentifier (an IA5String). The name MUST
 be a non-relative URL, and MUST follow the URL syntax and encoding
 rules specified in [RFC 1738].  The name must include both a scheme
 (e.g., "http" or "ftp") and a scheme-specific-part.  The scheme-
 specific-part must include a fully qualified domain name or IP
 address as the host.

 When the subjectAltName extension contains a iPAddress, the address
 MUST be stored in the octet string in "network byte order," as
 specified in RFC 791 [RFC 791]. The least significant bit (LSB) of
 each octet is the LSB of the corresponding byte in the network
 address. For IP Version 4, as specified in RFC 791, the octet string
 MUST contain exactly four octets.  For IP Version 6, as specified in
 RFC 1883, the octet string MUST contain exactly sixteen octets [RFC
 1883].

Field Summary

static int	directoryName Tag directoryName = 4.
static int	dNSName Tag dNSName = 2.
static int	ediPartyName Tag ediParyName = 5.
static int	iPAddress Tag iPAddress = 7.
static int	otherName Tag otherName = 0.
static int	registeredID Tag registeredID = 8.
static int	rfc822Name Tag rfc822Name = 1.
static int	uniformResourceIdentifier Tag uniformResourceIdentifier = 6.
static int	x400Address Tag x400Address = 3.

Fields inherited from class org.bouncycastle.asn1.ASN1Encodable

BER, DER

Constructor Summary

GeneralName(int tag, org.bouncycastle.asn1.ASN1Encodable name)
Default Constructor.

GeneralName(int tag, java.lang.String name)
Create a General name for the given tag from the passed in String.

GeneralName(RDNSequence dirName)
Constructor for directoryName (tag 4).

GeneralName(org.bouncycastle.asn1.x509.X509Name dirName)
Constructor for directoryName (tag 4).

Method Summary

static GeneralName	createNewIP(java.lang.String ipAddress) Creates a new instance with the given IP address.
static GeneralName	getInstance(org.bouncycastle.asn1.ASN1TaggedObject tagObj, boolean explicit)
static GeneralName	getInstance(java.lang.Object obj) General constructor.
org.bouncycastle.asn1.DEREncodable	getName() Returns the Name as DEREncodable.
java.lang.String	getNameAsString() Returns the Name as String.
int	getTagNo() Returns the Tag Number.
org.bouncycastle.asn1.DERObject	toASN1Object()

Methods inherited from class org.bouncycastle.asn1.ASN1Encodable

equals, getDEREncoded, getDERObject, getEncoded, getEncoded, hashCode

Methods inherited from class java.lang.Object

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

Field Detail

otherName

public static final int otherName

Tag otherName = 0.

See Also:

Constant Field Values

rfc822Name

public static final int rfc822Name

Tag rfc822Name = 1.

See Also:

Constant Field Values

dNSName

public static final int dNSName

Tag dNSName = 2.

See Also:

Constant Field Values

x400Address

public static final int x400Address

Tag x400Address = 3.

See Also:

Constant Field Values

directoryName

public static final int directoryName

Tag directoryName = 4.

See Also:

Constant Field Values

ediPartyName

public static final int ediPartyName

Tag ediParyName = 5.

See Also:

Constant Field Values

uniformResourceIdentifier

public static final int uniformResourceIdentifier

Tag uniformResourceIdentifier = 6.

See Also:

Constant Field Values

iPAddress

public static final int iPAddress

Tag iPAddress = 7.

See Also:

Constant Field Values

registeredID

public static final int registeredID

Tag registeredID = 8.

See Also:

Constant Field Values

Constructor Detail

GeneralName

public GeneralName(org.bouncycastle.asn1.x509.X509Name dirName)

Constructor for directoryName (tag 4).

GeneralName

public GeneralName(RDNSequence dirName)

Constructor for directoryName (tag 4).

GeneralName

public GeneralName(int tag,
                   org.bouncycastle.asn1.ASN1Encodable name)

Default Constructor.

GeneralName

public GeneralName(int tag,
                   java.lang.String name)

Create a General name for the given tag from the passed in String. Supported tags are : rfc822Name, dNSName, uniformResourceIdentifier, registeredID, iPAddress (only v4 yet supported), and dirName (RDNSequence in format RFC 2253 or 1779).

Parameters:

tag - tag number

name - string representation of name

Method Detail

createNewIP

public static GeneralName createNewIP(java.lang.String ipAddress)

Creates a new instance with the given IP address.

getInstance

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

General constructor. The object may be a org.bouncycastle.asn1.x509.GeneralName, a be.cardon.asn1.x509.GeneralName, or a ASN1TaggedObject.

getInstance

public static GeneralName getInstance(org.bouncycastle.asn1.ASN1TaggedObject tagObj,
                                      boolean explicit)

getTagNo

public int getTagNo()

Returns the Tag Number.

getName

public org.bouncycastle.asn1.DEREncodable getName()

Returns the Name as DEREncodable.

getNameAsString

public java.lang.String getNameAsString()

Returns the Name as String. Supported tag are: rfc822Name, dNSName, directoryName (in format RFC 2253), uniformResourceIdentifier, registeredID, iPAddress.

toASN1Object

public org.bouncycastle.asn1.DERObject toASN1Object()

Specified by:

toASN1Object in class org.bouncycastle.asn1.ASN1Encodable