Подпись (Платформа Java SE 7)

java.lang. Объект
- java.security. SignatureSpi
- - java.security. Подпись

```
public abstract class Signature
extends SignatureSpi
```
Класс Подписи используется, чтобы обеспечить приложения функциональность алгоритма цифровой подписи. Цифровые подписи используются для аутентификации и обеспечения целостности цифровых данных.
Алгоритм подписи может быть, среди других, 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 метод.
Отметьте, что этот класс абстрактен и расширяется от SignatureSpi по историческим причинам. Разработчики приложений должны только заметить методов, определенных в этом Signature класс; все методы в суперклассе предназначаются для провайдеров криптографических служб, которые хотят предоставить их собственные реализации алгоритмов цифровой подписи.
Каждая реализация платформы Java обязана поддерживать следующий стандарт Signature алгоритмы:
- SHA1withDSA
- SHA1withRSA
- SHA256withRSA
Эти алгоритмы описываются в разделе Подписи Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие алгоритмы.

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

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

Поля 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)` Проверяет переданный - в подписи в указанном массиве байтов, запускающихся при указанном смещении.

Методы java.security унаследованный от класса. SignatureSpi
engineGetParameter, engineGetParameters, engineInitSign, engineInitSign, engineInitVerify, engineSetParameter, engineSetParameter, engineSign, engineSign, engineUpdate, engineUpdate, engineUpdate, engineVerify, engineVerify

Методы 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 в классе 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 в классе SignatureSpi
    
    Возвраты:
    клон, если реализация является cloneable.
    
    Броски:
    
    CloneNotSupportedException - если это вызывают на реализации, которая не поддерживает Cloneable.
    См. Также:
    Cloneable

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

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

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

Поля java.security унаследованный от класса. SignatureSpi

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

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

Методы java.security унаследованный от класса. SignatureSpi

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

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

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

ЗНАК

ПРОВЕРИТЬ

состояние

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

Подпись

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

getInstance

getInstance

getInstance

getProvider

initVerify

initVerify

initSign

initSign

знак

знак

проверить

проверить

обновление

обновление

обновление

обновление

getAlgorithm

toString

setParameter

setParameter

getParameters

getParameter

клон