compact1, compact2, compact3

java.security.cert

Класс X509CertSelector

java.lang. Объект

java.security.cert. X509CertSelector

Все Реализованные Интерфейсы:

Cloneable, CertSelector

public class X509CertSelector
extends Object
implements CertSelector

A CertSelector это выбирает X509Certificates то соответствие все указанные критерии. Этот class особенно полезен, выбирая сертификаты из a CertStore создавать PKIX-совместимый путь сертификации.

Когда сначала создано, X509CertSelector не имеет никаких включенных критериев и каждый из get методы возвращают значение по умолчанию (null, или -1 для getBasicConstraints метод). Поэтому, match метод возвратился бы true для любого X509Certificate. Как правило, несколько критериев включаются (вызывая setIssuer или setKeyUsage, например) и затем X509CertSelector к передают CertStore.getCertificates или некоторый подобный метод.

Несколько критериев могут быть включены (вызывая setIssuer и setSerialNumber, например) так, что match метод обычно уникально соответствует сингл X509Certificate. Мы обычно говорим, так как для двух АВАРИЙ издания возможно иметь то же самое отличительное имя и каждую проблему сертификат с тем же самым порядковым номером. Другие уникальные комбинации включают выпускающего, предмет, subjectKeyIdentifier и/или subjectPublicKey критерии.

Пожалуйста, обратитесь к RFC 3280: Интернет Сертификат Инфраструктуры управления открытыми ключами X.509 и Профиль CRL для определений расширений сертификата X.509, упомянутых ниже.

Параллельный Доступ

Если иначе не определено, методы, определенные в этом class, не ориентированы на многопотоковое исполнение. Многократные потоки, которые должны получить доступ к единственному объекту одновременно, должны синхронизироваться среди себя и обеспечить необходимую блокировку. Многократные потоки каждое управление отдельные объекты не должны синхронизироваться.

С тех пор:

1.4

См. Также:

CertSelector, X509Certificate

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

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

Конструктор и Описание
X509CertSelector() Создает X509CertSelector.

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

Модификатор и Тип	Метод и Описание
void	addPathToName(int type, byte[] name) Добавляет имя к pathToNames критерию.
void	addPathToName(int type, String name) Добавляет имя к pathToNames критерию.
void	addSubjectAlternativeName(int type, byte[] name) Добавляет имя к subjectAlternativeNames критерию.
void	addSubjectAlternativeName(int type, String name) Добавляет имя к subjectAlternativeNames критерию.
Объект	clone() Возвращает копию этого объекта.
byte[]	getAuthorityKeyIdentifier() Возвращает authorityKeyIdentifier критерий.
int	getBasicConstraints() Возвращает основное ограничительное ограничение.
X509Certificate	getCertificate() Возвращает certificateEquals критерий.
Дата	getCertificateValid() Возвращает certificateValid критерий.
Set<String>	getExtendedKeyUsage() Возвращает extendedKeyUsage критерий.
X500Principal	getIssuer() Возвращает критерий выпускающего как X500Principal.
byte[]	getIssuerAsBytes() Возвращает критерий выпускающего как байтовый массив.
Строка	getIssuerAsString() Клеветавший, используйте getIssuer () или getIssuerAsBytes () вместо этого.
boolean[]	getKeyUsage() Возвращает keyUsage критерий.
boolean	getMatchAllSubjectAltNames() Указывает если X509Certificate должен содержать все или по крайней мере один из subjectAlternativeNames, определенных в setSubjectAlternativeNames или addSubjectAlternativeName методы.
byte[]	getNameConstraints() Возвращает ограничительный критерий имени.
Collection<List<?>>	getPathToNames() Возвращает копию pathToNames критерия.
Set<String>	getPolicy() Возвращает критерий политики.
Дата	getPrivateKeyValid() Возвращает privateKeyValid критерий.
BigInteger	getSerialNumber() Возвращает serialNumber критерий.
X500Principal	getSubject() Возвращает подчиненный критерий как X500Principal.
Collection<List<?>>	getSubjectAlternativeNames() Возвращает копию subjectAlternativeNames критерия.
byte[]	getSubjectAsBytes() Возвращает подчиненный критерий как байтовый массив.
Строка	getSubjectAsString() Клеветавший, используйте getSubject () или getSubjectAsBytes () вместо этого.
byte[]	getSubjectKeyIdentifier() Возвращает subjectKeyIdentifier критерий.
PublicKey	getSubjectPublicKey() Возвращает subjectPublicKey критерий.
Строка	getSubjectPublicKeyAlgID() Возвращает subjectPublicKeyAlgID критерий.
boolean	match(Certificate cert) Решает ли a Certificate должен быть выбран.
void	setAuthorityKeyIdentifier(byte[] authorityKeyID) Устанавливает authorityKeyIdentifier критерий.
void	setBasicConstraints(int minMaxPathLen) Устанавливает основное ограничительное ограничение.
void	setCertificate(X509Certificate cert) Устанавливает certificateEquals критерий.
void	setCertificateValid(Date certValid) Устанавливает certificateValid критерий.
void	setExtendedKeyUsage(Set<String> keyPurposeSet) Устанавливает extendedKeyUsage критерий.
void	setIssuer(byte[] issuerDN) Устанавливает критерий выпускающего.
void	setIssuer(String issuerDN) Клеветавший, используйте setIssuer (X500Principal) или setIssuer (байт []) вместо этого.
void	setIssuer(X500Principal issuer) Устанавливает критерий выпускающего.
void	setKeyUsage(boolean[] keyUsage) Устанавливает keyUsage критерий.
void	setMatchAllSubjectAltNames(boolean matchAllNames) Позволяет/отключает соответствовать все subjectAlternativeNames, определенные в setSubjectAlternativeNames или addSubjectAlternativeName методы.
void	setNameConstraints(byte[] bytes) Устанавливает ограничительный критерий имени.
void	setPathToNames(Collection<List<?>> names) Устанавливает pathToNames критерий.
void	setPolicy(Set<String> certPolicySet) Устанавливает ограничение политики.
void	setPrivateKeyValid(Date privateKeyValid) Устанавливает privateKeyValid критерий.
void	setSerialNumber(BigInteger serial) Устанавливает serialNumber критерий.
void	setSubject(byte[] subjectDN) Устанавливает подчиненный критерий.
void	setSubject(String subjectDN) Клеветавший, используйте setSubject (X500Principal) или setSubject (байт []) вместо этого.
void	setSubject(X500Principal subject) Устанавливает подчиненный критерий.
void	setSubjectAlternativeNames(Collection<List<?>> names) Устанавливает subjectAlternativeNames критерий.
void	setSubjectKeyIdentifier(byte[] subjectKeyID) Устанавливает subjectKeyIdentifier критерий.
void	setSubjectPublicKey(byte[] key) Устанавливает subjectPublicKey критерий.
void	setSubjectPublicKey(PublicKey key) Устанавливает subjectPublicKey критерий.
void	setSubjectPublicKeyAlgID(String oid) Устанавливает subjectPublicKeyAlgID критерий.
Строка	toString() Возвратите печатаемое представление CertSelector.

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

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

X509CertSelector

public X509CertSelector()

Создает X509CertSelector. Первоначально, никакие критерии не устанавливаются так никто X509Certificate будет соответствовать.

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

setCertificate

public void setCertificate(X509Certificate cert)

Устанавливает certificateEquals критерий. Указанное X509Certificate должно быть равным X509Certificate переданный к match метод. Если null, тогда эта проверка не применяется.

Этот метод особенно полезен, когда необходимо соответствовать единственный сертификат. Хотя другие критерии могут быть определены в соединении с certificateEquals критерием, это обычно не практично или необходимо.

Параметры:

cert - X509Certificate соответствовать (или null)

См. Также:

getCertificate()

setSerialNumber

public void setSerialNumber(BigInteger serial)

Устанавливает serialNumber критерий. Указанный порядковый номер должен соответствовать порядковый номер сертификата в X509Certificate. Если null, любой порядковый номер сертификата сделает.

Параметры:

serial - порядковый номер сертификата, чтобы соответствовать (или null)

См. Также:

getSerialNumber()

setIssuer

public void setIssuer(X500Principal issuer)

Устанавливает критерий выпускающего. Указанное отличительное имя должно соответствовать отличительное имя выпускающего в X509Certificate. Если null, любое отличительное имя выпускающего сделает.

Параметры:

issuer - отличительное имя как X500Principal (или null)

С тех пор:

1.5

setIssuer

public void setIssuer(String issuerDN)
               throws IOException

Клеветавший, используйте setIssuer (X500Principal) или setIssuer (байт []) вместо этого. На этот метод нельзя положиться, поскольку он может быть не в состоянии соответствовать некоторые сертификаты из-за потери кодирования информации в Строковой форме RFC 2253 некоторых отличительных имен.

Устанавливает критерий выпускающего. Указанное отличительное имя должно соответствовать отличительное имя выпускающего в X509Certificate. Если null, любое отличительное имя выпускающего сделает.

Если issuerDN не null, это должно содержать отличительное имя в формате RFC 2253.

Параметры:

issuerDN - отличительное имя в формате RFC 2253 (или null)

Броски:

IOException - если ошибка парсинга происходит (неправильная форма для DN)

setIssuer

public void setIssuer(byte[] issuerDN)
               throws IOException

Устанавливает критерий выпускающего. Указанное отличительное имя должно соответствовать отличительное имя выпускающего в X509Certificate. Если null определяется, критерий выпускающего отключается, и любое отличительное имя выпускающего сделает.

Если issuerDN не null, это должно содержать единственный DER закодированное отличительное имя, как определено в X.501. Нотация ASN.1 для этой структуры следующие.

 Name ::= CHOICE {
   RDNSequence }

 RDNSequence ::= SEQUENCE OF RelativeDistinguishedName

 RelativeDistinguishedName ::=
   SET SIZE (1 .. MAX) OF AttributeTypeAndValue

 AttributeTypeAndValue ::= SEQUENCE {
   type     AttributeType,
   value    AttributeValue }

 AttributeType ::= OBJECT IDENTIFIER

 AttributeValue ::= ANY DEFINED BY AttributeType
 ....
 DirectoryString ::= CHOICE {
       teletexString           TeletexString (SIZE (1..MAX)),
       printableString         PrintableString (SIZE (1..MAX)),
       universalString         UniversalString (SIZE (1..MAX)),
       utf8String              UTF8String (SIZE (1.. MAX)),
       bmpString               BMPString (SIZE (1..MAX)) }
 

Отметьте, что байтовый массив, определенный здесь, клонируется, чтобы защитить от последующих модификаций.

Параметры:

issuerDN - байтовый массив, содержащий отличительное имя в ASN.1 DER закодированная форма (или null)

Броски:

IOException - если ошибка кодирования происходит (неправильная форма для DN)

setSubject

public void setSubject(X500Principal subject)

Устанавливает подчиненный критерий. Указанное отличительное имя должно соответствовать подчиненное отличительное имя в X509Certificate. Если null, любое подчиненное отличительное имя сделает.

Параметры:

subject - отличительное имя как X500Principal (или null)

С тех пор:

1.5

setSubject

public void setSubject(String subjectDN)
                throws IOException

Клеветавший, используйте setSubject (X500Principal) или setSubject (байт []) вместо этого. На этот метод нельзя положиться, поскольку он может быть не в состоянии соответствовать некоторые сертификаты из-за потери кодирования информации в Строковой форме RFC 2253 некоторых отличительных имен.

Устанавливает подчиненный критерий. Указанное отличительное имя должно соответствовать подчиненное отличительное имя в X509Certificate. Если null, любое подчиненное отличительное имя сделает.

Если subjectDN не null, это должно содержать отличительное имя в формате RFC 2253.

Параметры:

subjectDN - отличительное имя в формате RFC 2253 (или null)

Броски:

IOException - если ошибка парсинга происходит (неправильная форма для DN)

setSubject

public void setSubject(byte[] subjectDN)
                throws IOException

Устанавливает подчиненный критерий. Указанное отличительное имя должно соответствовать подчиненное отличительное имя в X509Certificate. Если null, любое подчиненное отличительное имя сделает.

Если subjectDN не null, это должно содержать единственный DER закодированное отличительное имя, как определено в X.501. Для нотации ASN.1 для этой структуры см. setIssuer(byte [] issuerDN).

Параметры:

subjectDN - байтовый массив, содержащий отличительное имя в ASN.1 DER формат (или null)

Броски:

IOException - если ошибка кодирования происходит (неправильная форма для DN)

setSubjectKeyIdentifier

public void setSubjectKeyIdentifier(byte[] subjectKeyID)

Устанавливает subjectKeyIdentifier критерий. X509Certificate должен содержать расширение SubjectKeyIdentifier, для которого содержание расширения соответствует указанное значение критерия. Если значение критерия null, никакая проверка subjectKeyIdentifier не будет сделана.

Если subjectKeyID не null, это должно содержать единственный DER закодированное значение, соответствующее содержанию значения расширения (не включая объектный идентификатор, установку критичности, и инкапсуляцию СТРОКИ ОКТЕТА) для расширения SubjectKeyIdentifier. Нотация ASN.1 для этой структуры следует.

 SubjectKeyIdentifier ::= KeyIdentifier

 KeyIdentifier ::= OCTET STRING
 

Так как формат подчиненных ключевых идентификаторов не получает мандат никакими стандартными, подчиненными ключевыми идентификаторами, не анализируются X509CertSelector. Вместо этого значения сравниваются, используя сравнение байта байтом.

Отметьте, что байтовый массив, предоставленный здесь, клонируется, чтобы защитить от последующих модификаций.

Параметры:

subjectKeyID - подчиненный ключевой идентификатор (или null)

См. Также:

getSubjectKeyIdentifier()

setAuthorityKeyIdentifier

public void setAuthorityKeyIdentifier(byte[] authorityKeyID)

Устанавливает authorityKeyIdentifier критерий. X509Certificate должен содержать расширение AuthorityKeyIdentifier, для которого содержание значения расширения соответствует указанное значение критерия. Если значение критерия null, никакая проверка authorityKeyIdentifier не будет сделана.

Если authorityKeyID не null, это должно содержать единственный DER закодированное значение, соответствующее содержанию значения расширения (не включая объектный идентификатор, установку критичности, и инкапсуляцию СТРОКИ ОКТЕТА) для расширения AuthorityKeyIdentifier. Нотация ASN.1 для этой структуры следует.

 AuthorityKeyIdentifier ::= SEQUENCE {
    keyIdentifier             [0] KeyIdentifier           OPTIONAL,
    authorityCertIssuer       [1] GeneralNames            OPTIONAL,
    authorityCertSerialNumber [2] CertificateSerialNumber OPTIONAL  }

 KeyIdentifier ::= OCTET STRING
 

Ключевые идентификаторы Властей не анализируются X509CertSelector. Вместо этого значения сравниваются, используя сравнение байта байтом.

Когда keyIdentifier поле AuthorityKeyIdentifier заполняется, значение обычно принимается от SubjectKeyIdentifier расширение в сертификате выпускающего. Отметьте, однако, что результат X509Certificate.getExtensionValue(<SubjectKeyIdentifier Object Identifier>) на сертификате выпускающего, возможно, НЕ используется непосредственно в качестве ввода к setAuthorityKeyIdentifier. Это - то, потому что SubjectKeyIdentifier содержит только СТРОКУ ОКТЕТА KeyIdentifier, и не ПОСЛЕДОВАТЕЛЬНОСТЬ KeyIdentifier, GeneralNames, и CertificateSerialNumber. Чтобы использовать значение расширения сертификата выпускающего SubjectKeyIdentifier расширение, будет необходимо извлечь значение встроенного KeyIdentifier СТРОКА ОКТЕТА, тогда DER кодируют эту СТРОКУ ОКТЕТА в ПОСЛЕДОВАТЕЛЬНОСТИ. Для получения дополнительной информации на SubjectKeyIdentifier, см. setSubjectKeyIdentifier(byte[] subjectKeyID).

Отметьте также, что байтовый массив, предоставленный здесь, клонируется, чтобы защитить от последующих модификаций.

Параметры:

authorityKeyID - ключевой идентификатор полномочий (или null)

См. Также:

getAuthorityKeyIdentifier()

setCertificateValid

public void setCertificateValid(Date certValid)

Устанавливает certificateValid критерий. Указанная дата должна находиться в пределах срока действия сертификата для X509Certificate. Если null, никакая проверка certificateValid не будет сделана.

Отметьте что Date предоставленный здесь клонируется, чтобы защитить от последующих модификаций.

Параметры:

certValid - Date проверять (или null)

См. Также:

getCertificateValid()

setPrivateKeyValid

public void setPrivateKeyValid(Date privateKeyValid)

Устанавливает privateKeyValid критерий. Указанная дата должна находиться в пределах срока действия с закрытым ключом для X509Certificate. Если null, никакая проверка privateKeyValid не будет сделана.

Отметьте что Date предоставленный здесь клонируется, чтобы защитить от последующих модификаций.

Параметры:

privateKeyValid - Date проверять (или null)

См. Также:

getPrivateKeyValid()

setSubjectPublicKeyAlgID

public void setSubjectPublicKeyAlgID(String oid)
                              throws IOException

Устанавливает subjectPublicKeyAlgID критерий. X509Certificate должен содержать подчиненный открытый ключ с указанным алгоритмом. Если null, никакая проверка subjectPublicKeyAlgID не будет сделана.

Параметры:

oid - Объектный идентификатор (OID) алгоритма, чтобы проверить на (или null). OID представляется рядом неотрицательных целых чисел, разделенных периодами.

Броски:

IOException - если OID недопустим, таков как первый компонент быть не 0, 1 или 2 или второй компонент, являющийся больше чем 39.

См. Также:

getSubjectPublicKeyAlgID()

setSubjectPublicKey

public void setSubjectPublicKey(PublicKey key)

Устанавливает subjectPublicKey критерий. X509Certificate должен содержать указанный подчиненный открытый ключ. Если null, никакая проверка subjectPublicKey не будет сделана.

Параметры:

key - подчиненный открытый ключ, чтобы проверить на (или null)

См. Также:

getSubjectPublicKey()

setSubjectPublicKey

public void setSubjectPublicKey(byte[] key)
                         throws IOException

Устанавливает subjectPublicKey критерий. X509Certificate должен содержать указанный подчиненный открытый ключ. Если null, никакая проверка subjectPublicKey не будет сделана.

Поскольку этот метод позволяет открытому ключу быть определенным как байтовый массив, это может использоваться для неизвестных ключевых типов.

Если key не null, это должно содержать единственный DER закодированная структура SubjectPublicKeyInfo, как определено в X.509. Нотация ASN.1 для этой структуры следующие.

 SubjectPublicKeyInfo  ::=  SEQUENCE  {
   algorithm            AlgorithmIdentifier,
   subjectPublicKey     BIT STRING  }

 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
 

Отметьте, что байтовый массив, предоставленный здесь, клонируется, чтобы защитить от последующих модификаций.

Параметры:

key - байтовый массив, содержащий подчиненный открытый ключ в ASN.1 DER форма (или null)

Броски:

IOException - если ошибка кодирования происходит (неправильная форма для подчиненного открытого ключа)

См. Также:

getSubjectPublicKey()

setKeyUsage

public void setKeyUsage(boolean[] keyUsage)

Устанавливает keyUsage критерий. X509Certificate должен позволить указанные значения keyUsage. Если null, никакая проверка keyUsage не будет сделана. Отметьте что X509Certificate у этого нет никакого keyUsage расширения, неявно позволяет все значения keyUsage.

Отметьте, что булев массив, предоставленный здесь, клонируется, чтобы защитить от последующих модификаций.

Параметры:

keyUsage - булев массив в том же самом формате как булев массив, возвращенный X509Certificate.getKeyUsage(). Или null.

См. Также:

getKeyUsage()

setExtendedKeyUsage

public void setExtendedKeyUsage(Set<String> keyPurposeSet)
                         throws IOException

Устанавливает extendedKeyUsage критерий. X509Certificate должен позволить указанные ключевые цели в его расширенном ключевом расширении использования. Если keyPurposeSet пусто или null, никакая проверка extendedKeyUsage не будет сделана. Отметьте что X509Certificate у этого нет никакого extendedKeyUsage расширения, неявно позволяет все ключевые цели.

Отметьте что Set клонируется, чтобы защитить от последующих модификаций.

Параметры:

keyPurposeSet - a Set из ключевых OID цели в строковом формате (или null). Каждый OID представляется рядом неотрицательных целых чисел, разделенных периодами.

Броски:

IOException - если OID недопустим, таков как первый компонент быть не 0, 1 или 2 или второй компонент, являющийся больше чем 39.

См. Также:

getExtendedKeyUsage()

setMatchAllSubjectAltNames

public void setMatchAllSubjectAltNames(boolean matchAllNames)

Позволяет/отключает соответствовать все subjectAlternativeNames, определенные в setSubjectAlternativeNames или addSubjectAlternativeName методы. Если включено, X509Certificate должен содержать все указанные подчиненные альтернативные имена. Если отключено, X509Certificate должен содержать по крайней мере одно из указанных подчиненных альтернативных имен.

Флаг matchAllNames true по умолчанию.

Параметры:

matchAllNames - если true, флаг включается; если false, флаг отключается.

См. Также:

getMatchAllSubjectAltNames()

setSubjectAlternativeNames

public void setSubjectAlternativeNames(Collection<List<?>> names)
                                throws IOException

Устанавливает subjectAlternativeNames критерий. X509Certificate должен содержать все или по крайней мере один из указанных subjectAlternativeNames, в зависимости от значения флага matchAllNames (см. setMatchAllSubjectAltNames).

Этот метод позволяет вызывающей стороне определять, с единственным вызовом метода, полным набором подчиненных альтернативных имен для subjectAlternativeNames критерия. Указанное значение заменяет предыдущее значение для subjectAlternativeNames критерия.

names параметр (если нет null) a Collection с одной записью для каждого имени, которое будет включено в подчиненную альтернативу, называют критерий. Каждая запись является a List чья первая запись Integer (тип имени, 0-8) и чья вторая запись является a String или байтовый массив (имя, в строке или ASN.1 DER закодированная форма, соответственно). Могут быть многократные имена того же самого типа. Если null предоставляется как значение для этого параметра, никакая проверка subjectAlternativeNames не будет выполняться.

Каждое подчиненное альтернативное имя в Collection может быть определен любой как a String или как ASN.1 закодированный байтовый массив. Для получения дополнительной информации об используемых форматах, см. addSubjectAlternativeName(int type, String name) и addSubjectAlternativeName(int type, byte [] name).

Отметьте: для отличительных имен определите форму байтового массива вместо Строковой формы. См. примечание в addSubjectAlternativeName(int, String) для получения дополнительной информации.

Отметьте что names параметр может содержать двойные названия (то же самое имя и назвать тип), но они могут быть удалены из Collection из имен, возвращенных getSubjectAlternativeNames метод.

Отметьте, что глубокая копия выполняется на Collection защищать от последующих модификаций.

Параметры:

names - a Collection из имен (или null)

Броски:

IOException - если ошибка парсинга происходит

См. Также:

getSubjectAlternativeNames()

addSubjectAlternativeName

public void addSubjectAlternativeName(int type,
                                      String name)
                               throws IOException

Добавляет имя к subjectAlternativeNames критерию. X509Certificate должен содержать все или по крайней мере один из указанных subjectAlternativeNames, в зависимости от значения флага matchAllNames (см. setMatchAllSubjectAltNames).

Этот метод позволяет вызывающей стороне добавлять имя к набору подчиненных альтернативных имен. Указанное имя добавляется к любому предыдущему значению для subjectAlternativeNames критерия. Если указанное имя является копией, оно может быть проигнорировано.

Имя обеспечивается в строковом формате. RFC 822, DNS, и имена URI используют известные строковые форматы для тех типов (подвергающийся ограничениям, включенным в RFC 3280). Имена адреса IPv4 предоставляются, используя отмеченную точкой нотацию четверки. Имена адреса OID представляются как серия неотрицательных целых чисел, разделенных периодами. И имена каталогов (отличительные имена) предоставляются в формате RFC 2253. Никакой стандартный строковый формат не определяется для otherNames, имен X.400, имен стороны EDI, имен адреса IPv6, или никакого другого типа имен. Они должны быть определены, используя addSubjectAlternativeName(int type, byte [] name) метод.

Отметьте: для отличительных имен используйте addSubjectAlternativeName (интервал, байт []) вместо этого. На этот метод нельзя положиться, поскольку он может быть не в состоянии соответствовать некоторые сертификаты из-за потери кодирования информации в Строковой форме RFC 2253 некоторых отличительных имен.

Параметры:

type - тип имени (0-8, как определено в RFC 3280, раздел 4.2.1.7)

name - имя в строковой форме (нет null)

Броски:

IOException - если ошибка парсинга происходит

addSubjectAlternativeName

public void addSubjectAlternativeName(int type,
                                      byte[] name)
                               throws IOException

Добавляет имя к subjectAlternativeNames критерию. X509Certificate должен содержать все или по крайней мере один из указанных subjectAlternativeNames, в зависимости от значения флага matchAllNames (см. setMatchAllSubjectAltNames).

Этот метод позволяет вызывающей стороне добавлять имя к набору подчиненных альтернативных имен. Указанное имя добавляется к любому предыдущему значению для subjectAlternativeNames критерия. Если указанное имя является копией, оно может быть проигнорировано.

Имя обеспечивается как байтовый массив. Этот байтовый массив должен содержать DER закодированное имя, как это появилось бы в структуре GeneralName, определенной в RFC 3280 и X.509. Закодированный байтовый массив должен только содержать закодированное значение имени, и не должен включать тег, связанный с именем в структуре GeneralName. Определение ASN.1 этой структуры появляется ниже.

  GeneralName ::= CHOICE {
       otherName                       [0]     OtherName,
       rfc822Name                      [1]     IA5String,
       dNSName                         [2]     IA5String,
       x400Address                     [3]     ORAddress,
       directoryName                   [4]     Name,
       ediPartyName                    [5]     EDIPartyName,
       uniformResourceIdentifier       [6]     IA5String,
       iPAddress                       [7]     OCTET STRING,
       registeredID                    [8]     OBJECT IDENTIFIER}
 

Отметьте, что байтовый массив, предоставленный здесь, клонируется, чтобы защитить от последующих модификаций.

Параметры:

type - тип имени (0-8, как упомянуто выше)

name - байтовый массив, содержащий имя в ASN.1 DER закодированная форма

Броски:

IOException - если ошибка парсинга происходит

setNameConstraints

public void setNameConstraints(byte[] bytes)
                        throws IOException

Устанавливает ограничительный критерий имени. X509Certificate должен иметь подчиненные и подчиненные альтернативные имена, которые встречают ограничения указанного имени.

Ограничения имени определяются как байтовый массив. Этот байтовый массив должен содержать DER закодированная форма ограничений имени, поскольку они появились бы в структуре NameConstraints, определенной в RFC 3280 и X.509. Определение ASN.1 этой структуры появляется ниже.

  NameConstraints ::= SEQUENCE {
       permittedSubtrees       [0]     GeneralSubtrees OPTIONAL,
       excludedSubtrees        [1]     GeneralSubtrees OPTIONAL }

  GeneralSubtrees ::= SEQUENCE SIZE (1..MAX) OF GeneralSubtree

  GeneralSubtree ::= SEQUENCE {
       base                    GeneralName,
       minimum         [0]     BaseDistance DEFAULT 0,
       maximum         [1]     BaseDistance OPTIONAL }

  BaseDistance ::= INTEGER (0..MAX)

  GeneralName ::= CHOICE {
       otherName                       [0]     OtherName,
       rfc822Name                      [1]     IA5String,
       dNSName                         [2]     IA5String,
       x400Address                     [3]     ORAddress,
       directoryName                   [4]     Name,
       ediPartyName                    [5]     EDIPartyName,
       uniformResourceIdentifier       [6]     IA5String,
       iPAddress                       [7]     OCTET STRING,
       registeredID                    [8]     OBJECT IDENTIFIER}
 

Отметьте, что байтовый массив, предоставленный здесь, клонируется, чтобы защитить от последующих модификаций.

Параметры:

bytes - байтовый массив, содержащий ASN.1 DER кодирование расширения NameConstraints, которое будет использоваться для того, чтобы проверить ограничения имени. Только значение расширения включается, не флаг критичности или OID. Может быть null, когда никакая ограничительная проверка имени не будет выполняться.

Броски:

IOException - если ошибка парсинга происходит

См. Также:

getNameConstraints()

setBasicConstraints

public void setBasicConstraints(int minMaxPathLen)

Устанавливает основное ограничительное ограничение. Если значение больше чем или равно нулю, X509Certificates должен включать basicConstraints расширение с pathLen, по крайней мере, этого значения. Если значение-2, только сертификаты объекта конца принимаются. Если значение-1, никакая проверка не делается.

Это ограничение полезно, создавая путь сертификации вперед (от цели к доверительной привязке. Если частичный путь был создан, у любого сертификата кандидата должно быть значение maxPathLen, больше чем или равный числу сертификатов в частичном пути.

Параметры:

minMaxPathLen - значение для основного ограничительного ограничения

Броски:

IllegalArgumentException - если значение - меньше чем-2

См. Также:

getBasicConstraints()

setPolicy

public void setPolicy(Set<String> certPolicySet)
               throws IOException

Устанавливает ограничение политики. X509Certificate должен включать по крайней мере одну из указанных политик в ее расширении политик сертификата. Если certPolicySet пусто, тогда X509Certificate должен включать, по крайней мере, немного указанной политики в ее расширение политик сертификата. Если certPolicySet null, никакая проверка политики не будет выполняться.

Отметьте что Set клонируется, чтобы защитить от последующих модификаций.

Параметры:

certPolicySet - a Set из OID политики сертификата в строковом формате (или null). Каждый OID представляется рядом неотрицательных целых чисел, разделенных периодами.

Броски:

IOException - если ошибка парсинга происходит на OID, таком как первый компонент, не 0, 1 или 2, или второй компонент больше чем 39.

См. Также:

getPolicy()

setPathToNames

public void setPathToNames(Collection<List<?>> names)
                    throws IOException

Устанавливает pathToNames критерий. X509Certificate не должен включать ограничения имени, которые запретили бы создание пути к указанным именам.

Этот метод позволяет вызывающей стороне определять, с единственным вызовом метода, полным набором имен который X509Certificates's ограничения имени должен разрешить. Указанное значение заменяет предыдущее значение для pathToNames критерия.

Это ограничение полезно, создавая путь сертификации вперед (от цели к доверительной привязке. Если бы частичный путь был создан, любой сертификат кандидата не должен включать ограничения имени, которые запретили бы создание пути к любому из имен в частичном пути.

names параметр (если нет null) a Collection с одной записью для каждого имени, которое будет включено в pathToNames критерий. Каждая запись является a List чья первая запись Integer (тип имени, 0-8) и чья вторая запись является a String или байтовый массив (имя, в строке или ASN.1 DER закодированная форма, соответственно). Могут быть многократные имена того же самого типа. Если null предоставляется как значение для этого параметра, никакая проверка pathToNames не будет выполняться.

Каждое имя в Collection может быть определен любой как a String или как ASN.1 закодированный байтовый массив. Для получения дополнительной информации об используемых форматах, см. addPathToName(int type, String name) и addPathToName(int type, byte [] name).

Отметьте: для отличительных имен определите форму байтового массива вместо Строковой формы. См. примечание в addPathToName(int, String) для получения дополнительной информации.

Отметьте что names параметр может содержать двойные названия (то же самое имя и назвать тип), но они могут быть удалены из Collection из имен, возвращенных getPathToNames метод.

Отметьте, что глубокая копия выполняется на Collection защищать от последующих модификаций.

Параметры:

names - a Collection с одной записью на имя (или null)

Броски:

IOException - если ошибка парсинга происходит

См. Также:

getPathToNames()

addPathToName

public void addPathToName(int type,
                          String name)
                   throws IOException

Добавляет имя к pathToNames критерию. X509Certificate не должен включать ограничения имени, которые запретили бы создание пути к указанному имени.

Этот метод позволяет вызывающей стороне добавлять имя к набору имен который X509Certificates's ограничения имени должен разрешить. Указанное имя добавляется к любому предыдущему значению для pathToNames критерия. Если имя является копией, оно может быть проигнорировано.

Имя обеспечивается в строковом формате. RFC 822, DNS, и имена URI используют известные строковые форматы для тех типов (подвергающийся ограничениям, включенным в RFC 3280). Имена адреса IPv4 предоставляются, используя отмеченную точкой нотацию четверки. Имена адреса OID представляются как серия неотрицательных целых чисел, разделенных периодами. И имена каталогов (отличительные имена) предоставляются в формате RFC 2253. Никакой стандартный строковый формат не определяется для otherNames, имен X.400, имен стороны EDI, имен адреса IPv6, или никакого другого типа имен. Они должны быть определены, используя addPathToName(int type, byte [] name) метод.

Отметьте: для отличительных имен используйте addPathToName (интервал, байт []) вместо этого. На этот метод нельзя положиться, поскольку он может быть не в состоянии соответствовать некоторые сертификаты из-за потери кодирования информации в Строковой форме RFC 2253 некоторых отличительных имен.

Параметры:

type - тип имени (0-8, как определено в RFC 3280, раздел 4.2.1.7)

name - имя в строковой форме

Броски:

IOException - если ошибка парсинга происходит

addPathToName

public void addPathToName(int type,
                          byte[] name)
                   throws IOException

Добавляет имя к pathToNames критерию. X509Certificate не должен включать ограничения имени, которые запретили бы создание пути к указанному имени.

Этот метод позволяет вызывающей стороне добавлять имя к набору имен который X509Certificates's ограничения имени должен разрешить. Указанное имя добавляется к любому предыдущему значению для pathToNames критерия. Если имя является копией, оно может быть проигнорировано.

Имя обеспечивается как байтовый массив. Этот байтовый массив должен содержать DER закодированное имя, как это появилось бы в структуре GeneralName, определенной в RFC 3280 и X.509. Определение ASN.1 этой структуры появляется в документации для addSubjectAlternativeName(int type, byte [] name).

Отметьте, что байтовый массив, предоставленный здесь, клонируется, чтобы защитить от последующих модификаций.

Параметры:

type - тип имени (0-8, как определено в RFC 3280, раздел 4.2.1.7)

name - байтовый массив, содержащий имя в ASN.1 DER закодированная форма

Броски:

IOException - если ошибка парсинга происходит

getCertificate

public X509Certificate getCertificate()

Возвращает certificateEquals критерий. Указанное X509Certificate должно быть равным X509Certificate переданный к match метод. Если null, эта проверка не применяется.

Возвраты:

X509Certificate соответствовать (или null)

См. Также:

setCertificate(java.security.cert.X509Certificate)

getSerialNumber

public BigInteger getSerialNumber()

Возвращает serialNumber критерий. Указанный порядковый номер должен соответствовать порядковый номер сертификата в X509Certificate. Если null, любой порядковый номер сертификата сделает.

Возвраты:

порядковый номер сертификата, чтобы соответствовать (или null)

См. Также:

setSerialNumber(java.math.BigInteger)

getIssuer

public X500Principal getIssuer()

Возвращает критерий выпускающего как X500Principal. Это отличительное имя должно соответствовать отличительное имя выпускающего в X509Certificate. Если null, критерий выпускающего отключается, и любое отличительное имя выпускающего сделает.

Возвраты:

необходимое отличительное имя выпускающего как X500Principal (или null)

С тех пор:

1.5

getIssuerAsString

public String getIssuerAsString()

Клеветавший, используйте getIssuer () или getIssuerAsBytes () вместо этого. На этот метод нельзя положиться, поскольку он может быть не в состоянии соответствовать некоторые сертификаты из-за потери кодирования информации в Строковой форме RFC 2253 некоторых отличительных имен.

Возвращает критерий выпускающего как a String. Это отличительное имя должно соответствовать отличительное имя выпускающего в X509Certificate. Если null, критерий выпускающего отключается, и любое отличительное имя выпускающего сделает.

Если возвращенное значение не null, это - отличительное имя в формате RFC 2253.

Возвраты:

необходимое отличительное имя выпускающего в формате RFC 2253 (или null)

getIssuerAsBytes

public byte[] getIssuerAsBytes()
                        throws IOException

Возвращает критерий выпускающего как байтовый массив. Это отличительное имя должно соответствовать отличительное имя выпускающего в X509Certificate. Если null, критерий выпускающего отключается, и любое отличительное имя выпускающего сделает.

Если возвращенное значение не null, это - байтовый массив, содержащий единственный DER закодированное отличительное имя, как определено в X.501. Нотация ASN.1 для этой структуры предоставляется в документации для setIssuer(byte [] issuerDN).

Отметьте, что возвращенный байтовый массив клонируется, чтобы защитить от последующих модификаций.

Возвраты:

байтовый массив, содержащий необходимое отличительное имя выпускающего в ASN.1 DER формат (или null)

Броски:

IOException - если ошибка кодирования происходит

getSubject

public X500Principal getSubject()

Возвращает подчиненный критерий как X500Principal. Это отличительное имя должно соответствовать подчиненное отличительное имя в X509Certificate. Если null, подчиненный критерий отключается, и любое подчиненное отличительное имя сделает.

Возвраты:

необходимое подчиненное отличительное имя как X500Principal (или null)

С тех пор:

1.5

getSubjectAsString

public String getSubjectAsString()

Клеветавший, используйте getSubject () или getSubjectAsBytes () вместо этого. На этот метод нельзя положиться, поскольку он может быть не в состоянии соответствовать некоторые сертификаты из-за потери кодирования информации в Строковой форме RFC 2253 некоторых отличительных имен.

Возвращает подчиненный критерий как a String. Это отличительное имя должно соответствовать подчиненное отличительное имя в X509Certificate. Если null, подчиненный критерий отключается, и любое подчиненное отличительное имя сделает.

Если возвращенное значение не null, это - отличительное имя в формате RFC 2253.

Возвраты:

необходимое подчиненное отличительное имя в формате RFC 2253 (или null)

getSubjectAsBytes

public byte[] getSubjectAsBytes()
                         throws IOException

Возвращает подчиненный критерий как байтовый массив. Это отличительное имя должно соответствовать подчиненное отличительное имя в X509Certificate. Если null, подчиненный критерий отключается, и любое подчиненное отличительное имя сделает.

Если возвращенное значение не null, это - байтовый массив, содержащий единственный DER закодированное отличительное имя, как определено в X.501. Нотация ASN.1 для этой структуры предоставляется в документации для setSubject(byte [] subjectDN).

Отметьте, что возвращенный байтовый массив клонируется, чтобы защитить от последующих модификаций.

Возвраты:

байтовый массив, содержащий необходимое подчиненное отличительное имя в ASN.1 DER формат (или null)

Броски:

IOException - если ошибка кодирования происходит

getSubjectKeyIdentifier

public byte[] getSubjectKeyIdentifier()

Возвращает subjectKeyIdentifier критерий. X509Certificate должен содержать расширение SubjectKeyIdentifier с указанным значением. Если null, никакая проверка subjectKeyIdentifier не будет сделана.

Отметьте, что возвращенный байтовый массив клонируется, чтобы защитить от последующих модификаций.

Возвраты:

ключевой идентификатор (или null)

См. Также:

setSubjectKeyIdentifier(byte[])

getAuthorityKeyIdentifier

public byte[] getAuthorityKeyIdentifier()

Возвращает authorityKeyIdentifier критерий. X509Certificate должен содержать расширение AuthorityKeyIdentifier с указанным значением. Если null, никакая проверка authorityKeyIdentifier не будет сделана.

Отметьте, что возвращенный байтовый массив клонируется, чтобы защитить от последующих модификаций.

Возвраты:

ключевой идентификатор (или null)

См. Также:

setAuthorityKeyIdentifier(byte[])

getCertificateValid

public Date getCertificateValid()

Возвращает certificateValid критерий. Указанная дата должна находиться в пределах срока действия сертификата для X509Certificate. Если null, никакая проверка certificateValid не будет сделана.

Отметьте что Date возвращенный клонируется, чтобы защитить от последующих модификаций.

Возвраты:

Date проверять (или null)

См. Также:

setCertificateValid(java.util.Date)

getPrivateKeyValid

public Date getPrivateKeyValid()

Возвращает privateKeyValid критерий. Указанная дата должна находиться в пределах срока действия с закрытым ключом для X509Certificate. Если null, никакая проверка privateKeyValid не будет сделана.

Отметьте что Date возвращенный клонируется, чтобы защитить от последующих модификаций.

Возвраты:

Date проверять (или null)

См. Также:

setPrivateKeyValid(java.util.Date)

getSubjectPublicKeyAlgID

public String getSubjectPublicKeyAlgID()

Возвращает subjectPublicKeyAlgID критерий. X509Certificate должен содержать подчиненный открытый ключ с указанным алгоритмом. Если null, никакая проверка subjectPublicKeyAlgID не будет сделана.

Возвраты:

объектный идентификатор (OID) алгоритма подписи, чтобы проверить на (или null). OID представляется рядом неотрицательных целых чисел, разделенных периодами.

См. Также:

setSubjectPublicKeyAlgID(java.lang.String)

getSubjectPublicKey

public PublicKey getSubjectPublicKey()

Возвращает subjectPublicKey критерий. X509Certificate должен содержать указанный подчиненный открытый ключ. Если null, никакая проверка subjectPublicKey не будет сделана.

Возвраты:

подчиненный открытый ключ, чтобы проверить на (или null)

См. Также:

setSubjectPublicKey(java.security.PublicKey)

getKeyUsage

public boolean[] getKeyUsage()

Возвращает keyUsage критерий. X509Certificate должен позволить указанные значения keyUsage. Если ноль, никакая проверка keyUsage не будет сделана.

Отметьте, что булев возвращенный массив клонируется, чтобы защитить от последующих модификаций.

Возвраты:

булев массив в том же самом формате как булев массив, возвращенный X509Certificate.getKeyUsage(). Или null.

См. Также:

setKeyUsage(boolean[])

getExtendedKeyUsage

public Set<String> getExtendedKeyUsage()

Возвращает extendedKeyUsage критерий. X509Certificate должен позволить указанные ключевые цели в его расширенном ключевом расширении использования. Если keyPurposeSet возвращенный пусто или null, никакая проверка extendedKeyUsage не будет сделана. Отметьте что X509Certificate у этого нет никакого extendedKeyUsage расширения, неявно позволяет все ключевые цели.

Возвраты:

неизменное Set из ключевых OID цели в строковом формате (или null)

См. Также:

setExtendedKeyUsage(java.util.Set<java.lang.String>)

getMatchAllSubjectAltNames

public boolean getMatchAllSubjectAltNames()

Указывает если X509Certificate должен содержать все или по крайней мере один из subjectAlternativeNames, определенных в setSubjectAlternativeNames или addSubjectAlternativeName методы. Если true, X509Certificate должен содержать все указанные подчиненные альтернативные имена. Если false, X509Certificate должен содержать по крайней мере одно из указанных подчиненных альтернативных имен.

Возвраты:

true если флаг включается; false если флаг отключается. Флаг true по умолчанию.

См. Также:

setMatchAllSubjectAltNames(boolean)

getSubjectAlternativeNames

public Collection<List<?>> getSubjectAlternativeNames()

Возвращает копию subjectAlternativeNames критерия. X509Certificate должен содержать все или по крайней мере один из указанных subjectAlternativeNames, в зависимости от значения флага matchAllNames (см. getMatchAllSubjectAltNames). Если возвращенное значение null, никакая проверка subjectAlternativeNames не будет выполняться.

Если возвращенное значение не null, это - a Collection с одной записью для каждого имени, которое будет включено в подчиненную альтернативу, называют критерий. Каждая запись является a List чья первая запись Integer (тип имени, 0-8) и чья вторая запись является a String или байтовый массив (имя, в строке или ASN.1 DER закодированная форма, соответственно). Могут быть многократные имена того же самого типа. Отметьте что Collection возвращенный может содержать двойные названия (то же самое имя и назвать тип).

Каждое подчиненное альтернативное имя в Collection может быть определен любой как a String или как ASN.1 закодированный байтовый массив. Для получения дополнительной информации об используемых форматах, см. addSubjectAlternativeName(int type, String name) и addSubjectAlternativeName(int type, byte [] name).

Отметьте, что глубокая копия выполняется на Collection защищать от последующих модификаций.

Возвраты:

a Collection из имен (или null)

См. Также:

setSubjectAlternativeNames(java.util.Collection<java.util.List<?>>)

getNameConstraints

public byte[] getNameConstraints()

Возвращает ограничительный критерий имени. X509Certificate должен иметь подчиненные и подчиненные альтернативные имена, которые встречают ограничения указанного имени.

Ограничения имени возвращаются как байтовый массив. Этот байтовый массив содержит DER закодированная форма ограничений имени, поскольку они появились бы в структуре NameConstraints, определенной в RFC 3280 и X.509. Нотация ASN.1 для этой структуры предоставляется в документации для setNameConstraints(byte [] bytes).

Отметьте, что возвращенный байтовый массив клонируется, чтобы защитить от последующих модификаций.

Возвраты:

байтовый массив, содержащий ASN.1 DER кодирование расширения NameConstraints, используется для того, чтобы проверить ограничения имени. null если никакая ограничительная проверка имени не будет выполняться.

См. Также:

setNameConstraints(byte[])

getBasicConstraints

public int getBasicConstraints()

Возвращает основное ограничительное ограничение. Если значение больше чем или равно нулю, X509Certificates должен включать basicConstraints расширение с pathLen, по крайней мере, этого значения. Если значение-2, только сертификаты объекта конца принимаются. Если значение-1, никакая проверка basicConstraints не делается.

Возвраты:

значение для основного ограничительного ограничения

См. Также:

setBasicConstraints(int)

getPolicy

public Set<String> getPolicy()

Возвращает критерий политики. X509Certificate должен включать по крайней мере одну из указанных политик в ее расширении политик сертификата. Если Set возвращенный пусто, тогда X509Certificate должен включать, по крайней мере, немного указанной политики в ее расширение политик сертификата. Если Set возвращенный null, никакая проверка политики не будет выполняться.

Возвраты:

неизменное Set из OID политики сертификата в строковом формате (или null)

См. Также:

setPolicy(java.util.Set<java.lang.String>)

getPathToNames

public Collection<List<?>> getPathToNames()

Возвращает копию pathToNames критерия. X509Certificate не должен включать ограничения имени, которые запретили бы создание пути к указанным именам. Если возвращенное значение null, никакая проверка pathToNames не будет выполняться.

Если возвращенное значение не null, это - a Collection с одной записью для каждого имени, которое будет включено в pathToNames критерий. Каждая запись является a List чья первая запись Integer (тип имени, 0-8) и чья вторая запись является a String или байтовый массив (имя, в строке или ASN.1 DER закодированная форма, соответственно). Могут быть многократные имена того же самого типа. Отметьте что Collection возвращенный может содержать двойные названия (то же самое имя и назвать тип).

Каждое имя в Collection может быть определен любой как a String или как ASN.1 закодированный байтовый массив. Для получения дополнительной информации об используемых форматах, см. addPathToName(int type, String name) и addPathToName(int type, byte [] name).

Отметьте, что глубокая копия выполняется на Collection защищать от последующих модификаций.

Возвраты:

a Collection из имен (или null)

См. Также:

setPathToNames(java.util.Collection<java.util.List<?>>)

toString

public String toString()

Возвратите печатаемое представление CertSelector.

Переопределения:

toString в class Object

Возвраты:

a String описание содержания CertSelector

соответствие

public boolean match(Certificate cert)

Решает ли a Certificate должен быть выбран.

Определенный:

match в интерфейсе CertSelector

Параметры:

cert - Certificate быть проверенным

Возвраты:

true если Certificate должен быть выбран, false иначе

клон

public Object clone()

Возвращает копию этого объекта.

Определенный:

clone в интерфейсе CertSelector

Переопределения:

clone в class Object

Возвраты:

копия

См. Также:

Cloneable