NAME Passwd::Keyring::KDEWallet - Password storage implementation based on KDE Wallet. VERSION Version 0.2008 SYNOPSIS KDE Wallet based implementation of Passwd::Keyring. use Passwd::Keyring::KDEWallet; my $keyring = Passwd::Keyring::KDEWallet->new( app=>"blahblah scraper", group=>"Johnny web scrapers", ); my $username = "John"; # or get from .ini, or from .argv... my $password = $keyring->get_password($username, "blahblah.com"); unless( $password ) { $password = ; # securely save password for future use $keyring->set_password($username, $password, "blahblah.com"); } login_somewhere_using($username, $password); if( password_was_wrong ) { $keyring->clear_password($username, "blahblah.com"); } Note: see Passwd::Keyring::Auto::KeyringAPI for detailed comments on keyring method semantics (this document is installed with Passwd::Keyring::Auto package). SUBROUTINES/METHODS new(app=>'app name', group=>'passwords folder') Initializes the processing. Croaks if kwallet (or d-bus, or anything needed) does not seem to be available. Handled named parameters: - app - symbolic application name (used in "Application .... is asking to open the wallet" KDE Wallet prompt) - group - name for the password group (used as KDE Wallet folder name) set_password(username, password, realm) Sets (stores) password identified by given realm for given user get_password($user_name, $realm) Reads previously stored password for given user in given app. If such password can not be found, returns undef. clear_password($user_name, $realm) Removes given password (if present) is_persistent Returns info, whether this keyring actually saves passwords persistently. (true in this case) AUTHOR Marcin Kasperski Approach inspired by http://www.perlmonks.org/?node_id=869620. BUGS Please report any bugs or feature requests to issue tracker at https://bitbucket.org/Mekk/perl-keyring-kdewallet. SUPPORT You can find documentation for this module with the perldoc command. perldoc Passwd::Keyring::KDEWallet You can also look for information at: http://search.cpan.org/~mekk/Passwd-Keyring-KDEWallet/ Source code is tracked at: https://bitbucket.org/Mekk/perl-keyring-kdewallet LICENSE AND COPYRIGHT 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.