Interface IX509ExtensionAlternativeNames (certenroll.h)

Article
08/22/2023

L’interface IX509ExtensionAlternativeNames vous permet de spécifier un ou plusieurs formulaires de nom alternatifs pour l’objet d’un certificat. Une autorité de certification traite l’extension en liant les noms à la clé publique certifiée. La syntaxe suivante montre la structure ASN.1 ( Abstract Syntax Notation One ) de l’extension. La valeur d’extension est encodée à l’aide de Distinguished Encoding Rules (DER) et incluse dans la demande de certificat.


----------------------------------------------------------------------
-- AlternativeNames 
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------

AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames

GeneralName ::= CHOICE 
{
   otherName               [0] IMPLICIT OtherName,
   rfc822Name              [1] IMPLICIT IA5STRING,
   dNSName                 [2] IMPLICIT IA5STRING,
   x400Address             [3] IMPLICIT SeqOfAny,       -- Not supported
   directoryName           [4] EXPLICIT ANY,    
   ediPartyName            [5] IMPLICIT SeqOfAny,
   uniformResourceLocator  [6] IMPLICIT IA5STRING,
   iPAddress               [7] IMPLICIT OCTETSTRING,
   registeredID            [8] IMPLICIT EncodedObjectID -- Not supported
}

OtherName ::= SEQUENCE 
{
   type                    EncodedObjectID,
   value                   [0] EXPLICIT NOCOPYANY 
}

Si vous initialisez cette extension à l’aide d’une collection IAlternativeNames , les types de noms suivants sont pris en charge.

Valeur	Description
XCN_CERT_ALT_NAME_OTHER_NAME	Le nom se compose d’un identificateur d’objet et d’un tableau d’octets qui contient le nom.
XCN_CERT_ALT_NAME_RFC822_NAME	Le nom est une adresse e-mail.
XCN_CERT_ALT_NAME_DNS_NAME	Le nom est un nom de système de noms de domaine.
XCN_CERT_ALT_NAME_DIRECTORY_NAME	Le nom est un nom de répertoire X.500 .
XCN_CERT_ALT_NAME_URL	Le nom est une URL.
XCN_CERT_ALT_NAME_IP_ADDRESS	Le nom est une adresse IP (Internet Protocol).
XCN_CERT_ALT_NAME_REGISTERED_ID	Le nom est un identificateur d’objet inscrit (OID).
XCN_CERT_ALT_NAME_GUID	Le nom est un GUID. Il s’agit d’une forme de otherName.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME	Le nom est un nom d’utilisateur principal (UPN). Le format UPN est basé sur RFC 822.

Pour ajouter cet objet d’extension à une requête PKCS #10 ou CMC, vous devez d’abord l’ajouter à une collection IX509Extensions et utiliser la collection pour initialiser un objet IX509AttributeExtensions . Pour plus d’informations, consultez les rubriques Extensions PKCS #10 et Extensions CMC .

Héritage

L’interface IX509ExtensionAlternativeNames hérite de IX509Extension. IX509ExtensionAlternativeNames a également les types de membres suivants :

Méthodes

L’interface IX509ExtensionAlternativeNames a ces méthodes.


IX509ExtensionAlternativeNames::get_AlternativeNames Récupère une collection d’autres noms de sujet.
IX509ExtensionAlternativeNames::InitializeDecode Initialise l’extension à partir d’un tableau d’octets encodé Distinguished Encoding Rules (DER) qui contient la valeur d’extension. (IX509ExtensionAlternativeNames.InitializeDecode)
IX509ExtensionAlternativeNames::InitializeEncode Initialise l’extension à partir d’une collection IAlternativeNames.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certenroll.h

Voir aussi

API d’inscription de certificats

Extensions

IX509Extension