Класс TrustAnchor

Якорь доверия или наиболее надёжный центр сертификации (ЦС).

Этот класс представляет "наиболее надёжный ЦС", используемый в качестве якоря доверия для проверки цепочек сертификатов X.509. Наиболее надёжный ЦС включает открытый ключ ЦС, имя ЦС и любые ограничения на набор цепочек, которые могут быть проверены с использованием этого ключа. Эти параметры могут быть указаны в форме доверенного X509Certificate или в виде отдельных параметров.

Одновременный доступ

Все TrustAnchor объекты должны быть неизменяемыми и потокобезопасными. Это означает, что несколько потоков могут одновременно вызывать методы, определённые в этом классе, для одного TrustAnchor объекта (или более одного) без негативных последствий. Требование, чтобы TrustAnchor объекты были неизменяемыми и потокобезопасными, позволяет передавать их различным частям кода, не беспокоясь о координации доступа. Это условие относится ко всем общедоступным полям и методам этого класса и к любым добавленным или переопределённым подклассами.

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

TrustAnchor

public TrustAnchor(X509Certificate trustedCert,
                   byte[] nameConstraints)

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}

Параметры:

trustedCert - доверенный X509Certificate

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

Исключения:

IllegalArgumentException - если ограничения на имена невозможно декодировать

NullPointerException - если указанный X509Certificate является null

TrustAnchor

public TrustAnchor(X500Principal caPrincipal,
                   PublicKey pubKey,
                   byte[] nameConstraints)

Параметры:

caPrincipal - имя наиболее надёжного ЦС как X500Principal

pubKey - открытый ключ наиболее надёжного ЦС

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

Исключения:

NullPointerException - если указанный caPrincipal или pubKey параметр является null

Since:

1.5

TrustAnchor

public TrustAnchor(String caName,
                   PublicKey pubKey,
                   byte[] nameConstraints)

Параметры:

caName - полное доменное имя (FQDN) наиболее надёжного ЦС в формате RFC 2253 String

pubKey - открытый ключ наиболее надёжного ЦС

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

Исключения:

IllegalArgumentException - если указанный caName параметр пустой (caName.length() == 0) или имеет неправильный формат, или ограничения на имена невозможно декодировать

NullPointerException - если указанный caName или pubKey параметр является null

Методы

getTrustedCert

public final X509Certificate getTrustedCert()

Возвращает сертификат наиболее надёжного ЦС.

Возвращает:

доверенный X509Certificate или null если якорь доверия не был задан как доверенный сертификат

getCA

public final X500Principal getCA()

Возвращает имя наиболее надёжного ЦС в виде X500Principal.

Возвращает:

полное доменное имя (FQDN) наиболее надёжного ЦС, или null если якорь доверия не был задан как пара доверенного открытого ключа и имени или X500Principal

Since:

1.5

getCAName

public final String getCAName()

Возвращает имя наиболее надёжного ЦС в формате RFC 2253 String.

Возвращает:

полное доменное имя (FQDN) наиболее надёжного ЦС, или null если якорь доверия не был задан как пара доверенного открытого ключа и имени или X500Principal

getCAPublicKey

public final PublicKey getCAPublicKey()

Возвращает открытый ключ наиболее надёжного ЦС.

Возвращает:

открытый ключ наиболее надёжного ЦС, или null если якорь доверия не был задан как пара доверенного открытого ключа и имени или X500Principal

getNameConstraints

public final byte[] getNameConstraints()

Возвращает:

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

toString

public String toString()

Возвращает отформатированную строку, описывающую TrustAnchor.

Переопределяет:

toString в классе Object

Возвращает:

отформатированную строку, описывающую TrustAnchor