RSA Security logo

RSA BSAFE Cert-C
API Reference

ALTERNATE_NAME Reference

Holds a variety of name forms.

This structure is a component of several X.509 v3 certificate extensions (AIA_DESCRIPTION, AUTHORITY_KEY_ID, ISSUER_ALTNAME, NAME_CONSTRAINTS, and SUBJECT_ALTNAME); CRL extensions (AUTHORITY_KEY_ID, ISSUER_ALTNAME, and ISSUING_DISTRIBUTION_POINT); and CRL entry extensions (CERT_ISSUER). It is also used in the PKI_POP_GEN_SIGNATURE_INFO structure.

Data Fields
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 accordance with Internet RFC 822, of IA5 string type
CN_DNS_NAME Internet domain-name service, defined in accordance with Internet RFC 1035, of IA5 string type
CN_X400_ADDRESS O/R Address structure, defined in accordance with the X.411 standard
CN_DIRECTORY_NAME DN, defined in accordance with the X.501 standard
CN_EDI_PARTY_NAME Name of a form agreed upon between communicating EDI partners
CN_RESOURCE_LOCATOR Uniform Resource Locator for the World-Wide Web, defined in accordance with Internet RFC 1630, of IA5 string type
CN_IP_ADDRESS Internet Protocol address, defined in accordance with Internet RFC 791, represented as an octet string
CN_REGISTERED_ID Identifier of any registered object, defined in accordance with the X.660 standard

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 that is defined in accordance with Internet RFC 822. The data member points to an IA5 string.
    dNSName An ITEM structure that represents an Internet domain-name service that is defined in accordance with Internet RFC 1035. The data member points to an IA5 string.
    x400Address An OR_ADDRESS structure that represents an O/R Address that is defined in accordance with the X.411 standard.
    directoryName A NAME_OBJ object that represents a DN that is defined in accordance with the X.501 standard.
    ediPartyName An EDI_PARTY_NAME structure that represents an EDI name.
    resourceLocator An ITEM structure that represents a URL that is defined in accordance with Internet RFC 1630. The data member points to an IA5 string.
    ipAddress An ITEM structure that represents an IP address that is defined in accordance with Internet RFC 791. The data member points to an octet string.
    registeredID An ITEM structure that represents a registered OID that is defined in accordance with the X.660 standard. The data member points to the object identifier.

#include <certext.h> 

01645 typedef struct ALTERNATE_NAME {
01646   unsigned int altNameType;
01647   union {
01648     OTHER_NAME     otherName;       /* OTHER_NAME structure */
01649     ITEM           rfc822Name;      /* IA5String type */
01650     ITEM           dNSName;         /* IA5String type */
01651     OR_ADDRESS     x400Address;     /* OR_ADDRESS structure */
01652     NAME_OBJ       directoryName;   /* Distinguished NameObject type */
01653     EDI_PARTY_NAME ediPartyName;    /* EDI_PARTY_MAME structure */
01654     ITEM           resourceLocator; /* IA5String type */
01655     ITEM           ipAddress;       /* Octet string type */
01656     ITEM           registeredID;    /* Object identifier type */
01657   } altName;
01658 } ALTERNATE_NAME;
The documentation for this struct was generated from the following file:

RSA BSAFE® Cert-C 2.7 API Reference