Passwd::Keyring::Auto - interface to secure password storage(s)
Version 0.23
Passwd::Keyring is about securely preserving passwords and similar sensitive data applications use in backends like Gnome Keyring, KDE Wallet, OSX/Keychain etc.
While modules like Passwd::Keyring::Gnome handle specific backends, Passwd::Keyring::Auto tries to pick the best backend available, considering the current desktop environment.
use Passwd::Keyring::Auto qw(get_keyring); my $keyring = get_keyring(app=>"My super scraper", group=>"Social passwords"); my $username = "someuser"; my $password = $keyring->get_password($username, "mylostspace.com"); if(! $password) { # ... somehow interactively prompt for password $keyring->set_password($username, $password, "mylostspace.com"); } login_somewhere_using($username, $password); if( password_was_wrong ) { $keyring->clear_password($username, "mylostspace.com"); }
If any secure backend is available, password is preserved for successive runs, and users need not be prompted.
Instead of auto-detection, one can also be explicit:
use Passwd::Keyring::Gnome; my $keyring = Passwd::Keyring::Gnome->new(); # ... and so on
get_keyring
my $ring = get_keyring() my $ring = get_keyring(app=>'symbolic application name', group=>'symbolic group/folder/.. name'); my $ring = get_keyring(app=>'...', group=>'...', %backend_specific_options);
Returns the keyring object most appropriate for the current system. Passess all options received to this backend. See Passwd::Keyring::KeyringAPI for their semantic.
Passwd::Keyring::KeyringAPI describes backends API in detail.
Marcin Kasperski, <Marcin.Kasperski at mekk.waw.pl>
<Marcin.Kasperski at mekk.waw.pl>
Please report any bugs or feature requests to issue tracker at https://bitbucket.org/Mekk/perl-keyring.
You can find documentation for this module with the perldoc command.
perldoc Passwd::Keyring::Auto
Source code is published and issues are tracked at:
L<https://bitbucket.org/Mekk/perl-keyring-auto>
Copyright 2012 Marcin Kasperski.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
To install Passwd::Keyring::Auto, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Passwd::Keyring::Auto
CPAN shell
perl -MCPAN -e shell install Passwd::Keyring::Auto
For more information on module installation, please visit the detailed CPAN module installation guide.