Класс 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».

Возвращает:

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

Вызывает исключение:

NoSuchAlgorithmException — если algorithm недоступен.

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

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

Параметры:

algorithm — стандартное имя алгоритма. Сведения о стандартных именах алгоритмов см. в разделе MessageDigest документа «Документация по стандартным именам алгоритмов архитектуры криптографии Java».

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

Возвращает:

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

Вызывает исключение:

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

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

public JarSigner.Builder signatureAlgorithm(String algorithm) throws NoSuchAlgorithmException

Параметры:

algorithm — стандартное имя алгоритма. Сведения о стандартных именах алгоритмов см. в разделе Signature документа «Документация по стандартным именам алгоритмов архитектуры криптографии Java».

Возвращает:

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

Вызывает исключение:

NoSuchAlgorithmException — если algorithm недоступен.

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

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

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

Параметры:

algorithm — стандартное имя алгоритма. Сведения о стандартных именах алгоритмов см. в разделе Signature документа «Документация по стандартным именам алгоритмов архитектуры криптографии Java».

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

Возвращает:

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

Вызывает исключение:

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

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

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

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, часть 1, редакция 5, а также соответствующие рекомендации NIST. В частности, для ключа RSA размером более 7680 бит или ключа EC размером не менее 512 бит в качестве хеш-функции подписи будет использоваться SHA-512. В остальных случаях используется SHA-384, если только размер ключа не слишком мал для получаемого алгоритма подписи. Для ключей DSA возвращается алгоритм подписи SHA256withDSA независимо от размера ключа. В будущем значение может измениться.

Параметры:

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

Возвращает:

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

public JarSigner build()

Возвращает:

объект JarSigner.

Вызывает исключение:

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