Класс JarSigner.Builder

public Builder(KeyStore.PrivateKeyEntry entry)

Параметры:

entry - KeyStore.PrivateKeyEntry подписывающего.

public Builder(PrivateKey privateKey, CertPath certPath)

Параметры:

privateKey - закрытый ключ подписывающего.

certPath - сертификационный маршрут подписывающего.

Исключения:

IllegalArgumentException - если certPath пуста, или алгоритм privateKey не соответствует алгоритму PublicKey в сертификате конечного узла (первый сертификат в certPath).

public JarSigner.Builder digestAlgorithm(String algorithm) throws NoSuchAlgorithmException

Параметры:

algorithm - стандартное имя алгоритма. См. раздел MessageDigest в Java Cryptography Architecture Standard Algorithm Name Documentation для получения информации о стандартных именах алгоритмов.

Возвращает:

сам объект JarSigner.Builder.

Исключения:

NoSuchAlgorithmException - если алгоритм algorithm недоступен.

public JarSigner.Builder digestAlgorithm(String algorithm, Provider provider) throws NoSuchAlgorithmException

Параметры:

algorithm - стандартное имя алгоритма. См. раздел MessageDigest в Java Cryptography Architecture Standard Algorithm Name Documentation для получения информации о стандартных именах алгоритмов.

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

Возвращает:

сам объект JarSigner.Builder.

Исключения:

NoSuchAlgorithmException - если алгоритм algorithm недоступен в указанном поставщике.

public JarSigner.Builder signatureAlgorithm(String algorithm) throws NoSuchAlgorithmException

Параметры:

algorithm - стандартное имя алгоритма. См. раздел Signature в Java Cryptography Architecture Standard Algorithm Name Documentation для получения информации о стандартных именах алгоритмов.

Возвращает:

сам объект JarSigner.Builder.

Исключения:

NoSuchAlgorithmException - если алгоритм algorithm недоступен.

IllegalArgumentException - если алгоритм algorithm несовместим с алгоритмом закрытого ключа подписывающего.

public JarSigner.Builder signatureAlgorithm(String algorithm, Provider provider) throws NoSuchAlgorithmException

Параметры:

algorithm - стандартное имя алгоритма. См. раздел Signature в Java Cryptography Architecture Standard Algorithm Name Documentation для получения информации о стандартных именах алгоритмов.

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

Возвращает:

сам объект JarSigner.Builder.

Исключения:

NoSuchAlgorithmException - если алгоритм algorithm недоступен в указанном поставщике.

IllegalArgumentException - если алгоритм algorithm несовместим с алгоритмом закрытого ключа подписывающего.

public JarSigner.Builder tsa(URI uri)

Параметры:

uri - URI.

Возвращает:

сам объект JarSigner.Builder.

public JarSigner.Builder signerName(String name)

Параметры:

name - имя подписывающего.

Возвращает:

сам объект JarSigner.Builder.

Исключения:

IllegalArgumentException - если name пустое, имеет размер больше 8 или содержит символы, не принадлежащие набору "a-zA-Z0-9_-".

public JarSigner.Builder eventHandler(BiConsumer<String,String> handler)

Параметры:

handler - обработчик событий.

Возвращает:

сам объект JarSigner.Builder.

public JarSigner.Builder setProperty(String key, String value)

Примечание для реализации:

Данная реализация поддерживает следующие свойства:

• "tsaDigestAlg": алгоритм хеширования данных отметки времени в запросе отметки времени. Значение по умолчанию такое же, как результат вызова getDefaultDigestAlgorithm().
• "tsaPolicyId": TSAPolicyID для Уполномоченного центра по отметке времени. Значения по умолчанию нет.
• "internalsf": "true", если файл .SF включён в блок подписи, "false" в противном случае. Значение по умолчанию "false".
• "sectionsonly": "true", если файл .SF содержит только значения хеша для каждой секции манифеста, а не для всего манифеста; "false" в противном случае. Значение по умолчанию "false".

Все имена свойств регистронезависимы.

Параметры:

key - имя свойства.

value - значение свойства.

Возвращает:

сам объект JarSigner.Builder.

Исключения:

UnsupportedOperationException - если ключ не поддерживается данной реализацией.

IllegalArgumentException - если значение не является допустимым для данного ключа.

public static String getDefaultDigestAlgorithm()

Примечание для реализации:

Данная реализация возвращает "SHA-384". Значение может быть изменено в будущем.

Возвращает:

алгоритм хеширования по умолчанию.

public static String getDefaultSignatureAlgorithm(PrivateKey key)

Примечание для реализации:

Данная реализация использует сопоставимую безопасность, как определено в таблицах 2 и 3 NIST SP 800-57 Part 1-Rev.5, а также рекомендации NIST применительно. В частности, если ключ RSA имеет размер больше 7680 бит или ключ EC имеет размер больше или равен 512 бит, SHA-512 используется в качестве функции хеширования для подписи. В противном случае используется SHA-384, если размер ключа не слишком мал для алгоритма подписи. Что касается ключей DSA, алгоритм подписи SHA256withDSA возвращается независимо от размера ключа. Значение может быть изменено в будущем.

Параметры:

key - закрытый ключ.

Возвращает:

алгоритм подписи по умолчанию. Возвращает null, если алгоритм подписи по умолчанию не найден. В этом случае необходимо вызвать метод signatureAlgorithm(java.lang.String) для указания алгоритма подписи. В противном случае метод build() сгенерирует исключение IllegalArgumentException.

public JarSigner build()

Возвращает:

объект JarSigner.

Имеет исключение:

IllegalArgumentException - если алгоритм подписи не задан и не может быть получен из закрытого ключа с помощью метода getDefaultSignatureAlgorithm(java.security.PrivateKey).