Interface IX500DistinguishedName (certenroll.h)
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 |