Package org.metricshub.ipmi.core.coding.security

Class IntegrityMd5_128

java.lang.Object

org.metricshub.ipmi.core.coding.security.IntegrityAlgorithm

org.metricshub.ipmi.core.coding.security.IntegrityMd5_128

public class IntegrityMd5_128
extends IntegrityAlgorithm

MD5-128 integrity algorithm (IPMI 2.0 section 13.28.4): a plain MD5 of the password around the message, AuthCode = MD5(password + AuthType/Format ... Next Header + password), where the password is the user's key (Kuid) zero-padded to 20 bytes as the BMC stores it. Unlike the HMAC algorithms, it is not keyed with the Session Integrity Key: initialize(byte[]) takes the password.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ALGORITHM_NAME

Constructor Summary

Constructors

Constructor	Description
IntegrityMd5_128()	Initiates the MD5-128 integrity algorithm.

Method Summary

Modifier and Type	Method	Description
byte[]	generateAuthCode(byte[] base)	Creates AuthCode field for message.
String	getAlgorithmName()	Returns the name of the algorithm.
int	getAuthCodeLength()	Returns the length of the authentication code
byte	getCode()	Returns the algorithm's ID.
void	initialize(byte[] password)	Keys the algorithm with the user's password (not the Session Integrity Key), zero-padded to 20 bytes.

Methods inherited from class org.metricshub.ipmi.core.coding.security.IntegrityAlgorithm

wipeKey

Methods inherited from class java.lang.Object

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

Field Details

ALGORITHM_NAME

public static final String ALGORITHM_NAME

See Also:

• Constant Field Values

Constructor Details

IntegrityMd5_128

public IntegrityMd5_128()

Initiates the MD5-128 integrity algorithm.

Method Details

initialize

public void initialize(byte[] password)

Keys the algorithm with the user's password (not the Session Integrity Key), zero-padded to 20 bytes.

Overrides:

initialize in class IntegrityAlgorithm

Parameters:

password - the password of the user, as sent to the BMC; null for an empty password

generateAuthCode

public byte[] generateAuthCode(byte[] base)

Description copied from class: IntegrityAlgorithm

Creates AuthCode field for message. Synchronized: the sending, receiving and keep-alive threads share this instance and its Mac.

Overrides:

generateAuthCode in class IntegrityAlgorithm

Parameters:

base - - data starting with the AuthType/Format field up to and including the field that immediately precedes the AuthCode field

Returns:

AuthCode field. Might be null if empty AuthCOde field is generated.

See Also:

• Rakp1.calculateSik(org.metricshub.ipmi.core.coding.commands.session.Rakp1ResponseData)

getCode

public byte getCode()

Description copied from class: IntegrityAlgorithm

Returns the algorithm's ID.

Specified by:

getCode in class IntegrityAlgorithm

getAlgorithmName

public String getAlgorithmName()

Description copied from class: IntegrityAlgorithm

Returns the name of the algorithm.

Specified by:

getAlgorithmName in class IntegrityAlgorithm

Returns:

The algorithm name as a String.

getAuthCodeLength

public int getAuthCodeLength()

Description copied from class: IntegrityAlgorithm

Returns the length of the authentication code

Specified by:

getAuthCodeLength in class IntegrityAlgorithm

Returns:

The length of the authentication code in bytes.