Объект Certificate
[CAPICOM — это 32-разрядный компонент, доступный для использования в следующих операционных системах: Windows Server 2008, Windows Vista и Windows XP. Вместо этого используйте класс X509Certificate2 в пространстве имен System.Security.Cryptography.X509Certificates .]
Объект Certificate представляет один цифровой сертификат.
Объект Certificate предоставляет следующие интерфейсы:
- ICertificate — представлен в CAPICOM 1.0.
- ICertificate2 — представлен в CAPICOM 2.0.
Назначение
Объект Certificate используется для выполнения следующих задач:
- Загрузите данные сертификата, включая закрытый ключ, из файла.
- Получение сведений из сертификата.
- Возвращает основные ограничения, EKU, расширенные свойства, расширения, использование ключа, открытый ключ и объекты шаблона, связанные с сертификатом.
- Определите, является ли сертификат допустимым, и проверьте доступность доступа закрытого ключа субъекта сертификата.
- Отображение сертификата.
- Импортируйте и экспортируйте сертификат.
- Сохраните сертификат в файл.
- Получение или задание свойств, описывающих сертификат.
Элементы
Объект Certificate имеет следующие типы элементов:
Методы
Объект Certificate имеет эти методы.
| Метод | Описание |
|---|---|
| BasicConstraints | Возвращает объект BasicConstraints , представляющий базовое расширение ограничений сертификата. (Наследуется от CertificateICertificate2ICertificate) |
| Дисплей | Отображает сертификат. (Наследуется от CertificateICertificate2ICertificate) |
| Экспорт | Копирует сертификат в закодированную строку. Закодированную строку можно записать в файл или импортировать в новый объект Certificate . (Наследуется от CertificateICertificate2ICertificate) |
| ExtendedKeyUsage | Возвращает объект ExtendedKeyUsage , указывающий на допустимое использование расширенного ключа сертификата. (Наследуется от CertificateICertificate2ICertificate) |
| ExtendedProperties | Возвращает коллекцию расширенных свойств сертификата. (Наследуется от CertificateICertificate2) |
| Расширения | Возвращает коллекцию расширений, связанных с сертификатом. (Наследуется от CertificateICertificate2) |
| GetInfo | Извлекает сведения из сертификата. (Наследуется от CertificateICertificate2ICertificate) |
| HasPrivateKey | Определяет, связан ли сертификат с закрытым ключом . (Наследуется от CertificateICertificate2ICertificate) |
| Импорт | Импортирует ранее закодированный сертификат из строки в объект Certificate . (Наследуется от CertificateICertificate2ICertificate) |
| Isvalid | Создает цепочку проверки сертификата для сертификата и возвращает объект CertificateStatus , содержащий состояние допустимости сертификата. (Наследуется от CertificateICertificate2ICertificate) |
| KeyUsage | Возвращает объект KeyUsage , указывающий допустимое использование ключа сертификата. (Наследуется от CertificateICertificate2ICertificate) |
| Загрузить | Импортирует сертификат из файла. (Наследуется от CertificateICertificate2) |
| PublicKey | Возвращает объект PublicKey . (Наследуется от CertificateICertificate2) |
| Сохранить | Сохраняет сертификат в файл. (Наследуется от CertificateICertificate2) |
| Шаблон | Возвращает шаблон, связанный с сертификатом. (Наследуется от CertificateICertificate2) |
Свойства
Объект Certificate имеет эти свойства.
| Свойство | Тип доступа | Описание |
|---|---|---|
|
Архив |
Чтение/запись |
Задает или извлекает логическое значение, указывающее, архивируется ли сертификат. (Наследуется от CertificateICertificate2) |
|
IssuerName |
Только для чтения |
Извлекает строку, содержащую имя издателя сертификата. (Наследуется от CertificateICertificate2ICertificate) |
|
PrivateKey |
Чтение/запись |
Задает или извлекает закрытый ключ, связанный с сертификатом. (Наследуется от CertificateICertificate2) |
|
SerialNumber |
Только для чтения |
Извлекает строку, содержащую серийный номер сертификата. (Наследуется от CertificateICertificate2ICertificate) |
|
SubjectName |
Только для чтения |
Извлекает строку, содержащую имя субъекта сертификата. (Наследуется от CertificateICertificate2ICertificate) |
|
Отпечаток |
Только для чтения |
Извлекает шестнадцатеричную строку, содержащую хэш SHA-1 сертификата. (Наследуется от CertificateICertificate2ICertificate) |
|
ValidFromDate |
Только для чтения |
Извлекает дату начала действия сертификата. (Наследуется от CertificateICertificate2ICertificate) |
|
ValidToDate |
Только для чтения |
Извлекает дату окончания срока действия сертификата. (Наследуется от CertificateICertificate2ICertificate) |
|
Версия |
Только для чтения |
Извлекает номер версии сертификата. (Наследуется от CertificateICertificate2ICertificate) |
Remarks
Можно создать объект Certificate и безопасно использовать скрипты. Идентификатор ProgID для объекта Certificate — CAPICOM. Certificate.2".
CAPICOM 1. x: ProgID для объекта Certificate имеет значение CAPICOM. Certificate.1".
Требования
| Требование | Значение |
|---|---|
| Окончание поддержки клиентов |
Windows Vista |
| Окончание поддержки сервера |
Windows Server 2008 |
| Распространяемые компоненты |
CAPICOM 2.0 или более поздней версии на Windows Server 2003 и Windows XP |
| DLL |
|