Класс X509Certificate

Абстрактный класс для сертификатов X.509 v1. Он предоставляет стандартный способ доступа ко всем атрибутам сертификата X.509 версии 1. Атрибуты, специфичные для 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  }

Эти сертификаты широко используются для поддержки аутентификации и других функций в системах безопасности Интернета. Общие применения включают Privacy Enhanced Mail (PEM), Transport Layer Security (SSL), подпись кода для надёжного распространения программного обеспечения и Secure Electronic Transactions (SET).

Эти сертификаты управляются и гарантируются Центрами сертификации (ЦС). ЦС — это службы, которые создают сертификаты, помещая данные в стандартный формат X.509, а затем цифрово подписывают эти данные. ЦС действуют как доверенные третьи лица, обеспечивая знакомство между субъектами, которые не имеют непосредственного представления друг о друге. Сертификаты ЦС либо подписаны самими собой, либо другим ЦС, например, «корневым» ЦС.

Определение 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 должно быть изменено для создания другой реализации. Если это свойство безопасности не установлено, будет использоваться реализация по умолчанию. В настоящее время, из-за возможных ограничений безопасности на доступ к свойствам безопасности, это значение ищется и кэшируется во время инициализации класса и используется реализация по умолчанию, если свойство безопасности недоступно.

Примечание: классы в пакете javax.security.cert существуют для совместимости со старыми версиями расширения Java Secure Sockets Extension (JSSE). Новые приложения должны вместо этого использовать стандартные классы сертификатов Java SE, расположенные в java.security.cert.

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

X509Certificate

public X509Certificate()

Методы

getInstance

public static final X509Certificate getInstance(InputStream inStream)
                                         throws CertificateException

public <subClass>(InputStream inStream) ...

Параметры:

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

Возвращает:

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

Исключение:

CertificateException - если произошла ошибка инициализации класса или парсинга сертификата.

getInstance

public static final X509Certificate getInstance(byte[] certData)
                                         throws CertificateException

public <subClass>(InputStream inStream) ...

Параметры:

certData - массив байтов, содержащий DER-кодированный сертификат.

Возвращает:

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

Исключение:

CertificateException - если произошла ошибка инициализации класса или парсинга сертификата.

checkValidity

public abstract void checkValidity()
                            throws CertificateExpiredException,
                                   CertificateNotYetValidException

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 из сертификата. Номер записи — целое число, назначенное центром сертификации каждому сертификату. Он должен быть уникальным для каждого сертификата, выпущенного данным ЦС (т. е. имя издателя и номер записи идентифицируют уникальный сертификат). Определение ASN.1 для этого:

serialNumber     CertificateSerialNumber

 CertificateSerialNumber  ::=  INTEGER

Возвращает:

номер записи.

getIssuerDN

public abstract Principal getIssuerDN()

issuer    Name

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

 AttributeValueAssertion ::= SEQUENCE {
                               AttributeType,
                               AttributeValue }
 AttributeType ::= OBJECT IDENTIFIER
 AttributeValue ::= ANY

Возвращает:

объект Principal, имя которого является именем расширенного субъекта.

getSubjectDN

public abstract Principal getSubjectDN()

subject    Name

Возвращает:

объект Principal, имя которого является именем субъекта.

См. также:

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()

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

Возвращает:

имя алгоритма подписи.

getSigAlgOID

public abstract String getSigAlgOID()

Возвращает:

строку OID алгоритма подписи.

getSigAlgParams

public abstract byte[] getSigAlgParams()

Возвращает:

DER-кодированные параметры алгоритма подписи или null, если параметры отсутствуют.