Класс Mac

public class Mac
extends Object
implements Cloneable

Этот класс предоставляет функциональность алгоритма "Message Authentication Code" (MAC).

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

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

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

• HmacMD5
• HmacSHA1
• HmacSHA256

Эти алгоритмы описаны в разделе Mac документации по стандартным именам алгоритмов Java Cryptography Architecture. Обратитесь к документации выпуска для вашей реализации, чтобы узнать, какие другие алгоритмы поддерживаются.

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

Mac

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

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

Параметры:

macSpi - делегат

provider - провайдер

algorithm - алгоритм

Методы

getAlgorithm

public final String getAlgorithm()

Возвращает:

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

getInstance

public static final Mac getInstance(String algorithm)
                             throws NoSuchAlgorithmException

Параметры:

algorithm - стандартное имя запрашиваемого алгоритма MAC. См. раздел Mac в документации Java Cryptography Architecture по стандартным именам алгоритмов для получения информации о стандартных именах алгоритмов.

Возвращает:

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

Исключения:

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

См. также:

Provider

getInstance

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

Параметры:

algorithm - стандартное имя запрашиваемого алгоритма MAC. См. раздел Mac в документации Java Cryptography Architecture по стандартным именам алгоритмов для получения информации о стандартных именах алгоритмов.

provider - имя поставщика.

Возвращает:

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

Исключения:

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

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

IllegalArgumentException - если provider равно null или пустое.

См. также:

Provider

getInstance

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

Параметры:

algorithm - стандартное имя запрашиваемого алгоритма MAC. См. раздел Mac в документации Java Cryptography Architecture по стандартным именам алгоритмов для получения информации о стандартных именах алгоритмов.

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

Возвращает:

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

Исключения:

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

IllegalArgumentException - если provider равно null.

См. также:

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.

update

public final void update(byte input)
                  throws IllegalStateException

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

Параметры:

input - входной байт для обработки.

Исключения:

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

update

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

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

Параметры:

input - массив байтов для обработки.

Исключения:

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

update

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

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

Параметры:

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

offset - смещение в input, где начинается входной массив.

len - количество байтов для обработки.

Исключения:

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

update

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.

Исключения:

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

doFinal

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

Параметры:

output - буфер, в котором хранится результат MAC

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

Исключения:

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

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

doFinal

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

Параметры:

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

Возвращает:

результат MAC.

Исключения:

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

reset

public final void reset()

clone

public final Object clone()
                   throws CloneNotSupportedException

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

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

clone в классе Object

Возвращает:

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

Исключения:

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

См. также:

Cloneable