Interfaccia IX509ExtensionAlternativeNames (certenroll.h)

Articolo
03/14/2023

L'interfaccia IX509ExtensionAlternativeNames consente di specificare uno o più moduli di nome alternativi per l'oggetto di un certificato. Un'autorità di certificazione elabora l'estensione associando i nomi alla chiave pubblica certificata. La sintassi seguente mostra la struttura ASN.1 ( Abstract Syntax Notation One ) dell'estensione. Il valore dell'estensione viene codificato usando Distinguished Encoding Rules (DER) e incluso nella richiesta di certificato.


----------------------------------------------------------------------
-- 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 
}

Se si inizializza questa estensione usando un insieme IAlternativeNames , sono supportati i tipi di nome seguenti.

Valore	Descrizione
XCN_CERT_ALT_NAME_OTHER_NAME	Il nome è costituito da un identificatore di oggetto e da una matrice di byte che contiene il nome.
XCN_CERT_ALT_NAME_RFC822_NAME	Il nome è un indirizzo di posta elettronica.
XCN_CERT_ALT_NAME_DNS_NAME	Il nome è un nome di sistema del nome di dominio.
XCN_CERT_ALT_NAME_DIRECTORY_NAME	Il nome è un nome di directory X.500 .
XCN_CERT_ALT_NAME_URL	Il nome è un URL.
XCN_CERT_ALT_NAME_IP_ADDRESS	Il nome è un indirizzo IP (Internet Protocol).
XCN_CERT_ALT_NAME_REGISTERED_ID	Il nome è un identificatore di oggetto registrato (OID).
XCN_CERT_ALT_NAME_GUID	Il nome è un GUID. Si tratta di una forma di otherName.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME	Il nome è un nome dell'entità utente (UPN). Il formato UPN è basato su RFC 822.

Per aggiungere questo oggetto di estensione a una richiesta PKCS #10 o a una richiesta CMC, è innanzitutto necessario aggiungerlo a un insieme IX509Extensions e usare l'insieme per inizializzare un oggetto IX509AttributeExtensions . Per altre informazioni, vedere gli argomenti PKCS #10 Extensions (Estensioni PKCS #10 ) e CMC Extensions (Estensioni CMC ).

Ereditarietà

L'interfaccia IX509ExtensionAlternativeNames eredita da IX509Extension. IX509ExtensionAlternativeNames include anche questi tipi di membri:

Metodi

L'interfaccia IX509ExtensionAlternativeNames include questi metodi.


IX509ExtensionAlternativeNames::get_AlternativeNames Recupera una raccolta di nomi alternativi del soggetto.
IX509ExtensionAlternativeNames::InitializeDecode Inizializza l'estensione da una matrice di byte codificata Distinguished Encoding Rules (DER) che contiene il valore dell'estensione. (IX509ExtensionAlternativeNames.InitializeDecode)
IX509ExtensionAlternativeNames::InitializeEncode Inizializza l'estensione da un insieme IAlternativeNames.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenroll.h

Vedi anche

API di registrazione certificato

Estensioni

IX509Extension