compact1, compact2, compact3

java.security

Подпись класса

java.lang. Объект

java.security. SignatureSpi

java.security. Подпись

public abstract class Signature
extends SignatureSpi

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

Алгоритм подписи может быть, среди других, DSA стандарта NIST, используя DSA и SHA 1. Алгоритм DSA, используя SHA 1 алгоритм обзора сообщения может быть определен как SHA1withDSA. В случае RSA есть разнообразный выбор для алгоритма обзора сообщения, таким образом, алгоритм подписания мог быть определен как, например, MD2withRSA, MD5withRSA, или SHA1withRSA. Имя алгоритма должно быть определено, поскольку нет никакого значения по умолчанию.

Объект Подписи может использоваться, чтобы генерировать и проверить цифровые подписи.

Есть три фазы к использованию объекта Подписи или для подписания данных или для проверки подписи:

1. Инициализация, с также
   • открытый ключ, который инициализирует подпись для проверки (см. initVerify), или
   • закрытый ключ (и дополнительно Безопасный Генератор случайных чисел), который инициализирует подпись для того, чтобы подписаться (см. initSign(PrivateKey) и initSign(PrivateKey, SecureRandom)).

2. Обновление

   В зависимости от типа инициализации это обновит байты, которые будут подписаны или проверены. См. update методы.

3. Подписание или Проверка подписи на всех обновленных байтах. См. sign методы и verify метод.

Отметьте, что этот class абстрактен и расширяется от SignatureSpi по историческим причинам. Разработчики приложений должны только заметить методов, определенных в этом Signature class; все методы в суперклассе предназначаются для провайдеров криптографических служб, которые хотят предоставить их собственные реализации алгоритмов цифровой подписи.

Каждая реализация платформы Java обязана поддерживать следующий стандарт Signature алгоритмы:

• SHA1withDSA
• SHA1withRSA
• SHA256withRSA

Эти алгоритмы описываются в разделе Подписи Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие алгоритмы.

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected static int	ЗНАК Возможный state значение, показывая, что этот объект подписи был инициализирован для того, чтобы подписаться.
protected int	состояние Текущее состояние этого объекта подписи.
protected static int	НЕИНИЦИАЛИЗИРОВАННЫЙ Возможный state значение, показывая, что этот объект подписи еще не был инициализирован.
protected static int	ПРОВЕРИТЬ Возможный state значение, показывая, что этот объект подписи был инициализирован для проверки.

Поля, наследованные от class java.security. SignatureSpi

appRandom

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

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

Модификатор	Конструктор и Описание
protected	Signature(String algorithm) Создает объект Подписи для указанного алгоритма.

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

Модификатор и Тип	Метод и Описание
Объект	clone() Возвращает клона, если реализация является cloneable.
Строка	getAlgorithm() Возвращает имя алгоритма для этого объекта подписи.
static Signature	getInstance(String algorithm) Возвращается Подпись возражают, что реализует указанный алгоритм подписи.
static Signature	getInstance(String algorithm, Provider provider) Возвращается Подпись возражают, что реализует указанный алгоритм подписи.
static Signature	getInstance(String algorithm, String provider) Возвращается Подпись возражают, что реализует указанный алгоритм подписи.
Объект	getParameter(String param) Осуждаемый.
AlgorithmParameters	getParameters() Возвращает параметры, используемые с этим объектом подписи.
Провайдер	getProvider() Возвращает провайдера этого объекта подписи.
void	initSign(PrivateKey privateKey) Инициализируйте этот объект для того, чтобы подписаться.
void	initSign(PrivateKey privateKey, SecureRandom random) Инициализируйте этот объект для того, чтобы подписаться.
void	initVerify(Certificate certificate) Инициализирует этот объект для проверки, используя открытый ключ от данного сертификата.
void	initVerify(PublicKey publicKey) Инициализирует этот объект для проверки.
void	setParameter(AlgorithmParameterSpec params) Инициализирует этот механизм подписи с указанным набором параметра.
void	setParameter(String param, Object value) Осуждаемый. Использовать setParameter.
byte[]	sign() Возвращает байты подписи всех обновленных данных.
int	sign(byte[] outbuf, int offset, int len) Заканчивает работу подписи и хранит получающиеся байты подписи в обеспеченном буфере outbuf, запуск в offset.
Строка	toString() Возвращает строковое представление этого объекта подписи, предоставляя информацию, которая включает состояние объекта и имя используемого алгоритма.
void	update(byte b) Обновляет данные, которые будут подписаны или проверены байтом.
void	update(byte[] data) Обновляет данные, которые будут подписаны или проверены, используя указанный массив байтов.
void	update(byte[] data, int off, int len) Обновляет данные, которые будут подписаны или проверены, используя указанный массив байтов, запускаясь при указанном смещении.
void	update(ByteBuffer data) Обновляет данные, которые будут подписаны, или проверял использование указанного ByteBuffer.
boolean	verify(byte[] signature) Проверяет переданный - в подписи.
boolean	verify(byte[] signature, int offset, int length) Проверяет переданный - в подписи в указанном массиве байтов, запускающихся при указанном смещении.

Методы, наследованные от class java.security. SignatureSpi

engineGetParameter, engineGetParameters, engineInitSign, engineInitSign, engineInitVerify, engineSetParameter, engineSetParameter, engineSign, engineSign, engineUpdate, engineUpdate, engineUpdate, engineVerify, engineVerify

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

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

Полевая Деталь

НЕИНИЦИАЛИЗИРОВАННЫЙ

protected static final int UNINITIALIZED

Возможный state значение, показывая, что этот объект подписи еще не был инициализирован.

См. Также:

Постоянные Значения полей

ЗНАК

protected static final int SIGN

Возможный state значение, показывая, что этот объект подписи был инициализирован для того, чтобы подписаться.

См. Также:

Постоянные Значения полей

ПРОВЕРИТЬ

protected static final int VERIFY

Возможный state значение, показывая, что этот объект подписи был инициализирован для проверки.

См. Также:

Постоянные Значения полей

состояние

protected int state

Текущее состояние этого объекта подписи.

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

Подпись

protected Signature(String algorithm)

Создает объект Подписи для указанного алгоритма.

Параметры:

algorithm - стандартное имя строки алгоритма. См. раздел Подписи в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

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

getInstance

public static Signature getInstance(String algorithm)
                             throws NoSuchAlgorithmException

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

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

Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.

Параметры:

algorithm - стандартное имя алгоритма требуют. См. раздел Подписи в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

Возвраты:

новый объект Подписи.

Броски:

NoSuchAlgorithmException - если никакой Провайдер не поддерживает реализацию Подписи для указанного алгоритма.

См. Также:

Provider

getInstance

public static Signature getInstance(String algorithm,
                                    String provider)
                             throws NoSuchAlgorithmException,
                                    NoSuchProviderException

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

Возвращается новый объект Подписи инкапсуляция реализации SignatureSpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.

Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.

Параметры:

algorithm - имя алгоритма требуют. См. раздел Подписи в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

provider - имя провайдера.

Возвраты:

новый объект Подписи.

Броски:

NoSuchAlgorithmException - если реализация SignatureSpi для указанного алгоритма не доступна от указанного провайдера.

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

IllegalArgumentException - если имя провайдера является нулем или пустой.

См. Также:

Provider

getInstance

public static Signature getInstance(String algorithm,
                                    Provider provider)
                             throws NoSuchAlgorithmException

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

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

Параметры:

algorithm - имя алгоритма требуют. См. раздел Подписи в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

provider - провайдер.

Возвраты:

новый объект Подписи.

Броски:

NoSuchAlgorithmException - если реализация SignatureSpi для указанного алгоритма не доступна от указанного объекта Провайдера.

IllegalArgumentException - если провайдер является нулем.

С тех пор:

1.4

См. Также:

Provider

getProvider

public final Provider getProvider()

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

Возвраты:

провайдер этого объекта подписи

initVerify

public final void initVerify(PublicKey publicKey)
                      throws InvalidKeyException

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

Параметры:

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

Броски:

InvalidKeyException - если ключ недопустим.

initVerify

public final void initVerify(Certificate certificate)
                      throws InvalidKeyException

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

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

Параметры:

certificate - сертификат об идентификационных данных, подпись которых собирается быть проверенной.

Броски:

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

С тех пор:

1.3

initSign

public final void initSign(PrivateKey privateKey)
                    throws InvalidKeyException

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

Параметры:

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

Броски:

InvalidKeyException - если ключ недопустим.

initSign

public final void initSign(PrivateKey privateKey,
                           SecureRandom random)
                    throws InvalidKeyException

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

Параметры:

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

random - источник случайности для этой подписи.

Броски:

InvalidKeyException - если ключ недопустим.

знак

public final byte[] sign()
                  throws SignatureException

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

Звонок в этот метод сбрасывает этот объект подписи к состоянию, в котором это было когда ранее инициализировано для того, чтобы подписаться через звонок initSign(PrivateKey). Таким образом, объект сбрасывается и доступен, чтобы генерировать другую подпись от того же самого подписывающего лица, при желании, через новые звонки update и sign.

Возвраты:

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

Броски:

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

знак

public final int sign(byte[] outbuf,
                      int offset,
                      int len)
               throws SignatureException

Заканчивает работу подписи и хранит получающиеся байты подписи в обеспеченном буфере outbuf, запуск в offset. Формат подписи зависит от базовой схемы подписи.

Этот объект подписи сбрасывается к его начальному состоянию (состояние, в котором это было после звонка в один из initSign методы), и может быть снова использован, чтобы генерировать дальнейшие подписи с тем же самым закрытым ключом.

Параметры:

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

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

len - число байтов в пределах outbuf выделенный для подписи.

Возвраты:

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

Броски:

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

С тех пор:

1.2

проверить

public final boolean verify(byte[] signature)
                     throws SignatureException

Проверяет переданный - в подписи.

Звонок в этот метод сбрасывает этот объект подписи к состоянию, в котором это было когда ранее инициализировано для проверки через звонок initVerify(PublicKey). Таким образом, объект сбрасывается и доступен, чтобы проверить другую подпись от идентификационных данных, открытый ключ которых был определен в звонке initVerify.

Параметры:

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

Возвраты:

истина, если подпись была проверена, ложь если нет.

Броски:

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

проверить

public final boolean verify(byte[] signature,
                            int offset,
                            int length)
                     throws SignatureException

Проверяет переданный - в подписи в указанном массиве байтов, запускающихся при указанном смещении.

Звонок в этот метод сбрасывает этот объект подписи к состоянию, в котором это было когда ранее инициализировано для проверки через звонок initVerify(PublicKey). Таким образом, объект сбрасывается и доступен, чтобы проверить другую подпись от идентификационных данных, открытый ключ которых был определен в звонке initVerify.

Параметры:

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

offset - смещение, чтобы запуститься с в массиве байтов.

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

Возвраты:

истина, если подпись была проверена, ложь если нет.

Броски:

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

IllegalArgumentException - если signature байтовый массив является нулем, или offset или length меньше чем 0, или сумма offset и length больше чем длина signature байтовый массив.

С тех пор:

1.4

обновление

public final void update(byte b)
                  throws SignatureException

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

Параметры:

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

Броски:

SignatureException - если этот объект подписи не инициализируется должным образом.

обновление

public final void update(byte[] data)
                  throws SignatureException

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

Параметры:

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

Броски:

SignatureException - если этот объект подписи не инициализируется должным образом.

обновление

public final void update(byte[] data,
                         int off,
                         int len)
                  throws SignatureException

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

Параметры:

data - массив байтов.

off - смещение, чтобы запуститься с в массиве байтов.

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

Броски:

SignatureException - если этот объект подписи не инициализируется должным образом.

обновление

public final void update(ByteBuffer data)
                  throws SignatureException

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

Параметры:

data - ByteBuffer

Броски:

SignatureException - если этот объект подписи не инициализируется должным образом.

С тех пор:

1.5

getAlgorithm

public final String getAlgorithm()

Возвращает имя алгоритма для этого объекта подписи.

Возвраты:

имя алгоритма для этого объекта подписи.

toString

public String toString()

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

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

toString в class Object

Возвраты:

строковое представление этого объекта подписи.

setParameter

@Deprecated
public final void setParameter(String param,
                                           Object value)
                                    throws InvalidParameterException

Осуждаемый. Использовать setParameter.

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

Параметры:

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

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

Броски:

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

См. Также:

getParameter(java.lang.String)

setParameter

public final void setParameter(AlgorithmParameterSpec params)
                        throws InvalidAlgorithmParameterException

Инициализирует этот механизм подписи с указанным набором параметра.

Параметры:

params - параметры

Броски:

InvalidAlgorithmParameterException - если данные параметры являются несоответствующими для этого механизма подписи

См. Также:

getParameters()

getParameters

public final AlgorithmParameters getParameters()

Возвращает параметры, используемые с этим объектом подписи.

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

Возвраты:

параметры, используемые с этой подписью, или нулем, если эта подпись не использует параметров.

С тех пор:

1.4

См. Также:

setParameter(AlgorithmParameterSpec)

getParameter

@Deprecated
public final Object getParameter(String param)
                                      throws InvalidParameterException

Осуждаемый.

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

Параметры:

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

Возвраты:

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

Броски:

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

См. Также:

setParameter(String, Object)

клон

public Object clone()
             throws CloneNotSupportedException

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

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

clone в class SignatureSpi

Возвраты:

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

Броски:

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

См. Также:

Cloneable