File::KDBX::IO::HmacBlock3pm
Hmac block stream io handle
Version
version 0.906
Overview
Writing to a HMAC-block stream handle will transform the data into a series of blocks. An HMAC is calculated for each block and is included in the output.
Reading from a handle, each block will be verified and authenticated as the blocks are disassembled back into a data stream.
This format helps ensure data integrity and authenticity of KDBX4 files.
Each block is encoded thusly:
- •
-
HMAC - 32 bytes, calculated over [block index (increments starting with 0), block size and data]
- •
-
Block size - Little-endian unsigned 32-bit (counting only the data)
- •
-
Data - String of bytes
The terminating block is an empty block encoded as usual but block size is 0 and there is no data.
Attributes
block_size
Desired block size when writing (default: $File::KDBX::IO::HmacBlock::BLOCK_SIZE or 1,048,576 bytes)
key
HMAC-SHA256 key for authenticating the data stream (required)
Methods
new
$fh = File::KDBX::IO::HmacBlock->new(%attributes);$fh = File::KDBX::IO::HmacBlock->new($fh, %attributes);
Construct a new HMAC-block stream IO handle.
Copyright and license
This software is copyright (c) 2022 by Charles McGarvey.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Releases
2 releases since Debian 12 (Bookworm); the text changed 1 time.