Класс CertificateFactory

public class CertificateFactory
extends Object

Этот класс определяет функциональность фабрики сертификатов, которая используется для генерации объектов сертификата, цепочки сертификации (CertPath) и списка отзыва сертификатов (CRL) из их кодировок.

Для кодировок, состоящих из нескольких сертификатов, используйте generateCertificates при желании разобрать коллекцию, возможно, не связанных сертификатов. В противном случае, используйте generateCertPath при желании сгенерировать CertPath (цепочку сертификатов) и впоследствии проверить её с помощью CertPathValidator.

Фабрика сертификатов для X.509 должна возвращать сертификаты, которые являются экземплярами java.security.cert.X509Certificate, и CRL, которые являются экземплярами java.security.cert.X509CRL.

Следующий пример считывает файл с кодированными в Base64 сертификатами, каждый из которых ограничен в начале строкой -----BEGIN CERTIFICATE-----, а в конце строкой -----END CERTIFICATE-----. Мы преобразуем FileInputStream (которая не поддерживает mark и reset) в BufferedInputStream (которая поддерживает эти методы), чтобы каждый вызов generateCertificate потреблял только один сертификат, а позиция чтения входного потока устанавливалась на следующий сертификат в файле:

FileInputStream fis = new FileInputStream(filename);
 BufferedInputStream bis = new BufferedInputStream(fis);

 CertificateFactory cf = CertificateFactory.getInstance("X.509");

 while (bis.available() > 0) {
    Certificate cert = cf.generateCertificate(bis);
    System.out.println(cert.toString());
 }

Следующий пример разбирает ответ сертификата в формате PKCS#7, хранящийся в файле, и извлекает все сертификаты из него:

FileInputStream fis = new FileInputStream(filename);
 CertificateFactory cf = CertificateFactory.getInstance("X.509");
 Collection c = cf.generateCertificates(fis);
 Iterator i = c.iterator();
 while (i.hasNext()) {
    Certificate cert = (Certificate)i.next();
    System.out.println(cert);
 }

Каждая реализация Java платформы обязана поддерживать следующие стандартные типы CertificateFactory:

• X.509

и следующие стандартные кодировки CertPath:

• PKCS7
• PkiPath

Тип и кодировки описаны в разделе CertificateFactory и разделе CertPath Encodings документации Java Cryptography Architecture Standard Algorithm Name. Обратитесь к документации релиза вашей реализации, чтобы узнать, какие другие типы или кодировки поддерживаются.

Конструкторы

CertificateFactory

protected CertificateFactory(CertificateFactorySpi certFacSpi,
                             Provider provider,
                             String type)

Создаёт объект CertificateFactory заданного типа и инкапсулирует заданную реализацию поставщика (объект SPI) в нём.

Параметры:

certFacSpi - реализация поставщика.

provider - поставщик.

type - тип сертификата.

Методы

getInstance

public static final CertificateFactory getInstance(String type)
                                            throws CertificateException

Параметры:

type - имя запрошенного типа сертификата. Сведения о стандартных типах сертификатов см. в разделе CertificateFactory документации Java Cryptography Architecture по стандартным именам алгоритмов .

Возвращает:

объект фабрики сертификатов для указанного типа.

Исключения:

CertificateException - если ни один поставщик не поддерживает реализацию CertificateFactorySpi для указанного типа.

См. также:

Provider

getInstance

public static final CertificateFactory getInstance(String type,
                                                   String provider)
                                            throws CertificateException,
                                                   NoSuchProviderException

Параметры:

type - тип сертификата. Сведения о стандартных типах сертификатов см. в разделе CertificateFactory документации Java Cryptography Architecture по стандартным именам алгоритмов .

provider - имя поставщика.

Возвращает:

объект фабрики сертификатов для указанного типа.

Исключения:

CertificateException - если реализация CertificateFactorySpi для указанного алгоритма недоступна у указанного поставщика.

NoSuchProviderException - если указанный поставщик не зарегистрирован в списке поставщиков безопасности.

IllegalArgumentException - если имя поставщика равно null или пустое.

См. также:

Provider

getInstance

public static final CertificateFactory getInstance(String type,
                                                   Provider provider)
                                            throws CertificateException

Параметры:

type - тип сертификата. Сведения о стандартных типах сертификатов см. в разделе CertificateFactory документации Java Cryptography Architecture по стандартным именам алгоритмов .

provider - поставщик.

Возвращает:

объект фабрики сертификатов для указанного типа.

Исключения:

CertificateException - если реализация CertificateFactorySpi для указанного алгоритма недоступна от указанного объекта Provider.

IllegalArgumentException - если provider равен null.

С:

1.4

См. также:

Provider

getProvider

public final Provider getProvider()

Возвращает поставщика этой фабрики сертификатов.

Возвращает:

поставщика этой фабрики сертификатов.

getType

public final String getType()

Возвращает имя типа сертификата, связанного с этой фабрикой сертификатов.

Возвращает:

имя типа сертификата, связанного с этой фабрикой сертификатов.

generateCertificate

public final Certificate generateCertificate(InputStream inStream)
                                      throws CertificateException

Параметры:

inStream - поток ввода с данными сертификата.

Возвращает:

объект сертификата, инициализированный данными из потока ввода.

Исключения:

CertificateException - при ошибках разбора.

getCertPathEncodings

public final Iterator<String> getCertPathEncodings()

Возвращает:

итератор по именам поддерживаемых CertPath кодировок (в качестве String).

С:

1.4

generateCertPath

public final CertPath generateCertPath(InputStream inStream)
                                throws CertificateException

Генерирует объект CertPath и инициализирует его данными, считанными из InputStream inStream. Данные предполагаются в кодировке по умолчанию. Имя кодировки по умолчанию является первым элементом Iterator возвращаемого методом getCertPathEncodings.

Параметры:

inStream - InputStream содержащий данные

Возвращает:

объект CertPath инициализированный данными из InputStream

Исключения:

CertificateException - если произошла ошибка при декодировании

С:

1.4

generateCertPath

public final CertPath generateCertPath(InputStream inStream,
                                       String encoding)
                                throws CertificateException

Генерирует объект CertPath и инициализирует его данными, считанными из InputStream inStream. Данные предполагаются в указанной кодировке. Сведения о стандартных именах кодировки и их форматах см. в разделе CertPath Encodings документации Java Cryptography Architecture по стандартным именам алгоритмов .

Параметры:

inStream - InputStream содержащий данные

encoding - используемая кодировка данных

Возвращает:

объект CertPath инициализированный данными из InputStream

Исключения:

CertificateException - если произошла ошибка при декодировании или запрошенная кодировка не поддерживается

С:

1.4

generateCertPath

public final CertPath generateCertPath(List<? extends Certificate> certificates)
                                throws CertificateException

Параметры:

certificates - список List объектов Certificate.

Возвращает:

объект CertPath инициализированный переданным списком сертификатов

Исключения:

CertificateException - если произошла ошибка

С:

1.4

generateCertificates

public final Collection<? extends Certificate> generateCertificates(InputStream inStream)
                                                             throws CertificateException

Parameters:

inStream - входной поток с сертификатами.

Returns:

коллекция представлений объектов java.security.cert.Certificate, инициализированных данными из входного потока.

Throws:

CertificateException - при ошибках парсинга.

generateCRL

public final CRL generateCRL(InputStream inStream)
                      throws CRLException

Parameters:

inStream - входной поток с данными CRL.

Returns:

объект CRL, инициализированный данными из входного потока.

Throws:

CRLException - при ошибках парсинга.

generateCRLs

public final Collection<? extends CRL> generateCRLs(InputStream inStream)
                                             throws CRLException

Parameters:

inStream - входной поток с CRL.

Returns:

коллекция представлений объектов java.security.cert.CRL, инициализированных данными из входного потока.

Throws:

CRLException - при ошибках парсинга.