Source

perl/keyring/kdewallet / README

Marcin Kasperski 7eebe5a 


Marcin Kasperski b1652e5 
Marcin Kasperski 7eebe5a 
Marcin Kasperski 2954f1a 
Marcin Kasperski b1652e5 
Marcin Kasperski 7eebe5a 

Marcin Kasperski b1652e5 
Marcin Kasperski 7eebe5a 
Marcin Kasperski b1652e5 
Marcin Kasperski 24ee957 



Marcin Kasperski b1652e5 
Marcin Kasperski 24ee957 













Marcin Kasperski b1652e5 
Marcin Kasperski 7eebe5a 

Marcin Kasperski 24ee957 
Marcin Kasperski b1652e5 
Marcin Kasperski 7eebe5a 
Marcin Kasperski 24ee957 
Marcin Kasperski 7eebe5a 

Marcin Kasperski b1652e5 
Marcin Kasperski 24ee957 






Marcin Kasperski 587d256 

Marcin Kasperski b1652e5 
Marcin Kasperski 587d256 
Marcin Kasperski 7eebe5a 

Marcin Kasperski b1652e5 
Marcin Kasperski 587d256 
Marcin Kasperski 7eebe5a 
Marcin Kasperski b1652e5 
Marcin Kasperski 7eebe5a 


























Marcin Kasperski b1652e5 

Marcin Kasperski e0ae783 
Marcin Kasperski b1652e5 
Marcin Kasperski 7eebe5a 


Marcin Kasperski b1652e5 
Marcin Kasperski 7eebe5a 
Marcin Kasperski b1652e5 
NAME
    Passwd::Keyring::KDEWallet - Password storage implementation based on
    KDE Wallet.

VERSION
    Version 0.2005

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 = <somehow interactively prompt for password>;

            # securely save password for future use
            $keyring->set_password($username, "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 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.