NAME

File::KDBX::Key::ChallengeResponse - A challenge-response key

VERSION

version 0.906

SYNOPSIS

use File::KDBX::Key::ChallengeResponse;

my $responder = sub {
    my $challenge = shift;
    ...;    # generate a response based on a secret of some sort
    return $response;
};
my $key = File::KDBX::Key::ChallengeResponse->new($responder);

DESCRIPTION

A challenge-response key is kind of like multifactor authentication, except you don't really authenticate to a KDBX database because it's not a service. Specifically it would be the "what you have" component. It assumes there is some device that can store a key that is only known to the owner of a database. A challenge is made to the device and the response generated based on the key is used as the raw key.

Inherets methods and attributes from File::KDBX::Key.

This is a generic implementation where a responder subroutine is provided to provide the response. There is also File::KDBX::Key::YubiKey which is a subclass that allows YubiKeys to be responder devices.

METHODS

raw_key

$raw_key = $key->raw_key;
$raw_key = $key->raw_key($challenge);

Get the raw key which is the response to a challenge. The response will be saved so that subsequent calls (with or without the challenge) can provide the response without challenging the responder again. Only one response is saved at a time; if you call this with a different challenge, the new response is saved over any previous response.

challenge

$response = $key->challenge($challenge, @options);

Issue a challenge and get a response, or throw if the responder failed to provide one.

BUGS

Please report any bugs or feature requests on the bugtracker website https://github.com/chazmcgarvey/File-KDBX/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Charles McGarvey <ccm@cpan.org>

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.