QMessageAuthenticationCode

The QMessageAuthenticationCode class provides a way to generate hash-based message authentication codes. More…

Synopsis

Functions

• def addData (data)

• def addData (data, length)

• def addData (device)

• def reset ()

• def result ()

• def setKey (key)

Static functions

• def hash (message, key, method)

Detailed Description

QMessageAuthenticationCode supports all cryptographic hashes which are supported by QCryptographicHash .

To generate message authentication code, pass hash algorithm Algorithm to constructor, then set key and message by setKey() and addData() functions. Result can be acquired by result() function.

QByteArray key = "key";
QByteArray message = "The quick brown fox jumps over the lazy dog";
...
QMessageAuthenticationCode code(QCryptographicHash::Sha1);
code.setKey(key);
code.addData(message);
code.result().toHex();      // returns "de7c9b85b8b78aa6bc8a7a36f70a90701c9db4d9"

Alternatively, this effect can be achieved by providing message, key and method to hash() method.

QMessageAuthenticationCode::hash(message, key, QCryptographicHash::Sha1).toHex();

See also

QCryptographicHash

class QMessageAuthenticationCode(method[, key=QByteArray()])

param method

Algorithm

param key

QByteArray

Constructs an object that can be used to create a cryptographic hash from data using method method and key key .

PySide2.QtCore.QMessageAuthenticationCode.addData(device)

Parameters

device – QIODevice

Return type

bool

Reads the data from the open QIODevice device until it ends and adds it to message. Returns true if reading was successful.

Note

device must be already opened.

PySide2.QtCore.QMessageAuthenticationCode.addData(data)

Parameters

data – QByteArray

PySide2.QtCore.QMessageAuthenticationCode.addData(data, length)

Parameters

• data – str

• length – int

Adds the first length chars of data to the message.

static PySide2.QtCore.QMessageAuthenticationCode.hash(message, key, method)

Parameters

• message – QByteArray

• key – QByteArray

• method – Algorithm

Return type

QByteArray

Returns the authentication code for the message message using the key key and the method method .

PySide2.QtCore.QMessageAuthenticationCode.reset()

Resets message data. Calling this method doesn’t affect the key.

PySide2.QtCore.QMessageAuthenticationCode.result()

Return type

QByteArray

Returns the final authentication code.

See also

toHex()

PySide2.QtCore.QMessageAuthenticationCode.setKey(key)

Parameters

key – QByteArray

Sets secret key . Calling this method automatically resets the object state.