/ 
Password-Policy-Rule-Pwned-0.02
River stage zero No dependents
++
 / Password::Policy::Exception::PwnedError
Author image Pete Houston
and 1 contributors

NAME

Password::Policy::Exception::PwnedError - Die if the password pwned API is unreachable

SYNOPSIS

    use Password::Policy;
    use Try::Tiny;

    my $pass = 'password1';

    my $pp = Password::Policy->new (config => 'policy.yaml');
    try {
        $pp->process({ password => $pass });
    } catch {
        warn "This password '$pass' is pwned - don't use it";
        # Other actions
    }

DESCRIPTION

This exception is thrown when Password::Policy::Rule::Pwned cannot determine whether or not a password has been pwned. The determination depends on a remote service which may not be available for any number of reasons.

METHODS

error

    $exception->error ();

This method is not expected to be called directly but rather via Password::Policy->process. It returns the text of an appropriate error which in this case is "Invalid response checking for pwned password".

SEE ALSO

For how to determine if passwords are pwned, see Password::Policy::Rule::Pwned.

To understand how to use this as part of a wider password policy enforcement program, see Password::Policy.

REPOSITORY

https://gitlab.com/openstrike/password-pwned

MAINTAINER

This module is written and maintained by Pete Houston of Openstrike <cpan@openstrike.co.uk>

COPYRIGHT INFORMATION

Copyright 2018 by Pete Houston. All Rights Reserved.

Permission to use, copy, and distribute is hereby granted, providing that the above copyright notice and this permission appear in all copies and in supporting documentation.

LICENCE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.