Antarmuka IX509ExtensionAlternativeNames (certenroll.h)

Artikel
08/22/2023

Antarmuka IX509ExtensionAlternativeNames memungkinkan Anda menentukan satu atau beberapa formulir nama alternatif untuk subjek sertifikat. Otoritas sertifikasi memproses ekstensi dengan mengikat nama ke kunci publik bersertifikat. Sintaks berikut menunjukkan struktur Abstract Syntax Notation One (ASN.1) ekstensi. Nilai ekstensi dikodekan dengan menggunakan Distinguished Encoding Rules (DER) dan disertakan dalam permintaan sertifikat.


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

Jika Anda menginisialisasi ekstensi ini dengan menggunakan koleksi IAlternativeNames , jenis nama berikut didukung.

Nilai	Deskripsi
XCN_CERT_ALT_NAME_OTHER_NAME	Nama terdiri dari pengidentifikasi objek dan array byte yang berisi nama.
XCN_CERT_ALT_NAME_RFC822_NAME	Nama tersebut adalah alamat email.
XCN_CERT_ALT_NAME_DNS_NAME	Nama tersebut adalah nama Sistem Nama Domain.
XCN_CERT_ALT_NAME_DIRECTORY_NAME	Nama tersebut adalah nama direktori X.500 .
XCN_CERT_ALT_NAME_URL	Namanya adalah URL.
XCN_CERT_ALT_NAME_IP_ADDRESS	Nama tersebut adalah alamat Protokol Internet (IP).
XCN_CERT_ALT_NAME_REGISTERED_ID	Nama ini adalah pengidentifikasi objek terdaftar (OID).
XCN_CERT_ALT_NAME_GUID	Nama tersebut adalah GUID. Ini adalah bentuk otherName.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME	Nama tersebut adalah nama prinsipal pengguna (UPN). Format UPN didasarkan pada RFC 822.

Untuk menambahkan objek ekstensi ini ke permintaan PKCS #10 atau permintaan CMC, Anda harus terlebih dahulu menambahkannya ke koleksi IX509Extensions dan menggunakan koleksi untuk menginisialisasi objek IX509AttributeExtensions . Untuk informasi selengkapnya, lihat topik Ekstensi #10 PKCS dan Ekstensi CMC .

Warisan

Antarmuka IX509ExtensionAlternativeNames mewarisi dari IX509Extension. IX509ExtensionAlternativeNames juga memiliki jenis anggota ini:

Metode

Antarmuka IX509ExtensionAlternativeNames memiliki metode ini.


IX509ExtensionAlternativeNames::get_AlternativeNames Mengambil kumpulan nama alternatif subjek.
IX509ExtensionAlternativeNames::InitializeDecode Menginisialisasi ekstensi dari array byte yang dikodekan Distinguished Encoding Rules (DER) yang berisi nilai ekstensi. (IX509ExtensionAlternativeNames.InitializeDecode)
IX509ExtensionAlternativeNames::InitializeEncode Menginisialisasi ekstensi dari koleksi IAlternativeNames.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	certenroll.h

Lihat juga

API Pendaftaran Sertifikat

Ekstensi

IX509Extension