Interface IX500DistinguishedName (certenroll.h)

Article
02/23/2024

L’interface IX500DistinguishedName représente un nom unique (DN) X.500. La série X.500 de normes de mise en réseau couvre les services d’annuaire électronique. Un nom unique identifie (distingue) de manière unique chaque entrée du répertoire de toutes les autres entrées. Chaque DN se compose d’un ou plusieurs noms uniques relatifs (RDN).

Le champ objet d’une demande de certificat PKCS #10 contient le nom de domaine de l’entité qui demande le certificat


CertificationRequestInfo ::= SEQUENCE 
{
   version                 CertificationRequestInfoVersion,
   subject                 Name,
   subjectPublicKeyInfo    SubjectPublicKeyInfo,
   attributes              [0] IMPLICIT Attributes
}

Le nom de domaine se compose d’une séquence de RDN. Chaque RDN se compose d’un ensemble d’attributs, et chaque attribut se compose d’un identificateur d’objet (OID) et d’une valeur. Le type de données de la valeur est identifié par la structure DirectoryString .


Name ::= SEQUENCE OF RelativeDistinguishedName

RelativeDistinguishedName ::= SET OF AttributeTypeValue

AttributeTypeValue ::= SEQUENCE 
{
   type       EncodedObjectID,
   value      ANY 
}

DirectoryString ::= CHOICE 
{
   teletexString           TeletexString (SIZE (1..MAX)),
   printableString         PrintableString (SIZE (1..MAX)),
   universalString         UniversalString (SIZE (1..MAX)),
   utf8String              UTF8String (SIZE (1..MAX)),
   bmpString               BMPString (SIZE (1..MAX)) 
}

Les clés RDN suivantes et les OID associés sont actuellement pris en charge.

Clé :	OID	Description	Type RDN
C	XCN_OID_COUNTRY_NAME	Contient un code de pays ou de région ISO 3166 à deux lettres.	PrintableString
CN	XCN_OID_COMMON_NAME	Contient un nom commun.	PrintableString
EEMAIL	XCN_OID_RSA_emailAddr	Contient une adresse e-mail.	IA5String
DC	XCN_OID_DOMAIN_COMPONENT	Contient un composant d’un nom DNS (Domain Name System).	IA5String
GGivenName	XCN_OID_GIVEN_NAME	Contient la partie du nom d’une personne qui n’est pas un nom de famille.	PrintableString
I	XCN_OID_INITIALS	Contient les initiales d’une personne.	PrintableString
L	XCN_OID_LOCALITY_NAME	Contient le nom de la localité qui identifie une ville, un pays ou une autre région géographique.	PrintableString
O	XCN_OID_ORGANIZATION_NAME	Contient le nom d’un organization.	PrintableString
OU	XCN_OID_ORGANIZATIONAL_UNIT_NAME	Contient le nom d’une subdivision d’unité au sein d’une organization.	PrintableString
SST	XCN_OID_STATE_OR_PROVINCE_NAME	Contient le nom complet d’un état ou d’une province.	PrintableString
STREET	XCN_OID_STREET_ADDRESS	Contient l’adresse physique.	PrintableString
SN	XCN_OID_SUR_NAME	Contient le nom de famille d’une personne.	PrintableString
TTITLE	XCN_OID_TITLE	Contient le titre d’une personne dans le organization.	PrintableString

Chaque service basé sur X.500 définit sa propre représentation de chaîne de nom unique. Par exemple, LDAP utilise une liste délimitée par des virgules organisée de droite à gauche. Active Directory utilise une barre oblique (/) et organise la liste de gauche à droite. D’autres services utilisent des points-virgules comme séparateurs. L’exemple suivant montre une entrée Active Directory pour un employé nommé John Peoples qui travaille dans la division pharmaceutique d’une société nommée Contoso, Ltd.


/c=gb/o=Contoso Ltd./ou=Contoso Pharmaceuticals/cn=John Peoples

Héritage

L’interface IX500DistinguishedName hérite de l’interface IDispatch. IX500DistinguishedName a également les types de membres suivants :

Méthodes

L’interface IX500DistinguishedName contient ces méthodes.


IX500DistinguishedName ::D ecode Initialise l’objet à partir d’un nom unique encodé en Unicode.
IX500DistinguishedName ::Encode Initialise l’objet à partir d’une chaîne qui contient un nom unique.
IX500DistinguishedName ::get_EncodedName Récupère un nom unique encodé en Unicode.
IX500DistinguishedName ::get_Name Récupère un nom unique.

Configuration requise

Condition requise	Valeur
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

CertEnroll Interfaces

IDispatch

Noms de sujets