X509Certificate (Платформа Java SE 8 b92)

java.lang. Объект
- javax.security.cert. Сертификат
- - javax.security.cert. X509Certificate

```
public abstract class X509Certificate
extends Certificate
```
Абстрактный class для X.509 v1 сертификаты. Это обеспечивает стандартный способ получить доступ ко всем атрибутам версии 1 сертификата X.509. Атрибуты, которые являются определенными для X.509 v2 или v3, не доступны через этот интерфейс. Будущее развитие API обеспечит полный доступ, чтобы завершить X.509 v3 атрибуты.
Основной формат X.509 был определен ISO/IEC и ANSI X9 и описывается ниже в ASN.1:
```
 Certificate  ::=  SEQUENCE  {
     tbsCertificate       TBSCertificate,
     signatureAlgorithm   AlgorithmIdentifier,
     signature            BIT STRING  }
 
```
Эти сертификаты широко используются, чтобы поддерживать аутентификацию и другую функциональность в системах Защиты в сети Интернет. Общее применение включает Почту с усовершенствованной защитой (PEM), Безопасность Транспортного уровня (SSL), подписывание кода для распределения достоверного программного обеспечения, и Защищает Электронные Транзакции (НАБОР).
Этими сертификатами управляют и ручались за Центрами сертификации (АВАРИЯ). АВАРИЯ Является службами, которые создают сертификаты, помещая данные в стандартный формат X.509 и затем в цифровой форме подписывая те данные. Действие АВАРИИ как доверенные третьи стороны, представляющиеся между принципалами, у кого нет никаких сведений из первоисточника друг друга. Сертификаты CA или подписываются собой, или некоторым другим CA, таким как "корневой" CA.
Определение ASN.1 tbsCertificate :
```
 TBSCertificate  ::=  SEQUENCE  {
     version         [0]  EXPLICIT Version DEFAULT v1,
     serialNumber         CertificateSerialNumber,
     signature            AlgorithmIdentifier,
     issuer               Name,
     validity             Validity,
     subject              Name,
     subjectPublicKeyInfo SubjectPublicKeyInfo,
     }
 
```
Вот пример кода, чтобы инстанцировать сертификата X.509:
```
 InputStream inStream = new FileInputStream("fileName-of-cert");
 X509Certificate cert = X509Certificate.getInstance(inStream);
 inStream.close();
 
```
ИЛИ
```
 byte[] certData = <certificate read from a file, say>
 X509Certificate cert = X509Certificate.getInstance(certData);
 
```
В любом случае код, который инстанцирует сертификата X.509, консультируется со значением cert.provider.x509v1 свойство безопасности, чтобы определить местоположение фактической реализации или инстанцирует реализации по умолчанию.
cert.provider.x509v1 свойство устанавливается в реализацию по умолчанию для X.509, такого как:
```
 cert.provider.x509v1=com.sun.security.cert.internal.x509.X509V1CertImpl
 
```
Значение этого cert.provider.x509v1 свойство должно быть изменено, чтобы инстанцировать другой реализации. Если это свойство безопасности не будет установлено, то реализация по умолчанию будет использоваться. В настоящий момент, из-за возможных ограничений безопасности на доступ к свойствам Security, это значение ищется и кэшируется во время инициализации class, и будет нейтрализация на реализации по умолчанию, если свойство Security не будет доступно.
Отметьте: классы в пакете javax.security.cert существуйте для совместимости с более ранними версиями Расширения Защищенных сокетов Java (JSSE). Новые приложения должны вместо этого использовать стандартный Java классы сертификата SE, расположенные в java.security.cert.
С тех пор:

1.4

См. Также:

Certificate, X509Extension, security properties

Сводка конструктора

Конструкторы
Конструктор и Описание

X509Certificate()

Конструкторы
Конструктор и Описание
`X509Certificate()`

Сводка метода

Все Методы Статические Методы Методы экземпляра Абстрактные Методы Конкретные Методы
Модификатор и Тип	Метод и Описание
`abstract void`	`checkValidity()` Проверки, что сертификат в настоящий момент допустим.
`abstract void`	`checkValidity(Date date)` Проверки, что указанная дата в пределах срока действия сертификата.
`static X509Certificate`	`getInstance(byte[] certData)` Инстанцирует объекта X509Certificate, и инициализирует это с указанным байтовым массивом.
`static X509Certificate`	`getInstance(InputStream inStream)` Инстанцирует объекта X509Certificate, и инициализирует это с данными, считанными из входного потока `inStream`.
`abstract Principal`	`getIssuerDN()` Добирается `issuer` (отличительное имя выпускающего), оценивают от сертификата.
`abstract Date`	`getNotAfter()` Добирается `notAfter` дата со срока действия сертификата.
`abstract Date`	`getNotBefore()` Добирается `notBefore` дата со срока действия сертификата.
`abstract BigInteger`	`getSerialNumber()` Добирается `serialNumber` значение от сертификата.
`abstract String`	`getSigAlgName()` Получает имя алгоритма подписи для алгоритма подписи сертификата.
`abstract String`	`getSigAlgOID()` Получает строку OID алгоритма подписи от сертификата.
`abstract byte[]`	`getSigAlgParams()` Получает DER-закодированные параметры алгоритма подписи от алгоритма подписи этого сертификата.
`abstract Principal`	`getSubjectDN()` Добирается `subject` (подвергните отличительное имя), значение от сертификата.
`abstract int`	`getVersion()` Добирается `version` (номер версии) значение от сертификата.

Методы, наследованные от class javax.security.cert. Сертификат
equals, getEncoded, getPublicKey, hashCode, toString, verify, verify

Методы, наследованные от class java.lang. Объект
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - X509Certificate
```
public X509Certificate()
```
- Деталь метода
  - getInstance
```
public static final X509Certificate getInstance(InputStream inStream)
                                         throws CertificateException
```
    Инстанцирует объекта X509Certificate, и инициализирует это с данными, считанными из входного потока inStream. Реализация (X509Certificate является абстрактный class) обеспечивается class, определенным как значение cert.provider.x509v1 свойство безопасности.
    Отметьте: Только один DER-закодированный сертификат, как ожидают, будет во входном потоке. Кроме того, все подклассы X509Certificate должны предоставить конструктору формы:
```
 public <subClass>(InputStream inStream) ...
 
```
    Параметры:
    
    inStream - входной поток с данными, которые будут считаны, чтобы инициализировать сертификат.
    
    Возвраты:
    
    объект X509Certificate инициализируется с данными от входного потока.
    
    Броски:
    
    CertificateException - если инициализация class или ошибка парсинга сертификата происходят.
  - getInstance
```
public static final X509Certificate getInstance(byte[] certData)
                                         throws CertificateException
```
    Инстанцирует объекта X509Certificate, и инициализирует это с указанным байтовым массивом. Реализация (X509Certificate является абстрактный class) обеспечивается class, определенным как значение cert.provider.x509v1 свойство безопасности.
    Отметьте: Все подклассы X509Certificate должны предоставить конструктору формы:
```
 public <subClass>(InputStream inStream) ...
 
```
    Параметры:
    
    certData - байтовый массив, содержащий DER-закодированный сертификат.
    
    Возвраты:
    
    объект X509Certificate, инициализированный с данными от certData.
    
    Броски:
    
    CertificateException - если инициализация class или ошибка парсинга сертификата происходят.
  - checkValidity
```
public abstract void checkValidity()
                            throws CertificateExpiredException,
                                   CertificateNotYetValidException
```
    Проверки, что сертификат в настоящий момент допустим. Это - если текущая дата и время в пределах срока действия, данного в сертификате.
    Срок действия состоит из двух дат/временных стоимостей: первые и последние даты (и времена), на котором сертификат допустим. Это определяется в ASN.1 как:
```
 validity             Validity
 Validity ::= SEQUENCE {
     notBefore      CertificateValidityDate,
     notAfter       CertificateValidityDate }

 CertificateValidityDate ::= CHOICE {
     utcTime        UTCTime,
     generalTime    GeneralizedTime }
 
```
    Броски:
    
    CertificateExpiredException - если сертификат истек.
    
    CertificateNotYetValidException - если сертификат еще не допустим.
  - checkValidity
```
public abstract void checkValidity(Date date)
                            throws CertificateExpiredException,
                                   CertificateNotYetValidException
```
    Проверки, что указанная дата в пределах срока действия сертификата. Другими словами это определяет, был ли бы сертификат допустим в указанной дате/времени.
    
    Параметры:
    
    date - Дата, чтобы проверить по видеть, допустим ли этот сертификат в той дате/времени.
    
    Броски:
    
    CertificateExpiredException - если сертификат истек относительно date предоставленный.
    
    CertificateNotYetValidException - если сертификат еще не допустим относительно date предоставленный.
    
    См. Также:
    
    checkValidity()
  - getVersion
```
public abstract int getVersion()
```
    Добирается version (номер версии) значение от сертификата. Определение ASN.1 для этого:
```
 version         [0]  EXPLICIT Version DEFAULT v1
 Version  ::=  INTEGER  {  v1(0), v2(1), v3(2)  }
 
```
    Возвраты:
    
    номер версии от кодирования ASN.1, то есть 0, 1 или 2.
  - getSerialNumber
```
public abstract BigInteger getSerialNumber()
```
    Добирается serialNumber значение от сертификата. Порядковый номер является целым числом, присвоенным центром сертификации каждому сертификату. Это должно быть уникально для каждого сертификата, выпущенного данным CA (то есть, имя выпускающего и порядковый номер идентифицируют уникальный сертификат). Определение ASN.1 для этого:
```
 serialNumber     CertificateSerialNumber

 CertificateSerialNumber  ::=  INTEGER
 
```
    Возвраты:
    
    порядковый номер.
  - getIssuerDN
```
public abstract Principal getIssuerDN()
```
    Добирается issuer (отличительное имя выпускающего), оценивают от сертификата. Имя выпускающего идентифицирует объект, который подписался (и вышел), сертификат.
    Поле имени выпускающего содержит отличительное имя X.500 (DN). Определение ASN.1 для этого:
```
 issuer    Name

 Name ::= CHOICE { RDNSequence }
 RDNSequence ::= SEQUENCE OF RelativeDistinguishedName
 RelativeDistinguishedName ::=
     SET OF AttributeValueAssertion

 AttributeValueAssertion ::= SEQUENCE {
                               AttributeType,
                               AttributeValue }
 AttributeType ::= OBJECT IDENTIFIER
 AttributeValue ::= ANY
 
```
    Name описывает иерархическое имя, составленное из атрибутов, таких как название страны, и соответствующие значения, такие как US. Тип AttributeValue компонент определяется AttributeType; вообще это будет a directoryString. A directoryString обычно один из PrintableString, TeletexString или UniversalString.
    Возвраты:
    
    Принципал, имя которого является отличительным именем выпускающего.
  - getSubjectDN
```
public abstract Principal getSubjectDN()
```
    Добирается subject (подвергните отличительное имя), значение от сертификата. Определение ASN.1 для этого:
```
 subject    Name
 
```
    См. getIssuerDN для Name и другие соответствующие определения.
    Возвраты:
    
    Принципал, имя которого является подчиненным именем.
    
    См. Также:
    
    getIssuerDN()
  - getNotBefore
```
public abstract Date getNotBefore()
```
    Добирается notBefore дата со срока действия сертификата. Соответствующие определения ASN.1:
```
 validity             Validity

 Validity ::= SEQUENCE {
     notBefore      CertificateValidityDate,
     notAfter       CertificateValidityDate }

 CertificateValidityDate ::= CHOICE {
     utcTime        UTCTime,
     generalTime    GeneralizedTime }
 
```
    Возвраты:
    
    дата начала срока действия.
    
    См. Также:
    
    checkValidity()
  - getNotAfter
```
public abstract Date getNotAfter()
```
    Добирается notAfter дата со срока действия сертификата. См. getNotBefore для соответствующих определений ASN.1.
    
    Возвраты:
    
    дата окончания срока действия.
    
    См. Также:
    
    checkValidity()
  - getSigAlgName
```
public abstract String getSigAlgName()
```
    Получает имя алгоритма подписи для алгоритма подписи сертификата. Примером является строка "SHA-1/DSA". Определение ASN.1 для этого:
```
 signatureAlgorithm   AlgorithmIdentifier
 AlgorithmIdentifier  ::=  SEQUENCE  {
     algorithm               OBJECT IDENTIFIER,
     parameters              ANY DEFINED BY algorithm OPTIONAL  }
                             -- contains a value of the type
                             -- registered for use with the
                             -- algorithm object identifier value
 
```
    Имя алгоритма определяется от algorithm Строка OID.
    Возвраты:
    
    имя алгоритма подписи.
  - getSigAlgOID
```
public abstract String getSigAlgOID()
```
    Получает строку OID алгоритма подписи от сертификата. OID представляется рядом положительных целых чисел, разделенных периодами. Например, строка "1.2.840.10040.4.3" идентифицирует SHA 1 с алгоритмом подписи DSA согласно первой части PKIX.
    См. getSigAlgName для соответствующих определений ASN.1.
    
    Возвраты:
    
    строка OID алгоритма подписи.
  - getSigAlgParams
```
public abstract byte[] getSigAlgParams()
```
    Получает DER-закодированные параметры алгоритма подписи от алгоритма подписи этого сертификата. В большинстве случаев параметры алгоритма подписи являются нулем; параметры обычно предоставляются открытым ключом сертификата.
    См. getSigAlgName для соответствующих определений ASN.1.
    
    Возвраты:
    
    DER-закодированные параметры алгоритма подписи, или нуль, если никакие параметры не присутствуют.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс X509Certificate

Сводка конструктора

Сводка метода

Методы, наследованные от class javax.security.cert. Сертификат

Методы, наследованные от class java.lang. Объект

Деталь конструктора

X509Certificate

Деталь метода

getInstance

getInstance

checkValidity

checkValidity

getVersion

getSerialNumber

getIssuerDN

getSubjectDN

getNotBefore

getNotAfter

getSigAlgName

getSigAlgOID

getSigAlgParams