javax.crypto

Класс Mac

java.lang. Объект

javax.crypto. Mac

Все Реализованные Интерфейсы:

Cloneable

public class Mac
extends Object
implements Cloneable

Этот класс обеспечивает функциональность "Кода аутентификации сообщений" (MAC) алгоритм.

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

Механизм MAC, который основан на криптографических хеш-функциях, упоминается как HMAC. HMAC может использоваться с любой криптографической хеш-функцией, например, MD5 или SHA 1, в комбинации с секретом совместно использованный ключ. HMAC определяется в RFC 2104.

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

• HmacMD5
• HmacSHA1
• HmacSHA256

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

С тех пор:

1.4

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

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

Модификатор	Конструктор и Описание
protected	Mac(MacSpi macSpi, Provider provider, String algorithm) Создает объект MAC.

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

Методы

Модификатор и Тип	Метод и Описание
Объект	clone() Возвращает клона, если реализация провайдера является cloneable.
byte[]	doFinal() Заканчивает работу MAC.
byte[]	doFinal(byte[] input) Обрабатывает данный массив байтов и заканчивает работу MAC.
void	doFinal(byte[] output, int outOffset) Заканчивает работу MAC.
Строка	getAlgorithm() Возвращает имя алгоритма этого Mac объект.
static Mac	getInstance(String algorithm) Возвраты a Mac возразите, что реализует указанный алгоритм MAC.
static Mac	getInstance(String algorithm, Provider provider) Возвраты a Mac возразите, что реализует указанный алгоритм MAC.
static Mac	getInstance(String algorithm, String provider) Возвраты a Mac возразите, что реализует указанный алгоритм MAC.
int	getMacLength() Возвращает длину MAC в байтах.
Провайдер	getProvider() Возвращает провайдера этого Mac объект.
void	init(Key key) Инициализирует это Mac объект с данным ключом.
void	init(Key key, AlgorithmParameterSpec params) Инициализирует это Mac объект с данным ключом и параметрами алгоритма.
void	reset() Сбросы это Mac объект.
void	update(byte input) Обрабатывает данный байт.
void	update(byte[] input) Обрабатывает данный массив байтов.
void	update(byte[] input, int offset, int len) Обрабатывает первое len байты в input, запуск в offset включительно.
void	update(ByteBuffer input) Процессы input.remaining() байты в ByteBuffer input, запуск в input.position().

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

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

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

Mac

protected Mac(MacSpi macSpi,
   Provider provider,
   String algorithm)

Создает объект MAC.

Параметры:

macSpi - делегат

provider - провайдер

algorithm - алгоритм

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

getAlgorithm

public final String getAlgorithm()

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

Это - то же самое имя, которое было определено в одном из getInstance вызовы, которые создали это Mac объект.

Возвраты:

имя алгоритма этого Mac объект.

getInstance

public static final Mac getInstance(String algorithm)
                             throws NoSuchAlgorithmException

Возвраты a Mac возразите, что реализует указанный алгоритм MAC.

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

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

Параметры:

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

Возвраты:

новое Mac объект.

Броски:

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

См. Также:

Provider

getInstance

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

Возвраты a Mac возразите, что реализует указанный алгоритм MAC.

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

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

Параметры:

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

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

Возвраты:

новое Mac объект.

Броски:

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

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

IllegalArgumentException - если provider нуль или пустой.

См. Также:

Provider

getInstance

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

Возвраты a Mac возразите, что реализует указанный алгоритм MAC.

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

Параметры:

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

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

Возвраты:

новое Mac объект.

Броски:

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

IllegalArgumentException - если provider нуль.

См. Также:

Provider

getProvider

public final Provider getProvider()

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

Возвраты:

провайдер этого Mac объект.

getMacLength

public final int getMacLength()

Возвращает длину MAC в байтах.

Возвраты:

длина MAC в байтах.

init

public final void init(Key key)
                throws InvalidKeyException

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

Параметры:

key - ключ.

Броски:

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

init

public final void init(Key key,
        AlgorithmParameterSpec params)
                throws InvalidKeyException,
                       InvalidAlgorithmParameterException

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

Параметры:

key - ключ.

params - параметры алгоритма.

Броски:

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

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

обновление

public final void update(byte input)
                  throws IllegalStateException

Обрабатывает данный байт.

Параметры:

input - входной байт, который будет обработан.

Броски:

IllegalStateException - если это Mac не был инициализирован.

обновление

public final void update(byte[] input)
                  throws IllegalStateException

Обрабатывает данный массив байтов.

Параметры:

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

Броски:

IllegalStateException - если это Mac не был инициализирован.

обновление

public final void update(byte[] input,
          int offset,
          int len)
                  throws IllegalStateException

Обрабатывает первое len байты в input, запуск в offset включительно.

Параметры:

input - входной буфер.

offset - смещение в input где ввод запускается.

len - число байтов, чтобы обработать.

Броски:

IllegalStateException - если это Mac не был инициализирован.

обновление

public final void update(ByteBuffer input)

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

Параметры:

input - ByteBuffer

Броски:

IllegalStateException - если это Mac не был инициализирован.

С тех пор:

1.5

doFinal

public final byte[] doFinal()
                     throws IllegalStateException

Заканчивает работу MAC.

Звонок в этот метод сбрасывает это Mac возразите против состояния, в котором это было когда ранее инициализировано через звонок init(Key) или init(Key, AlgorithmParameterSpec). Таким образом, объект сбрасывается и доступен, чтобы генерировать другой MAC от того же самого ключа, при желании, через новые звонки update и doFinal. (Чтобы снова использовать это Mac объект с различным ключом, это должно быть повторно инициализировано через звонок init(Key) или init(Key, AlgorithmParameterSpec).

Возвраты:

результат MAC.

Броски:

IllegalStateException - если это Mac не был инициализирован.

doFinal

public final void doFinal(byte[] output,
           int outOffset)
                   throws ShortBufferException,
                          IllegalStateException

Заканчивает работу MAC.

Звонок в этот метод сбрасывает это Mac возразите против состояния, в котором это было когда ранее инициализировано через звонок init(Key) или init(Key, AlgorithmParameterSpec). Таким образом, объект сбрасывается и доступен, чтобы генерировать другой MAC от того же самого ключа, при желании, через новые звонки update и doFinal. (Чтобы снова использовать это Mac объект с различным ключом, это должно быть повторно инициализировано через звонок init(Key) или init(Key, AlgorithmParameterSpec).

Результат MAC сохранен в output, запуск в outOffset включительно.

Параметры:

output - буфер, где результат MAC сохранен

outOffset - смещение в output где MAC сохранен

Броски:

ShortBufferException - если данный буфер вывода является слишком небольшим, чтобы содержать результат

IllegalStateException - если это Mac не был инициализирован.

doFinal

public final byte[] doFinal(byte[] input)
                     throws IllegalStateException

Обрабатывает данный массив байтов и заканчивает работу MAC.

Звонок в этот метод сбрасывает это Mac возразите против состояния, в котором это было когда ранее инициализировано через звонок init(Key) или init(Key, AlgorithmParameterSpec). Таким образом, объект сбрасывается и доступен, чтобы генерировать другой MAC от того же самого ключа, при желании, через новые звонки update и doFinal. (Чтобы снова использовать это Mac объект с различным ключом, это должно быть повторно инициализировано через звонок init(Key) или init(Key, AlgorithmParameterSpec).

Параметры:

input - данные в байтах

Возвраты:

результат MAC.

Броски:

IllegalStateException - если это Mac не был инициализирован.

сброс

public final void reset()

Сбросы это Mac объект.

Звонок в этот метод сбрасывает это Mac возразите против состояния, в котором это было когда ранее инициализировано через звонок init(Key) или init(Key, AlgorithmParameterSpec). Таким образом, объект сбрасывается и доступен, чтобы генерировать другой MAC от того же самого ключа, при желании, через новые звонки update и doFinal. (Чтобы снова использовать это Mac объект с различным ключом, это должно быть повторно инициализировано через звонок init(Key) или init(Key, AlgorithmParameterSpec).

клон

public final Object clone()
                   throws CloneNotSupportedException

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

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

clone в классе Object

Возвраты:

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

Броски:

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

См. Также:

Cloneable