	RSA BSAFE Cert-C	Certificate Components for C
		Crypto-C 6.2.1 Developer's Guide
		Search

ALTERNATE_NAME Reference

Holds a variety of name forms.

It is a component of several X.509 v3 certificate extensions:

AIA_DESCRIPTION
AUTHORITY_KEY_ID
ISSUER_ALTNAME
NAME_CONSTRAINTS
SUBJECT_ALTNAME.

It is also a component of the following CRL extensions:

It is also a component of CERT_ISSUER and is used in PKI_POP_GEN_SIGNATURE_INFO.

Samples:: cmp.c, cmpku.c, cmpreq.c, cmprev.c, extnhlp.c, pkiutil.c, roleattrib.c, saltname.c, and smplsaltnm.c.

#include <certext.h>

typedef struct ALTERNATE_NAME {

  unsigned int altNameType;

  union {
    OTHER_NAME     otherName;
    ITEM           rfc822Name;
    ITEM           dNSName;
    OR_ADDRESS     x400Address;
    NAME_OBJ       directoryName;
    EDI_PARTY_NAME ediPartyName;
    ITEM           resourceLocator;
    ITEM           ipAddress;
    ITEM           registeredID;
  } altName;
} ALTERNATE_NAME;

Data Fields
unsigned int	altNameType
	An `unsigned int` value that identifies the type of data structure in the altName union. More...
union ALTERNATE_NAME::@4	altName
	A union that contains an alternate name in the format specified by altNameType. More...

Field Documentation

union { ... } altName

A union that contains an alternate name in the format specified by altNameType.

otherName An OTHER_NAME structure that represents any application-defined type of name.
rfc822Name An ITEM structure that represents an Internet e-mail address defined in RFC 822. The data member points to an IA5 string.
dNSName An ITEM structure that represents an Internet domain-name service defined in RFC 1035. The data member points to an IA5 string.
x400Address An OR_ADDRESS structure that represents an O/R address defined in the X.411 standard.
directoryName A NAME_OBJ object that represents a DN defined in the X.501 standard.
ediPartyName An EDI_PARTY_NAME structure that represents an EDI name.
resourceLocator An ITEM structure that represents a URL defined in RFC 1630. The data member points to an IA5 string.
ipAddress An ITEM structure that represents an IP address defined in RFC 791. The data member points to an octet string.
registeredID An ITEM structure that represents a registered OID defined in the X.660 standard. The data member points to the object identifier.

unsigned int altNameType

An unsigned int value that identifies the type of data structure in the altName union. Cert-C supports the following alternate-name types:

Alternate-Name Type Description

CN_OTHER_NAME Name of any form defined as an instance of OTHER_NAME

CN_RFC822_NAME Internet e-mail address, defined in RFC 822, of IA5 string type

CN_DNS_NAME Internet domain-name service, defined RFC 1035, of IA5 string type

CN_X400_ADDRESS O/R address structure, defined in the X.411 standard

CN_DIRECTORY_NAME DN, defined in the X.501 standard

CN_EDI_PARTY_NAME Name of a form agreed upon between communicating EDI partners

CN_RESOURCE_LOCATOR URL for the World-Wide Web, defined in RFC 1630, of IA5 string type

CN_IP_ADDRESS Internet protocol address, defined in RFC 791, represented as an octet string

CN_REGISTERED_ID Identifier of any registered object, defined in the X.660 standard

ALTERNATE_NAME Reference

Data Fields

Field Documentation