File::KDBX::Key::ChallengeResponse(3p)

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.