|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
MAC is an interface which represents the properties shared between all Message
Authentication Code algorithms. MAC functions are also called keyed hash functions since they
require a key to operate.
The two common ways of obtaining a MAC are by using a digest algorithm and by using a block cipher.
| Method Summary | ||
|
boolean |
checkMAC(byte[] mac)
Returns true if the MAC calculated so far is the same as the given MAC. |
|
boolean |
checkMAC(byte[] mac,
boolean reset)
Returns true if the MAC calculated so far is the same as the given MAC. |
|
boolean |
checkMAC(byte[] mac,
int offset)
Returns true if the MAC calculated so far is the same as the given MAC. |
|
boolean |
checkMAC(byte[] mac,
int offset,
boolean reset)
Returns true if the MAC calculated so far is the same as the given MAC. |
|
String |
getAlgorithm()
Returns the name of the mac alonng with the digest or block cipher used, such as "HMAC/SHA1". |
|
int |
getLength()
Returns the length, in bytes, of the MAC. |
|
byte[] |
getMAC()
Returns a byte array containing the MAC of all the input data since the last reset. |
|
byte[] |
getMAC(boolean reset)
Returns a byte array containing the MAC of all the input data since the last reset. |
|
int |
getMAC(byte[] buffer,
int offset)
Puts the MAC of all the input data since the last reset into the given buffer starting at the specified offset. |
|
int |
getMAC(byte[] buffer,
int offset,
boolean reset)
Puts the MAC of all the input data since the last reset into the given buffer starting at the specified offset. |
|
void |
reset()
Reinitializes the MAC. |
|
void |
update(byte[] data)
Feeds more data into the MAC algorithm. |
|
void |
update(byte[] data,
int offset,
int length)
Feeds more data into the MAC algorithm. |
|
void |
update(int data)
Feeds more data into the MAC algorithm. |
| Method Detail |
public boolean checkMAC(byte[] mac)
throws CryptoTokenException
mac - The MAC to check against.CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
public boolean checkMAC(byte[] mac,
boolean reset)
throws CryptoTokenException
mac - The MAC to check against.reset - if true then the MAC is reset.CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
public boolean checkMAC(byte[] mac,
int offset)
throws CryptoTokenException
mac - The array containing the MAC to check against.offset - The starting offset of the MAC in the array.CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
public boolean checkMAC(byte[] mac,
int offset,
boolean reset)
throws CryptoTokenException
mac - The array containing the MAC to check against.offset - The starting offset of the MAC in the array.reset - if true then the MAC is reset.CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.public String getAlgorithm()
public int getLength()
public byte[] getMAC()
throws CryptoTokenException
CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
public byte[] getMAC(boolean reset)
throws CryptoTokenException
reset - if true then the MAC is reset.CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
public int getMAC(byte[] buffer,
int offset)
throws CryptoTokenException
buffer - The array to contain the MAC.offset - The offset, or initial position, of teh MAC data within the buffer.CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
public int getMAC(byte[] buffer,
int offset,
boolean reset)
throws CryptoTokenException
buffer - The array to contain the MAC.offset - The offset, or initial position, of teh MAC data within the buffer.reset - if true then the MAC is reset.CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
public void reset()
throws CryptoTokenException
CryptoTokenException - Thrown if an error occurs with the crypto
token or the crypto token is invalid.
public void update(byte[] data)
throws CryptoTokenException
data - The array containing the input data. The entire array is
added to the MAC.CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
public void update(byte[] data,
int offset,
int length)
throws CryptoTokenException
data - The array containing the input data.offset - The offset, or initial position, of the data within the array.length - The length of the input data, in bytes.CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
public void update(int data)
throws CryptoTokenException
data - A byte of input data.CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2007 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.