Класс SignatureSpi

public abstract class SignatureSpi
extends Object

Этот класс определяет интерфейс поставщика сервисов (SPI) для класса Signature, который используется для предоставления функциональности алгоритма цифровой подписи. Цифровые подписи используются для аутентификации и обеспечения целостности цифровых данных. .

Все абстрактные методы в этом классе должны быть реализованы каждым поставщиком криптографических сервисов, желающим предоставить реализацию определенного алгоритма подписи.

Поля

appRandom

protected SecureRandom appRandom

Источник случайных чисел, заданный приложением.

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

SignatureSpi

public SignatureSpi()

Методы

engineInitVerify

protected abstract void engineInitVerify(PublicKey publicKey)
                                  throws InvalidKeyException

Инициализирует этот объект подписи указанным открытым ключом для операций проверки.

Параметры:

publicKey - открытый ключ идентичности, чья подпись будет проверяться.

Исключения:

InvalidKeyException - если ключ закодирован некорректно, отсутствуют параметры и т. д.

engineInitSign

protected abstract void engineInitSign(PrivateKey privateKey)
                                throws InvalidKeyException

Инициализирует этот объект подписи указанным закрытым ключом для операций подписи.

Параметры:

privateKey - закрытый ключ идентичности, чья подпись будет сгенерирована.

Исключения:

InvalidKeyException - если ключ закодирован некорректно, отсутствуют параметры и т. д.

engineInitSign

protected void engineInitSign(PrivateKey privateKey,
                              SecureRandom random)
                       throws InvalidKeyException

Параметры:

privateKey - закрытый ключ идентичности, чья подпись будет сгенерирована.

random - источник случайных чисел

Исключения:

InvalidKeyException - если ключ закодирован некорректно, отсутствуют параметры и т. д.

engineUpdate

protected abstract void engineUpdate(byte b)
                              throws SignatureException

Обновляет данные для подписи или проверки с использованием указанного байта.

Параметры:

b - байт, используемый для обновления.

Исключения:

SignatureException - если движок не инициализирован должным образом.

engineUpdate

protected abstract void engineUpdate(byte[] b,
                                     int off,
                                     int len)
                              throws SignatureException

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

Параметры:

b - массив байтов

off - смещение для начала в массиве байтов

len - количество байтов для использования, начиная со смещения

Исключения:

SignatureException - если движок не инициализирован должным образом

engineUpdate

protected void engineUpdate(ByteBuffer input)

Обновляет данные для подписи или проверки с использованием указанного ByteBuffer. Обрабатывает data.remaining() байтов, начиная со смещения data.position(). По завершении, позиция буфера будет равна его пределу; его предел не изменится.

Параметры:

input - ByteBuffer

С момента:

1.5

engineSign

protected abstract byte[] engineSign()
                              throws SignatureException

Возвращает байты подписи всех обновлённых данных до сих пор. Формат подписи зависит от базовой схемы подписи.

Возвращает:

байты подписи результата операции подписи.

Исключения:

SignatureException - если движок не инициализирован должным образом или этот алгоритм подписи не может обработать предоставленные входные данные.

engineSign

protected int engineSign(byte[] outbuf,
                         int offset,
                         int len)
                  throws SignatureException

Параметры:

outbuf - буфер для результата подписи.

offset - смещение в outbuf, где хранится подпись.

len - количество байтов в outbuf, отведенных для подписи. Как эта реализация по умолчанию, так и поставщик SUN не возвращают частичные хэши. Если значение этого параметра меньше фактической длины подписи, этот метод вызовет исключение SignatureException. Этот параметр игнорируется, если его значение больше или равно фактической длине подписи.

Возвращает:

количество байтов, помещенных в outbuf

Исключения:

SignatureException - если движок не инициализирован должным образом, если этот алгоритм подписи не может обработать предоставленные входные данные или если len меньше фактической длины подписи.

С момента:

1.2

engineVerify

protected abstract boolean engineVerify(byte[] sigBytes)
                                 throws SignatureException

Проверяет переданную подпись.

Параметры:

sigBytes - байты подписи, которые нужно проверить.

Возвращает:

true, если подпись проверена, false — если нет.

Исключения:

SignatureException - если движок не инициализирован должным образом, переданная подпись закодирована неправильно или имеет неправильный тип, если этот алгоритм подписи не может обработать предоставленные входные данные и т. д.

engineVerify

protected boolean engineVerify(byte[] sigBytes,
                               int offset,
                               int length)
                        throws SignatureException

Параметры:

sigBytes - байты подписи, которые нужно проверить.

offset - смещение для начала в массиве байтов.

length - количество байтов для использования, начиная со смещения.

Возвращает:

true, если подпись проверена, false — если нет.

С момента:

1.4

engineSetParameter

@Deprecated
protected abstract void engineSetParameter(String param,
                                                       Object value)
                                                throws InvalidParameterException

Устарело. Заменено на engineSetParameter.

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

Параметры:

param - строковый идентификатор параметра.

value - значение параметра.

Исключения:

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

engineSetParameter

protected void engineSetParameter(AlgorithmParameterSpec params)
                           throws InvalidAlgorithmParameterException

Параметры:

params - параметры

Исключения:

UnsupportedOperationException - если этот метод не переопределён поставщиком

InvalidAlgorithmParameterException - если этот метод переопределён поставщиком, а заданные параметры неподходящи для данного движка подписи

engineGetParameters

protected AlgorithmParameters engineGetParameters()

Возвращает:

используемые с этим движком подписи параметры или null

Исключения:

UnsupportedOperationException - если этот метод не переопределён поставщиком

С момента:

1.4

engineGetParameter

@Deprecated
protected abstract Object engineGetParameter(String param)
                                                  throws InvalidParameterException

Устарело.

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

Параметры:

param - строковое имя параметра.

Возвращает:

объект, представляющий значение параметра, или null , если его нет.

Исключения:

InvalidParameterException - если param является недопустимым параметром для данного движка, или при попытке получить этот параметр происходит другое исключение.

clone

public Object clone()
             throws CloneNotSupportedException

Возвращает клон, если реализация поддерживает клонирование.

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

clone в классе Object

Возвращает:

клон, если реализация поддерживает клонирование.

Исключения:

CloneNotSupportedException - если этот метод вызван на реализации, которая не поддерживает Cloneable.

См. также:

Cloneable